# 订单补发货

调试诊断

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:delivery_compensation

订单商品发货后,因为商品漏发/拆分包裹/坏损/赠品等场景可进行补发。一个订单最多可补发10次。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/order/delivery/compensation?access_token=ACCESS_TOKEN

# 云调用

  • 本接口不支持云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用)

# 请求体 Request Payload

参数名类型必填说明枚举
order_idnumber订单id-
delivery_listobjarray物流信息-
reasonnumber补发原因枚举值

# Body.delivery_list(Array) Object Payload

物流信息

参数名类型必填说明
deliver_typenumber发货方式,1:第三方快递发货,6:自建物流发货
waybill_idstring快递单号
delivery_idstring快递公司id,通过获取快递公司列表接口获得,非主流快递公司可以填OTHER
product_infosobjarray包裹中的商品信息

# Body.delivery_list(Array).product_infosObject Payload

包裹中的商品信息

参数名类型必填说明
product_idstring商品id
sku_idstring商品sku
product_cntnumber商品数量

# 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,请检查相关权限是否已开通
606004delivery_id不合法,请使用【获取物流公司列表】接口获取合法的delivery_id
606005waybill_id不合法,请检查快递单号是否正确填写
606049当前订单存在风险,具体风险提示请查看errmsg
6060494商品未完成发货
6060495订单超出补发上限
6060496商品不存在
6060497订单不支持补发
6060498商品超出订单补发次数上限
6060499商品不支持补发

# 8. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。

接口变更日志(1条)
2025 年 12 月 10 日
新增 订单补发货