售后详情 - 小红书 API

{ "returnsId": "R7488183140002901", "returnType": 1, "reasonId": "", "reason": "质量问题", "status": 1, "subStatus": 301, "receiveAbnormalType": 1, "orderId": "P617****3941", "exchangeOrderId": "P617****941", "userId": "1419231", "createdAt": 1617724800, "returnExpressNo": "6411****2491", "returnExpressCompany": "中通", "returnAddress": "上海是徐汇区****", "shipNeeded": "", "refunded": true, "refundStatus": 1, "autoReceiveDeadline": 1617724800, "useFastRefund": "", "proofPhotos": [ "string" ], "desc": "质量不好", "note": "质量不好", "refundTime": 1617724800, "fillExpressTime": 1617724800, "expressSignTime": 1617724800, "skus": [ { "skuId": "5e216****04d5", "skuName": "测试商品", "image": "http://img.xiaohongshu.com/items/3135edc58855dcf047fc39161ee9f687@2o.jpg", "price": 100, "boughtCount": 1, "appliedCount": 1, "returnedCount": 1, "refundedCount": 3, "returnPrice": 100, "exchangeSkuId": "5e216****04d5", "exchangeSkuName": "测试换货商品", "exchangeSkuImage": "http://img.xiaohongshu.com/items/3135edc58855dcf047fc39161ee9f687@2o.jpg", "scSkucode": "RTI2***50-AL", "barcode": "xhsbo***901", "exchangeScskuCode": "RTI2***50-AL", "exchangeBarcode": "xhsbo***901" } ], "refundFee": 100, "returnExpressRefundable": true, "returnExpressRefunded": "", "expectRefundFee": 110, "updatedAt": 1617724800, "returnExpressCompanyCode": "", "openAddressId": "", "expectedRefundAmount": 100 }

请求参数

Header 参数

Content-Type

string

可选

默认值:

application/json;charset=utf-8

Body 参数application/json

timestamp

string

必需

接口调用时的时间戳，即当前时间戳（时间戳：当前距离Epoch（1970年1月1日) 以秒计算的时间，即unix-timestamp

appId

string

必需

第三方获取到的appid

sign

string

输入参数的签名结果

必需

version

string

必需

版本号，采用oauth2授权后均填入2.0

method

string

具体调用方法

必需

accessToken

string

可选

业务接口鉴权。非必须，调用商家业务接口必须使用

afterSaleId

string

售后id

必需

示例

返回响应

🟢200成功

application/json

Body

returnsId

string

售后id

必需

returnType

integer

必需

退货类型 1-退货退款, 2-换货, 3:仅退款(old) 4:仅退款(new) 理论上不会有3出现 5:未发货仅退款

reasonId

string

售后原因id

必需

reason

string

售后原因说明

必需

status

integer

必需

售后状态 1:待审核 2:待用户寄回 3:待收货 4:完成 5:取消 6:关闭 9:拒绝 12:包裹商家已确认收货，等待商家发货 13:包裹商家已发货，等待用户确认收货

subStatus

integer

必需

售后子状态 301-待审核 302-快递已签收 304-收货异常

receiveAbnormalType

integer

必需

收货异常类型 1:商家已开工单 2:仓库质检异常 3:收货地异常 4:寄回包裹物流超时 5:仓库反向创建退货 6:快递轨迹异常 7:拒收退仓超时 8:退款金额超限 9:收货地不一致 10:仓库质检假货 11:已退款，未收货 21:未收到货 22:退货数量不符 23:退货商品不符 24:退货质检异常 25:其他

orderId

string

订单id

必需

exchangePackageId

string

换货订单id

必需

userId

string

用户id

必需

createdAt

integer

创建时间

必需

returnExpressNo

string

售后订单快递单号

必需

returnExpressCompany

string

售后订单快递公司

必需

returnAddress

string

售后寄回地址

必需

shipNeeded

string

必需

是否需要寄回 0-否 1-是 -1-全部

refunded

boolean

是否已退款

必需

refundStatus

integer

必需

退款状态，0：暂未触发退款；108 触发退款；1 退款中；2 退款成功；3 退款失败；101 转帐超时；401 已取消；201 待审核；301 审核通过；302 审核不通过；402 自动关闭

autoReceiveDeadline

integer

必需

超时自动确认收货的时间

useFastRefund

string

必需

是否急速退款，已经废弃

proofPhotos

array[string]

照片凭证

必需

desc

string

描述

必需

note

string

备注

必需

refundTime

integer

退款时间

必需

fillExpressTime

integer

填写退货快递单时间

必需

expressSignTime

integer

退货快递签收时间

必需

skus

array [object {16}]

售后商品

必需

itemId

string

商品id

可选

itemName

string

商品名称

可选

image

string

商品主图

可选

price

integer

商品价格

可选

boughtCount

integer

购买数量

可选

appliedCount

integer

申请退货数量

可选

returnedCount

integer

实际收货数量

可选

refundedCount

integer

退款数量

可选

returnPrice

integer

实际退款

可选

exchangeItemId

string

换货商品id

可选

exchangeItemName

string

换货商品名称

可选

exchangeItemImage

string

换货商品主图

可选

skucode

string

商品代码

可选

barcode

string

商品条码

可选

exchangeSkucode

string

换货商品代码

可选

exchangeBarcode

string

换货商品条码

可选

refundFee

integer

退款金额，单位元

必需

returnExpressRefundable

boolean

退货运费是否可退

必需

returnExpressRefunded

string

退货运费是否已退

必需

expectRefundFee

integer

必需

(废弃)期望退款金额，单位元，目前是售后单包含的商品总金额

updatedAt

integer

更新时间

必需

returnExpressCompanyCode

string

退货快递公司编号

必需

openAddressId

string

收件信息id

必需

expectedRefundAmount

integer

必需

预期退款金额，单位元