淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
dealer_order_ids	Number []	必须	123,124,125	最大列表长度：50	经销采购单编号。多个编号用英文符号的逗号隔开。最多支持50个经销采购单编号的查询。
fields	String	可选	dealer_order_details.product_id		多个字段用","分隔。 fields 如果为空：返回所有经销采购单对象(dealer_orders)字段。如果不为空：返回指定采购单对象(dealer_orders)字段。例1： dealer_order_details.product_id 表示只返回product_id 例2： dealer_order_details 表示只返回明细列表

名称	类型	示例值	描述
dealer_orders	DealerOrder []		经销采购单结果列表
└ logistics_type String LOGISTICS 物流方式：SELF_PICKUP（自提）、LOGISTICS（物流发货) └ quantity_count Number 1000 总采购数量 receiver Receiver 收货人信息 └ zip String 310000 邮政编码 └ mobile_phone String 1384567895 移动电话 └ phone String 57188155188 固定电话 └ address String 文一西路969号收货人的详细地址信息 └ name String zhangsan 收货人全名 └ state String 浙江省收货人所在省份 └ district String 余杭区区/县 └ card_id String 111112222233333444 证件号 └ city String 杭州市收货人的城市 └ logistics_fee String 200.07 物流费用(精确到2位小数;单位:元。如:200.07，表示:200元7分 ) └ rebate_fee String 200.07 折让费用(精确到2位小数;单位:元。如:200.07，表示:200元7分 ) └ modified_time Date 2000-01-01 00:00:00 修改时间 └ applied_time Date 2000-01-01 00:00:00 申请时间 └ audit_time_applier Date 2000-01-01 00:00:00 分销商最后一次确认/申请/拒绝的时间 └ total_price String 200.07 采购总价(精确到2位小数;单位:元。如:200.07，表示:200元7分 ) └ order_status String WAIT_FOR_APPLIER_AUDIT WAIT_FOR_SUPPLIER_AUDIT1：分销商提交申请，待供应商审核；SUPPLIER_REFUSE：供应商驳回申请，待分销商确认；WAIT_FOR_APPLIER_AUDIT：供应商修改后，待分销商确认；WAIT_FOR_SUPPLIER_AUDIT2：分销商拒绝修改，待供应商再审核；BOTH_AGREE_WAIT_PAY：审核通过下单成功，待分销商付款WAIT_FOR_SUPPLIER_DELIVER：付款成功，待供应商发货；WAIT_FOR_APPLIER_STORAGE：供应商发货，待分销商收货；TRADE_FINISHED：分销商收货，交易成功；TRADE_CLOSED：经销采购单关闭。 └ close_reason String 下单有误，关闭申请单。关闭原因 └ delivered_quantity_count Number 10000 已发货数量 └ pay_type String PREPAY 支付方式：ALIPAY_SURETY（支付宝担保交易）TRANSFER（线下转账）PREPAY（预存款）IMMEDIATELY（即时到账） └ supplier_nick String zhangsan 供应商nick └ dealer_order_id Number 123456 经销采购单编号，API发货使用此字段 └ refuse_reason_supplier String 采购价格偏低，予以驳回。供应商驳回申请的原因 └ refuse_reason_applier String 价格不合理。分销商拒绝供应商修改的原因 dealer_order_details DealerOrderDetail [] 产品明细 └ product_id Number 123456 产品id └ final_price String 200.07 最终价格(精确到2位小数;单位:元。如:200.07，表示:200元7分 ) └ sku_spec String 颜色：桔色，尺码：36(2尺8) 产品规格 └ original_price String 200.07 原始价格(精确到2位小数;单位:元。如:200.07，表示:200元7分 ) └ dealer_detail_id Number 234567 经销采购单明细id └ snapshot_url String http://gongxiao.tmall.com/product/product_snapshot.htm?subOrderId=123456 产品快照url └ is_deleted Boolean true 该条明细是否已删除。true：已删除；false：未删除。 └ product_title String 某某产品产品标题 └ price_count String 200.07 金额小计(采购数量乘以最终价格。精确到2位小数;单位:元。如:200.07，表示:200元7分 ) └ dealer_order_id Number 123456 经销采购单编号 └ quantity Number 100 采购数量 └ sku_id Number 234213 sku id └ sku_number String 商家编码1 商家编码，是sku则为sku的商家编码，否则是产品的商家编码 features Feature [] a:b;c:d 属性信息列表，key-value形式。如attr_key为storeCode，attr_value则为仓库编码。 └ attr_key String a 属性键 └ attr_value String b 属性值 └ applier_nick String wangwu 分销商nick └ audit_time_supplier Date 2000-01-01 00:00:00 供应商最后一次审核通过/修改/驳回的时间 └ alipay_no String 5588 支付宝交易号 └ pay_time Date 2000-01-01 00:00:00 付款时间 └ supplier_memo String 该单免邮供应商备注。仅供应商可见。 └ supplier_memo_flag Number 1 供应商备注旗帜。1:红色 2:黄色 3:绿色 4:蓝色 5:粉红色。仅供应商可见。 features Feature [] a:b;c:d 属性信息列表，key-value形式。 └ attr_key String a 属性键 └ attr_value String b 属性值 └ dist_memo String 分销商备注 distMemo

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoDealerRequisitionorderQueryRequest req = new FenxiaoDealerRequisitionorderQueryRequest();
req.setDealerOrderIds("123,124,125");
req.setFields("dealer_order_details.product_id");
FenxiaoDealerRequisitionorderQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

<fenxiao_dealer_requisitionorder_query_response>
    <dealer_orders>
        <dealer_order>
            <logistics_type>LOGISTICS</logistics_type>
            <quantity_count>1000</quantity_count>
            <receiver>
                <zip>310000</zip>
                <mobile_phone>1384567895</mobile_phone>
                <phone>57188155188</phone>
                <address>文一西路969号</address>
                <name>zhangsan</name>
                <state>浙江省</state>
                <district>余杭区</district>
                <card_id>111112222233333444</card_id>
                <city>杭州市</city>
            </receiver>
            <logistics_fee>200.07</logistics_fee>
            <rebate_fee>200.07</rebate_fee>
            <modified_time>2000-01-01 00:00:00</modified_time>
            <applied_time>2000-01-01 00:00:00</applied_time>
            <audit_time_applier>2000-01-01 00:00:00</audit_time_applier>
            <total_price>200.07</total_price>
            <order_status>WAIT_FOR_APPLIER_AUDIT</order_status>
            <close_reason>下单有误，关闭申请单。</close_reason>
            <delivered_quantity_count>10000</delivered_quantity_count>
            <pay_type>PREPAY</pay_type>
            <supplier_nick>zhangsan</supplier_nick>
            <dealer_order_id>123456</dealer_order_id>
            <refuse_reason_supplier>采购价格偏低，予以驳回。</refuse_reason_supplier>
            <refuse_reason_applier>价格不合理。</refuse_reason_applier>
            <dealer_order_details>
                <dealer_order_detail>
                    <product_id>123456</product_id>
                    <final_price>200.07</final_price>
                    <sku_spec>颜色：桔色，尺码：36(2尺8)</sku_spec>
                    <original_price>200.07</original_price>
                    <dealer_detail_id>234567</dealer_detail_id>
                    <snapshot_url>http://gongxiao.tmall.com/product/product_snapshot.htm?subOrderId=123456</snapshot_url>
                    <is_deleted>true</is_deleted>
                    <product_title>某某产品</product_title>
                    <price_count>200.07</price_count>
                    <dealer_order_id>123456</dealer_order_id>
                    <quantity>100</quantity>
                    <sku_id>234213</sku_id>
                    <sku_number>商家编码1</sku_number>
                    <features>
                        <feature>
                            <attr_key>a</attr_key>
                            <attr_value>b</attr_value>
                        </feature>
                    </features>
                </dealer_order_detail>
            </dealer_order_details>
            <applier_nick>wangwu</applier_nick>
            <audit_time_supplier>2000-01-01 00:00:00</audit_time_supplier>
            <alipay_no>5588</alipay_no>
            <pay_time>2000-01-01 00:00:00</pay_time>
            <supplier_memo>该单免邮</supplier_memo>
            <supplier_memo_flag>1</supplier_memo_flag>
            <features>
                <feature>
                    <attr_key>a</attr_key>
                    <attr_value>b</attr_value>
                </feature>
            </features>
            <dist_memo>分销商备注</dist_memo>
        </dealer_order>
    </dealer_orders>
</fenxiao_dealer_requisitionorder_query_response>

{
    "fenxiao_dealer_requisitionorder_query_response":{
        "dealer_orders":{
            "dealer_order":[
                {
                    "logistics_type":"LOGISTICS",
                    "quantity_count":1000,
                    "receiver":{
                        "zip":"310000",
                        "mobile_phone":"1384567895",
                        "phone":"57188155188",
                        "address":"文一西路969号",
                        "name":"zhangsan",
                        "state":"浙江省",
                        "district":"余杭区",
                        "card_id":"111112222233333444",
                        "city":"杭州市"
                    },
                    "logistics_fee":"200.07",
                    "rebate_fee":"200.07",
                    "modified_time":"2000-01-01 00:00:00",
                    "applied_time":"2000-01-01 00:00:00",
                    "audit_time_applier":"2000-01-01 00:00:00",
                    "total_price":"200.07",
                    "order_status":"WAIT_FOR_APPLIER_AUDIT",
                    "close_reason":"下单有误，关闭申请单。",
                    "delivered_quantity_count":10000,
                    "pay_type":"PREPAY",
                    "supplier_nick":"zhangsan",
                    "dealer_order_id":123456,
                    "refuse_reason_supplier":"采购价格偏低，予以驳回。",
                    "refuse_reason_applier":"价格不合理。",
                    "dealer_order_details":{
                        "dealer_order_detail":[
                            {
                                "product_id":123456,
                                "final_price":"200.07",
                                "sku_spec":"颜色：桔色，尺码：36(2尺8)",
                                "original_price":"200.07",
                                "dealer_detail_id":234567,
                                "snapshot_url":"http:\/\/gongxiao.tmall.com\/product\/product_snapshot.htm?subOrderId=123456",
                                "is_deleted":true,
                                "product_title":"某某产品",
                                "price_count":"200.07",
                                "dealer_order_id":123456,
                                "quantity":100,
                                "sku_id":234213,
                                "sku_number":"商家编码1",
                                "features":{
                                    "feature":[
                                        {
                                            "attr_key":"a",
                                            "attr_value":"b"
                                        }
                                    ]
                                }
                            }
                        ]
                    },
                    "applier_nick":"wangwu",
                    "audit_time_supplier":"2000-01-01 00:00:00",
                    "alipay_no":"5588",
                    "pay_time":"2000-01-01 00:00:00",
                    "supplier_memo":"该单免邮",
                    "supplier_memo_flag":1,
                    "features":{
                        "feature":[
                            {
                                "attr_key":"a",
                                "attr_value":"b"
                            }
                        ]
                    },
                    "dist_memo":"分销商备注"
                }
            ]
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

分销API

taobao.fenxiao.dealer.requisitionorder.query (按编号查询采购申请/经销采购单)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ