# 查询代发单详情

> 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。

接口英文名：dropship_get

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

## 1. 调用方式

### HTTPS 调用

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

### 云调用

- 本接口不支持云调用。

### 第三方调用

- 本接口支持第三方平台代微信小店商家调用。[第三方服务商调用模式介绍](/doc/store/shop/dev_before/third_party_platforms)

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

- 服务商获得其中之一权限集授权后，可通过使用 [authorizer_access_token](/doc/oplatform/developers/dev/AuthorizerAccessToken.md) 代微信小店商家进行调用，具体可查看 [第三方调用](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/call_interface.md) 说明文档。

## 2. 请求参数

### 查询参数 `Query String Parameters`

```json
[
  {
    "参数名": "access_token",
    "类型": "string",
    "必填": "是",
    "示例": "ACCESS_TOKEN",
    "说明": "接口调用凭证，可使用 [access_token](/doc/store/shop/API/apimgnt/common/api_getaccesstoken)（微信小店商家）、[authorizer_access_token](/doc/oplatform/openApi/ticket-token/api_getauthorizeraccesstoken.md)（服务商代调用）"
  }
]
```

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "ds_order_id",
    "类型": "string",
    "必填": "是",
    "说明": "代发单号"
  }
]
```

## 3. 返回参数

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "errcode",
    "类型": "number",
    "说明": "错误码"
  },
  {
    "参数名": "errmsg",
    "类型": "string",
    "说明": "错误描述"
  },
  {
    "参数名": "dropship_order",
    "类型": "object",
    "说明": "代发单结构"
  }
]
```

### Res.dropship_order `Object Payload`

代发单结构

```json
[
  {
    "参数名": "ds_order_id",
    "类型": "number",
    "说明": "代发单号",
    "枚举": "-"
  },
  {
    "参数名": "create_time",
    "类型": "number",
    "说明": "秒级时间戳",
    "枚举": "-"
  },
  {
    "参数名": "update_time",
    "类型": "number",
    "说明": "秒级时间戳",
    "枚举": "-"
  },
  {
    "参数名": "status",
    "类型": "number",
    "说明": "代发单状态",
    "枚举": "枚举值"
  },
  {
    "参数名": "supplier_appid",
    "类型": "string",
    "说明": "供货商appid",
    "枚举": "-"
  },
  {
    "参数名": "supplier_name",
    "类型": "string",
    "说明": "供货商名称",
    "枚举": "-"
  },
  {
    "参数名": "order_id",
    "类型": "number",
    "说明": "关联订单号",
    "枚举": "-"
  },
  {
    "参数名": "dropship_order_detail",
    "类型": "object",
    "说明": "代发单详情",
    "枚举": "-"
  }
]
```

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

代发单详情

```json
[
  {
    "参数名": "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`

商品信息

```json
[
  {
    "参数名": "product_id",
    "类型": "number",
    "说明": "商品spuid"
  },
  {
    "参数名": "sku_id",
    "类型": "number",
    "说明": "商品skuid"
  },
  {
    "参数名": "thumb_img",
    "类型": "string",
    "说明": "sku小图"
  },
  {
    "参数名": "sku_cnt",
    "类型": "number",
    "说明": "sku数量"
  },
  {
    "参数名": "title",
    "类型": "string",
    "说明": "商品标题"
  },
  {
    "参数名": "sku_code",
    "类型": "string",
    "说明": "商品编码"
  },
  {
    "参数名": "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",
    "说明": "代发相关信息"
  }
]
```

__sku_deliver_info">

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

商品发货信息

```json
[
  {
    "参数名": "stock_type",
    "类型": "number",
    "说明": "商品发货类型：0：现货，1：全款预售",
    "枚举": "-"
  },
  {
    "参数名": "predict_delivery_time",
    "类型": "number",
    "说明": "预计发货时间(stock_type=1时返回该字段)",
    "枚举": "-"
  },
  {
    "参数名": "full_payment_presale_delivery_type",
    "类型": "number",
    "说明": "预售类型(stock_type=1时返回该字段)",
    "枚举": "枚举值"
  }
]
```

__dropship_info">

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

代发相关信息

```json
[
  {
    "参数名": "ds_order_id",
    "类型": "number",
    "说明": "代发单号",
    "枚举": "-"
  },
  {
    "参数名": "delivery_status",
    "类型": "number",
    "说明": "发货状态",
    "枚举": "枚举值"
  },
  {
    "参数名": "aftersale_status",
    "类型": "number",
    "说明": "售后状态，1：售后中",
    "枚举": "-"
  },
  {
    "参数名": "cancel_time",
    "类型": "number",
    "说明": "取消时间，秒级时间戳",
    "枚举": "-"
  },
  {
    "参数名": "cancel_scene",
    "类型": "number",
    "说明": "取消原因，1：售后，2：商家取消代发",
    "枚举": "-"
  },
  {
    "参数名": "preshipment_change_sku_state",
    "类型": "number",
    "说明": "换货申请状态， 3：等待商家处理",
    "枚举": "-"
  }
]
```

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

发货信息

```json
[
  {
    "参数名": "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`

地址信息

```json
[
  {
    "参数名": "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.address_info.tel_number_ext_info `Object Payload`

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

```json
[
  {
    "参数名": "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`

发货物流信息

```json
[
  {
    "参数名": "waybill_id",
    "类型": "string",
    "说明": "快递单号"
  },
  {
    "参数名": "delivery_id",
    "类型": "string",
    "说明": "快递公司编码"
  },
  {
    "参数名": "product_infos",
    "类型": "objarray",
    "说明": "包裹中商品信息"
  },
  {
    "参数名": "delivery_name",
    "类型": "string",
    "说明": "快递公司名称"
  },
  {
    "参数名": "delivery_time",
    "类型": "number",
    "说明": "发货时间，秒级时间戳"
  },
  {
    "参数名": "deliver_type",
    "类型": "number",
    "说明": "配送方式"
  },
  {
    "参数名": "delivery_address",
    "类型": "object",
    "说明": "发货地址"
  }
]
```

__product_infos">

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

包裹中商品信息

```json
[
  {
    "参数名": "product_id",
    "类型": "number",
    "说明": "商品spuid"
  },
  {
    "参数名": "sku_id",
    "类型": "number",
    "说明": "商品skuid"
  },
  {
    "参数名": "product_cnt",
    "类型": "number",
    "说明": "商品数量"
  }
]
```

__delivery_address">

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

发货地址

```json
[
  {
    "参数名": "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",
    "说明": "标识当前店铺下一个唯一的用户收货地址"
  }
]
```

__delivery_address__tel_number_ext_info">

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

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

```json
[
  {
    "参数名": "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`

扩展信息

```json
[
  {
    "参数名": "customer_notes",
    "类型": "string",
    "说明": "用户备注"
  },
  {
    "参数名": "merchant_notes",
    "类型": "string",
    "说明": "商家备注"
  },
  {
    "参数名": "present_notes",
    "类型": "string",
    "说明": "礼物备注"
  }
]
```

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

需代写的商品贺卡信息

```json
[
  {
    "参数名": "giver_name",
    "类型": "string",
    "说明": "贺卡落款，用户选填"
  },
  {
    "参数名": "receiver_name",
    "类型": "string",
    "说明": "贺卡称谓，用户选填"
  },
  {
    "参数名": "greeting_message",
    "类型": "string",
    "说明": "贺卡内容，用户必填"
  }
]
```

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

商品定制信息

```json
[
  {
    "参数名": "custom_img_url",
    "类型": "string",
    "说明": "定制图片，custom_type=2时返回",
    "枚举": "-"
  },
  {
    "参数名": "custom_word",
    "类型": "string",
    "说明": "定制文字，custom_type=1时返回",
    "枚举": "-"
  },
  {
    "参数名": "custom_type",
    "类型": "number",
    "说明": "定制类型",
    "枚举": "枚举值"
  },
  {
    "参数名": "custom_preview_img_url",
    "类型": "string",
    "说明": "定制预览图片，开启了定制预览时返回",
    "枚举": "-"
  }
]
```

## 4. 枚举信息

### Res.dropship_order.status `Enum`

代发单状态

```json
[
  {
    "枚举值": "100",
    "描述": "待发货"
  },
  {
    "枚举值": "199",
    "描述": "部分发货"
  },
  {
    "枚举值": "200",
    "描述": "已发货"
  },
  {
    "枚举值": "300",
    "描述": "已取消"
  }
]
```

__sku_deliver_info__full_payment_presale_delivery_type">

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

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

```json
[
  {
    "枚举值": "0",
    "描述": "付款后n天发货"
  },
  {
    "枚举值": "1",
    "描述": "预售结束后n天发货"
  }
]
```

__dropship_info__delivery_status">

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

发货状态

```json
[
  {
    "枚举值": "10",
    "描述": "待发货"
  },
  {
    "枚举值": "19",
    "描述": "部分发货"
  },
  {
    "枚举值": "20",
    "描述": "已发货"
  },
  {
    "枚举值": "30",
    "描述": "已取消"
  }
]
```

### Res.dropship_order.dropship_order_detail.custom_info.custom_type `Enum`

定制类型

```json
[
  {
    "枚举值": "1",
    "描述": "文字定制"
  },
  {
    "枚举值": "2",
    "描述": "图片定制"
  }
]
```

## 5. 注意事项

本接口无特殊注意事项

## 6. 代码示例

请求示例

```json
{
    "ds_order_id": "44012940902395351",
}
```

返回示例

```json
{
    "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. 错误码

以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/store/shop/dev_before/commErrCode)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。

```json
[
  {
    "错误码": "610011",
    "错误描述": "代发单不存在"
  }
]
```

## 8. 适用范围

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

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（1条）
2026 年 01 月 29 日补充代发单发货状态枚举