订单发货 | 微信开放文档

# 订单发货

# 接口说明

可通过该接口对订单发货

# 注意事项

已经完成售后的商品不能进行发货，虚拟商品必须整单发货。

# 接口调用请求说明

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	应平台管控要求，请使用【上传生鲜质检信息】接口上传商品打包信息
606046	请使用电子面单发货
606048	核销信息有误，小程序appid或path为空
606049	当前订单存在风险，具体风险提示请查看errmsg
606051	虚拟商品必须整单发货
10020276	存在发货前更换sku请求，请商家处理后再发货

# 结构体

# 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	是	小程序地址