taobao.fenxiao.dealer.requisitionorder.get (批量查询采购申请/经销采购单)

批量查询采购申请/经销采购单,目前支持供应商和分销商查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start_date Date 必须 2000-01-01 00:00:00 采购申请/经销采购单最早修改时间
end_date Date 必须 2000-01-21 00:00:00 采购申请/经销采购单最迟修改时间。与start_date字段的最大时间间隔不能超过30天
page_no Number 可选 1
  • 默认值:1
  • 页码(大于0的整数。无值或小于1的值按默认值1计)
    page_size Number 可选 50
  • 默认值:50
  • 每页条数(大于0但小于等于50的整数。无值或大于50或小于1的值按默认值50计)
    order_status Number 可选 1
  • 默认值:0
  • 采购申请/经销采购单状态。 0:全部状态。 1:分销商提交申请,待供应商审核。 2:供应商驳回申请,待分销商确认。 3:供应商修改后,待分销商确认。 4:分销商拒绝修改,待供应商再审核。 5:审核通过下单成功,待分销商付款。 7:付款成功,待供应商发货。 8:供应商发货,待分销商收货。 9:分销商收货,交易成功。 10:采购申请/经销采购单关闭。 注:无值按默认值0计,超出状态范围返回错误信息。
    identity Number 必须 1 查询者自己在所要查询的采购申请/经销采购单中的身份。 1:供应商。 2:分销商。 注:填写其他值当做错误处理。
    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
    • 13812345678
    • 移动电话
    • └ 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
    • 优惠
    • 属性键
    total_results Number 100 按查询条件查到的记录总数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    FenxiaoDealerRequisitionorderGetRequest req = new FenxiaoDealerRequisitionorderGetRequest();
    req.setStartDate(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndDate(StringUtils.parseDateTime("2000-01-21 00:00:00"));
    req.setPageNo(1L);
    req.setPageSize(50L);
    req.setOrderStatus(1L);
    req.setIdentity(1L);
    req.setFields("dealer_order_details.product_id");
    FenxiaoDealerRequisitionorderGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <fenxiao_dealer_requisitionorder_get_response>
        <dealer_orders>
            <dealer_order>
                <logistics_type>LOGISTICS</logistics_type>
                <quantity_count>1000</quantity_count>
                <receiver>
                    <zip>310000</zip>
                    <mobile_phone>13812345678</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>
        <total_results>100</total_results>
    </fenxiao_dealer_requisitionorder_get_response>

    异常示例

    • 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工具

    如何获得此API

    FAQ

    返回
    顶部