视频号
  • 中文
  • EN
取消
中文
  • 中文
  • EN
中文
EN
取消
  • 介绍

    • # 订单发货

    # 接口说明

    可通过该接口对订单发货

    # 注意事项

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

    # 接口调用请求说明

    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 用户申请修改收货地址，请商家处理完毕之后再发货

    # 结构体

    # 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 是 小程序地址
    技术咨询