淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
status	String	可选	WAIT_BUYER_PAY		交易状态，不传默认查询所有采购单根据用户角色选择自身状态可选值: * 供应商： WAIT_SELLER_SEND_GOODS(等待发货) WAIT_SELLER_CONFIRM_PAY(待确认收款) WAIT_BUYER_PAY(等待付款) WAIT_BUYER_CONFIRM_GOODS(已发货) TRADE_REFUNDING(退款中) TRADE_FINISHED(采购成功) TRADE_CLOSED(已关闭) * 分销商： WAIT_BUYER_PAY(等待付款) WAIT_BUYER_CONFIRM_GOODS(待收货确认) TRADE_FOR_PAY(已付款) TRADE_REFUNDING(退款中) TRADE_FINISHED(采购成功) TRADE_CLOSED(已关闭)
start_created	Date	可选	2000-01-01 00:00:00		起始时间，格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。若不传时分秒，默认为0时0分0秒。当指定了purchase_order_id或者tc_order_id时，此值可选，否则此参数必传。结束时间和开始时间的时间间隔不能超过7天，精确到秒。
end_created	Date	可选	2000-01-01 23:59:59		结束时间，格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。若不传时分秒，默认为0时0分0秒。当指定了purchase_order_id或者tc_order_id时，此值可选，否则此参数必传。结束时间和开始时间的时间间隔不能超过7天，精确到秒。
time_type	String	可选	trade_time_type		时间类型： trade_time_type(默认类型，按照采购单创建时间范围查询，推荐按照此时间类型查询) update_time_type(采购单按照更新时间范围查询)
purchase_order_id	Number	可选	44926651888684		采购单编号或分销流水号。当指定此参数后，其他可选参数可以为空
page_no	Number	可选	1		页码。（大于0的整数。默认为1）
page_size	Number	可选	10		每页条数。（每页条数不超过50条）
fields	String	可选	sub_purchase_orders.tc_order_id		指定返回的字段（废弃该参数）多个字段用","分隔。 fields 如果为空：返回所有采购单对象(purchase_orders)字段。如果不为空：返回指定采购单对象(purchase_orders)字段。例1： sub_purchase_orders.tc_order_id 表示只返回tc_order_id 例2： sub_purchase_orders表示只返回子采购单列表
tc_order_id	Number	可选	157026218599994214		消费者交易单号（采购单下游买家订单id）。当在代销、寄售交易中，此单号存在。
channel_codes	Number []	可选	200002	最大列表长度：999	渠道市场编码，可批量指定。当不指定时，按照配置的分销市场生效渠道编码枚举：1-供销平台（淘宝）；2-供销平台（天猫）；3-供销平台（天猫超市）；5-供销平台（淘乡甜）；110001-供销平台（全球购）；110007-淘分销；200002-消费电子市场
user_role_type	Number	可选	1		当前查询用户的角色当不指定时，默认为供应商供应商：2，分销商：1
trade_types	Number []	可选	1	最大列表长度：999	查询的经营模式，当不指定时，默认查询代销订单代销：1 经销：2 寄售（自营寄售）：5 平台寄售：6

名称	类型	示例值	描述
total_results	Number	9999	查询到的采购单记录总数
purchase_orders	TopDpOrderDo []		采购单及子采购单信息。返回 PurchaseOrder 包含的字段信息。
└ tc_order_id Number 157026218599994214 消费者主订单ID （经销模式下，不存在该单号） └ supplier_from String values: taobao 供应商来源网站。入驻时定义供应商来源的外部系统编码, values: taobao, alibaba └ supplier_username String zhangsan 供应商昵称（在来源网站的帐号名） └ distributor_from String taobao 建议废弃：分销商来源网站。入驻时定义分销商来源的外部系统编码, 目前固定值: taobao └ distributor_username String zhangsan 分销商昵称（在来源网站的帐号名）。 └ buyer_taobao_id String F21121542129F21121542129F2112154 加密后的消费者淘宝ID，长度为32 └ buyer_nick String zhangsan 消费者（买家）nick，供应商查询不会返回买家昵称，分销商查询才会返回。 └ trade_type String AGENT 交易模式（分销方式）：AGENT（代销）、DEALER（经销）、INSTEAD_SALE（代售）、CONSIGNMENT（自营寄售）、PLATFORM_CONSIGNMENT（平台寄售） └ created Date 2000-01-01 00:00:00 采购单创建时间。格式:yyyy-MM-dd HH:mm:ss └ id Number 555 废弃：如果是担保交易此值是TP800的交易单号，其他情况是采购单单号 └ fenxiao_id Number 1001 分销采购单号（分销流水号） └ memo String 留言。采购单留言，默认是分销商留言。在代销模式下信息包括消费者（买家）留言和分销商留言信息 └ supplier_memo String 供应商信息描述供应商备注信息。只有供应商身份查询输出此新信息 └ supplier_flag Number 1 供应商备注旗帜vlaue在1-5之间。非1-5之间，都采用1作为默认。 1:红色 2:黄色 3:绿色 4:蓝色 5:粉红色供应商角色查询返回 └ alipay_no String 200010507220088888888449086137 支付宝交易号，在分销商使用担保交易支付时存在。来源主订单的payOrderId。 └ total_fee String 200.07 应付采购单总额（不含邮费,精确到2位小数;单位:元。如:200.07，表示:200元7分 ) 计算公式： SUM(子单采购价 * 子单采购数量 - 子单折扣）+ 主单调整金额 - 主单折扣 └ post_fee String 200.07 采购单邮费。(改价后最新邮费，精确到2位小数;单位:元。如:8.07，表示:8元7分 ) └ distributor_payment String 200.07 分销商实付金额。(精确到2位小数;单位:元。如:208.14，表示:208元1角4分 ) └ buyer_payment String 200.07 消费者（买家）支付给分销商的主单的实际总金额。注意买家购买的商品可能不是全部来自同一供货商，所以此金额不代表供应商销售商品消费者的实付款。请同时参考子单上的相关金额。（精确到2位小数;单位:元。如:200.07，表示:200元7分） └ snapshot_url String www.vancl.com 交易订单快照URL（该字段废弃） └ status String TRADE_FINISHED(交易成功) 采购单交易状态，耦合了退款状态，废弃。可选值： WAIT_BUYER_PAY(等待付款) WAIT_SELLER_SEND_GOODS(已付款，待发货） WAIT_BUYER_CONFIRM_GOODS(已付款，已发货) PAID_FORBID_CONSIGN(已付款，禁止发货 ps:架海金梁erpHold单场景) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) WAIT_BUYER_CONFIRM_GOODS_ACOUNTED(已付款（已分账），已发货。只对代销分账支持) PAY_ACOUNTED_GOODS_CONFIRM （已分账发货成功） PAY_WAIT_ACOUNT_GOODS_CONFIRM（已付款，确认收货） TRADE_REFUNDING(退款中) TRADE_REFUNDED(退款结束) └ pay_time Date 2000-01-01 00:00:00 采购单付款时间。格式:yyyy-MM-dd HH:mm:ss └ end_time Date 2000-01-01 00:00:00 交易结束时间。如果交易成功此时间表示交易成功时间，如果交易关闭，此时间表示交易关闭时间。 └ consign_time Date 2000-01-01 00:00:00 采购单物流发货时间。格式:yyyy-MM-dd HH:mm:ss └ modified Date 2000-01-01 00:00:00 采购单最后修改时间（包括订单状态变更和订单操作）。格式:yyyy-MM-dd HH:mm:ss └ isv_custom_key String [] isv_custom_key ISV自定义key，通过taobao.fenxiao.order.customfield.update 写入。目前禁用 └ isv_custom_value String [] isv_custom_value ISV自定义值，通过taobao.fenxiao.order.customfield.update 写入。目前禁用 features FeatureDo [] 123 建议废弃 Feature对象列表目前已有的属性： attr_key为 www，attr_value为1 表示是www子订单； attr_key为 wwwStoreCode，attr_value是www子订单发货的仓库编码； attr_key为 isWt，attr_value为1 表示是网厅子订单； attr_key为wtInfo,attr_value为网厅相关合约信息； attr_key为 storeCode，attr_value为仓库信息； attr_key为 erpHold，attr_value为1表示强管控中， attr_value为2表示分单完成； └ attr_key String 1234 属性键 └ attr_value String 2342 属性值 └ pay_type String ALIPAY_SURETY 支付方式：ALIPAY_SURETY（支付宝担保交易）、ALIPAY_CHAIN（分账交易）、TRANSFER（线下转账）、PREPAY（预存款）、IMMEDIATELY（即时到账）、CASHGOODS（先款后货）、ACCOUNT_PERIOD（账期支付） └ shipping String FAST 物流配送方式，发货后有此数据。对应的值：FAST(快速)、EMS、ORDINARY(平邮)、SELLER(卖家包邮) └ logistics_company_name String EMS 物流公司名称 └ logistics_id String 123123 运单号 sub_purchase_orders SubOrderDetail [] 详细列表子订单的详细信息列表 └ tc_order_id Number 157026218599994214 消费者订单子订单ID（经销模式下不存在该值） └ fenxiao_id Number 46467999930382 子采购单编号 └ item_id Number 620019999537 分销平台上的产品id └ item_outer_id String OUT00001 商品商家编码，供应商发布产品是定义的产品编码 └ sku_id Number 555 分销产品的SKU ID。当存在时才会有值，建议使用sku_outer_id，sku_properties这两个值 └ auction_id Number 100 消费者购买宝贝ID，不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。 └ auction_sku_id Number 100 消费者购买宝贝SKU ID，不存在时为0。 2015年3月15日之前创建的采购单该字段都是0。 └ sku_outer_id String 5555 SKU商家编码，供应商发布产品SKU是定义的编码 └ sku_properties String 颜色:红色 SKU属性值。如: 颜色:红色:别名;尺码:L:别名 └ old_sku_properties String 颜色:红色老的SKU属性值。如: 颜色:红色:别名;尺码:L:别名 └ num Number 50 产品的采购数量。取值范围:大于零的整数 └ title String 裙子采购的产品标题。 └ price String 50 产品的采购价格。（精确到2位小数;单位:元。如:200.07，表示:200元7分） └ snapshot_url String www.vancl.com 废弃：产品快照地址 └ created Date 2000-01-01 00:00:00 子单创建时间。格式 yyyy-MM-dd HH:mm:ss 。 └ status String WAIT_BUYER_PAY(等待买家付款) 采购单交易状态，耦合了退款状态，废弃。可选值： WAIT_BUYER_PAY(等待付款) WAIT_SELLER_CONFIRM(付款信息待确认，待发货) WAIT_SELLER_SEND_GOODS(已付款，待发货） WAIT_BUYER_CONFIRM_GOODS(已付款，已发货) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_REFUNDING(退款中) TRADE_REFUNDED(已退款) PAID_FORBID_CONSIGN(已付款, 禁止发货(大快消行业)) WAIT_BUYER_CONFIRM_GOODS_ACOUNTED(已付款（已分账），已发货。只对代销分账支持) PAY_ACOUNTED_GOODS_CONFIRM （已分账发货成功） PAY_WAIT_ACOUNT_GOODS_CONFIRM（已付款，确认收货） └ id Number 5552 建议废弃：只有当担保交易支付时存在，为TP800的订单编号子采购单id，淘宝交易主键，采购单未付款时为0.（只有支付宝付款才有这个id，其余付款形式该字段为0） └ total_fee String 200.07 分销商应付金额。计算公式：num(采购数量)price(采购价) - 折扣。（精确到2位小数;单位:元。如:200.07，表示:200元7分） └ distributor_payment String 200.07 分销商实付金额。 total_fee（分销商应付金额）+ 改价。（精确到2位小数;单位:元。如:200.07，表示:200元7分） └ buyer_payment String 200.07 买家订单上对应的子单零售金额。计算公式：消费者订单的成交价购买数量 + 调整金额 - 优惠折扣（精确到2位小数;单位:元。如:200.07，表示:200元7分） └ refund_fee String 12.23 退款金额，单位元。（精确到2位小数;单位:元。如:12.23，表示:12元2角3分） └ order_200_status String PAID_SEND_GOODS 消费者的交易订单状态（代销采购单对应下游200订单状态）。可选值： WAIT_SELLER_SEND_GOODS(已付款，待发货) WAIT_BUYER_CONFIRM_GOODS(已付款，已发货) TRADE_CLOSED(已退款成功) TRADE_REFUNDING(退款中) TRADE_FINISHED(交易成功) TRADE_CLOSED_BY_TAOBAO(交易关闭) └ auction_price String 100.10 分销商店铺中宝贝一口价，消费者看见的宝贝价格。单位元代销场景下存在，此价格不是实付款的价格。 └ bill_fee String 100.10 发票应开金额。子单的消费者实付分摊金额。根据买家实际付款去除邮费后，按各个子单(商品)金额比例进行分摊后的金额，仅供开发票时做票面金额参考。 └ sc_item_id Number 100000000 后端商品id └ tc_preferential_type String 聚划算商品优惠类型：聚划算、秒杀或其他 └ tc_discount_fee Number 1000 优惠金额，始终为正数，单位是分，不带小数 └ tc_adjust_fee Number 1000 商品的卖出金额调整，金额增加时为正数，金额减少时为负数，单位是分，不带小数 └ discount_fee String 11.11 消费者订单优惠金额，始终为正数，单位是分，不带小数 └ promotion_type String 1 采购子订单优惠活动类型。0=无优惠；1=限时折 features FeatureDo [] a:b;c:d 建议废弃 Feature对象列表目前已有的属性： attr_key为 www，attr_value为1 表示是www子订单； attr_key为 wwwStoreCode，attr_value是www子订单发货的仓库编码； attr_key为 isWt，attr_value为1 表示是网厅子订单； attr_key为wtInfo,attr_value为网厅相关合约信息； attr_key为 storeCode，attr_value为仓库信息； attr_key为 erpHold，attr_value为1表示强管控中， attr_value为2表示分单完成； └ attr_key String 1234 属性键 └ attr_value String 2342 属性值 top_memo TopMemoDto 子订单留言信息 └ remark String 123 子订单备注内容 └ operate_user_nick String 123 操作者昵称 attachments TopMemoAttachment [] 123 附件 └ url String 123 附件地址 └ name String 123 附件名称 └ order_status String WAIT_SELLER_SEND_GOODS 真正的采购单交易状态。可选值： LOCKED(交易hold单中) WAIT_FOR_PAY(等待付款) PAID_WAIT_FOR_CONFIRM(付款信息待确认，待发货) PAID(已付款待发货）CONSIGNED(已发货待确认收货) ORDER_SUCCESS(交易成功) ORDER_CLOSE(交易关闭) └ refund_status String RF_STATUS_NO_REFUND 采购单售中退款状态。可选值： RF_STATUS_NO_REFUND(子单无退款) RF_STATUS_REFUNDING(子单退款中) RF_STATUS_END_REFUND(子单退款结束) └ suit_status String ORDER_RF_NO_SUIT 采购单售后维权状态。可选值：ORDER_RF_NO_SUIT(未申请维权) ORDER_RF_SUITING(维权中) ORDER_RF_END_SUIT(维权结束) └ need_sn Boolean true 百补订单要求发货必须带SN回传 └ bybt_sn_code_tag String {t:1} 有此字段代表百补订单要求必须预上传SN └ latest_refund_id Number 125656688526 最近一笔售中逆向订单ID └ latest_suit_id Number 123899666366 最近一笔售后逆向订单ID └ latest_exchange_refund_id Number 125899633653 最近一笔售中换货订单ID └ latest_exchange_suit_id Number 125846639978 最近一笔售后换货订单ID receiver TopReceiverDo 买家详细信息 └ name String zhangsan 收货人全名 └ address String 文一西路969号收货人的详细地址信息 └ zip String 310000 邮政编码 └ phone String 57188155188 固定电话 └ mobile_phone String 13812345678 移动电话 └ state String 浙江省收货人所在省份 └ city String 杭州市收货人的城市 └ district String 余杭区区/县 └ oaid String xxxx 收件人ID (Open Addressee ID)，长度在128个字符之内。 order_messages OrderMessages [] 采购单留言列表，如果是代销，包含消费者留言。 └ message_time Date 2000-01-01 00:00:00 留言时间 └ message_title String 分销商留言留言标题，例如：分销商留言，供应商留言，买家留言 └ message_content String 留言内容留言内容 └ pic_url String 1 留言时的图片地址 logistics_infos ErpLogisticsInfo [] [架海金梁独有字段，非架海金梁用户请勿关心]子单物流发货信息 └ consign_type String cn 发货类型 CN=菜鸟发货,SC的商家仓发货 └ num_iid Number 12222 商品数字编号 └ sku_id String 213 商品的最小库存单位Sku的id └ type String 00 子订单类型:标示该子交易单来源交易，还是BMS增加的，枚举值(00=交易，10=BMS绑定) └ store_code String 2223 如是菜鸟仓，则将菜鸟仓的区域仓code进行填充，如是商家仓发货则填充SC └ need_consign_num Number 5 应发数量 └ item_code String 323232 货品仓储code └ item_id String 2323232 货品仓储id └ sub_order_id Number 1100070860173581613 采购单子单号 └ order_id Number 1100070860172581613 采购单号 └ combine_item_id String 558578215712 组合商品ID └ combine_item_code String 1021-0 组合商品Code └ item_ratio Number 1 组合货品比例 └ bar_code String a223323 货品条码 └ delivery_cps String STO 推荐配送公司编码 └ biz_store_code String YT_HD_STORE 仓商家编码 └ biz_delivery_code String 2356364 推荐配送erp编码 └ biz_sd_type String 1 仓配建议类型 └ send_division_code String 330110005 预计发货地址-最小行政地址编码 └ send_country String 中国预计发货地址-文案描述-国家 └ send_state String 浙江预计发货地址-文案描述-省份 └ send_city String 杭州预计发货地址-文案描述-城市 └ send_district String 西湖区预计发货地址-文案描述-地区 └ send_town String 三墩镇预计发货地址-文案描述-街道/镇 └ black_delivery_cps String SF,YT,ZT CP黑名单，逗号分隔 └ white_delivery_cps String YD,JT,JD CP白名单，逗号分隔 └ alipay_order_no String 2020081222001182111436382503 支付宝交易号，担保交易使用。 └ confirm_paid_fee_yuan String 22.22 已执行确认收货的金额，单位：元 └ channel_code Number 200002 渠道(市场)编码，例如消费电子的编码为200002 └ open_buyer_uid String 44544541165 消费者淘宝id被加密后的唯一标识 └ delivery_time String 2019-04-12 16:00:00 计划出库时间 └ sign_time String 2019-04-12 16:00:00 计划送达时间 └ asdp_ads String 201,202 配送服务,201为驿站送货上门服务,202为顺丰配送服务,里面多个值时用英文逗号隔开 └ delivery_cps String STO 推荐配送公司编码 └ order_status String WAIT_SELLER_SEND_GOODS 真正的采购单交易状态。可选值： LOCKED(交易hold单中) WAIT_BUYER_PAY(等待付款) WAIT_SELLER_CONFIRM_PAY(付款信息待确认，待发货) WAIT_SELLER_SEND_GOODS(已付款，待发货） WAIT_BUYER_CONFIRM_GOODS(已付款，已发货) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) └ refund_status String ORDER_RF_NO_REFUND 采购单售中退款状态。可选值： ORDER_RF_NO_REFUND(整单无退款) ORDER_RF_REFUNDING(退款中) ORDER_RF_END_REFUND(退款结束) └ suit_status String ORDER_RF_NO_SUIT 采购单售后维权状态。可选值：ORDER_RF_NO_SUIT(未申请维权) ORDER_RF_SUITING(维权中) ORDER_RF_END_SUIT(维权结束) └ order_type String 100 采购单业务类型枚举值。可选值： SALES_ORDER(100, "销售订单"), LG_CTC_SALES_ORDER(110, "两张履约单一盘货销售单"), ONE_STOCK_SALES_ORDER(220, "一张履约单一盘货销售单"), COLLECT_ORDER(200,"揽收单"), SEMI_HOST_ORDER(300, "半托管订单"), FUND_DECOUPLE_SALES_ORDER(400, "资金解耦的新销售订单"), EXCHANGE_ORDER(500, "换货订单"), RESHIPMENT_ORDER(600, "补发订单") └ order_type_desc String 销售订单采购单业务类型枚举解释。可选值： SALES_ORDER(100, "销售订单"), LG_CTC_SALES_ORDER(110, "两张履约单一盘货销售单"), ONE_STOCK_SALES_ORDER(220, "一张履约单一盘货销售单"), COLLECT_ORDER(200,"揽收单"), SEMI_HOST_ORDER(300, "半托管订单"), FUND_DECOUPLE_SALES_ORDER(400, "资金解耦的新销售订单"), EXCHANGE_ORDER(500, "换货订单"), RESHIPMENT_ORDER(600, "补发订单")

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoOrdersGetRequest req = new FenxiaoOrdersGetRequest();
req.setStatus("WAIT_BUYER_PAY");
req.setStartCreated(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndCreated(StringUtils.parseDateTime("2000-01-01 23:59:59"));
req.setTimeType("trade_time_type");
req.setPurchaseOrderId(44926651888684L);
req.setPageNo(1L);
req.setPageSize(10L);
req.setFields("sub_purchase_orders.tc_order_id");
req.setTcOrderId(157026218599994214L);
req.setChannelCodes("200002");
req.setUserRoleType(1L);
req.setTradeTypes("1");
FenxiaoOrdersGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
FenxiaoOrdersGetRequest req = new FenxiaoOrdersGetRequest();
req.Status = "WAIT_BUYER_PAY";
req.StartCreated = DateTime.Parse("2000-01-01 00:00:00");
req.EndCreated = DateTime.Parse("2000-01-01 23:59:59");
req.TimeType = "trade_time_type";
req.PurchaseOrderId = 44926651888684L;
req.PageNo = 1L;
req.PageSize = 10L;
req.Fields = "sub_purchase_orders.tc_order_id";
req.TcOrderId = 157026218599994214L;
req.ChannelCodes = "200002";
req.UserRoleType = 1L;
req.TradeTypes = "1";
FenxiaoOrdersGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new FenxiaoOrdersGetRequest;
$req->setStatus("WAIT_BUYER_PAY");
$req->setStartCreated("2000-01-01 00:00:00");
$req->setEndCreated("2000-01-01 23:59:59");
$req->setTimeType("trade_time_type");
$req->setPurchaseOrderId("44926651888684");
$req->setPageNo("1");
$req->setPageSize("10");
$req->setFields("sub_purchase_orders.tc_order_id");
$req->setTcOrderId("157026218599994214");
$req->setChannelCodes("200002");
$req->setUserRoleType("1");
$req->setTradeTypes("1");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.fenxiao.orders.get' \
-d 'partner_id=apidoc' \
-d 'session=fd9585c5-c307-41ce-8a21-6c44b7907d3b' \
-d 'sign=4F428E0762EAAD1CD9A34C10B27697BF' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-14+21%3A42%3A33' \
-d 'v=2.0' \
-d 'channel_codes=200002' \
-d 'end_created=2000-01-01+23%3A59%3A59' \
-d 'fields=sub_purchase_orders.tc_order_id' \
-d 'page_no=1' \
-d 'page_size=10' \
-d 'purchase_order_id=44926651888684' \
-d 'start_created=2000-01-01+00%3A00%3A00' \
-d 'status=WAIT_BUYER_PAY' \
-d 'tc_order_id=157026218599994214' \
-d 'time_type=trade_time_type' \
-d 'trade_types=1' \
-d 'user_role_type=1'

# -*- coding: utf-8 -*-
import top.api

req=top.api.FenxiaoOrdersGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.status="WAIT_BUYER_PAY"
req.start_created="2000-01-01 00:00:00"
req.end_created="2000-01-01 23:59:59"
req.time_type="trade_time_type"
req.purchase_order_id=44926651888684
req.page_no=1
req.page_size=10
req.fields="sub_purchase_orders.tc_order_id"
req.tc_order_id=157026218599994214
req.channel_codes="200002"
req.user_role_type=1
req.trade_types="1"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.fenxiao.orders.get");
add_param(pRequest,"status","WAIT_BUYER_PAY");
add_param(pRequest,"start_created","2000-01-01 00:00:00");
add_param(pRequest,"end_created","2000-01-01 23:59:59");
add_param(pRequest,"time_type","trade_time_type");
add_param(pRequest,"purchase_order_id","44926651888684");
add_param(pRequest,"page_no","1");
add_param(pRequest,"page_size","10");
add_param(pRequest,"fields","sub_purchase_orders.tc_order_id");
add_param(pRequest,"tc_order_id","157026218599994214");
add_param(pRequest,"channel_codes","200002");
add_param(pRequest,"user_role_type","1");
add_param(pRequest,"trade_types","1");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.fenxiao.orders.get', {
	'status':'WAIT_BUYER_PAY',
	'start_created':'2000-01-01 00:00:00',
	'end_created':'2000-01-01 23:59:59',
	'time_type':'trade_time_type',
	'purchase_order_id':'44926651888684',
	'page_no':'1',
	'page_size':'10',
	'fields':'sub_purchase_orders.tc_order_id',
	'tc_order_id':'157026218599994214',
	'channel_codes':'200002',
	'user_role_type':'1',
	'trade_types':'1'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<fenxiao_orders_get_response>
    <total_results>9999</total_results>
    <purchase_orders>
        <top_dp_order_do>
            <tc_order_id>157026218599994214</tc_order_id>
            <supplier_from>values: taobao</supplier_from>
            <supplier_username>zhangsan</supplier_username>
            <distributor_from>taobao</distributor_from>
            <distributor_username>zhangsan</distributor_username>
            <buyer_taobao_id>F21121542129F21121542129F2112154</buyer_taobao_id>
            <buyer_nick>zhangsan</buyer_nick>
            <trade_type>AGENT</trade_type>
            <created>2000-01-01 00:00:00</created>
            <id>555</id>
            <fenxiao_id>1001</fenxiao_id>
            <memo>留言。</memo>
            <supplier_memo>供应商信息描述</supplier_memo>
            <supplier_flag>1</supplier_flag>
            <alipay_no>200010507220088888888449086137</alipay_no>
            <total_fee>200.07</total_fee>
            <post_fee>200.07</post_fee>
            <distributor_payment>200.07</distributor_payment>
            <buyer_payment>200.07</buyer_payment>
            <snapshot_url>www.vancl.com</snapshot_url>
            <status>TRADE_FINISHED(交易成功)</status>
            <pay_time>2000-01-01 00:00:00</pay_time>
            <end_time>2000-01-01 00:00:00</end_time>
            <consign_time>2000-01-01 00:00:00</consign_time>
            <modified>2000-01-01 00:00:00</modified>
            <isv_custom_key>
                <string>isv_custom_key</string>
            </isv_custom_key>
            <isv_custom_value>
                <string>isv_custom_value</string>
            </isv_custom_value>
            <features>
                <feature_do>
                    <attr_key>1234</attr_key>
                    <attr_value>2342</attr_value>
                </feature_do>
            </features>
            <pay_type>ALIPAY_SURETY</pay_type>
            <shipping>FAST</shipping>
            <logistics_company_name>EMS</logistics_company_name>
            <logistics_id>123123</logistics_id>
            <sub_purchase_orders>
                <sub_order_detail>
                    <tc_order_id>157026218599994214</tc_order_id>
                    <fenxiao_id>46467999930382</fenxiao_id>
                    <item_id>620019999537</item_id>
                    <item_outer_id>OUT00001</item_outer_id>
                    <sku_id>555</sku_id>
                    <auction_id>100</auction_id>
                    <auction_sku_id>100</auction_sku_id>
                    <sku_outer_id>5555</sku_outer_id>
                    <sku_properties>颜色:红色</sku_properties>
                    <old_sku_properties>颜色:红色</old_sku_properties>
                    <num>50</num>
                    <title>裙子</title>
                    <price>50</price>
                    <snapshot_url>www.vancl.com</snapshot_url>
                    <created>2000-01-01 00:00:00</created>
                    <status>WAIT_BUYER_PAY(等待买家付款)</status>
                    <id>5552</id>
                    <total_fee>200.07</total_fee>
                    <distributor_payment>200.07</distributor_payment>
                    <buyer_payment>200.07</buyer_payment>
                    <refund_fee>12.23</refund_fee>
                    <order_200_status>PAID_SEND_GOODS</order_200_status>
                    <auction_price>100.10</auction_price>
                    <bill_fee>100.10</bill_fee>
                    <sc_item_id>100000000</sc_item_id>
                    <tc_preferential_type>聚划算</tc_preferential_type>
                    <tc_discount_fee>1000</tc_discount_fee>
                    <tc_adjust_fee>1000</tc_adjust_fee>
                    <discount_fee>11.11</discount_fee>
                    <promotion_type>1</promotion_type>
                    <features>
                        <feature_do>
                            <attr_key>1234</attr_key>
                            <attr_value>2342</attr_value>
                        </feature_do>
                    </features>
                    <top_memo>
                        <remark>123</remark>
                        <operate_user_nick>123</operate_user_nick>
                        <attachments>
                            <top_memo_attachment>
                                <url>123</url>
                                <name>123</name>
                            </top_memo_attachment>
                        </attachments>
                    </top_memo>
                    <order_status>WAIT_SELLER_SEND_GOODS</order_status>
                    <refund_status>RF_STATUS_NO_REFUND</refund_status>
                    <suit_status>ORDER_RF_NO_SUIT</suit_status>
                    <need_sn>true</need_sn>
                    <bybt_sn_code_tag>{t:1}</bybt_sn_code_tag>
                    <latest_refund_id>125656688526</latest_refund_id>
                    <latest_suit_id>123899666366</latest_suit_id>
                    <latest_exchange_refund_id>125899633653</latest_exchange_refund_id>
                    <latest_exchange_suit_id>125846639978</latest_exchange_suit_id>
                </sub_order_detail>
            </sub_purchase_orders>
            <receiver>
                <name>zhangsan</name>
                <address>文一西路969号</address>
                <zip>310000</zip>
                <phone>57188155188</phone>
                <mobile_phone>13812345678</mobile_phone>
                <state>浙江省</state>
                <city>杭州市</city>
                <district>余杭区</district>
                <oaid>xxxx</oaid>
            </receiver>
            <order_messages>
                <order_messages>
                    <message_time>2000-01-01 00:00:00</message_time>
                    <message_title>分销商留言</message_title>
                    <message_content>留言内容</message_content>
                    <pic_url>1</pic_url>
                </order_messages>
            </order_messages>
            <logistics_infos>
                <erp_logistics_info>
                    <consign_type>cn</consign_type>
                    <num_iid>12222</num_iid>
                    <sku_id>213</sku_id>
                    <type>00</type>
                    <store_code>2223</store_code>
                    <need_consign_num>5</need_consign_num>
                    <item_code>323232</item_code>
                    <item_id>2323232</item_id>
                    <sub_order_id>1100070860173581613</sub_order_id>
                    <order_id>1100070860172581613</order_id>
                    <combine_item_id>558578215712</combine_item_id>
                    <combine_item_code>1021-0</combine_item_code>
                    <item_ratio>1</item_ratio>
                    <bar_code>a223323</bar_code>
                    <delivery_cps>STO</delivery_cps>
                    <biz_store_code>YT_HD_STORE</biz_store_code>
                    <biz_delivery_code>2356364</biz_delivery_code>
                    <biz_sd_type>1</biz_sd_type>
                    <send_division_code>330110005</send_division_code>
                    <send_country>中国</send_country>
                    <send_state>浙江</send_state>
                    <send_city>杭州</send_city>
                    <send_district>西湖区</send_district>
                    <send_town>三墩镇</send_town>
                    <black_delivery_cps>SF,YT,ZT</black_delivery_cps>
                    <white_delivery_cps>YD,JT,JD</white_delivery_cps>
                </erp_logistics_info>
            </logistics_infos>
            <alipay_order_no>2020081222001182111436382503</alipay_order_no>
            <confirm_paid_fee_yuan>22.22</confirm_paid_fee_yuan>
            <channel_code>200002</channel_code>
            <open_buyer_uid>44544541165</open_buyer_uid>
            <delivery_time>2019-04-12 16:00:00</delivery_time>
            <sign_time>2019-04-12 16:00:00</sign_time>
            <asdp_ads>201,202</asdp_ads>
            <delivery_cps>STO</delivery_cps>
            <order_status>WAIT_SELLER_SEND_GOODS</order_status>
            <refund_status>ORDER_RF_NO_REFUND</refund_status>
            <suit_status>ORDER_RF_NO_SUIT</suit_status>
            <order_type>100</order_type>
            <order_type_desc>销售订单</order_type_desc>
        </top_dp_order_do>
    </purchase_orders>
</fenxiao_orders_get_response>

{
    "fenxiao_orders_get_response":{
        "total_results":9999,
        "purchase_orders":{
            "top_dp_order_do":[
                {
                    "tc_order_id":157026218599994214,
                    "supplier_from":"values: taobao",
                    "supplier_username":"zhangsan",
                    "distributor_from":"taobao",
                    "distributor_username":"zhangsan",
                    "buyer_taobao_id":"F21121542129F21121542129F2112154",
                    "buyer_nick":"zhangsan",
                    "trade_type":"AGENT",
                    "created":"2000-01-01 00:00:00",
                    "id":555,
                    "fenxiao_id":1001,
                    "memo":"留言。",
                    "supplier_memo":"供应商信息描述",
                    "supplier_flag":1,
                    "alipay_no":"200010507220088888888449086137",
                    "total_fee":"200.07",
                    "post_fee":"200.07",
                    "distributor_payment":"200.07",
                    "buyer_payment":"200.07",
                    "snapshot_url":"www.vancl.com",
                    "status":"TRADE_FINISHED(交易成功)",
                    "pay_time":"2000-01-01 00:00:00",
                    "end_time":"2000-01-01 00:00:00",
                    "consign_time":"2000-01-01 00:00:00",
                    "modified":"2000-01-01 00:00:00",
                    "isv_custom_key":{
                        "string":[
                            "isv_custom_key"
                        ]
                    },
                    "isv_custom_value":{
                        "string":[
                            "isv_custom_value"
                        ]
                    },
                    "features":{
                        "feature_do":[
                            {
                                "attr_key":"1234",
                                "attr_value":"2342"
                            }
                        ]
                    },
                    "pay_type":"ALIPAY_SURETY",
                    "shipping":"FAST",
                    "logistics_company_name":"EMS",
                    "logistics_id":"123123",
                    "sub_purchase_orders":{
                        "sub_order_detail":[
                            {
                                "tc_order_id":157026218599994214,
                                "fenxiao_id":46467999930382,
                                "item_id":620019999537,
                                "item_outer_id":"OUT00001",
                                "sku_id":555,
                                "auction_id":100,
                                "auction_sku_id":100,
                                "sku_outer_id":"5555",
                                "sku_properties":"颜色:红色",
                                "old_sku_properties":"颜色:红色",
                                "num":50,
                                "title":"裙子",
                                "price":"50",
                                "snapshot_url":"www.vancl.com",
                                "created":"2000-01-01 00:00:00",
                                "status":"WAIT_BUYER_PAY(等待买家付款)",
                                "id":5552,
                                "total_fee":"200.07",
                                "distributor_payment":"200.07",
                                "buyer_payment":"200.07",
                                "refund_fee":"12.23",
                                "order_200_status":"PAID_SEND_GOODS",
                                "auction_price":"100.10",
                                "bill_fee":"100.10",
                                "sc_item_id":100000000,
                                "tc_preferential_type":"聚划算",
                                "tc_discount_fee":1000,
                                "tc_adjust_fee":1000,
                                "discount_fee":"11.11",
                                "promotion_type":"1",
                                "features":{
                                    "feature_do":[
                                        {
                                            "attr_key":"1234",
                                            "attr_value":"2342"
                                        }
                                    ]
                                },
                                "top_memo":{
                                    "remark":"123",
                                    "operate_user_nick":"123",
                                    "attachments":{
                                        "top_memo_attachment":[
                                            {
                                                "url":"123",
                                                "name":"123"
                                            }
                                        ]
                                    }
                                },
                                "order_status":"WAIT_SELLER_SEND_GOODS",
                                "refund_status":"RF_STATUS_NO_REFUND",
                                "suit_status":"ORDER_RF_NO_SUIT",
                                "need_sn":true,
                                "bybt_sn_code_tag":"{t:1}",
                                "latest_refund_id":125656688526,
                                "latest_suit_id":123899666366,
                                "latest_exchange_refund_id":125899633653,
                                "latest_exchange_suit_id":125846639978
                            }
                        ]
                    },
                    "receiver":{
                        "name":"zhangsan",
                        "address":"文一西路969号",
                        "zip":"310000",
                        "phone":"57188155188",
                        "mobile_phone":"13812345678",
                        "state":"浙江省",
                        "city":"杭州市",
                        "district":"余杭区",
                        "oaid":"xxxx"
                    },
                    "order_messages":{
                        "order_messages":[
                            {
                                "message_time":"2000-01-01 00:00:00",
                                "message_title":"分销商留言",
                                "message_content":"留言内容",
                                "pic_url":"1"
                            }
                        ]
                    },
                    "logistics_infos":{
                        "erp_logistics_info":[
                            {
                                "consign_type":"cn",
                                "num_iid":12222,
                                "sku_id":"213",
                                "type":"00",
                                "store_code":"2223",
                                "need_consign_num":5,
                                "item_code":"323232",
                                "item_id":"2323232",
                                "sub_order_id":1100070860173581613,
                                "order_id":1100070860172581613,
                                "combine_item_id":"558578215712",
                                "combine_item_code":"1021-0",
                                "item_ratio":1,
                                "bar_code":"a223323",
                                "delivery_cps":"STO",
                                "biz_store_code":"YT_HD_STORE",
                                "biz_delivery_code":"2356364",
                                "biz_sd_type":"1",
                                "send_division_code":"330110005",
                                "send_country":"中国",
                                "send_state":"浙江",
                                "send_city":"杭州",
                                "send_district":"西湖区",
                                "send_town":"三墩镇",
                                "black_delivery_cps":"SF,YT,ZT",
                                "white_delivery_cps":"YD,JT,JD"
                            }
                        ]
                    },
                    "alipay_order_no":"2020081222001182111436382503",
                    "confirm_paid_fee_yuan":"22.22",
                    "channel_code":200002,
                    "open_buyer_uid":"44544541165",
                    "delivery_time":"2019-04-12 16:00:00",
                    "sign_time":"2019-04-12 16:00:00",
                    "asdp_ads":"201,202",
                    "delivery_cps":"STO",
                    "order_status":"WAIT_SELLER_SEND_GOODS",
                    "refund_status":"ORDER_RF_NO_REFUND",
                    "suit_status":"ORDER_RF_NO_SUIT",
                    "order_type":"100",
                    "order_type_desc":"销售订单"
                }
            ]
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isv.invalid-parameter:user_id_num	用户数字ID不合法，或者不是分销平台用户
isv.invalid-parameter:purchaseorder_intervaldate	采购单查询的起始时间与结束时间跨度不能超过7天
isv.invalid-parameter:purchaseorder_empty	此错误是查询订单的起始时间，结束时间为空或者间隔超过7天。
isv.invalid-parameter:fields

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

开放平台

分销API

taobao.fenxiao.orders.get (查询采购单信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ