# 查询代发单详情

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

接口英文名：dropship_get

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

# 1. 调用方式

# HTTPS 调用

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

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代供货商调用。
该接口所属的权限集 id 为：192
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代供货商进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token（供货商）、authorizer_access_token（服务商）

# 请求体 `Request Payload`

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

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息
dropship_order	object	代发单结构

# Res.dropship_order `Object Payload`

代发单结构

参数名	类型	说明
ds_order_id	string	代发单号
create_time	number	秒级时间戳
update_time	number	秒级时间戳
status	number	代发单状态，具体枚举值请参考下文
shop_appid	string	商家appid
shop_name	string	商家名称
order_id	string	关联订单号
dropship_order_detail	object	代发单详情

# Res.dropship_order.dropship_order_detail `Object Payload`

代发单详情

参数名	类型	说明
product_infos	objarray	商品信息
delivery_info	object	发货信息
ext_info	object	扩展信息
greeting_card_info	object	需代写的商品贺卡信息
custom_info	object	商品定制信息

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

商品信息

参数名	类型	说明
product_id	string	商品spuid
sku_id	string	商品skuid
thumb_img	string	sku小图
sku_cnt	number	sku数量
title	string	商品标题
sku_code	string	商品编码
sku_attrs	objarray	sku属性/款式信息
out_product_id	string	商品外部spuid
out_sku_id	string	商品外部skuid
out_warehouse_id	string	区域库存id
sku_deliver_info	object	商品发货信息
delivery_deadline	number	商品发货时效，超时此时间未发货即为发货超时
is_free_gift	number	是否赠品，非必填，赠品商品返回，1:是赠品
product_unique_id	string	商品常量编号，订单内商品唯一标识，下单后不会发生变化，可用于判断商品是否更换款式
dropship_info	object	代发相关信息

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

sku属性/款式信息

参数名	类型	说明
attr_key	string	sku属性/款式类型
attr_value	string	属性/款式值

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

商品发货信息

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

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

代发相关信息

参数名	类型	说明
ds_order_id	string	代发单号
delivery_status	number	发货状态，枚举值请参考下文
aftersale_status	number	售后状态，0：无售后/售后被关闭；1：商品售后中，详情需联系商家；2：商品已售后完成(退货/退款完成)
cancel_time	number	取消时间，秒级时间戳
cancel_scene	number	取消原因，1：售后，2：商家取消代发
preshipment_change_sku_state	number	换货申请状态， 3：等待商家处理

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

发货信息

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

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

地址信息

参数名	类型	说明
user_name	string	收货人姓名
postal_code	string	邮编
province_name	string	省份
city_name	string	城市
county_name	string	区
detail_info	string	详细地址
tel_number	string	联系方式
house_number	string	门牌号码
virtual_order_tel_number	string	虚拟发货订单联系方式(deliver_method=1时返回)
tel_number_ext_info	object	额外的联系方式信息（虚拟号码相关
use_tel_number	number	0：不使用虚拟号码，1：使用虚拟号码
hash_code	string	标识当前店铺下一个唯一的用户收货地址

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

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

参数名	类型	说明
real_tel_number	string	脱敏手机号
virtual_tel_number	string	完整的虚拟号码
get_virtual_tel_cnt	number	主动兑换虚拟号码次数
virtual_tel_expire_time	number	主动兑换的虚拟号码过期时间

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

发货物流信息

参数名	类型	说明
waybill_id	string	快递单号
delivery_id	string	快递公司编码
product_infos	objarray	包裹中商品信息
delivery_name	string	快递公司名称
delivery_time	number	发货时间，秒级时间戳
deliver_type	number	配送方式，具体枚举值请参考下文
delivery_address	object	发货地址

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

包裹中商品信息

参数名	类型	说明
product_id	number	商品spuid
sku_id	number	商品skuid
product_cnt	number	商品数量

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

发货地址

参数名	类型	说明
user_name	string	收货人姓名
postal_code	string	邮编
province_name	string	省份
city_name	string	城市
county_name	string	区
detail_info	string	详细地址
national_code	string	国家码，已废弃，请勿使用
tel_number	string	联系方式
house_number	string	门牌号码
virtual_order_tel_number	string	虚拟发货订单联系方式(deliver_method=1时返回)
tel_number_ext_info	object	额外的联系方式信息（虚拟号码相关
use_tel_number	number	0：不使用虚拟号码，1：使用虚拟号码
hash_code	string	标识当前店铺下一个唯一的用户收货地址

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

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

参数名	类型	说明
real_tel_number	string	脱敏手机号
virtual_tel_number	string	完整的虚拟号码
get_virtual_tel_cnt	number	主动兑换虚拟号码次数
virtual_tel_expire_time	number	主动兑换的虚拟号码过期时间

# Res.dropship_order.dropship_order_detail.ext_info `Object Payload`

扩展信息

参数名	类型	说明
customer_notes	string	用户备注
merchant_notes	string	商家备注
present_notes	string	礼物备注

# Res.dropship_order.dropship_order_detail.greeting_card_info `Object Payload`

需代写的商品贺卡信息

参数名	类型	说明
giver_name	string	贺卡落款，用户选填
receiver_name	string	贺卡称谓，用户选填
greeting_message	string	贺卡内容，用户必填

# Res.dropship_order.dropship_order_detail.custom_info `Object Payload`

商品定制信息

参数名	类型	说明
custom_img_url	string	定制图片，custom_type=2时返回
custom_word	string	定制文字，custom_type=1时返回
custom_type	number	定制类型，枚举值请参考下文
custom_preview_img_url	string	定制预览图片，开启了定制预览时返回

# 4. 注意事项

full_payment_presale_delivery_type预售类型

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

custom_type定制类型

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

status代发单状态

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

delivery_status发货状态

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

# 5. 代码示例

请求示例

{
    "ds_order_id": "4429352113418018304"
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "dropship_order": {
        "ds_order_id": "4429352113418018304",
        "create_time": 1751959503,
        "update_time": 1751959503,
        "status": 300,
        "shop_appid": "wx2b255582a7b4bfd0",
        "shop_name": "开平电商小店",
        "order_id": "3729352105237033728",
        "dropship_order_detail": {
            "product_infos": [
                {
                    "product_id": "10000257699941",
                    "sku_id": "3721630902",
                    "thumb_img": "https://wst.wxapp.tc.qq.com/161/20304/snscosdownload/SZ/reserved/685e963600094a611c5fb5995391bb0b000000a000004f50",
                    "sku_cnt": 1,
                    "title": "i但是但是爬山的恐怕",
                    "sku_code": "",
                    "sku_deliver_info": {
                        "stock_type": 0
                    },
                    "delivery_deadline": 1752132283,
                    "dropship_info": {
                        "delivery_status": 30,
                        "aftersale_status": 0,
                        "cancel_time": 1751960709,
                        "cancel_scene": 2
                    }
                }
            ],
            "delivery_info": {
                "address_info": {
                    "user_name": "徐**",
                    "postal_code": "610041",
                    "province_name": "四川省",
                    "city_name": "成都市",
                    "county_name": "武侯区",
                    "detail_info": "****",
                    "national_code": "510107064",
                    "tel_number": "155****2519",
                    "house_number": "",
                    "virtual_order_tel_number": ""
                },
                "delivery_product_info": [

                ],
                "ship_done_time": 0,
                "deliver_method": 0
            },
            "ext_info": {
                "customer_notes": "测试",
                "merchant_notes": ""
            }
        }
    }
}

# 6. 错误码

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

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

# 7. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。

# 查询代发单详情

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.dropship_order Object Payload

# Res.dropship_order.dropship_order_detail Object Payload

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

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

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

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

# Res.dropship_order.dropship_order_detail.delivery_info Object Payload

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

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

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

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

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

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

# Res.dropship_order.dropship_order_detail.ext_info Object Payload

# Res.dropship_order.dropship_order_detail.greeting_card_info Object Payload

# Res.dropship_order.dropship_order_detail.custom_info Object Payload