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

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
purchase_order_query_top_d_t_o	PurchaseOrderQueryTopDTO	可选			查询DTO
└ pr_item_number String 可选 null PR行的ID └ supplier_id Number 可选 628 供应商的ID └ sr_number String 可选 null 需求池行的ID └ po_create_date_end Date 可选 2019-11-23 17:00:00 订单创建时间结束 └ receiver String 可选 75193 接收人工号 └ po_view String 可选 ITEM_INCLUDED PO视图 └ po_create_date_start Date 可选 2019-11-22 10:25:02 订单创建时间开始 └ page_size Number 可选 10 每页显示数量 └ pr_number String 可选 PR598229 PR单号 └ buyer String 可选 75193 采购员工号 └ po_modified_date_start Date 可选 2019-11-22 10:25:02 订单修改时间开始 └ current_page Number 可选 1 当前页 └ po_modified_date_end Date 可选 2019-11-23 10:25:02 订单修改时间结束 └ po_number String 可选 PO123456 订单号 └ status String [] 可选订单状态 └ include_supplier_bank_account Boolean 可选 true 是否需要供应商账号信息

名称	类型	示例值	描述
content	PageDataDTO		分页对象
└ current_page Number 1 当前页 data_list PurchaseOrderTopOutDTO [] 采购订单对象 └ 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 是否按明细发货 └ demander_purchase_org_id Number 1050 需求方采购组织 └ description String 同步测试订单描述 └ effect_date_range_end Date 2015-09-23 订单有效期区间结束 └ effect_date_range_start Date 2015-09-23 订单有效期区间开始 └ 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 123 外部订单编号 └ files String null 附件 └ 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 已开票总金额 └ modifier String 38912 修改人 └ no_contract_reason String 2344 无合同理由 └ origin_currency String CNY 原始币种 └ ou_code String ID11 OU代码 └ paid_amount String 1000.000000 已付总金额 └ payee_bank_id Number 179613 收款方账户ID └ payee_id Number 948 收款方ID └ po_detail_link String https://procurement.alibaba-inc.com 订单详情链接 └ 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_id Number 628 供应商ID └ tenant_id Number 10000 租户ID └ to_paid_amount String y 已满足付款条件 └ total_amount String 1000.000000 订单总金额 supplier SupplierTopOutDTO 供应商信息 └ address String 杭州地址 └ country String 中国国家 └ id Number 628 供应商ID └ is_need_transit_bank String y 是否需要中转银行 └ name String 供应商A 供应商名称 └ supplier_code String 888 供应商编码 └ transit_bank_account String 7799 中转银行账户 └ transit_bank_state String 中国中转银行国家 └ transit_bank_swiftcode String 007 中转银行汇款代码 supplier_bank_accounts SupplierBankAccountTopOutDTO [] 供应商收款帐号列表 └ account String null 银行账户账号 └ account_name String null 银行账户名称 └ 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 银行国家 └ 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 null ID └ ifsc_code String null ifscCode └ in_land_bank_code String null 国内银行总行bankcode └ payment_purpose String null 支付目的 └ province String null 开户省 └ routing_no String null routingNo └ sort_code String null sortCode └ swift_code String null swiftCode item_list PurchaseOrderItemTopOutDTO [] 订单明细 └ address_ext String null 地址扩展信息 └ address_id Number null 收货地址ID └ address_info String null 收货地址信息 └ biz_type String null 业务类型 └ category_code String null 采购类目code └ category_name String null 采购类目名称 └ category_use String null 采购用途code └ category_use_name String null 采购用途名称 └ currency String null 币种 └ demander String null 需求方 └ exchange_rate String null 汇率 └ ext_json_string String null 扩展字段 └ goods_quotation_id Number null 商品报价ID └ id Number null 订单明细ID └ incoterm String null 国际贸易术语 └ item_description String null 物品描述 └ item_name String null 物品名称 └ line_num Number null 行号 └ need_by_date_end Date null 期望交付日期终 └ need_by_date_start Date null 期望交付日期始 └ order_type String null 购买方式 └ origin_tax_amount String null 原始含税金额 └ origin_tax_unit_price String null 原始含税单价 └ pr_item_number String null 采购申请单行编号 └ pr_number String null PR单编号 └ product_id Number null 产品ID └ project_number String null 项目编号 └ purchase_order_id Number null 订单ID └ quantity String null 数量 └ quotation_item_number String null 报价单行编码 └ receiver String null 接收人员工编码 └ receiver_name String null 接收人姓名 └ receiver_phone String null 接收人电话 └ sku_id Number null 产品SKU的ID └ specification String null 规格属性 └ sr_number String null 需求表单号 └ status String null 状态 └ tax_amount String null 含税金额 └ tax_code String null 税码 └ tax_code_desc String null 税码描述 └ tax_rate String null 税率 └ tax_unit_price String null 含税单价 └ uom String null 单位 finance_distribution_d_t_o_list FinanceDistributionTopDTO [] 预算分配（包括财务段值） └ id Number null 预发分配ID └ biz_id Number null 业务ID └ biz_type String null 业务类型 └ allocation_amount String null 金额 └ allocation_quantity String null 数量 └ unit_price String null 单价 └ total_amount String null 总金额 └ total_quantity String null 总数量 └ allocation_value String null 分配额 └ item_description String null 描述 └ parent_distribution_id Number null 父分配行ID └ acct_ccid Number null 财务组合ID └ source_id Number null 来源id └ currency_code String null 币种 └ distribution_value_list String null 财务分配值列表 └ accounting_map String null 财务科目map └ quantity_received String null 接收已使用 └ received String null 已接收金额 payment_plan_top_out_d_t_o PaymentPlanTopOutDTO 付款计划 └ pay_on_percent String y 是否按比例支付 └ payment_name String 货到付款条款名称 └ payment_type String PAY_AFTER_RECEIPT 条款类型 payment_plan_item_top_out_dto_list PaymentPlanItemTopOutDTO [] 付款计划行信息 └ item_digest_cn String null 本条款的摘要信息(中文) └ item_digest_en String null 本条款的摘要信息(英文) └ need_invoice String null 是否有票 └ pay_apply_date Date null 付款申请日期 └ pay_ref_type String null 付款参照类型 └ pay_term Number null 付款期限 └ pay_term_type String null 付款期限类型 └ payment_amount String null 付款金额 └ payment_percent String null 付款比例 └ phase Number null 阶段 └ terms String null 条款内容 └ item_type String null 条款行类型 po_billable_info_dto PoBillableInfoDto 开票信息 billable_info_details BillableInfoDetailDto [] 明细信息集合 └ billable_no String KP123 开票号 └ billable_type String PREPAY 开票类型 └ org_id Number null ouId └ org_name String 蚂蚁国内支付宝网络有限公司 ou名称 └ tax_rate BigDecimal 3 税率（百分比） └ amount BigDecimal 100 开票金额 └ entry_amount BigDecimal 20 可录入发票金额 └ billable_desc String 该发票仅用于测试使用开票说明 └ currency_code String CNY 币种 └ invoice_type String SPECIAL 开票类型 tax_info_dto TaxInfoDto 税务信息 └ org_id Number 123456 orgId └ invoice_title String 蚂蚁国内支付宝网络有限公司发票抬头 └ tax_no String 123456 公司税号 └ bank_name String 中国银行开户行名称 └ account_no String 123456 开户行账号 └ type String GENERAL 性质 └ type_desc String 一般纳税人性质描述 └ effective_date Date 2015-05-01 生效时间 └ address String 杭州注册地址 └ phone_no String 123456 电话 └ status_desc String null 状态 └ scan_time Date null 扫描时间 └ precision Number null 精度 └ invoice_no String null 发票号 └ is_current_buyer Boolean true isCurrentBuyer └ is_abroad Boolean false isAbroad receive_info_dto ReceiveInfoDto receiveInfo 收件信息 └ receive String 蚂蚁集团收件人 └ telephone String 0571-123456 电话 └ postcode String 311121 邮编 └ address String 浙江省杭州市地址 └ ou_id String null OU ID └ company_name String null 公司名称 └ total_count Number null 总数量
error_msg	String	null	错误信息
error_level	Number	null	错误级别

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAntPurPoGetRequest req = new AlibabaAntPurPoGetRequest();
AlibabaAntPurPoGetRequest.PurchaseOrderQueryTopDTO obj1 = new AlibabaAntPurPoGetRequest.PurchaseOrderQueryTopDTO();
obj1.setPrItemNumber("null");
obj1.setSupplierId(628L);
obj1.setSrNumber("null");
obj1.setPoCreateDateEnd(StringUtils.parseDateTime("2019-11-23 17:00:00"));
obj1.setReceiver("75193");
obj1.setPoView("ITEM_INCLUDED");
obj1.setPoCreateDateStart(StringUtils.parseDateTime("2019-11-22 10:25:02"));
obj1.setPageSize(10L);
obj1.setPrNumber("PR598229");
obj1.setBuyer("75193");
obj1.setPoModifiedDateStart(StringUtils.parseDateTime("2019-11-22 10:25:02"));
obj1.setCurrentPage(1L);
obj1.setPoModifiedDateEnd(StringUtils.parseDateTime("2019-11-23 10:25:02"));
obj1.setPoNumber("PO123456");
obj1.setStatus("");
obj1.setIncludeSupplierBankAccount(true);
req.setPurchaseOrderQueryTopDTO(obj1);
AlibabaAntPurPoGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAntPurPoGetRequest req = new AlibabaAntPurPoGetRequest();
AlibabaAntPurPoGetRequest.PurchaseOrderQueryTopDTODomain obj1 = new AlibabaAntPurPoGetRequest.PurchaseOrderQueryTopDTODomain();
obj1.PrItemNumber = "null";
obj1.SupplierId = 628L;
obj1.SrNumber = "null";
obj1.PoCreateDateEnd = DateTime.Parse(2019-11-23 17:00:00");
obj1.Receiver = "75193";
obj1.PoView = "ITEM_INCLUDED";
obj1.PoCreateDateStart = DateTime.Parse(2019-11-22 10:25:02");
obj1.PageSize = 10L;
obj1.PrNumber = "PR598229";
obj1.Buyer = "75193";
obj1.PoModifiedDateStart = DateTime.Parse(2019-11-22 10:25:02");
obj1.CurrentPage = 1L;
obj1.PoModifiedDateEnd = DateTime.Parse(2019-11-23 10:25:02");
obj1.PoNumber = "PO123456";
obj1.Status = "";
obj1.IncludeSupplierBankAccount = true;
req.PurchaseOrderQueryTopDTO_ = obj1;
AlibabaAntPurPoGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAntPurPoGetRequest;
$purchase_order_query_top_d_t_o = new PurchaseOrderQueryTopDTO;
$purchase_order_query_top_d_t_o->pr_item_number="null";
$purchase_order_query_top_d_t_o->supplier_id="628";
$purchase_order_query_top_d_t_o->sr_number="null";
$purchase_order_query_top_d_t_o->po_create_date_end="2019-11-23 17:00:00";
$purchase_order_query_top_d_t_o->receiver="75193";
$purchase_order_query_top_d_t_o->po_view="ITEM_INCLUDED";
$purchase_order_query_top_d_t_o->po_create_date_start="2019-11-22 10:25:02";
$purchase_order_query_top_d_t_o->page_size="10";
$purchase_order_query_top_d_t_o->pr_number="PR598229";
$purchase_order_query_top_d_t_o->buyer="75193";
$purchase_order_query_top_d_t_o->po_modified_date_start="2019-11-22 10:25:02";
$purchase_order_query_top_d_t_o->current_page="1";
$purchase_order_query_top_d_t_o->po_modified_date_end="2019-11-23 10:25:02";
$purchase_order_query_top_d_t_o->po_number="PO123456";
$purchase_order_query_top_d_t_o->status="";
$purchase_order_query_top_d_t_o->include_supplier_bank_account="true";
$req->setPurchaseOrderQueryTopDTO(json_encode($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.ant.pur.po.get' \
-d 'partner_id=apidoc' \
-d 'sign=B807BC35A1FFA110AC27CA55ADD8BA13' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-26+07%3A36%3A02' \
-d 'v=2.0' \
-d 'purchase_order_query_top_d_t_o=null'

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

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

req.purchase_order_query_top_d_t_o="数据结构示例JSON格式"
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.ant.pur.po.get");
add_param(pRequest,"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.ant.pur.po.get', {
	'purchase_order_query_top_d_t_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_ant_pur_po_get_response>
    <content>
        <current_page>1</current_page>
        <data_list>
            <purchase_order_top_out_d_t_o>
                <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>123</external_po_number>
                <files>null</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>
                <modifier>38912</modifier>
                <no_contract_reason>2344</no_contract_reason>
                <origin_currency>CNY</origin_currency>
                <ou_code>ID11</ou_code>
                <paid_amount>1000.000000</paid_amount>
                <payee_bank_id>179613</payee_bank_id>
                <payee_id>948</payee_id>
                <po_detail_link>https://procurement.alibaba-inc.com</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_id>628</supplier_id>
                <tenant_id>10000</tenant_id>
                <to_paid_amount>y</to_paid_amount>
                <total_amount>1000.000000</total_amount>
                <supplier>
                    <address>杭州</address>
                    <country>中国</country>
                    <id>628</id>
                    <is_need_transit_bank>y</is_need_transit_bank>
                    <name>供应商A</name>
                    <supplier_code>888</supplier_code>
                    <transit_bank_account>7799</transit_bank_account>
                    <transit_bank_state>中国</transit_bank_state>
                    <transit_bank_swiftcode>007</transit_bank_swiftcode>
                    <supplier_bank_accounts>
                        <supplier_bank_account_top_out_d_t_o>
                            <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>null</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_d_t_o>
                    </supplier_bank_accounts>
                </supplier>
                <item_list>
                    <purchase_order_item_top_out_d_t_o>
                        <address_ext>null</address_ext>
                        <address_id>null</address_id>
                        <address_info>null</address_info>
                        <biz_type>null</biz_type>
                        <category_code>null</category_code>
                        <category_name>null</category_name>
                        <category_use>null</category_use>
                        <category_use_name>null</category_use_name>
                        <currency>null</currency>
                        <demander>null</demander>
                        <exchange_rate>null</exchange_rate>
                        <ext_json_string>null</ext_json_string>
                        <goods_quotation_id>null</goods_quotation_id>
                        <id>null</id>
                        <incoterm>null</incoterm>
                        <item_description>null</item_description>
                        <item_name>null</item_name>
                        <line_num>null</line_num>
                        <need_by_date_end>null</need_by_date_end>
                        <need_by_date_start>null</need_by_date_start>
                        <order_type>null</order_type>
                        <origin_tax_amount>null</origin_tax_amount>
                        <origin_tax_unit_price>null</origin_tax_unit_price>
                        <pr_item_number>null</pr_item_number>
                        <pr_number>null</pr_number>
                        <product_id>null</product_id>
                        <project_number>null</project_number>
                        <purchase_order_id>null</purchase_order_id>
                        <quantity>null</quantity>
                        <quotation_item_number>null</quotation_item_number>
                        <receiver>null</receiver>
                        <receiver_name>null</receiver_name>
                        <receiver_phone>null</receiver_phone>
                        <sku_id>null</sku_id>
                        <specification>null</specification>
                        <sr_number>null</sr_number>
                        <status>null</status>
                        <tax_amount>null</tax_amount>
                        <tax_code>null</tax_code>
                        <tax_code_desc>null</tax_code_desc>
                        <tax_rate>null</tax_rate>
                        <tax_unit_price>null</tax_unit_price>
                        <uom>null</uom>
                        <finance_distribution_d_t_o_list>
                            <finance_distribution_top_d_t_o>
                                <id>null</id>
                                <biz_id>null</biz_id>
                                <biz_type>null</biz_type>
                                <allocation_amount>null</allocation_amount>
                                <allocation_quantity>null</allocation_quantity>
                                <unit_price>null</unit_price>
                                <total_amount>null</total_amount>
                                <total_quantity>null</total_quantity>
                                <allocation_value>null</allocation_value>
                                <item_description>null</item_description>
                                <parent_distribution_id>null</parent_distribution_id>
                                <acct_ccid>null</acct_ccid>
                                <source_id>null</source_id>
                                <currency_code>null</currency_code>
                                <distribution_value_list>null</distribution_value_list>
                                <accounting_map>null</accounting_map>
                            </finance_distribution_top_d_t_o>
                        </finance_distribution_d_t_o_list>
                        <quantity_received>null</quantity_received>
                        <received>null</received>
                    </purchase_order_item_top_out_d_t_o>
                </item_list>
                <payment_plan_top_out_d_t_o>
                    <pay_on_percent>y</pay_on_percent>
                    <payment_name>货到付款</payment_name>
                    <payment_type>PAY_AFTER_RECEIPT</payment_type>
                    <payment_plan_item_top_out_dto_list>
                        <payment_plan_item_top_out_d_t_o>
                            <item_digest_cn>null</item_digest_cn>
                            <item_digest_en>null</item_digest_en>
                            <need_invoice>null</need_invoice>
                            <pay_apply_date>null</pay_apply_date>
                            <pay_ref_type>null</pay_ref_type>
                            <pay_term>null</pay_term>
                            <pay_term_type>null</pay_term_type>
                            <payment_amount>null</payment_amount>
                            <payment_percent>null</payment_percent>
                            <phase>null</phase>
                            <terms>null</terms>
                            <item_type>null</item_type>
                        </payment_plan_item_top_out_d_t_o>
                    </payment_plan_item_top_out_dto_list>
                </payment_plan_top_out_d_t_o>
                <po_billable_info_dto>
                    <billable_info_details>
                        <billable_info_detail_dto>
                            <billable_no>KP123</billable_no>
                            <billable_type>PREPAY</billable_type>
                            <org_id>null</org_id>
                            <org_name>蚂蚁国内支付宝网络有限公司</org_name>
                            <tax_rate>3</tax_rate>
                            <amount>100</amount>
                            <entry_amount>20</entry_amount>
                            <billable_desc>该发票仅用于测试使用</billable_desc>
                            <currency_code>CNY</currency_code>
                            <invoice_type>SPECIAL</invoice_type>
                            <tax_info_dto>
                                <org_id>123456</org_id>
                                <invoice_title>蚂蚁国内支付宝网络有限公司</invoice_title>
                                <tax_no>123456</tax_no>
                                <bank_name>中国银行</bank_name>
                                <account_no>123456</account_no>
                                <type>GENERAL</type>
                                <type_desc>一般纳税人</type_desc>
                                <effective_date>2015-05-01</effective_date>
                                <address>杭州</address>
                                <phone_no>123456</phone_no>
                            </tax_info_dto>
                            <status_desc>null</status_desc>
                            <scan_time>null</scan_time>
                            <precision>null</precision>
                            <invoice_no>null</invoice_no>
                        </billable_info_detail_dto>
                    </billable_info_details>
                    <is_current_buyer>true</is_current_buyer>
                    <is_abroad>false</is_abroad>
                    <receive_info_dto>
                        <receive>蚂蚁集团</receive>
                        <telephone>0571-123456</telephone>
                        <postcode>311121</postcode>
                        <address>浙江省杭州市</address>
                    </receive_info_dto>
                </po_billable_info_dto>
                <ou_id>null</ou_id>
                <company_name>null</company_name>
            </purchase_order_top_out_d_t_o>
        </data_list>
        <total_count>null</total_count>
    </content>
    <error_msg>null</error_msg>
    <error_level>null</error_level>
</alibaba_ant_pur_po_get_response>

{
    "alibaba_ant_pur_po_get_response":{
        "content":{
            "current_page":1,
            "data_list":{
                "purchase_order_top_out_d_t_o":[
                    {
                        "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":"123",
                        "files":"null",
                        "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",
                        "modifier":"38912",
                        "no_contract_reason":"2344",
                        "origin_currency":"CNY",
                        "ou_code":"ID11",
                        "paid_amount":"1000.000000",
                        "payee_bank_id":179613,
                        "payee_id":948,
                        "po_detail_link":"https:\/\/procurement.alibaba-inc.com",
                        "po_number":"PO10075677",
                        "quotation_approved_time":"2019-11-05 15:12:25",
                        "quotation_number":"BJD10023393",
                        "source_type":"PR",
                        "status":"EFFECT",
                        "supplier_id":628,
                        "tenant_id":10000,
                        "to_paid_amount":"y",
                        "total_amount":"1000.000000",
                        "supplier":{
                            "address":"杭州",
                            "country":"中国",
                            "id":628,
                            "is_need_transit_bank":"y",
                            "name":"供应商A",
                            "supplier_code":"888",
                            "transit_bank_account":"7799",
                            "transit_bank_state":"中国",
                            "transit_bank_swiftcode":"007",
                            "supplier_bank_accounts":{
                                "supplier_bank_account_top_out_d_t_o":[
                                    {
                                        "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":null,
                                        "ifsc_code":"null",
                                        "in_land_bank_code":"null",
                                        "payment_purpose":"null",
                                        "province":"null",
                                        "routing_no":"null",
                                        "sort_code":"null",
                                        "swift_code":"null"
                                    }
                                ]
                            }
                        },
                        "item_list":{
                            "purchase_order_item_top_out_d_t_o":[
                                {
                                    "address_ext":"null",
                                    "address_id":null,
                                    "address_info":"null",
                                    "biz_type":"null",
                                    "category_code":"null",
                                    "category_name":"null",
                                    "category_use":"null",
                                    "category_use_name":"null",
                                    "currency":"null",
                                    "demander":"null",
                                    "exchange_rate":"null",
                                    "ext_json_string":"null",
                                    "goods_quotation_id":null,
                                    "id":null,
                                    "incoterm":"null",
                                    "item_description":"null",
                                    "item_name":"null",
                                    "line_num":null,
                                    "need_by_date_end":"null",
                                    "need_by_date_start":"null",
                                    "order_type":"null",
                                    "origin_tax_amount":"null",
                                    "origin_tax_unit_price":"null",
                                    "pr_item_number":"null",
                                    "pr_number":"null",
                                    "product_id":null,
                                    "project_number":"null",
                                    "purchase_order_id":null,
                                    "quantity":"null",
                                    "quotation_item_number":"null",
                                    "receiver":"null",
                                    "receiver_name":"null",
                                    "receiver_phone":"null",
                                    "sku_id":null,
                                    "specification":"null",
                                    "sr_number":"null",
                                    "status":"null",
                                    "tax_amount":"null",
                                    "tax_code":"null",
                                    "tax_code_desc":"null",
                                    "tax_rate":"null",
                                    "tax_unit_price":"null",
                                    "uom":"null",
                                    "finance_distribution_d_t_o_list":{
                                        "finance_distribution_top_d_t_o":[
                                            {
                                                "id":null,
                                                "biz_id":null,
                                                "biz_type":"null",
                                                "allocation_amount":"null",
                                                "allocation_quantity":"null",
                                                "unit_price":"null",
                                                "total_amount":"null",
                                                "total_quantity":"null",
                                                "allocation_value":"null",
                                                "item_description":"null",
                                                "parent_distribution_id":null,
                                                "acct_ccid":null,
                                                "source_id":null,
                                                "currency_code":"null",
                                                "distribution_value_list":"null",
                                                "accounting_map":"null"
                                            }
                                        ]
                                    },
                                    "quantity_received":"null",
                                    "received":"null"
                                }
                            ]
                        },
                        "payment_plan_top_out_d_t_o":{
                            "pay_on_percent":"y",
                            "payment_name":"货到付款",
                            "payment_type":"PAY_AFTER_RECEIPT",
                            "payment_plan_item_top_out_dto_list":{
                                "payment_plan_item_top_out_d_t_o":[
                                    {
                                        "item_digest_cn":"null",
                                        "item_digest_en":"null",
                                        "need_invoice":"null",
                                        "pay_apply_date":"null",
                                        "pay_ref_type":"null",
                                        "pay_term":null,
                                        "pay_term_type":"null",
                                        "payment_amount":"null",
                                        "payment_percent":"null",
                                        "phase":null,
                                        "terms":"null",
                                        "item_type":"null"
                                    }
                                ]
                            }
                        },
                        "po_billable_info_dto":{
                            "billable_info_details":{
                                "billable_info_detail_dto":[
                                    {
                                        "billable_no":"KP123",
                                        "billable_type":"PREPAY",
                                        "org_id":null,
                                        "org_name":"蚂蚁国内支付宝网络有限公司",
                                        "tax_rate":"3",
                                        "amount":"100",
                                        "entry_amount":"20",
                                        "billable_desc":"该发票仅用于测试使用",
                                        "currency_code":"CNY",
                                        "invoice_type":"SPECIAL",
                                        "tax_info_dto":{
                                            "org_id":123456,
                                            "invoice_title":"蚂蚁国内支付宝网络有限公司",
                                            "tax_no":"123456",
                                            "bank_name":"中国银行",
                                            "account_no":"123456",
                                            "type":"GENERAL",
                                            "type_desc":"一般纳税人",
                                            "effective_date":"2015-05-01",
                                            "address":"杭州",
                                            "phone_no":"123456"
                                        },
                                        "status_desc":"null",
                                        "scan_time":"null",
                                        "precision":null,
                                        "invoice_no":"null"
                                    }
                                ]
                            },
                            "is_current_buyer":true,
                            "is_abroad":false,
                            "receive_info_dto":{
                                "receive":"蚂蚁集团",
                                "telephone":"0571-123456",
                                "postcode":"311121",
                                "address":"浙江省杭州市"
                            }
                        },
                        "ou_id":"null",
                        "company_name":"null"
                    }
                ]
            },
            "total_count":null
        },
        "error_msg":"null",
        "error_level":null
    }
}

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下载

信息平台-采购

alibaba.ant.pur.po.get (PO查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈