微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 查询供货单详情

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

    接口英文名：supplyorder_get

    该接口用于查询供货单详情

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 本接口不支持云调用。

    # 第三方调用

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

    # 请求体 Request Payload

    参数名类型必填说明
    supply_order_idstring是供货单号

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    supply_orderobject供货单结构

    # Res.supply_order Object Payload

    供货单结构

    参数名类型说明
    supply_order_idstring供货单号
    create_timenumber秒级时间戳
    update_timenumber秒级时间戳
    statusnumber供货单状态，具体枚举值请参考下文
    supplier_appidstring供货商appid
    supplier_namestring供货商名称
    order_idstring订单号
    supply_order_detailobject供货单详情

    # Res.supply_order.supply_order_detail Object Payload

    供货单详情

    参数名类型说明
    product_infosobjarray商品信息
    price_infoobjarray价格信息
    delivery_infoobject发货信息
    ext_infoobject扩展信息
    greeting_card_infoobject需代写的商品贺卡信息
    custom_infoobject商品定制信息
    freightnumber运费
    after_sale_ordersobjarray售后信息

    # Res.supply_order.supply_order_detail.product_infos(Array) Object Payload

    商品信息

    参数名类型说明
    product_idstring商品spuid
    sku_idstring商品skuid
    thumb_imgstringsku小图
    sku_cntnumbersku数量
    titlestring商品标题
    sku_codestring商品编码
    sku_attrsobjarraysku属性/款式信息
    out_product_idstring商品外部spuid
    out_sku_idstring商品外部skuid
    out_warehouse_idstring区域库存id
    sku_deliver_infoobject商品发货信息
    delivery_deadlinenumber商品发货时效，超时此时间未发货即为发货超时
    is_free_giftnumber是否赠品，非必填，赠品商品返回，1:是赠品
    product_unique_idstring商品常量编号，订单内商品唯一标识，下单后不会发生变化，可用于判断货品是否更换款式
    supply_order_product_infoobject供货信息

    # Res.supply_order.supply_order_detail.product_infos(Array).sku_attrsObject Payload

    sku属性/款式信息

    参数名类型说明
    attr_keystringsku属性/款式类型
    attr_valuestring属性/款式值

    # Res.supply_order.supply_order_detail.product_infos(Array).sku_deliver_info Object Payload

    商品发货信息

    参数名类型说明
    stock_typenumber商品发货类型：0：现货，1：全款预售
    predict_delivery_timenumber预计发货时间(stock_type=1时返回该字段)
    full_payment_presale_delivery_typenumber预售类型(stock_type=1时返回该字段)，枚举值请参考下文

    # Res.supply_order.supply_order_detail.product_infos(Array).supply_order_product_info Object Payload

    供货信息

    参数名类型说明
    supply_order_idstring供货单单号
    delivery_statusnumber发货状态
    aftersale_statusnumber售后状态
    cancel_timenumber取消时间
    cancel_scenenumber取消场景
    preshipment_change_sku_statenumber换sku

    # Res.supply_order.supply_order_detail.price_info(Array) Object Payload

    价格信息

    参数名类型说明
    total_pricenumber供货单总价（商品售价 X 商品数量 + 运费）

    # Res.supply_order.supply_order_detail.delivery_info Object Payload

    发货信息

    参数名类型说明
    address_infoobject地址信息
    delivery_product_infoobjarray发货物流信息
    ship_done_timenumber发货完成时间，秒级时间戳
    deliver_methodnumber订单发货方式，0：普通快递物流，由货品的同名字段决定

    # Res.supply_order.supply_order_detail.delivery_info.address_info Object Payload

    地址信息

    参数名类型说明
    user_namestring收货人姓名
    postal_codestring邮编
    province_namestring省份
    city_namestring城市
    county_namestring区
    detail_infostring详细地址
    tel_numberstring联系方式
    house_numberstring门牌号码
    virtual_order_tel_numberstring虚拟发货订单联系方式(deliver_method=1时返回)
    tel_number_ext_infoobject额外的联系方式信息（虚拟号码相关）
    use_tel_numbernumber0：不使用虚拟号码，1：使用虚拟号码
    hash_codestring标识当前店铺下一个唯一的用户收货地址

    # Res.supply_order.supply_order_detail.delivery_info.address_info.tel_number_ext_info Object Payload

    额外的联系方式信息（虚拟号码相关）

    参数名类型说明
    real_tel_numberstring脱敏手机号
    virtual_tel_numberstring完整的虚拟号码
    get_virtual_tel_cntnumber主动兑换虚拟号码次数
    virtual_tel_expire_timenumber主动兑换的虚拟号码过期时间

    # Res.supply_order.supply_order_detail.delivery_info.delivery_product_info(Array) Object Payload

    发货物流信息

    参数名类型说明
    waybill_idstring快递单号
    delivery_idstring快递公司编码
    product_infosobjarray包裹中商品信息
    delivery_namestring快递公司名称
    delivery_timenumber发货时间，秒级时间戳
    deliver_typenumber配送方式，具体枚举值请参考下文

    # Res.supply_order.supply_order_detail.delivery_info.delivery_product_info(Array).product_infosObject Payload

    包裹中商品信息

    参数名类型说明
    product_idnumber商品spuid
    sku_idnumber商品skuid
    product_cntnumber商品数量

    # Res.supply_order.supply_order_detail.ext_info Object Payload

    扩展信息

    参数名类型说明
    customer_notesstring用户备注
    merchant_notesstring商家备注
    present_notesstring礼物备注

    # Res.supply_order.supply_order_detail.greeting_card_info Object Payload

    需代写的商品贺卡信息

    参数名类型说明
    giver_namestring贺卡落款，用户选填
    receiver_namestring贺卡称谓，用户选填
    greeting_messagestring贺卡内容，用户必填

    # Res.supply_order.supply_order_detail.custom_info Object Payload

    商品定制信息

    参数名类型说明
    custom_img_urlstring定制图片，custom_type=2时返回
    custom_wordstring定制文字，custom_type=1时返回
    custom_typenumber定制类型，枚举值请参考下文
    custom_preview_img_urlstring定制预览图片，开启了定制预览时返回

    # Res.supply_order.supply_order_detail.after_sale_orders(Array) Object Payload

    售后信息

    参数名类型说明
    aftersale_order_idstring售后单号
    statusnumber售后状态

    # 4. 注意事项

    full_payment_presale_delivery_type预售类型

    枚举值 描述
    0 付款后n天发货
    1 预售结束后n天发货

    custom_type定制类型

    枚举值 描述
    1 文字定制
    2 图片定制

    status供货单状态

    枚举值 描述
    100 待发货
    199 部分发货
    200 已发货
    300 已取消
    400 已完成

    delivery_status发货状态

    枚举值 描述
    10 待发货
    19 部分发货
    20 已发货
    30 已取消

    cancel_scene取消场景

    枚举值 描述
    1 用户售后
    2 平台砍单

    # 5. 代码示例

    请求示例

    {
    "supply_order_id": ""
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "",
    "supply_order": {
        "supply_order_id": "",
        "create_time": 0,
        "update_time": 0,
        "status": 0,
        "supplier_appid": "",
        "supplier_name": "",
        "shop_appid": "",
        "shop_name": "",
        "order_id": "",
        "supply_order_detail": {
            "product_infos": [
                {
                    "product_id": "",
                    "sku_id": "",
                    "thumb_img": "",
                    "sale_price": 0,
                    "sku_cnt": 0,
                    "title": "",
                    "on_aftersale_sku_cnt": 0,
                    "finish_aftersale_sku_cnt": 0,
                    "sku_code": "",
                    "market_price": 0,
                    "sku_attrs": [
                        {
                            "attr_key": "",
                            "attr_value": ""
                        }
                    ],
                    "real_price": 0,
                    "out_product_id": "",
                    "out_sku_id": "",
                    "is_discounted": false,
                    "estimate_price": 0,
                    "is_change_price": false,
                    "change_price": 0,
                    "out_warehouse_id": "",
                    "sku_deliver_info": {
                        "stock_type": 0,
                        "predict_delivery_time": 0,
                        "full_payment_presale_delivery_type": 0
                    },
                    "extra_service": {},
                    "use_deduction": false,
                    "deduction_price": 0,
                    "voucher_list": [
                        {}
                    ],
                    "order_product_coupon_info_list": [
                        {}
                    ],
                    "voucher_product_type": 0,
                    "package_sku_list": [
                        {}
                    ],
                    "delivery_deadline": 0,
                    "merchant_discounted_price": 0,
                    "platform_discounted_price": 0,
                    "finder_discounted_price": 0,
                    "is_free_gift": 0,
                    "vip_discounted_price": 0,
                    "product_unique_id": "",
                    "change_sku_info": {},
                    "free_gift_info": {},
                    "bulkbuy_discounted_price": 0,
                    "national_subsidy_discounted_price": 0,
                    "supply_order_product_info": {
                        "supply_order_id": "",
                        "delivery_status": 0,
                        "aftersale_status": 0,
                        "cancel_time": 0,
                        "cancel_scene": 0,
                        "preshipment_change_sku_state": 0
                    }
                }
            ],
            "delivery_info": {
                "address_info": {
                    "user_name": "",
                    "postal_code": "",
                    "province_name": "",
                    "city_name": "",
                    "county_name": "",
                    "detail_info": "",
                    "national_code": "",
                    "tel_number": "",
                    "house_number": "",
                    "virtual_order_tel_number": "",
                    "tel_number_ext_info": {
                        "real_tel_number": "",
                        "virtual_tel_number": "",
                        "get_virtual_tel_cnt": 0,
                        "virtual_tel_expire_time": 0,
                        "has_delay_times": 0
                    },
                    "use_tel_number": 0,
                    "hash_code": ""
                },
                "delivery_product_info": [
                    {
                        "waybill_id": "",
                        "delivery_id": "",
                        "product_infos": [
                            {
                                "product_id": 0,
                                "sku_id": 0,
                                "product_cnt": 0
                            }
                        ],
                        "delivery_name": "",
                        "delivery_time": 0,
                        "deliver_type": 0,
                        "delivery_address": {
                            "user_name": "",
                            "postal_code": "",
                            "province_name": "",
                            "city_name": "",
                            "county_name": "",
                            "detail_info": "",
                            "national_code": "",
                            "tel_number": "",
                            "house_number": "",
                            "virtual_order_tel_number": "",
                            "tel_number_ext_info": {
                                "real_tel_number": "",
                                "virtual_tel_number": "",
                                "get_virtual_tel_cnt": 0,
                                "virtual_tel_expire_time": 0,
                                "has_delay_times": 0
                            },
                            "use_tel_number": 0,
                            "hash_code": ""
                        }
                    }
                ],
                "ship_done_time": 0,
                "deliver_method": 0,
                "address_under_review": {},
                "address_apply_time": 0,
                "recharge_info": {},
                "ewaybill_order_code": "",
                "quality_inspect_type": 0,
                "quality_inspect_info": {},
                "dropship_flag": 0
            },
            "ext_info": {
                "customer_notes": "",
                "merchant_notes": "",
                "confirm_receipt_time": 0,
                "finder_id": "",
                "live_id": "",
                "order_scene": 0,
                "vip_order_session_id": "",
                "commission_handling_progress": 0,
                "present_notes": ""
            },
            "greeting_card_info": {
                "giver_name": "",
                "receiver_name": "",
                "greeting_message": ""
            },
            "custom_info": {
                "custom_img_url": "",
                "custom_word": "",
                "custom_type": 0,
                "custom_preview_img_url": ""
            },
            "freight": 0,
            "after_sale_orders": [
                {
                    "aftersale_order_id": "",
                    "status": 0
                }
            ]
        }
    }
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述
    610011供货单不存在

    # 7. 适用范围

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