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

    • # 查询代发单详情

    调试诊断

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

    接口英文名：dropship_get

    该接口用于查询代发单详情

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口支持第三方平台代微信小店商家调用。

    • 该接口所属的权限集 id 为：131

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

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

    # 请求体 Request Payload

    参数名类型必填说明
    ds_order_idstring是代发单号

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误描述
    dropship_orderobject代发单结构

    # Res.dropship_order Object Payload

    代发单结构

    参数名类型说明枚举
    ds_order_idnumber代发单号-
    create_timenumber秒级时间戳-
    update_timenumber秒级时间戳-
    statusnumber代发单状态枚举值
    supplier_appidstring供货商appid-
    supplier_namestring供货商名称-
    order_idnumber关联订单号-
    dropship_order_detailobject代发单详情-

    # Res.dropship_order.dropship_order_detail Object Payload

    代发单详情

    参数名类型说明
    product_infosobjarray商品信息
    delivery_infoobject发货信息
    ext_infoobject扩展信息
    greeting_card_infoobject需代写的商品贺卡信息
    custom_infoobject商品定制信息

    # Res.dropship_order.dropship_order_detail.product_infos(Array) Object Payload

    商品信息

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

    # Res.dropship_order.dropship_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.dropship_order.dropship_order_detail.product_infos(Array).dropship_info Object Payload

    代发相关信息

    参数名类型说明枚举
    ds_order_idnumber代发单号-
    delivery_statusnumber发货状态枚举值
    aftersale_statusnumber售后状态，1：售后中-
    cancel_timenumber取消时间，秒级时间戳-
    cancel_scenenumber取消原因，1：售后，2：商家取消代发-
    preshipment_change_sku_statenumber换货申请状态， 3：等待商家处理-

    # Res.dropship_order.dropship_order_detail.delivery_info Object Payload

    发货信息

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

    # Res.dropship_order.dropship_order_detail.delivery_info.address_info Object Payload

    地址信息

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

    # Res.dropship_order.dropship_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.dropship_order.dropship_order_detail.delivery_info.delivery_product_info(Array) Object Payload

    发货物流信息

    参数名类型说明
    waybill_idstring快递单号
    delivery_idstring快递公司编码
    product_infosobjarray包裹中商品信息
    delivery_namestring快递公司名称
    delivery_timenumber发货时间，秒级时间戳
    deliver_typenumber配送方式
    delivery_addressobject发货地址

    # Res.dropship_order.dropship_order_detail.delivery_info.delivery_product_info(Array).product_infosObject Payload

    包裹中商品信息

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

    # Res.dropship_order.dropship_order_detail.delivery_info.delivery_product_info(Array).delivery_address Object Payload

    发货地址

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

    # Res.dropship_order.dropship_order_detail.delivery_info.delivery_product_info(Array).delivery_address.tel_number_ext_info Object Payload

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

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

    # Res.dropship_order.dropship_order_detail.ext_info Object Payload

    扩展信息

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

    # Res.dropship_order.dropship_order_detail.greeting_card_info Object Payload

    需代写的商品贺卡信息

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

    # Res.dropship_order.dropship_order_detail.custom_info Object Payload

    商品定制信息

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

    # 4. 枚举信息

    # Res.dropship_order.status Enum

    代发单状态

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

    # Res.dropship_order.dropship_order_detail.product_infos(Array).sku_deliver_info.full_payment_presale_delivery_type Enum

    预售类型(stock_type=1时返回该字段)

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

    # Res.dropship_order.dropship_order_detail.product_infos(Array).dropship_info.delivery_status Enum

    发货状态

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

    # Res.dropship_order.dropship_order_detail.custom_info.custom_type Enum

    定制类型

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

    # 5. 注意事项

    本接口无特殊注意事项

    # 6. 代码示例

    请求示例

    {
    "ds_order_id": "44012940902395351",
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok",
    "dropship_order": {
        "ds_order_id": 0,
        "create_time": 0,
        "update_time": 0,
        "status": 0,
        "supplier_appid": "",
        "supplier_name": "",
        "shop_appid": "",
        "shop_name": "",
        "order_id": 0,
        "dropship_order_detail": {
            "product_infos": {
                "product_id": 0,
                "sku_id": 0,
                "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": {
                    "seven_day_return": 0,
                    "freight_insurance": 0
                },
                "use_deduction": false,
                "deduction_price": 0,
                "voucher_list": {
                    "voucher_code": "",
                    "sku_id": 0,
                    "time_index": 0,
                    "voucher_type": 0,
                    "voucher_buy_amount": 0
                },
                "order_product_coupon_info_list": {
                    "user_coupon_id": "",
                    "coupon_type": 0,
                    "discounted_price": 0,
                    "coupon_id": ""
                },
                "voucher_product_type": 0,
                "package_sku_list": {
                    "sku_id": 0,
                    "product_id": 0,
                    "pack_num": 0,
                    "sale_price": 0,
                    "real_price": 0
                },
                "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": {
                    "preshipment_change_sku_state": 0,
                    "old_sku_id": 0,
                    "new_sku_id": 0,
                    "ddl_time_stamp": 0
                },
                "free_gift_info": {
                    "main_product_list": {
                        "gift_cnt": 0,
                        "task_id": 0,
                        "product_id": 0,
                        "sku_id": 0
                    }
                },
                "bulkbuy_discounted_price": 0,
                "national_subsidy_discounted_price": 0,
                "dropship_info": {
                    "ds_order_id": 0,
                    "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": {
                    "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": ""
                },
                "address_apply_time": 0,
                "recharge_info": {
                    "account_no": "",
                    "account_type": "",
                    "wx_openid": "",
                    "related_node_list": {
                        "level": 0,
                        "node_id": "",
                        "node_name": ""
                    },
                    "platform_type": 0,
                    "query_account_type": 0,
                    "query_acount_no": "",
                    "nick_name": ""
                },
                "ewaybill_order_code": "",
                "quality_inspect_type": 0,
                "quality_inspect_info": {
                    "inspect_status": 0
                },
                "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": ""
            }
        }
    }
}

    # 7. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

    错误码错误描述解决方案
    610011代发单不存在

    # 8. 适用范围

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