# 订单发货

# 接口说明

可通过该接口对订单发货

# 注意事项

已经完成售后的商品不能进行发货。

# 接口调用请求说明

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

# 请求参数说明

参数 类型 是否必填 描述
order_id string 订单id
delivery_list array DeliveryInfo 物流信息,结构体详情请参考DeliveryInfo

# 请求参数示例

# 普通快递发货

{
    "order_id": "123456",
    "delivery_list": [
        {
            "delivery_id": "YD",
            "waybill_id": "23424324253",
            "deliver_type": 1,
            "product_infos": [
                {
                    "product_cnt": 1,
                    "product_id": "12345",
                    "sku_id": "678910"
                }
            ]
        }
    ]
}

# 课程发货

{
    "order_id": "123456",
    "delivery_list": [
        {
            "deliver_type": 3,
            "product_infos": [
                {
                    "product_cnt": 1,
                    "product_id": "12345",
                    "sku_id": "678910"
                }
            ],
            "course_info" :{
                "start_time" : 1675180800,
                "end_time" : 1675958400,
                "course_path" : {
                    "type" : 0,
                    "wxa_appid" : "wxabcdes",
                    "wxa_path" : "path"
                }
            }
        }
    ]
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok"
}

# 错误码

错误码 错误描述
公共错误码 -
48001 无权调用本api,请检查相关权限是否已开通
47001 请求体格式不正确,请检查请求体中各个参数的类型是否正确
40097 请求体参数不正确,请检查各个参数是否按规范填写,具体原因请查看errmsg
100002 订单不存在
100003 订单更新过于频繁,更新订单失败,请重试
101100 当前订单状态不允许发货,请检查订单状态
108009 当前订单有未完成售后单,不允许发货
109000 发货失败,请检查 errmsg 中返回的商品是否正确填写,包括订单中是否包含该商品,该商品是否已经发货,是否已经完成售后无法发货,以及商品数量是否填写正确等
109001 当前订单已经发货完成,不能重复发货
109002 当前发货请求里没有带上发货商品,请检查product_infos和is_all_product是否按规范填写
109205 当前订单已经下单在线物流单,不允许自寄发货
606003 商家没有默认退货地址,不可发货,请设置默认退货地址后再进行发货
606004 delivery_id不合法,请使用【获取物流公司列表】接口获取合法的delivery_id
606005 waybill_id不合法,请检查快递单号是否正确填写
606008 deliver_type不符合要求,普通订单请使用快递发货,虚拟商品订单请无需物流发货,请检查订单deliver_method
606031 发货请求里product_id或sku_id填写不正确,请检查订单中是否包含该商品
606034 请前往平台服务-商品质检菜单,开通质检服务后走质检发货流程
606036 带有课程链接的包裹里只能包含一个sku
606037 该sku不是课程商品,不能填写课程信息
606038 课程链接appid或小程序地址为空
6060479 快递单号与物流公司提供的正则表达式不匹配
10020115 用户申请修改收货地址,请商家处理完毕之后再发货
606045 应平台管控要求,请使用【上传生鲜质检信息】接口上传商品打包信息

# 结构体

# DeliveryInfo

物流信息

参数 类型 是否必填 描述
delivery_id string 快递公司id,通过【获取快递公司列表】接口获得,非主流快递公司可以填OTHER,deliver_type=1时必填
waybill_id string 快递单号,deliver_type=1时必填
deliver_type number 发货方式,1:自寄快递发货,3:虚拟商品无需物流发货(只有deliver_method=1的订单可以使用虚拟发货)
product_infos array DeliveryProductInfo 包裹中的商品信息,结构体详情请参考DeliveryProductInfo
course_info object CourseInfo 课程相关信息,结构体详情请参考CourseInfo

# DeliveryProductInfo

包裹中的商品信息

参数 类型 是否必填 描述
product_id string 商品id
sku_id string 商品sku
product_cnt number 商品数量

# CourseInfo

课程相关信息

参数 类型 是否必填 描述
start_time number 课程开始时间,时间戳
end_time number 课程结束时间,时间戳
course_path object CoursePath 课程地址,结构体详情请参考CoursePath

# CoursePath

课程地址

参数 类型 是否必填 描述
type number 课程地址类型,0:小程序地址
wxa_appid string 小程序appid
wxa_path string 小程序地址