淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_purchase_order_query_top_d_t_o	PurchaseOrderQueryTopDto	可选			查询dto
└ buyer String 可选 038912 采购员 └ current_page Number 可选 1 当前页 └ include_supplier_bank_account Boolean 可选 false 是否返回供应商银行账户信息 └ page_size Number 可选 100 每页数量 └ po_create_date_end Date 可选 2019-11-21 17:00:00 订单创建时间结束 └ po_create_date_start Date 可选 2019-11-22 10:25:02 订单创建时间开始 └ po_modified_date_end Date 可选 2019-11-21 17:00:00 订单修改时间结束 └ po_modified_date_start Date 可选 2019-11-22 10:25:02 订单修改时间开始 └ po_number String 可选 PO200002276 订单号 └ po_view String 可选 ITEM_INCLUDED 订单视图 └ pr_item_number String 可选 123123 采购申请单行编号（明细上） └ pr_number String 可选 123132 采购申请单号 └ receiver String 可选 038912 接收人 └ sr_number String 可选 13213 需求表单号（明细上） └ status String [] 可选 EFFECT 订单状态 └ supplier_id Number 可选 628 供应商ID └ need_structure_item Boolean 可选 true 是否展示结构化信息

名称	类型	示例值	描述
content	PageDataDto	null	分页对象
└ current_page Number 1 当前页 data_list PurchaseOrderTopOutDto [] null 采购订单对象 └ biz_type String CERES_INQUIRY 业务类型 └ buyer String 113267 采购员员工编码 └ buyer_dept_code String 40549 采购员部门 └ buyer_manager String 113267 采购经理员工编码 └ buyer_purchase_org_id Number 1050 采购员采购组织 └ cash_pay Boolean true 是否现金支付 └ cheque_pay Boolean false 是否支票支付 └ company_code String 290 业务公司 └ contract_number String A50201400468 合同编号 └ contract_type String PURCHASE 合同类型 └ creator String 38912 创建人 └ currency String CNY 币种 └ delivery_detail Boolean false isDeliveryDetail └ demander_purchase_org_id Number 1050 需求方采购组织 └ description String 同步测试订单描述 └ effect_date_range_end Date 2015-09-23 订单有效期区间_end └ effect_date_range_start Date 2015-09-23 订单有效期区间_start └ effect_time Date 2019-02-01 00:00:00 订单生效时间 └ email_status String SEND_SUCCESS 邮件发送状态 └ exchange_rate String 1.0000 汇率 └ expire_remind Boolean true 是否到期提醒 └ external_po_number String null 外部订单编号 └ files String ,043e2a59203b4136a5bded4a7526eeb4.txt, 附件 └ gmt_create Date 2017-07-26 09:45:17 创建时间 └ gmt_modified Date 2019-11-05 15:12:25 修改时间 └ has_electronic_sign Boolean true 是否已有电子章 └ id Number 45162031 订单ID └ invoiced_amount String 185.002020 已开票总金额 item_list PurchaseOrderItemTopOutDto [] [] 订单明细 └ address_ext String code/text 地址扩展信息 └ address_id Number 6540779 收货地址 └ address_info String 杭州阿里巴巴收货地址信息 └ biz_type String CMALL 业务类型 └ category_code String VB01 采购类目code └ category_name String null 采购类目 └ category_use String SHOOTING_OUT 采购用途code └ category_use_name String null 采购用途 └ currency String CNY 币种 └ demander String 27467 需求方 └ exchange_rate String 1.0000 汇率 └ ext_json_string String {"sourceValue":"123"} 扩展字段 └ goods_quotation_id Number 101010636 商品报价ID └ id Number 100179416 订单明细ID └ incoterm String FOB 国际贸易术语 └ item_description String UI自动化-订单-提交-一键生成 UI自动化-订单-提交-一键生成物品描述 └ item_name String UI自动化-订单-提交-一键生成物品名称 └ line_num Number 1 行号 └ need_by_date_end Date 2019-04-13 期望交付日期终 └ need_by_date_start Date 2019-04-25 期望交付日期始 └ order_type String AMOUNT 购买方式 └ origin_tax_amount String 1000.000000 原始含税金额 └ origin_tax_unit_price String 1.000000 原始含税单价 └ pr_item_number String 10469947 采购申请单行编号 └ pr_number String PR148170 PR单编号 └ product_id Number 337399 产品ID └ project_number String NB123456 项目编号 └ purchase_order_id Number 45162031 订单id └ quantity String 1000.000000 数量 └ quotation_item_number String 26304 报价单行编码 └ receiver String 38912 接收人员工编码 └ receiver_name String null 接收人姓名 └ receiver_phone String null 接收人电话 └ sku_id Number 100990 产品SKU的ID └ specification String 项目名称:采购中台;城市:杭州市;活动时间:20190101-20191231 规格属性 └ sr_number String 26354 需求表单号 └ status String CANCELLED 状态 └ tax_amount String 1000.000000 含税金额 └ tax_code String liyunlongtest3 税码 └ tax_code_desc String null 税码描述 └ tax_rate String 0.000000 税率 └ tax_unit_price String 1.000000 含税单价 └ uom String 元单位 finance_distribution_d_t_o_list FinanceDistributionTopDto [] null 预算分配（包括财务段值） └ id Number null id └ biz_id Number null bizId └ biz_type String 2 业务类型 └ allocation_amount String 1666 金额 └ allocation_quantity String 1000 数量 └ unit_price String 14 单价 └ total_amount String 12222 总金额 └ total_quantity String 111 总数量 └ allocation_value String 1111 分配额 └ item_description String 很好描述 └ parent_distribution_id Number 1 父分配行ID └ acct_ccid Number 1 财务组合ID └ source_id Number 1 来源id └ currency_code String cny 币种 └ distribution_value_list String null 财务分配值列表 └ accounting_map String null 财务科目map └ received String 1 已接收金额 └ quantity_received String 0 接收已使用金额 structure_item_top_out_d_t_o_list StructureItemTopOutDTO [] 结构化信息 └ id Number 123 存储主键id └ parent_id Number 123 父item主键id └ item_level Number 1 层级 └ root_id Number 123 根item主键id └ root String y 当前节点是否根节点 └ biz_id Number 1234 关联业务单据Id └ biz_type String PO 关联业务单据type └ properties String <"purchaseCategoryCode", "HA01"> 拓展属性段 └ from_structure_item_id Number 1234 来源明细id └ modifier String 38912 修改人 └ no_contract_reason String 2344 无合同理由 └ origin_currency String CNY 原始币种 └ ou_code String null OU代码 └ paid_amount String 1000.000000 paidAmount └ payee_bank_id Number 179613 收款方账户id └ payee_id Number 948 收款方ID payment_plan_top_out_d_t_o PaymentPlanTopOutDto null 付款计划 └ pay_on_percent String y 是否按比例支付 └ payment_name String 货到付款条款名称 payment_plan_item_top_out_dto_list PaymentPlanItemTopOutDto [] null 付款计划行信息 └ item_digest_cn String null 本条款的摘要信息(中文) └ item_digest_en String null 本条款的摘要信息(英文) └ item_type String POSTPAY_MONEY 条款行类型 └ need_invoice String y 是否有票 └ pay_apply_date Date 2019-09-30 付款申请日期 └ pay_ref_type String INVOICE_ARV_DATE 付款参照类型 └ pay_term Number 465 付款期限 └ pay_term_type String WORKING_DAY 付款期限类型 └ payment_amount String 1000.000000 付款金额 └ payment_percent String 20.000000 付款比例 └ phase Number 1 阶段 └ terms String 1111222 条款内容 └ payment_type String PAY_AFTER_RECEIPT 条款类型 └ po_detail_link String null 订单详情链接 └ po_number String PO10075677 订单编号 └ quotation_approved_time Date 2019-11-05 15:12:25 报价审批通过时间 └ quotation_number String BJD10023393 报价单号 └ source_type String PR 来源系统类型 └ status String EFFECT 订单状态 supplier SupplierTopOutDto 供应商信息 └ address String null 地址 └ country String null 国家 └ id Number 628 ID └ is_need_transit_bank String y 是否需要中转银行 └ name String 供应商A 供应商名称 supplier_bank_accounts SupplierBankAccountTopOutDto [] [] 供应商收款帐号列表 └ account String null 银行账户 └ account_name String null accountName └ bank_account_type String null 对公(COMPANY) 对私(PERSON) └ bank_address String null 开户行地址(IBAN)/香港开户银行分行代码(ACH) └ bank_branch_name String null 开户行名 └ bank_code String null 银行编码 └ bank_country String null bankCountry └ bank_name String null 银行总行名称 └ beneficiary_citizenship_status String null 收款户国籍 └ beneficiary_residency_status String null 收款户常驻状态 └ beneficiary_type String null 收款户类型 └ branch_code String null 分行编码 └ bsb_code String null bsbCode └ cnaps String null cnaps 银联号 └ district String null 开户市 └ iban_number String null ibanNumber └ id Number 12321 ID └ ifsc_code String null IFSC_CODE └ in_land_bank_code String null 国内银行总行bankcode └ payment_purpose String null 支付目的 └ province String null 开户省 └ routing_no String null routing number └ sort_code String null sortCode └ swift_code String null swift Code(swift number) └ supplier_code String null 供应商编码 └ transit_bank_account String null 中转银行账户 └ transit_bank_state String null 中转银行国家 └ transit_bank_swiftcode String null 中转银行BankSwiftcode └ supplier_id Number 628 供应商ID └ tenant_id Number 10000 租户ID └ to_paid_amount String y 已满足付款条件 └ total_amount String 1000.000000 订单总金额 └ total_count Number 10 数据总数
error_level	Number	1	错误等级

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaPurPoGetRequest req = new AlibabaPurPoGetRequest();
AlibabaPurPoGetRequest.PurchaseOrderQueryTopDto obj1 = new AlibabaPurPoGetRequest.PurchaseOrderQueryTopDto();
obj1.setBuyer("038912");
obj1.setCurrentPage(1L);
obj1.setIncludeSupplierBankAccount(false);
obj1.setPageSize(100L);
obj1.setPoCreateDateEnd(StringUtils.parseDateTime("2019-11-21 17:00:00"));
obj1.setPoCreateDateStart(StringUtils.parseDateTime("2019-11-22 10:25:02"));
obj1.setPoModifiedDateEnd(StringUtils.parseDateTime("2019-11-21 17:00:00"));
obj1.setPoModifiedDateStart(StringUtils.parseDateTime("2019-11-22 10:25:02"));
obj1.setPoNumber("PO200002276");
obj1.setPoView("ITEM_INCLUDED");
obj1.setPrItemNumber("123123");
obj1.setPrNumber("123132");
obj1.setReceiver("038912");
obj1.setSrNumber("13213");
obj1.setStatus("EFFECT");
obj1.setSupplierId(628L);
obj1.setNeedStructureItem(true);
req.setParamPurchaseOrderQueryTopDTO(obj1);
AlibabaPurPoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaPurPoGetRequest req = new AlibabaPurPoGetRequest();
AlibabaPurPoGetRequest.PurchaseOrderQueryTopDtoDomain obj1 = new AlibabaPurPoGetRequest.PurchaseOrderQueryTopDtoDomain();
obj1.Buyer = "038912";
obj1.CurrentPage = 1L;
obj1.IncludeSupplierBankAccount = false;
obj1.PageSize = 100L;
obj1.PoCreateDateEnd = DateTime.Parse(2019-11-21 17:00:00");
obj1.PoCreateDateStart = DateTime.Parse(2019-11-22 10:25:02");
obj1.PoModifiedDateEnd = DateTime.Parse(2019-11-21 17:00:00");
obj1.PoModifiedDateStart = DateTime.Parse(2019-11-22 10:25:02");
obj1.PoNumber = "PO200002276";
obj1.PoView = "ITEM_INCLUDED";
obj1.PrItemNumber = "123123";
obj1.PrNumber = "123132";
obj1.Receiver = "038912";
obj1.SrNumber = "13213";
obj1.Status = "EFFECT";
obj1.SupplierId = 628L;
obj1.NeedStructureItem = true;
req.ParamPurchaseOrderQueryTopDTO_ = obj1;
AlibabaPurPoGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaPurPoGetRequest;
$param_purchase_order_query_top_d_t_o = new PurchaseOrderQueryTopDto;
$param_purchase_order_query_top_d_t_o->buyer="038912";
$param_purchase_order_query_top_d_t_o->current_page="1";
$param_purchase_order_query_top_d_t_o->include_supplier_bank_account="false";
$param_purchase_order_query_top_d_t_o->page_size="100";
$param_purchase_order_query_top_d_t_o->po_create_date_end="2019-11-21 17:00:00";
$param_purchase_order_query_top_d_t_o->po_create_date_start="2019-11-22 10:25:02";
$param_purchase_order_query_top_d_t_o->po_modified_date_end="2019-11-21 17:00:00";
$param_purchase_order_query_top_d_t_o->po_modified_date_start="2019-11-22 10:25:02";
$param_purchase_order_query_top_d_t_o->po_number="PO200002276";
$param_purchase_order_query_top_d_t_o->po_view="ITEM_INCLUDED";
$param_purchase_order_query_top_d_t_o->pr_item_number="123123";
$param_purchase_order_query_top_d_t_o->pr_number="123132";
$param_purchase_order_query_top_d_t_o->receiver="038912";
$param_purchase_order_query_top_d_t_o->sr_number="13213";
$param_purchase_order_query_top_d_t_o->status="EFFECT";
$param_purchase_order_query_top_d_t_o->supplier_id="628";
$param_purchase_order_query_top_d_t_o->need_structure_item="true";
$req->setParamPurchaseOrderQueryTopDTO(json_encode($param_purchase_order_query_top_d_t_o));
$resp = $c->execute($req);

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=alibaba.pur.po.get' \
-d 'partner_id=apidoc' \
-d 'sign=3FDA4BFA896DED5352ED0B6CD8F5D6D9' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-16+17%3A43%3A36' \
-d 'v=2.0' \
-d 'param_purchase_order_query_top_d_t_o=null'

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

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

req.param_purchase_order_query_top_d_t_o=""
try:
	resp= req.getResponse()
	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,"alibaba.pur.po.get");
add_param(pRequest,"param_purchase_order_query_top_d_t_o","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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('alibaba.pur.po.get', {
	'param_purchase_order_query_top_d_t_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_pur_po_get_response>
    <content>
        <current_page>1</current_page>
        <data_list>
            <purchase_order_top_out_dto>
                <biz_type>CERES_INQUIRY</biz_type>
                <buyer>113267</buyer>
                <buyer_dept_code>40549</buyer_dept_code>
                <buyer_manager>113267</buyer_manager>
                <buyer_purchase_org_id>1050</buyer_purchase_org_id>
                <cash_pay>true</cash_pay>
                <cheque_pay>false</cheque_pay>
                <company_code>290</company_code>
                <contract_number>A50201400468</contract_number>
                <contract_type>PURCHASE</contract_type>
                <creator>38912</creator>
                <currency>CNY</currency>
                <delivery_detail>false</delivery_detail>
                <demander_purchase_org_id>1050</demander_purchase_org_id>
                <description>同步测试</description>
                <effect_date_range_end>2015-09-23</effect_date_range_end>
                <effect_date_range_start>2015-09-23</effect_date_range_start>
                <effect_time>2019-02-01 00:00:00</effect_time>
                <email_status>SEND_SUCCESS</email_status>
                <exchange_rate>1.0000</exchange_rate>
                <expire_remind>true</expire_remind>
                <external_po_number>null</external_po_number>
                <files>,043e2a59203b4136a5bded4a7526eeb4.txt,</files>
                <gmt_create>2017-07-26 09:45:17</gmt_create>
                <gmt_modified>2019-11-05 15:12:25</gmt_modified>
                <has_electronic_sign>true</has_electronic_sign>
                <id>45162031</id>
                <invoiced_amount>185.002020</invoiced_amount>
                <item_list>
                    <purchase_order_item_top_out_dto>
                        <address_ext>code/text</address_ext>
                        <address_id>6540779</address_id>
                        <address_info>杭州阿里巴巴</address_info>
                        <biz_type>CMALL</biz_type>
                        <category_code>VB01</category_code>
                        <category_name>null</category_name>
                        <category_use>SHOOTING_OUT</category_use>
                        <category_use_name>null</category_use_name>
                        <currency>CNY</currency>
                        <demander>27467</demander>
                        <exchange_rate>1.0000</exchange_rate>
                        <ext_json_string>{&quot;sourceValue&quot;:&quot;123&quot;}</ext_json_string>
                        <goods_quotation_id>101010636</goods_quotation_id>
                        <id>100179416</id>
                        <incoterm>FOB</incoterm>
                        <item_description>UI自动化-订单-提交-一键生成 UI自动化-订单-提交-一键生成</item_description>
                        <item_name>UI自动化-订单-提交-一键生成</item_name>
                        <line_num>1</line_num>
                        <need_by_date_end>2019-04-13</need_by_date_end>
                        <need_by_date_start>2019-04-25</need_by_date_start>
                        <order_type>AMOUNT</order_type>
                        <origin_tax_amount>1000.000000</origin_tax_amount>
                        <origin_tax_unit_price>1.000000</origin_tax_unit_price>
                        <pr_item_number>10469947</pr_item_number>
                        <pr_number>PR148170</pr_number>
                        <product_id>337399</product_id>
                        <project_number>NB123456</project_number>
                        <purchase_order_id>45162031</purchase_order_id>
                        <quantity>1000.000000</quantity>
                        <quotation_item_number>26304</quotation_item_number>
                        <receiver>38912</receiver>
                        <receiver_name>null</receiver_name>
                        <receiver_phone>null</receiver_phone>
                        <sku_id>100990</sku_id>
                        <specification>项目名称:采购中台;城市:杭州市;活动时间:20190101-20191231</specification>
                        <sr_number>26354</sr_number>
                        <status>CANCELLED</status>
                        <tax_amount>1000.000000</tax_amount>
                        <tax_code>liyunlongtest3</tax_code>
                        <tax_code_desc>null</tax_code_desc>
                        <tax_rate>0.000000</tax_rate>
                        <tax_unit_price>1.000000</tax_unit_price>
                        <uom>元</uom>
                        <finance_distribution_d_t_o_list>
                            <finance_distribution_top_dto>
                                <id>null</id>
                                <biz_id>null</biz_id>
                                <biz_type>2</biz_type>
                                <allocation_amount>1666</allocation_amount>
                                <allocation_quantity>1000</allocation_quantity>
                                <unit_price>14</unit_price>
                                <total_amount>12222</total_amount>
                                <total_quantity>111</total_quantity>
                                <allocation_value>1111</allocation_value>
                                <item_description>很好</item_description>
                                <parent_distribution_id>1</parent_distribution_id>
                                <acct_ccid>1</acct_ccid>
                                <source_id>1</source_id>
                                <currency_code>cny</currency_code>
                                <distribution_value_list>null</distribution_value_list>
                                <accounting_map>null</accounting_map>
                            </finance_distribution_top_dto>
                        </finance_distribution_d_t_o_list>
                        <received>1</received>
                        <quantity_received>0</quantity_received>
                        <structure_item_top_out_d_t_o_list>
                            <structure_item_top_out_d_t_o>
                                <id>123</id>
                                <parent_id>123</parent_id>
                                <item_level>1</item_level>
                                <root_id>123</root_id>
                                <root>y</root>
                                <biz_id>1234</biz_id>
                                <biz_type>PO</biz_type>
                                <properties>&lt;&quot;purchaseCategoryCode&quot;, &quot;HA01&quot;&gt;</properties>
                                <from_structure_item_id>1234</from_structure_item_id>
                            </structure_item_top_out_d_t_o>
                        </structure_item_top_out_d_t_o_list>
                    </purchase_order_item_top_out_dto>
                </item_list>
                <modifier>38912</modifier>
                <no_contract_reason>2344</no_contract_reason>
                <origin_currency>CNY</origin_currency>
                <ou_code>null</ou_code>
                <paid_amount>1000.000000</paid_amount>
                <payee_bank_id>179613</payee_bank_id>
                <payee_id>948</payee_id>
                <payment_plan_top_out_d_t_o>
                    <pay_on_percent>y</pay_on_percent>
                    <payment_name>货到付款</payment_name>
                    <payment_plan_item_top_out_dto_list>
                        <payment_plan_item_top_out_dto>
                            <item_digest_cn>null</item_digest_cn>
                            <item_digest_en>null</item_digest_en>
                            <item_type>POSTPAY_MONEY</item_type>
                            <need_invoice>y</need_invoice>
                            <pay_apply_date>2019-09-30</pay_apply_date>
                            <pay_ref_type>INVOICE_ARV_DATE</pay_ref_type>
                            <pay_term>465</pay_term>
                            <pay_term_type>WORKING_DAY</pay_term_type>
                            <payment_amount>1000.000000</payment_amount>
                            <payment_percent>20.000000</payment_percent>
                            <phase>1</phase>
                            <terms>1111222</terms>
                        </payment_plan_item_top_out_dto>
                    </payment_plan_item_top_out_dto_list>
                    <payment_type>PAY_AFTER_RECEIPT</payment_type>
                </payment_plan_top_out_d_t_o>
                <po_detail_link>null</po_detail_link>
                <po_number>PO10075677</po_number>
                <quotation_approved_time>2019-11-05 15:12:25</quotation_approved_time>
                <quotation_number>BJD10023393</quotation_number>
                <source_type>PR</source_type>
                <status>EFFECT</status>
                <supplier>
                    <address>null</address>
                    <country>null</country>
                    <id>628</id>
                    <is_need_transit_bank>y</is_need_transit_bank>
                    <name>供应商A</name>
                    <supplier_bank_accounts>
                        <supplier_bank_account_top_out_dto>
                            <account>null</account>
                            <account_name>null</account_name>
                            <bank_account_type>null</bank_account_type>
                            <bank_address>null</bank_address>
                            <bank_branch_name>null</bank_branch_name>
                            <bank_code>null</bank_code>
                            <bank_country>null</bank_country>
                            <bank_name>null</bank_name>
                            <beneficiary_citizenship_status>null</beneficiary_citizenship_status>
                            <beneficiary_residency_status>null</beneficiary_residency_status>
                            <beneficiary_type>null</beneficiary_type>
                            <branch_code>null</branch_code>
                            <bsb_code>null</bsb_code>
                            <cnaps>null</cnaps>
                            <district>null</district>
                            <iban_number>null</iban_number>
                            <id>12321</id>
                            <ifsc_code>null</ifsc_code>
                            <in_land_bank_code>null</in_land_bank_code>
                            <payment_purpose>null</payment_purpose>
                            <province>null</province>
                            <routing_no>null</routing_no>
                            <sort_code>null</sort_code>
                            <swift_code>null</swift_code>
                        </supplier_bank_account_top_out_dto>
                    </supplier_bank_accounts>
                    <supplier_code>null</supplier_code>
                    <transit_bank_account>null</transit_bank_account>
                    <transit_bank_state>null</transit_bank_state>
                    <transit_bank_swiftcode>null</transit_bank_swiftcode>
                </supplier>
                <supplier_id>628</supplier_id>
                <tenant_id>10000</tenant_id>
                <to_paid_amount>y</to_paid_amount>
                <total_amount>1000.000000</total_amount>
            </purchase_order_top_out_dto>
        </data_list>
        <total_count>10</total_count>
    </content>
    <error_level>1</error_level>
</alibaba_pur_po_get_response>

{
    "alibaba_pur_po_get_response":{
        "content":{
            "current_page":1,
            "data_list":{
                "purchase_order_top_out_dto":[
                    {
                        "biz_type":"CERES_INQUIRY",
                        "buyer":"113267",
                        "buyer_dept_code":"40549",
                        "buyer_manager":"113267",
                        "buyer_purchase_org_id":1050,
                        "cash_pay":true,
                        "cheque_pay":false,
                        "company_code":"290",
                        "contract_number":"A50201400468",
                        "contract_type":"PURCHASE",
                        "creator":"38912",
                        "currency":"CNY",
                        "delivery_detail":false,
                        "demander_purchase_org_id":1050,
                        "description":"同步测试",
                        "effect_date_range_end":"2015-09-23",
                        "effect_date_range_start":"2015-09-23",
                        "effect_time":"2019-02-01 00:00:00",
                        "email_status":"SEND_SUCCESS",
                        "exchange_rate":"1.0000",
                        "expire_remind":true,
                        "external_po_number":"null",
                        "files":",043e2a59203b4136a5bded4a7526eeb4.txt,",
                        "gmt_create":"2017-07-26 09:45:17",
                        "gmt_modified":"2019-11-05 15:12:25",
                        "has_electronic_sign":true,
                        "id":45162031,
                        "invoiced_amount":"185.002020",
                        "item_list":{
                            "purchase_order_item_top_out_dto":[
                                {
                                    "address_ext":"code\/text",
                                    "address_id":6540779,
                                    "address_info":"杭州阿里巴巴",
                                    "biz_type":"CMALL",
                                    "category_code":"VB01",
                                    "category_name":"null",
                                    "category_use":"SHOOTING_OUT",
                                    "category_use_name":"null",
                                    "currency":"CNY",
                                    "demander":"27467",
                                    "exchange_rate":"1.0000",
                                    "ext_json_string":"{\"sourceValue\":\"123\"}",
                                    "goods_quotation_id":101010636,
                                    "id":100179416,
                                    "incoterm":"FOB",
                                    "item_description":"UI自动化-订单-提交-一键生成 UI自动化-订单-提交-一键生成",
                                    "item_name":"UI自动化-订单-提交-一键生成",
                                    "line_num":1,
                                    "need_by_date_end":"2019-04-13",
                                    "need_by_date_start":"2019-04-25",
                                    "order_type":"AMOUNT",
                                    "origin_tax_amount":"1000.000000",
                                    "origin_tax_unit_price":"1.000000",
                                    "pr_item_number":"10469947",
                                    "pr_number":"PR148170",
                                    "product_id":337399,
                                    "project_number":"NB123456",
                                    "purchase_order_id":45162031,
                                    "quantity":"1000.000000",
                                    "quotation_item_number":"26304",
                                    "receiver":"38912",
                                    "receiver_name":"null",
                                    "receiver_phone":"null",
                                    "sku_id":100990,
                                    "specification":"项目名称:采购中台;城市:杭州市;活动时间:20190101-20191231",
                                    "sr_number":"26354",
                                    "status":"CANCELLED",
                                    "tax_amount":"1000.000000",
                                    "tax_code":"liyunlongtest3",
                                    "tax_code_desc":"null",
                                    "tax_rate":"0.000000",
                                    "tax_unit_price":"1.000000",
                                    "uom":"元",
                                    "finance_distribution_d_t_o_list":{
                                        "finance_distribution_top_dto":[
                                            {
                                                "id":null,
                                                "biz_id":null,
                                                "biz_type":"2",
                                                "allocation_amount":"1666",
                                                "allocation_quantity":"1000",
                                                "unit_price":"14",
                                                "total_amount":"12222",
                                                "total_quantity":"111",
                                                "allocation_value":"1111",
                                                "item_description":"很好",
                                                "parent_distribution_id":1,
                                                "acct_ccid":1,
                                                "source_id":1,
                                                "currency_code":"cny",
                                                "distribution_value_list":"null",
                                                "accounting_map":"null"
                                            }
                                        ]
                                    },
                                    "received":"1",
                                    "quantity_received":"0",
                                    "structure_item_top_out_d_t_o_list":{
                                        "structure_item_top_out_d_t_o":[
                                            {
                                                "id":123,
                                                "parent_id":123,
                                                "item_level":1,
                                                "root_id":123,
                                                "root":"y",
                                                "biz_id":1234,
                                                "biz_type":"PO",
                                                "properties":"<\"purchaseCategoryCode\", \"HA01\">",
                                                "from_structure_item_id":1234
                                            }
                                        ]
                                    }
                                }
                            ]
                        },
                        "modifier":"38912",
                        "no_contract_reason":"2344",
                        "origin_currency":"CNY",
                        "ou_code":"null",
                        "paid_amount":"1000.000000",
                        "payee_bank_id":179613,
                        "payee_id":948,
                        "payment_plan_top_out_d_t_o":{
                            "pay_on_percent":"y",
                            "payment_name":"货到付款",
                            "payment_plan_item_top_out_dto_list":{
                                "payment_plan_item_top_out_dto":[
                                    {
                                        "item_digest_cn":"null",
                                        "item_digest_en":"null",
                                        "item_type":"POSTPAY_MONEY",
                                        "need_invoice":"y",
                                        "pay_apply_date":"2019-09-30",
                                        "pay_ref_type":"INVOICE_ARV_DATE",
                                        "pay_term":465,
                                        "pay_term_type":"WORKING_DAY",
                                        "payment_amount":"1000.000000",
                                        "payment_percent":"20.000000",
                                        "phase":1,
                                        "terms":"1111222"
                                    }
                                ]
                            },
                            "payment_type":"PAY_AFTER_RECEIPT"
                        },
                        "po_detail_link":"null",
                        "po_number":"PO10075677",
                        "quotation_approved_time":"2019-11-05 15:12:25",
                        "quotation_number":"BJD10023393",
                        "source_type":"PR",
                        "status":"EFFECT",
                        "supplier":{
                            "address":"null",
                            "country":"null",
                            "id":628,
                            "is_need_transit_bank":"y",
                            "name":"供应商A",
                            "supplier_bank_accounts":{
                                "supplier_bank_account_top_out_dto":[
                                    {
                                        "account":"null",
                                        "account_name":"null",
                                        "bank_account_type":"null",
                                        "bank_address":"null",
                                        "bank_branch_name":"null",
                                        "bank_code":"null",
                                        "bank_country":"null",
                                        "bank_name":"null",
                                        "beneficiary_citizenship_status":"null",
                                        "beneficiary_residency_status":"null",
                                        "beneficiary_type":"null",
                                        "branch_code":"null",
                                        "bsb_code":"null",
                                        "cnaps":"null",
                                        "district":"null",
                                        "iban_number":"null",
                                        "id":12321,
                                        "ifsc_code":"null",
                                        "in_land_bank_code":"null",
                                        "payment_purpose":"null",
                                        "province":"null",
                                        "routing_no":"null",
                                        "sort_code":"null",
                                        "swift_code":"null"
                                    }
                                ]
                            },
                            "supplier_code":"null",
                            "transit_bank_account":"null",
                            "transit_bank_state":"null",
                            "transit_bank_swiftcode":"null"
                        },
                        "supplier_id":628,
                        "tenant_id":10000,
                        "to_paid_amount":"y",
                        "total_amount":"1000.000000"
                    }
                ]
            },
            "total_count":10
        },
        "error_level":1
    }
}

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.trade-service-unavailable	查询采购订单异常	联系接口负责人处理

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

开放平台

信息平台-采购

alibaba.pur.po.get (查询采购订单)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ