基础技术
一、说明
本文档说面向的对象包括接入补寄 API 开发天猫通用&淘宝通用业务身份商家的补寄处理功能的第三方开发者（下文简称为：isv）或进行自主开发的商家。
本文档主要涵盖补寄流程介绍、补寄 API 接口说明 2 个部分。其中补寄 API 接口说明主要包括了对 API 具体功能、常用出参与入参、具体调用场景及注意事项等几个方面。
二、补寄流程
当前补寄基本流程如下图所示。
三、补寄 API 接口
1. 具体功能
接口名称 |
功能简介 |
接口功能描述 |
查询补寄详情 |
查询 补寄详情数据 单笔 |
|
查询补寄列表 |
查询 补寄数据 列表 |
|
查询补寄留言列表 |
查询 补寄留言(原因/说明/凭证) 列表 |
|
卖家创建补寄留言 |
操作 卖家创建补寄留言 |
|
卖家同意补寄申请 |
操作 同意补寄 |
|
卖家拒绝补寄申请 |
操作 拒绝补寄 |
|
卖家补寄发货 |
操作 卖家补寄发货 |
|
查询拒绝补寄原因列表 |
查询 拒绝补寄原因 列表 |
天猫、淘宝关于补寄单处理规则
2. 参数总结
补寄状态
补寄待处理 |
WAIT_SELLER_AGREE |
1 |
等待卖家发货 |
WAIT_SELLER_SEND_GOODS |
16 |
等待买家收货 |
WAIT_BUYER_CONFIRM_REDO_SEND_GOODS |
7 |
卖家拒绝补寄 |
SELLER_REFUSE_BUYER |
6 |
转退款 |
EXCHANGE_TRANSFORM_TO_REFUND |
14 |
补寄成功 |
SUCCESS |
5 |
补寄关闭 |
CLOSED |
4 |
3. 调用场景
① 所有功能类补寄接口，只针对属于卖家应当处理且处于特定补寄状态的补寄单；
② 所有查询类补寄接口，卖家可以随时调用；
③ 对于创建留言接口，卖家可以调用其在任何处于补寄流程中的补寄单。
4. 注意事项
1、若还未对接erp，商家可以直接在千牛售后工作台处理补寄单。
2、接口仅支持新补寄的调用，老补寄暂未支持。 tmall.reshipping.get( 查询补寄详情 ) 接口返回的attributes字段或taobao.refund.get接口返回的attribute字段里含newReshipping=1即为新补寄。
3、同意补寄后24H未发货，买家可申请赔付。
4、补寄接口目前天猫和淘宝共用一套，不需要分别接入。
5、补寄灰度是针对买家维度的，商家维度全量的；如果有需要灰度买家显示补寄入口的，请在钉钉答疑群（群号：124335031705）提供买家nick或者买家ID反馈给答疑小二添加。
6、买家是哪个SKU申请了补寄可以关注字段 bought_sku、new_bought_sku；但是不要完全依赖这两个字段，因为申请补寄的不一定是这个sku，但实际情况，比如买了衣服，那么是在这件衣服下面发起的补寄，但是有可能只是补寄一个纽扣；所以实际要补寄的信息需要商家和买家协商沟通的结果，还要关注字段desc的信息。
7、tmall.reshipping.refuse( 卖家拒绝补寄申请 ) 的leave_message_pics入参限制，与taobao.refund.refuse( 卖家拒绝退款 )的一样
8、查询补寄列表接口tmall.reshipping.receive.get ，请求是传数字查询，返回是英文状态
9、新补寄逻辑 “查询补寄详情数据”和 “查询补寄详列表”都没有体现从原订单上哪个子订单申请的补寄单吗？
答：查看出参biz_order_id 返回的是子订单号。
10、tmall.reshipping.get 和 tmall.reshipping.receive.get 哪个字段是交易主订单号？
答：淘宝交易主订单号字段 alipay_no
11、buyer_address这个地址一定是4段吗，会不会出现没有其中1段，或者多1段的情况，省 市 区县 乡镇 详细地址的字段能否分开。
buyer_address："北京^^^北京市^^^东城区^^^东**街道测试地址不发货!”
答：就这4段。
12、咨询下,新补寄单数据获取方式有没有可能整合到塔内数据推送里,我们目前的补寄单也是从数据推送这边过来,再对接一套查询接口其实没有必要。
答：补寄单推送到退款表中 JDP_TB_REFUND，其他的 同意补寄、拒绝补寄、补寄发货 等功能需要你们API实现。
推送数据中通过字段"dispute_type": "RESHIPPING" 判断是否补寄单。
13、请问下为什么tmall.reshipping.receive.get接口没有返回desc字段？tmall.reshipping.get有返回。这2个接口返回的字段不能保持统一吗？
答：tmall.reshipping.receive.get 是查询补寄列表的，不支持查询详情，补寄详情使用详情查询接口 tmall.reshipping.get
列表接口支持查询的字段请看文档说明。
14、请问下 bought_sku 和 new_bought_sku 的区别是什么？
答：bought_sku 是指原订单上的旧sku；new_bought_sku是指原订单上的新sku。
15、补寄我看也有OAID，获取运单号的时候，使用电子面单是需要传入原交易号+OAID，还是使用补寄单dispute_id+OAID获取呢？
答：使用补寄单dispute_id+OAID获取。
16、消费者从补寄转退款是指，收到货品之后然后补寄的商品又不要了是嘛？这个时候是不是会有退款申请，退款申请的交易号是原订单号+申请单号是补寄单号吗？还是会产生一个新的申请单号？
答：新创建一个退款单，然后补寄单关闭。