文档中心 > 基础技术

补寄场景

更新时间：2025/11/25 访问次数：1174

一、说明
二、补寄流程
三、补寄 API 接口

一、说明

本文档说面向的对象包括接入补寄 API 开发天猫通用&淘宝通用业务身份商家的补寄处理功能的第三方开发者（下文简称为：isv）或进行自主开发的商家。

本文档主要涵盖补寄流程介绍、补寄 API 接口说明 2 个部分。其中补寄 API 接口说明主要包括了对 API 具体功能、常用出参与入参、具体调用场景及注意事项等几个方面。

二、补寄流程

当前补寄基本流程如下图所示。

三、补寄 API 接口

1. 具体功能

接口名称	功能简介	接口功能描述
tmall.reshipping.get	查询补寄详情	查询补寄详情数据单笔
tmall.reshipping.receive.get	查询补寄列表	查询补寄数据列表
tmall.reshipping.messages.get	查询补寄留言列表	查询补寄留言(原因/说明/凭证) 列表
tmall.reshipping.message.add	卖家创建补寄留言	操作卖家创建补寄留言
tmall.reshipping.agree	卖家同意补寄申请	操作同意补寄
tmall.reshipping.refuse	卖家拒绝补寄申请	操作拒绝补寄
tmall.reshipping.consigngoods	卖家补寄发货	操作卖家补寄发货
tmall.reshipping.refusereason.get	查询拒绝补寄原因列表	查询拒绝补寄原因列表

天猫、淘宝关于补寄单处理规则

淘宝：https://rulechannel.taobao.com/?type=detail&ruleId=20008385&cId=81#/rule/detail?ruleId=20008385&cId=81

天猫：https://rulechannel.tmall.com/?type=detail&ruleId=20008387&cId=395#/rule/detail?ruleId=20008387&cId=395

2. 参数总结

https://open.taobao.com/api.htm?spm=a219a.7386797.0.0.82e7669a5oYZWP&source=search&docId=73480&docType=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. 注意事项

① 若还未对接erp，商家可以直接在千牛售后工作台处理补寄单。

② 接口仅支持新补寄的调用，老补寄暂未支持。 tmall.reshipping.get( 查询补寄详情 ) 接口返回的attributes字段或taobao.refund.get接口返回的attribute字段里含newReshipping=1即为新补寄。

③ 同意补寄后24H未发货，买家可申请赔付。

④ 补寄接口目前天猫和淘宝共用一套，不需要分别接入。

⑤ 补寄灰度是针对买家维度的，商家维度全量的；如果有需要灰度买家显示补寄入口的，请在钉钉答疑群（群号：124335031705）提供买家nick或者买家ID反馈给答疑小二添加。

⑥ 买家是哪个SKU申请了补寄可以关注字段 bought_sku、new_bought_sku；但是不要完全依赖这两个字段，因为申请补寄的不一定是这个sku，但实际情况，比如买了衣服，那么是在这件衣服下面发起的补寄，但是有可能只是补寄一个纽扣；所以实际要补寄的信息需要商家和买家协商沟通的结果，还要关注字段desc的信息。