售后信息同步接口

所有金额单位为分
所有时间格式为：yyyy-MM-dd HH:mm:ss

退货退款售后单
上传运单后，售后单状态为 status=4，退货中，同步客户，报文如下：
[{"parentOrderNo":"10011798989493365174273","orderNo":"10011798989493365174273","refundId":"1798993336141864961","uid":1000000273,"status":4,"aftersaleMethod":1,"reasonCode":"7","reasonCodeDes":"不想要了","afterSaleImgList":null,"createRemark":"退货退款","createTime":"2024-06-07 16:20:10","auditTime":"2024-06-07 16:27:50","deliveryTime":"2024-06-07 16:28:33","warehouseReceiveTime":"","finishTime":"","cancelTime":"","updateTime":"","cancelType":null,"cancelRemark":null,"auditRemark":"退货退款单","expressDeliveryRemark":"上传运单","warehouseReceiveRemark":null,"receiveAddressProvince":"","receiveAddressCity":"","receiveAddressArea":"","receiveAddressDetail":"江苏省南京市江宁区孩子王产业园","receiveName":"15951000354","receiveMobile":"15951000354","warehouseType":"2","warehouseCode":"s001","warehouseName":"s001商城虚拟仓","afterSaleExpressList":[{"expressCompanyCode":"yuantong","expressCompanyName":"圆通速递","expressNumber":"YT202406071628"}],"sceneType":"0","originalOrderPaymentType":"0","originalOrderPaymentTypeDesc":"全款","originalOrderBusinessType":"1","originalOrderBusinessTypeDesc":"一般贸易","depositAmt":null,"balancePaymentAmt":null,"supplierCode":null,"goodsTotalFee":100000,"deliveryFee":0,"auditHandDeductFee":0,"warehouseHandDeductFee":0,"totalDeductFee":0,"goodsAllowRefundFee":100000,"payDetailList":null,"afterSaleGoodsList":[{"orderLineNo":"1001","goodsSerial":"1001","skuCode":"005367","externalSkuCode":"","barCode":"2300000009095","picUrl":"https://test-1253930173.file.myqcloud.com/153658/a1be5190-53c1-4313-8098-858023116561_type_cos_size_500x310.jpg","skuName":"666Goods666Goods666Goods666Goods666Goods666Goods6","aftersaleAmount":1,"tradingType":"0","saleAmt":100000,"goodsLineRefundFee":100000}]}]

入库操作后，售后单状态 status=6 待退款，同步客户，报文如下：
[{"parentOrderNo":"10011798989493365174273","orderNo":"10011798989493365174273","refundId":"1798993336141864961","uid":1000000273,"status":6,"aftersaleMethod":1,"reasonCode":"7","reasonCodeDes":"不想要了","afterSaleImgList":null,"createRemark":"退货退款","createTime":"2024-06-07 16:20:10","auditTime":"2024-06-07 16:27:50","deliveryTime":"2024-06-07 16:28:33","warehouseReceiveTime":"2024-06-07 16:31:00","finishTime":"","cancelTime":"","updateTime":"","cancelType":null,"cancelRemark":null,"auditRemark":"退货退款单","expressDeliveryRemark":"上传运单","warehouseReceiveRemark":null,"receiveAddressProvince":"","receiveAddressCity":"","receiveAddressArea":"","receiveAddressDetail":"江苏省南京市江宁区孩子王产业园","receiveName":"15951000354","receiveMobile":"15951000354","warehouseType":"2","warehouseCode":"s001","warehouseName":"s001商城虚拟仓","afterSaleExpressList":[{"expressCompanyCode":"yuantong","expressCompanyName":"圆通速递","expressNumber":"YT202406071628"}],"sceneType":"0","originalOrderPaymentType":"0","originalOrderPaymentTypeDesc":"全款","originalOrderBusinessType":"1","originalOrderBusinessTypeDesc":"一般贸易","depositAmt":null,"balancePaymentAmt":null,"supplierCode":null,"goodsTotalFee":100000,"deliveryFee":0,"auditHandDeductFee":0,"warehouseHandDeductFee":0,"totalDeductFee":0,"goodsAllowRefundFee":100000,"payDetailList":null,"afterSaleGoodsList":[{"orderLineNo":"1001","goodsSerial":"1001","skuCode":"005367","externalSkuCode":"","barCode":"2300000009095","picUrl":"https://test-1253930173.file.myqcloud.com/153658/a1be5190-53c1-4313-8098-858023116561_type_cos_size_500x310.jpg","skuName":"666Goods666Goods666Goods666Goods666Goods666Goods6","aftersaleAmount":1,"tradingType":"0","saleAmt":100000,"goodsLineRefundFee":100000}]}]

退款成功后，售后单状态 status=8 已完成，同步客户，报文如下：
{"parentOrderNo":"10011798989493365174273","orderNo":"10011798989493365174273","refundId":"1798993336141864961","uid":1000000273,"status":8,"aftersaleMethod":1,"reasonCode":"7","reasonCodeDes":"不想要了","afterSaleImgList":null,"createRemark":"退货退款","createTime":"2024-06-07 16:20:10","auditTime":"2024-06-07 16:27:50","deliveryTime":"2024-06-07 16:28:33","warehouseReceiveTime":"2024-06-07 16:31:00","finishTime":"","cancelTime":"","updateTime":"","cancelType":null,"cancelRemark":null,"auditRemark":"退货退款单","expressDeliveryRemark":"上传运单","warehouseReceiveRemark":null,"receiveAddressProvince":"","receiveAddressCity":"","receiveAddressArea":"","receiveAddressDetail":"江苏省南京市江宁区孩子王产业园","receiveName":"15951000354","receiveMobile":"15951000354","warehouseType":"2","warehouseCode":"s001","warehouseName":"s001商城虚拟仓","afterSaleExpressList":[{"expressCompanyCode":"yuantong","expressCompanyName":"圆通速递","expressNumber":"YT202406071628"}],"sceneType":"0","originalOrderPaymentType":"0","originalOrderPaymentTypeDesc":"全款","originalOrderBusinessType":"1","originalOrderBusinessTypeDesc":"一般贸易","depositAmt":null,"balancePaymentAmt":null,"supplierCode":null,"goodsTotalFee":100000,"deliveryFee":0,"auditHandDeductFee":0,"warehouseHandDeductFee":0,"totalDeductFee":0,"goodsAllowRefundFee":100000,"payDetailList":[{"bizOrderId":"1798993336141864961","status":7,"merchantPayType":1003,"merchantPayTypeName":"钱包","realAmount":100000}],"afterSaleGoodsList":[{"orderLineNo":"1001","goodsSerial":"1001","skuCode":"005367","externalSkuCode":"","barCode":"2300000009095","picUrl":"https://test-1253930173.file.myqcloud.com/153658/a1be5190-53c1-4313-8098-858023116561_type_cos_size_500x310.jpg","skuName":"666Goods666Goods666Goods666Goods666Goods666Goods6","aftersaleAmount":1,"tradingType":"0","saleAmt":100000,"goodsLineRefundFee":100000}]}

仅退款售后单
退款成功后，售后单状态 status=8 已完成，同步客户，报文如下：
[{"parentOrderNo":"10011798989493365174273","orderNo":"10011798989493365174273","refundId":"1799006166563938306","uid":1000000273,"status":8,"aftersaleMethod":0,"reasonCode":"8","reasonCodeDes":"其他原因","afterSaleImgList":null,"createRemark":"仅退款","createTime":"2024-06-07 17:11:09","auditTime":"2024-06-07 17:11:48","deliveryTime":"","warehouseReceiveTime":"","finishTime":"","cancelTime":"","updateTime":"","cancelType":null,"cancelRemark":null,"auditRemark":"审核仅退款","expressDeliveryRemark":null,"warehouseReceiveRemark":null,"receiveAddressProvince":null,"receiveAddressCity":null,"receiveAddressArea":null,"receiveAddressDetail":null,"receiveName":null,"receiveMobile":null,"warehouseType":null,"warehouseCode":"s001","warehouseName":null,"afterSaleExpressList":null,"sceneType":"0","originalOrderPaymentType":"0","originalOrderPaymentTypeDesc":"全款","originalOrderBusinessType":"1","originalOrderBusinessTypeDesc":"一般贸易","depositAmt":null,"balancePaymentAmt":null,"supplierCode":null,"goodsTotalFee":100000,"deliveryFee":0,"auditHandDeductFee":0,"warehouseHandDeductFee":0,"totalDeductFee":0,"goodsAllowRefundFee":100000,"payDetailList":[{"bizOrderId":"1799006166563938306","status":7,"merchantPayType":1003,"merchantPayTypeName":"钱包","realAmount":100000}],"afterSaleGoodsList":[{"orderLineNo":"1001","goodsSerial":"1001","skuCode":"005367","externalSkuCode":"","barCode":"2300000009095","picUrl":"https://test-1253930173.file.myqcloud.com/153658/a1be5190-53c1-4313-8098-858023116561_type_cos_size_500x310.jpg","skuName":"666Goods666Goods666Goods666Goods666Goods666Goods6","aftersaleAmount":1,"tradingType":"0","saleAmt":100000,"goodsLineRefundFee":100000}]}]

请求参数

Cookie 参数

_platform_num

string

租户号

必需

示例值:

153658

Body 参数application/json

parentOrderNo

string

原单父单号

必需

orderNo

string

原单子单号

必需

refundId

string

售后主单号

必需

uid

string

uid

必需

status

integer

必需

售后状态 1: 待审核; 2: 审核不通过; 3: 待退货; 4: 退货中; 5: 退货失败; 6: 待退款; 7: 退款失败; 8: 已完成; 9: 已取消;10 已关闭

aftersaleMethod

string

必需

售后方式 0: 仅退款; 1: 退货退款;

reasonCode

string

售后原因编码

必需

reasonCodeDes

string

售后原因描述

必需

afterSaleImgList

array[string]

售后图片

可选

createRemark

string

售后创建备注

可选

createTime

string

必需

售后单创建时间 yyyy-MM-dd HH:mm:ss

auditTime

string

售后单审核时间

可选

deliveryTime

string

售后单运单上传时间

可选

warehouseReceiveTime

string

售后单确认入库时间

可选

finishTime

string

售后单退款完成时间

可选

cancelTime

string

售后单取消时间

可选

updateTime

string

售后单最后更新时间

可选

cancelType

string

可选

售后取消类型 0: 顾客取消; 1: 员工取消; 2: 超时未上传运单取消;

cancelRemark

string

售后取消备注

可选

auditRemark

string

售后单审核备注

可选

expressDeliveryRemark

string

售后单发货备注

可选

warehouseReceiveRemark

string

仓库确认收货备注

可选

receiveAddressProvince

string

退货收货省名称

可选

receiveAddressCity

string

退货收货市名称

可选

receiveAddressArea

string

退货收货区名称

可选

receiveAddressDetail

string

可选

退货收货省+市+区+街道+详细地址

receiveName

string

退单收货人姓名

可选

receiveMobile

string

退单收货人电话

可选

originalOrderPaymentType

string

必需

原单付款方式, 0-全款；1-定金；2-货到付款

originalOrderPaymentTypeDesc

string

原单付款方式描述

必需

originalOrderBusinessType

string

必需

原单业务类型, 1-一般贸易，2-跨境购，3-一件代发

originalOrderBusinessTypeDesc

string

原单业务类型描述

必需

depositAmt

number

售后定金金额汇总

必需

balancePaymentAmt

number

售后尾款金额汇总

必需

supplierCode

string

代发供应商编码

必需

warehouseType

string

可选

后仓库类型 0-门店仓 1-大仓 2-一件代发仓

warehouseCode

string

售后仓库编码

可选

warehouseName

string

售后仓库名称

可选

afterSaleExpressList

array [object {3}]

售后退货物流信息

可选

expressCompanyCode

string

售后快递公司编码

必需

expressCompanyName

string

售后快递公司名称

必需

expressNumber

string

售后物流单号

必需

sceneType

integer

必需

原订单场景类型, 0-普通销售，1-代客下单

goodsTotalFee

number

必需

商品售后总金额(申请商品退款金额总和)

totalRefundFee

number

必需

售后单退款总金额(商品退款金额+退运费金额(如果配置可退)-扣货款金额)

deliveryFee

number | null

退运费总金额

必需

auditHandDeductFee

number

审核手工扣款总金额

必需

warehouseHandDeductFee

number

入库手工扣款总金额

必需

totalDeductFee

number

必需

扣货款总金额 totalDeductFee = auditHandDeductFee + warehouseHandDeductFee + 优惠内扣货款金额

goodsAllowRefundFee

number

必需

商品可退款总金额（申请商品退款金额总和 - 扣货款金额 - 审核和入库手工扣款金额）

payDetailList

array [object {5}]

退款信息

可选

bizOrderId

string

退款单号

必需

status

integer

必需

7 退款成功 8 退款失败

merchantPayType

string

商户支付方式

必需

merchantPayTypeName

string

商户支付方式名称

必需

realAmount

number

子单实退金额

必需

afterSaleGoodsList

array [object {13}]

售后商品列表

必需

orderLineNo

string

原订单商品行号

必需

goodsSerial

string

售后商品行号

必需

skuCode

string

商品编码

必需

externalSkuCode

string

外部商品编码

必需

barCode

string

商品条码

必需

skuName

string

商品名称

必需

aftersaleAmount

integer

售后数量

必需

picUrl

string

商品主图

必需

tradingType

integer

必需

商品交易类型 0 主商品 1 赠品 2 换购品

saleAmt

number

必需

原单商品售价（单价）

goodsLineRefundFee

number

商品行退款金额

必需

depositAmt

number

定金分摊金额

必需

balancePaymentAmt

number

尾款分摊金额

必需

示例

{
    "parentOrderNo": "string",
    "orderNo": "string",
    "refundId": "string",
    "uid": "string",
    "status": 0,
    "aftersaleMethod": "string",
    "reasonCode": "string",
    "reasonCodeDes": "string",
    "afterSaleImgList": [
        "string"
    ],
    "createRemark": "string",
    "createTime": "string",
    "auditTime": "string",
    "deliveryTime": "string",
    "warehouseReceiveTime": "string",
    "finishTime": "string",
    "cancelTime": "string",
    "updateTime": "string",
    "cancelType": "string",
    "cancelRemark": "string",
    "auditRemark": "string",
    "expressDeliveryRemark": "string",
    "warehouseReceiveRemark": "string",
    "receiveAddressProvince": "string",
    "receiveAddressCity": "string",
    "receiveAddressArea": "string",
    "receiveAddressDetail": "string",
    "receiveName": "string",
    "receiveMobile": "string",
    "originalOrderPaymentType": "string",
    "originalOrderPaymentTypeDesc": "string",
    "originalOrderBusinessType": "string",
    "originalOrderBusinessTypeDesc": "string",
    "depositAmt": 0,
    "balancePaymentAmt": 0,
    "supplierCode": "string",
    "warehouseType": "string",
    "warehouseCode": "string",
    "warehouseName": "string",
    "afterSaleExpressList": [
        {
            "expressCompanyCode": "string",
            "expressCompanyName": "string",
            "expressNumber": "string"
        }
    ],
    "sceneType": 0,
    "goodsTotalFee": 0,
    "totalRefundFee": 0,
    "deliveryFee": 0,
    "auditHandDeductFee": 0,
    "warehouseHandDeductFee": 0,
    "totalDeductFee": 0,
    "goodsAllowRefundFee": 0,
    "payDetailList": [
        {
            "bizOrderId": "string",
            "status": 0,
            "merchantPayType": "string",
            "merchantPayTypeName": "string",
            "realAmount": 0
        }
    ],
    "afterSaleGoodsList": [
        {
            "orderLineNo": "string",
            "goodsSerial": "string",
            "skuCode": "string",
            "externalSkuCode": "string",
            "barCode": "string",
            "skuName": "string",
            "aftersaleAmount": 0,
            "picUrl": "string",
            "tradingType": 0,
            "saleAmt": 0,
            "goodsLineRefundFee": 0,
            "depositAmt": 0,
            "balancePaymentAmt": 0
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '由客户方提供' \
--header 'Cookie: _platform_num=153658' \
--header 'Content-Type: application/json' \
--data-raw '{
    "parentOrderNo": "string",
    "orderNo": "string",
    "refundId": "string",
    "uid": "string",
    "status": 0,
    "aftersaleMethod": "string",
    "reasonCode": "string",
    "reasonCodeDes": "string",
    "afterSaleImgList": [
        "string"
    ],
    "createRemark": "string",
    "createTime": "string",
    "auditTime": "string",
    "deliveryTime": "string",
    "warehouseReceiveTime": "string",
    "finishTime": "string",
    "cancelTime": "string",
    "updateTime": "string",
    "cancelType": "string",
    "cancelRemark": "string",
    "auditRemark": "string",
    "expressDeliveryRemark": "string",
    "warehouseReceiveRemark": "string",
    "receiveAddressProvince": "string",
    "receiveAddressCity": "string",
    "receiveAddressArea": "string",
    "receiveAddressDetail": "string",
    "receiveName": "string",
    "receiveMobile": "string",
    "originalOrderPaymentType": "string",
    "originalOrderPaymentTypeDesc": "string",
    "originalOrderBusinessType": "string",
    "originalOrderBusinessTypeDesc": "string",
    "depositAmt": 0,
    "balancePaymentAmt": 0,
    "supplierCode": "string",
    "warehouseType": "string",
    "warehouseCode": "string",
    "warehouseName": "string",
    "afterSaleExpressList": [
        {
            "expressCompanyCode": "string",
            "expressCompanyName": "string",
            "expressNumber": "string"
        }
    ],
    "sceneType": 0,
    "goodsTotalFee": 0,
    "totalRefundFee": 0,
    "deliveryFee": 0,
    "auditHandDeductFee": 0,
    "warehouseHandDeductFee": 0,
    "totalDeductFee": 0,
    "goodsAllowRefundFee": 0,
    "payDetailList": [
        {
            "bizOrderId": "string",
            "status": 0,
            "merchantPayType": "string",
            "merchantPayTypeName": "string",
            "realAmount": 0
        }
    ],
    "afterSaleGoodsList": [
        {
            "orderLineNo": "string",
            "goodsSerial": "string",
            "skuCode": "string",
            "externalSkuCode": "string",
            "barCode": "string",
            "skuName": "string",
            "aftersaleAmount": 0,
            "picUrl": "string",
            "tradingType": 0,
            "saleAmt": 0,
            "goodsLineRefundFee": 0,
            "depositAmt": 0,
            "balancePaymentAmt": 0
        }
    ]
}'

请求参数

示例代码

返回响应