# 订单补发货
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:delivery_compensation
订单商品发货后,因为商品漏发/拆分包裹/坏损/赠品等场景可进行补发。一个订单最多可补发10次。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/order/delivery/compensation?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为:131
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用) |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| order_id | number | 是 | 订单id | - |
| delivery_list | objarray | 是 | 物流信息 | - |
| reason | number | 是 | 补发原因 | 枚举值 |
# Body.delivery_list(Array) Object Payload
物流信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| deliver_type | number | 是 | 发货方式,1:第三方快递发货,6:自建物流发货 |
| waybill_id | string | 是 | 快递单号 |
| delivery_id | string | 是 | 快递公司id,通过获取快递公司列表接口获得,非主流快递公司可以填OTHER |
| product_infos | objarray | 是 | 包裹中的商品信息 |
# Body.delivery_list(Array).product_infosObject Payload
Object Payload包裹中的商品信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | string | 是 | 商品id |
| sku_id | string | 是 | 商品sku |
| product_cnt | number | 是 | 商品数量 |
# 3. 返回参数
# 返回体 Response Payload
无
# 4. 枚举信息
# Body.reason Enum
补发原因
| 枚举值 | 描述 |
|---|---|
| 1 | 商品漏发 |
| 2 | 商品拆分包裹 |
| 3 | 商品坏损 |
| 4 | 赠品 |
# 5. 注意事项
订单同时符合以下条件时,可使用本功能:
- 订单为需通过快递发货的实物商品,且订单类型非「质检订单」、「国补订单」;
- 订单处于售后期内;
- 需操作补发货的商品SKU已全部发货;
- 需操作补发货的商品SKU未处于售后中状态。
同一订单可最多补发货10个运单包裹,即商家补发货10次后,将不再支持使用本功能。
# 6. 代码示例
请求示例
{
"order_id": "123456",
"reason":1,
"delivery_list": [
{
"delivery_id": "YD",
"waybill_id": "23424324253",
"deliver_type": 1,
"product_infos": [
{
"product_cnt": 1,
"product_id": "12345",
"sku_id": "678910"
}
]
}
]
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 7. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 40097 | 请求体参数不正确,请检查各个参数是否按规范填写,具体原因请查看errmsg |
| 47001 | 请求体格式不正确,请检查请求体中各个参数的类型是否正确 |
| 48001 | 无权调用本api,请检查相关权限是否已开通 |
| 606004 | delivery_id不合法,请使用【获取物流公司列表】接口获取合法的delivery_id |
| 606005 | waybill_id不合法,请检查快递单号是否正确填写 |
| 606049 | 当前订单存在风险,具体风险提示请查看errmsg |
| 6060494 | 商品未完成发货 |
| 6060495 | 订单超出补发上限 |
| 6060496 | 商品不存在 |
| 6060497 | 订单不支持补发 |
| 6060498 | 商品超出订单补发次数上限 |
| 6060499 | 商品不支持补发 |
# 8. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。
2025 年 12 月 10 日
新增 订单补发货