阿里安全开放平台-阿里聚安全

请求地址：

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

名称	类型	是否必须	示例值	描述
trade_types	Number	可选	1	查询的经营模式，当不指定时，默认查询代销订单代销：1 经销：2 寄售（自营寄售）：5 平台寄售：6
page_size	Number	必须	50	每页条数。（每页条数不超过50条）
page_num	Number	可选	1	页号，不填则默认为1
user_role_type	Number	可选	2	当前查询用户的角色当不指定时，默认为供应商供应商：2，分销商：1
begin_time	Date	必须	2000-01-01 00:00:00	采购单最后更新时间-起始时间，格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。时间跨度必须在0-7天。
end_time	Date	必须	2000-01-01 00:00:00	采购单最后更新时间-结束时间，格式 yyyy-MM-dd HH:mm:ss 支持到秒的查询。时间跨度必须在0-7天。
channel_codes	Number	可选	302	渠道市场编码，可批量指定。当不指定时，按照配置的分销市场生效渠道编码枚举：1-供销平台（淘宝）；2-供销平台（天猫）；3-供销平台（天猫超市）；5-供销平台（淘乡甜）；110001-供销平台（全球购）；110007-淘分销；200002-消费电子市场；302-猫超一盘货；506-虾选一盘货
order_status	Number	可选	1	主采购单交易状态-数字表示，枚举：1-已付款，待发货；2-待确认收款；4-等待买家付款；5-已付款，已发货；6-交易成功；7-交易关闭；8-已付款；
refund_status	Number	可选	9	主采购单退款状态-数字表示，枚举：9-没有过申请退款；10-退款活动中,至少有一个子单在退款中；11-退款结束，即曾经发生过退款且所有退款都完结了

名称	类型	示例值	描述
purchase_orders	OrderList []	null	采购单及子采购单信息
└ alipay_no String null 支付宝交易号，在分销商使用担保交易支付时存在。来源主订单的payOrderId。 └ logistics_id String LP00167730231064-1 运单号 └ pay_time Date 2000-01-01 00:00:00 采购单付款时间。格式:yyyy-MM-dd HH:mm:ss └ memo String 这是一条采购单留言采购单留言 └ buyer_actual_pay_yuan String 0.00 采购单主单买家实付金额，当前台订单只有一个供应商时该字段有值。单位：元。 └ pay_type Number 10000 支付方式，枚举：101-支付宝担保交易；102-代销分账；103-即时到账；104-预存款；201-线下转账汇款交易；301-资金账户预存款交易；302-资金账户即时到账交易；303-先款后货；401-账期支付；402-国际分账；403-直营无需支付；404-外币分账；10000-无需支付 └ consign_time Date 2000-01-01 00:00:00 发货时间，格式：格式:yyyy-MM-dd HH:mm:ss └ shipping Number 2 配送方式，枚举：1-平邮；2-快递；3-ems；4-虚拟物品 └ logistics_company_name String 这是一家物流公司物流公司 └ distributor_nick String 商家测试帐号86 分销商昵称 └ postage_yuan String 0.00 采购单邮费 └ supplier_memo String 供应商备注供应商备注信息。只有供应商身份查询输出此新信息 └ biz_order_id String 38913818274736 采购单编号 sub_order_detail_yph_list SubOrderList [] null 子采购单详情 └ refund_fee Number 0 退款金额，单位：分 └ buyer_pay_price String 1.00 买家实付金额，单位：元 └ buy_num Number 1 购买数量 └ discount_fee_yuan String 0.00 优惠活动折扣金额，单位：元 └ discount_fee Number 0 优惠活动折扣金额，单位：分 └ sub_tc_order_id Number 911465155210793700 子订单的前台订单号 └ sku_property_val String 颜色分类：仅共享商品sku属性值 └ confirm_paid_fee Number 0 确认收货金额，单位：分 └ distributor_pay_price_yuan String 0.00 分销商实付金额，单位：元 └ bill_fee Number 10 发票应开金额。子单的消费者实付分摊金额。根据买家实际付款去除邮费后，按各个子单(商品)金额比例进行分摊后的金额，仅供开发票时做票面金额参考。 └ title String 【测试，请不要拍】至清测试专用，勿动，请自重-多SKU-03 商品标题 └ real_auction_id Number 613697976491 消费者购买宝贝ID，不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。 └ refund_fee_yuan String 0.00 退款金额，单位：元。（精确到2位小数;单位:元。如:12.23，表示:12元2角3分） └ real_auction_sku_id Number 4496911555141 消费者购买宝贝SKU ID，不存在时为0。 2015年3月15日之前创建的采购单该字段都是0。 └ sub_order_id Number 0 采购单子单号 └ price Number 0 单个商品价格，单位：分 └ tc_discount_fee Number 0 优惠金额，始终为正数，单位是分，不带小数 └ confirm_paid_fee_yuan String 0.00 已执行确认收货的金额，单位：元 └ buyer_pay_price_yuan String 1.00 买家实付金额，单位：元 └ promotion_type String 0 优惠活动类型 0-无优惠 1-限时折 └ distributor_price Number 0 分销商应付金额，单位：分 └ sc_item_id Number 613702760269 后端商品id └ fenxiao_id Number 38913818274736 分销采购单号（分销流水号） └ tc_adjust_fee Number 0 商品的卖出金额调整，金额增加时为正数，金额减少时为负数，单位是分，不带小数 └ gmt_create Date 2000-01-01 00:00:00 创单时间 └ auction_id Number 613694296654 消费者购买宝贝ID，不存在时为0。 2015年4月15日之前创建的采购单该字段都是0。 └ tc_preferential_type String 聚划算商品优惠类型：聚划算、秒杀或其他 └ auction_sku_id Number 4493468966531 消费者购买宝贝SKU ID，不存在时为0。 2015年3月15日之前创建的采购单该字段都是0 └ bill_fee_yuan String 1.00 发票应开金额，单位：元。子单的消费者实付分摊金额。根据买家实际付款去除邮费后，按各个子单(商品)金额比例进行分摊后的金额，仅供开发票时做票面金额参考。 └ auction_price String 0.01 分销商店铺中宝贝一口价，消费者看见的宝贝价格。单位：元。代销场景下存在，此价格不是实付款的价格。 └ price_yuan String 0.00 产品的采购价格。（精确到2位小数;单位:元。如:200.07，表示:200元7分） └ order_200_status String TRADE_FINISHED 消费者的交易订单状态（代销采购单对应下游200订单状态）。可选值： WAIT_SELLER_SEND_GOODS(已付款，待发货) WAIT_BUYER_CONFIRM_GOODS(已付款，已发货) TRADE_CLOSED(已退款成功) TRADE_REFUNDING(退款中) TRADE_FINISHED(交易成功) TRADE_CLOSED_BY_TAOBAO(交易关闭) └ distributor_pay_price Number 0 分销商实付金额，单位：分 └ distributor_price_yuan String 0.00 分销商应付金额，单位：元 └ sub_order_status_code String DELIVERED 子采购单交易状态，枚举：AUDITING-意向单审核中；LOCKED-订单付款前锁定；WAIT_FOR_ALLOCATE_GOODS-待分货；ALLOCATING-分货中；WAIT_FOR_PAY-等待付款；PAID_WAIT_FOR_CONFIRM-已付款待确认付款操作；PAID-已确认付款，可直接发货；DELIVERED-已提交交货；CONSIGNED-已发货；RECEIVING-已提交确认收货，但收货未完成；ORDER_CLOSE-交易关闭；ORDER_SUCCESS-交易成功 └ sub_order_status Number 70 子采购单交易状态-数字表示，枚举：10-意向单审核中；20-订单付款前锁定；30-待分货；40-分货中；50-订单等待付款；55-已付款待确认付款操作；60-已付款；70-已提交交货；80-已发货；90-已提交确认收货，但收货未完成；100-交易关闭；110-交易成功 └ refund_status Number 9 子采购单退款状态-数字形式，枚举：9-没有申请退款；20-退款中；21-退款结束，退款成功或者退款关闭都会走到这里 └ refund_status_code String RF_STATUS_NO_REFUND 子采购单退款状态，枚举：RF_STATUS_NO_REFUND-没有申请退款；RF_STATUS_REFUNDING-退款中；RF_STATUS_END_REFUND-退款结束，退款成功或者退款关闭都会走到这里 └ auction_out_id String OUT100000 子采购单商品商家编码，供应商发布产品时定义的产品编码 └ secondary_supplier_id Number 1000000000012345 二级供应商id └ tp_create_time_price BigDecimal 9.00 tp单创单时间点的货品采购价 features FeatureDO [] 建议废弃 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为shipper,attr_value为cn表示菜鸟发货； attr_key为 storeCode，attr_value为仓库信息； attr_key为 erpHold，attr_value为1表示强管控中， attr_value为2表示分单完成； └ attr_key String 111 属性键 └ attr_value String 222 属性值 └ auction_out_sku_id String 5555 SKU商家编码，供应商发布产品SKU是定义的编码 └ gmt_modified Date 2000-01-01 00:00:00 采购单最后修改时间（包括订单状态变更和订单操作）。格式:yyyy-MM-dd HH:mm:ss └ total_price Number 0 采购单总额（不含邮费，单位：分） └ tc_order_id Number 911465155210793700 消费者主订单ID （经销模式下，不存在该单号) └ order_status Number 6 主采购单交易状态-数字表示，枚举：1-已付款，待发货；2-待确认收款；4-等待买家付款；5-已付款，已发货；6-交易成功；7-交易关闭；8-已付款； └ confirm_paid_fee Number 0 确认收货金额，单位：分 └ distributor_pay_price_yuan String 0.00 分销商实付金额，单位：元 └ supplier_nick String 商家测试帐号42 供应商昵称 └ confirm_paid_fee_yuan String 0.00 确认收货金额，单位：元 └ trade_type Number 1 查询的经营模式，当不指定时，默认查询代销订单代销：1 经销：2 寄售（自营寄售）：5 平台寄售：6 └ channel_code Number 302 渠道市场编码，可批量指定。当不指定时，按照配置的分销市场生效渠道编码枚举：1-供销平台（淘宝）；2-供销平台（天猫）；3-供销平台（天猫超市）；5-供销平台（淘乡甜）；110001-供销平台（全球购）；110007-淘分销；200002-消费电子市场；302-猫超一盘货；506-虾选一盘货 └ buyer_actual_pay Number 0 采购单主单买家实付金额，当前台订单只有一个供应商时该字段有值。单位：分。 └ fenxiao_id Number 38913818274736 分销采购单号（分销流水号） └ gmt_create Date 2000-01-01 00:00:00 采购单创建时间 └ postage Number 0 采购单邮费，单位：分 └ supplier_from_sys Number 1 供应商来源网站。入驻时定义供应商来源的外部系统编码, values: taobao, alibaba └ distributor_from_sys String taobao 分销商来源网站 └ end_time Date 2000-01-01 00:00:00 交易成功的时间，分销商确认收货/付款的时间。格式:yyyy-MM-dd HH:mm:ss └ distributor_pay_price Number 0 分销商实付金额，单位：分 └ total_price_yuan String 0.00 采购单总额（不含邮费），单位：元 └ order_status_code String TRADE_FINISHED 主采购单交易状态，枚举：WAIT_SELLER_SEND_GOODS-已付款，待发货；WAIT_SELLER_CONFIRM_PAY-待确认收款；TRADE_REFUNDING-退款中；WAIT_BUYER_PAY-等待买家付款；WAIT_BUYER_CONFIRM_GOODS-已付款，已发货；TRADE_FINISHED-交易成功了；TRADE_CLOSED-交易关闭；TRADE_FOR_PAY-已付款；TRADE_REFUNDED-已退款 └ refund_status Number 9 主采购单退款状态-数字表示，枚举：9-没有过申请退款；10-退款活动中,至少有一个子单在退款中；11-退款结束，即曾经发生过退款且所有退款都完结了 └ refund_status_code String ORDER_RF_NO_REFUND 主采购单退款状态，枚举：ORDER_RF_NO_REFUND-没有过申请退款；ORDER_RF_REFUNDING-退款活动中,至少有一个子单在退款中；ORDER_RF_END_REFUND-退款结束，即曾经发生过退款且所有退款都完结了 └ logis_type String 菜鸟仓寄售模式文字（商家仓，菜鸟仓，门店发货） └ logis_type_code Number 0 寄售模式code(0-菜鸟仓，1-商家仓，2-门店发货) dp_buyer_detail DpBuyerDetail 消费者详细信息（收货人姓名、收货人手机、收货人电话、收货人邮编、收货人省份、收货人详细地址） └ area String 余杭区地区 └ address String 收货地址收货地址 └ mobile_phone String 12345678910 移动电话 └ post String 610000 邮编 └ city String 杭州市城市 └ phone String 123456 固定电话 └ full_name String 收货人全名收货人全名 └ prov String 浙江省省份 └ oaid String xxxxx 收件人ID (Open Addressee ID)，长度在128个字符之内。 └ tp_create_time String 1645414654000 tp单创单时间 features FeatureDO [] 建议废弃 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为shipper,attr_value为cn表示菜鸟发货； attr_key为 storeCode，attr_value为仓库信息； attr_key为 erpHold，attr_value为1表示强管控中， attr_value为2表示分单完成； └ attr_key String 123 属性键 └ attr_value String 111 属性值
remark	String	这是一条返回给前端的错误信息	错误说明
total_count	Number	25	采购单查询总数
opt_time	Date	2000-01-01 00:00:00	接口操作时间
result_code	String	SYSTEM_ERROR	接口返回错误码

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoYphOrdersGetRequest req = new FenxiaoYphOrdersGetRequest();
req.setTradeTypes(1L);
req.setPageSize(50L);
req.setPageNum(1L);
req.setUserRoleType(2L);
req.setBeginTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setChannelCodes(302L);
req.setOrderStatus(1L);
req.setRefundStatus(9L);
FenxiaoYphOrdersGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
FenxiaoYphOrdersGetRequest req = new FenxiaoYphOrdersGetRequest();
req.TradeTypes = 1L;
req.PageSize = 50L;
req.PageNum = 1L;
req.UserRoleType = 2L;
req.BeginTime = DateTime.Parse("2000-01-01 00:00:00");
req.EndTime = DateTime.Parse("2000-01-01 00:00:00");
req.ChannelCodes = 302L;
req.OrderStatus = 1L;
req.RefundStatus = 9L;
FenxiaoYphOrdersGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new FenxiaoYphOrdersGetRequest;
$req->setTradeTypes("1");
$req->setPageSize("50");
$req->setPageNum("1");
$req->setUserRoleType("2");
$req->setBeginTime("2000-01-01 00:00:00");
$req->setEndTime("2000-01-01 00:00:00");
$req->setChannelCodes("302");
$req->setOrderStatus("1");
$req->setRefundStatus("9");
$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.yph.orders.get' \
-d 'partner_id=apidoc' \
-d 'session=4911038e-a39b-4256-8142-f9dd496d1381' \
-d 'sign=8FC58DD2C13371548BC3929F08BD6966' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-14+11%3A24%3A46' \
-d 'v=2.0' \
-d 'begin_time=2000-01-01+00%3A00%3A00' \
-d 'channel_codes=302' \
-d 'end_time=2000-01-01+00%3A00%3A00' \
-d 'order_status=1' \
-d 'page_num=1' \
-d 'page_size=50' \
-d 'refund_status=9' \
-d 'trade_types=1' \
-d 'user_role_type=2'

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

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

req.trade_types=1
req.page_size=50
req.page_num=1
req.user_role_type=2
req.begin_time="2000-01-01 00:00:00"
req.end_time="2000-01-01 00:00:00"
req.channel_codes=302
req.order_status=1
req.refund_status=9
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.yph.orders.get");
add_param(pRequest,"trade_types","1");
add_param(pRequest,"page_size","50");
add_param(pRequest,"page_num","1");
add_param(pRequest,"user_role_type","2");
add_param(pRequest,"begin_time","2000-01-01 00:00:00");
add_param(pRequest,"end_time","2000-01-01 00:00:00");
add_param(pRequest,"channel_codes","302");
add_param(pRequest,"order_status","1");
add_param(pRequest,"refund_status","9");
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.yph.orders.get', {
	'trade_types':'1',
	'page_size':'50',
	'page_num':'1',
	'user_role_type':'2',
	'begin_time':'2000-01-01 00:00:00',
	'end_time':'2000-01-01 00:00:00',
	'channel_codes':'302',
	'order_status':'1',
	'refund_status':'9'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<fenxiao_yph_orders_get_response>
    <purchase_orders>
        <order_list>
            <alipay_no>null</alipay_no>
            <logistics_id>LP00167730231064-1</logistics_id>
            <pay_time>2000-01-01 00:00:00</pay_time>
            <memo>这是一条采购单留言</memo>
            <buyer_actual_pay_yuan>0.00</buyer_actual_pay_yuan>
            <pay_type>10000</pay_type>
            <consign_time>2000-01-01 00:00:00</consign_time>
            <shipping>2</shipping>
            <logistics_company_name>这是一家物流公司</logistics_company_name>
            <distributor_nick>商家测试帐号86</distributor_nick>
            <postage_yuan>0.00</postage_yuan>
            <supplier_memo>供应商备注</supplier_memo>
            <biz_order_id>38913818274736</biz_order_id>
            <sub_order_detail_yph_list>
                <sub_order_list>
                    <refund_fee>0</refund_fee>
                    <buyer_pay_price>1.00</buyer_pay_price>
                    <buy_num>1</buy_num>
                    <discount_fee_yuan>0.00</discount_fee_yuan>
                    <discount_fee>0</discount_fee>
                    <sub_tc_order_id>911465155210793700</sub_tc_order_id>
                    <sku_property_val>颜色分类：仅共享</sku_property_val>
                    <confirm_paid_fee>0</confirm_paid_fee>
                    <distributor_pay_price_yuan>0.00</distributor_pay_price_yuan>
                    <bill_fee>10</bill_fee>
                    <title>【测试，请不要拍】至清测试专用，勿动，请自重-多SKU-03</title>
                    <real_auction_id>613697976491</real_auction_id>
                    <refund_fee_yuan>0.00</refund_fee_yuan>
                    <real_auction_sku_id>4496911555141</real_auction_sku_id>
                    <sub_order_id>0</sub_order_id>
                    <price>0</price>
                    <tc_discount_fee>0</tc_discount_fee>
                    <confirm_paid_fee_yuan>0.00</confirm_paid_fee_yuan>
                    <buyer_pay_price_yuan>1.00</buyer_pay_price_yuan>
                    <promotion_type>0</promotion_type>
                    <distributor_price>0</distributor_price>
                    <sc_item_id>613702760269</sc_item_id>
                    <fenxiao_id>38913818274736</fenxiao_id>
                    <tc_adjust_fee>0</tc_adjust_fee>
                    <gmt_create>2000-01-01 00:00:00</gmt_create>
                    <auction_id>613694296654</auction_id>
                    <tc_preferential_type>聚划算</tc_preferential_type>
                    <auction_sku_id>4493468966531</auction_sku_id>
                    <bill_fee_yuan>1.00</bill_fee_yuan>
                    <auction_price>0.01</auction_price>
                    <price_yuan>0.00</price_yuan>
                    <order_200_status>TRADE_FINISHED</order_200_status>
                    <distributor_pay_price>0</distributor_pay_price>
                    <distributor_price_yuan>0.00</distributor_price_yuan>
                    <sub_order_status_code>DELIVERED</sub_order_status_code>
                    <sub_order_status>70</sub_order_status>
                    <refund_status>9</refund_status>
                    <refund_status_code>RF_STATUS_NO_REFUND</refund_status_code>
                    <auction_out_id>OUT100000</auction_out_id>
                    <secondary_supplier_id>1000000000012345</secondary_supplier_id>
                    <tp_create_time_price>9.00</tp_create_time_price>
                    <features>
                        <feature_d_o>
                            <attr_key>111</attr_key>
                            <attr_value>222</attr_value>
                        </feature_d_o>
                    </features>
                    <auction_out_sku_id>5555</auction_out_sku_id>
                </sub_order_list>
            </sub_order_detail_yph_list>
            <gmt_modified>2000-01-01 00:00:00</gmt_modified>
            <total_price>0</total_price>
            <tc_order_id>911465155210793700</tc_order_id>
            <order_status>6</order_status>
            <confirm_paid_fee>0</confirm_paid_fee>
            <distributor_pay_price_yuan>0.00</distributor_pay_price_yuan>
            <supplier_nick>商家测试帐号42</supplier_nick>
            <confirm_paid_fee_yuan>0.00</confirm_paid_fee_yuan>
            <trade_type>1</trade_type>
            <channel_code>302</channel_code>
            <buyer_actual_pay>0</buyer_actual_pay>
            <fenxiao_id>38913818274736</fenxiao_id>
            <gmt_create>2000-01-01 00:00:00</gmt_create>
            <postage>0</postage>
            <supplier_from_sys>1</supplier_from_sys>
            <distributor_from_sys>taobao</distributor_from_sys>
            <end_time>2000-01-01 00:00:00</end_time>
            <distributor_pay_price>0</distributor_pay_price>
            <total_price_yuan>0.00</total_price_yuan>
            <order_status_code>TRADE_FINISHED</order_status_code>
            <refund_status>9</refund_status>
            <refund_status_code>ORDER_RF_NO_REFUND</refund_status_code>
            <logis_type>菜鸟仓</logis_type>
            <logis_type_code>0</logis_type_code>
            <dp_buyer_detail>
                <area>余杭区</area>
                <address>收货地址</address>
                <mobile_phone>12345678910</mobile_phone>
                <post>610000</post>
                <city>杭州市</city>
                <phone>123456</phone>
                <full_name>收货人全名</full_name>
                <prov>浙江省</prov>
                <oaid>xxxxx</oaid>
            </dp_buyer_detail>
            <tp_create_time>1645414654000</tp_create_time>
            <features>
                <feature_d_o>
                    <attr_key>123</attr_key>
                    <attr_value>111</attr_value>
                </feature_d_o>
            </features>
        </order_list>
    </purchase_orders>
    <remark>这是一条返回给前端的错误信息</remark>
    <total_count>25</total_count>
    <opt_time>2000-01-01 00:00:00</opt_time>
    <result_code>SYSTEM_ERROR</result_code>
</fenxiao_yph_orders_get_response>

{
    "fenxiao_yph_orders_get_response":{
        "purchase_orders":{
            "order_list":[
                {
                    "alipay_no":"null",
                    "logistics_id":"LP00167730231064-1",
                    "pay_time":"2000-01-01 00:00:00\t",
                    "memo":"这是一条采购单留言",
                    "buyer_actual_pay_yuan":"0.00",
                    "pay_type":10000,
                    "consign_time":"2000-01-01 00:00:00\t",
                    "shipping":2,
                    "logistics_company_name":"这是一家物流公司",
                    "distributor_nick":"商家测试帐号86",
                    "postage_yuan":"0.00",
                    "supplier_memo":"供应商备注",
                    "biz_order_id":"38913818274736",
                    "sub_order_detail_yph_list":{
                        "sub_order_list":[
                            {
                                "refund_fee":0,
                                "buyer_pay_price":"1.00",
                                "buy_num":1,
                                "discount_fee_yuan":"0.00",
                                "discount_fee":0,
                                "sub_tc_order_id":911465155210793700,
                                "sku_property_val":"颜色分类：仅共享",
                                "confirm_paid_fee":0,
                                "distributor_pay_price_yuan":"0.00",
                                "bill_fee":10,
                                "title":"【测试，请不要拍】至清测试专用，勿动，请自重-多SKU-03",
                                "real_auction_id":613697976491,
                                "refund_fee_yuan":"0.00",
                                "real_auction_sku_id":4496911555141,
                                "sub_order_id":0,
                                "price":0,
                                "tc_discount_fee":0,
                                "confirm_paid_fee_yuan":"0.00",
                                "buyer_pay_price_yuan":"1.00",
                                "promotion_type":"0",
                                "distributor_price":0,
                                "sc_item_id":613702760269,
                                "fenxiao_id":38913818274736,
                                "tc_adjust_fee":0,
                                "gmt_create":"2000-01-01 00:00:00\t",
                                "auction_id":613694296654,
                                "tc_preferential_type":"聚划算",
                                "auction_sku_id":4493468966531,
                                "bill_fee_yuan":"1.00",
                                "auction_price":"0.01",
                                "price_yuan":"0.00",
                                "order_200_status":"TRADE_FINISHED",
                                "distributor_pay_price":0,
                                "distributor_price_yuan":"0.00",
                                "sub_order_status_code":"DELIVERED",
                                "sub_order_status":70,
                                "refund_status":9,
                                "refund_status_code":"RF_STATUS_NO_REFUND",
                                "auction_out_id":"OUT100000",
                                "secondary_supplier_id":1000000000012345,
                                "tp_create_time_price":"9.00",
                                "features":{
                                    "feature_d_o":[
                                        {
                                            "attr_key":"111",
                                            "attr_value":"222"
                                        }
                                    ]
                                },
                                "auction_out_sku_id":"5555"
                            }
                        ]
                    },
                    "gmt_modified":"2000-01-01 00:00:00\t",
                    "total_price":0,
                    "tc_order_id":911465155210793700,
                    "order_status":6,
                    "confirm_paid_fee":0,
                    "distributor_pay_price_yuan":"0.00",
                    "supplier_nick":"商家测试帐号42",
                    "confirm_paid_fee_yuan":"0.00",
                    "trade_type":1,
                    "channel_code":302,
                    "buyer_actual_pay":0,
                    "fenxiao_id":38913818274736,
                    "gmt_create":"2000-01-01 00:00:00",
                    "postage":0,
                    "supplier_from_sys":1,
                    "distributor_from_sys":"taobao",
                    "end_time":"2000-01-01 00:00:00",
                    "distributor_pay_price":0,
                    "total_price_yuan":"0.00",
                    "order_status_code":"TRADE_FINISHED",
                    "refund_status":9,
                    "refund_status_code":"ORDER_RF_NO_REFUND",
                    "logis_type":"菜鸟仓",
                    "logis_type_code":0,
                    "dp_buyer_detail":{
                        "area":"余杭区",
                        "address":"收货地址",
                        "mobile_phone":"12345678910",
                        "post":"610000",
                        "city":"杭州市",
                        "phone":"123456",
                        "full_name":"收货人全名",
                        "prov":"浙江省",
                        "oaid":"xxxxx"
                    },
                    "tp_create_time":"1645414654000",
                    "features":{
                        "feature_d_o":[
                            {
                                "attr_key":"123",
                                "attr_value":"111"
                            }
                        ]
                    }
                }
            ]
        },
        "remark":"这是一条返回给前端的错误信息",
        "total_count":25,
        "opt_time":"2000-01-01 00:00:00",
        "result_code":"SYSTEM_ERROR"
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

分销API

taobao.fenxiao.yph.orders.get (批量查询一盘货采购单信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈