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

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
po_number	String	必须	PO35048033		PO编号

名称	类型	示例值	描述
result	PoResultDto		返回结果
└ account String 591902896910604 开户账号 attachments FileDto [] 附件 └ file_download_url String null 附件下载地址 └ file_name String null 附件名称 └ bank_account_name String zpptest 收款户名 └ bank_branch_name String 招商银行福州分行白马支行开户行名称 └ billed_amount String 0 已开票总金额 company OuDto 费用公司信息 └ code String T50 费用公司编码 └ id Number 127 费用公司id └ name String 淘宝(中国)软件有限公司费用公司名称 └ complement_code_list String [] 主合同关联的补充协议列表 └ contract_code String A50201500166 合同号 └ contract_order_end_date Date null 合同订单截止日期 contract_order_files FileDto [] 合同订单附件 └ file_download_url String null 合同订单附件下载地址 └ file_name String null 合同订单附件名称 └ contract_order_start_date Date null 合同订单开始日期 └ currency_code String CNY 币种 └ description String 1 描述 └ no_contract_reason String null 无合同理由 └ payee_name String 蒋彦霞测试用公司-私人专用收款方名称 └ payment_amount String 0 已付总金额 po_lines PoLineResultDto [] 订单行信息 └ amount String 800 行金额 └ category_name String 外包采购-技术服务外包-无线开发采购类别名称 └ currency_code String CNY 币种 └ item_name String 岗位测试物品名称 └ line_type String 按金额开单方式：按金额/按数量 └ mpn_id Number null 对于非ATO PO，这个字段为空 └ po_line_num Number 1 行号 └ quantity String 800 可执行数量 └ quantity_received String 800 已接收数量/金额(按开单方式区分) └ quantity_un_received String 0 未接收数量/金额 └ tax_rate String null 税率 └ unit_price String null 含税单价 └ po_number String PO35048033 订单编号 └ project_number String null 项目编号 └ quotation_number String null 报价单号 └ requisition_number String PR230674 申请单号 └ status String 已生效状态 supplier SupplierDto 供应商信息 └ supplier_code String SU012812 供应商编号 └ supplier_id Number 2788 供应商ID └ supplier_name String 蒋彦霞测试用公司-私人专用供应商名称 └ virtual_pr_number String null 虚拟PR单号 └ status_code String EFFECT 状态编码 └ con_tract_id Number 123 合同id └ available_quantity String 123 可用总金额

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaInfopCeresPoQueryRequest req = new AlibabaInfopCeresPoQueryRequest();
req.setPoNumber("PO35048033");
AlibabaInfopCeresPoQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaInfopCeresPoQueryRequest req = new AlibabaInfopCeresPoQueryRequest();
req.PoNumber = "PO35048033";
AlibabaInfopCeresPoQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaInfopCeresPoQueryRequest;
$req->setPoNumber("PO35048033");
$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.infop.ceres.po.query' \
-d 'partner_id=apidoc' \
-d 'sign=054F66EFF182B092C182FA8035FE191F' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-26+07%3A36%3A00' \
-d 'v=2.0' \
-d 'po_number=PO35048033'

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

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

req.po_number="PO35048033"
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.infop.ceres.po.query");
add_param(pRequest,"po_number","PO35048033");
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.infop.ceres.po.query', {
	'po_number':'PO35048033'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_infop_ceres_po_query_response>
    <result>
        <account>591902896910604</account>
        <attachments>
            <file_dto>
                <file_download_url>null</file_download_url>
                <file_name>null</file_name>
            </file_dto>
        </attachments>
        <bank_account_name>zpptest</bank_account_name>
        <bank_branch_name>招商银行福州分行白马支行</bank_branch_name>
        <billed_amount>0</billed_amount>
        <company>
            <code>T50</code>
            <id>127</id>
            <name>淘宝(中国)软件有限公司</name>
        </company>
        <complement_code_list>
            <string></string>
        </complement_code_list>
        <contract_code>A50201500166</contract_code>
        <contract_order_end_date>null</contract_order_end_date>
        <contract_order_files>
            <file_dto>
                <file_download_url>null</file_download_url>
                <file_name>null</file_name>
            </file_dto>
        </contract_order_files>
        <contract_order_start_date>null</contract_order_start_date>
        <currency_code>CNY</currency_code>
        <description>1</description>
        <no_contract_reason>null</no_contract_reason>
        <payee_name>蒋彦霞测试用公司-私人专用</payee_name>
        <payment_amount>0</payment_amount>
        <po_lines>
            <po_line_result_dto>
                <amount>800</amount>
                <category_name>外包采购-技术服务外包-无线开发</category_name>
                <currency_code>CNY</currency_code>
                <item_name>岗位测试</item_name>
                <line_type>按金额</line_type>
                <mpn_id>null</mpn_id>
                <po_line_num>1</po_line_num>
                <quantity>800</quantity>
                <quantity_received>800</quantity_received>
                <quantity_un_received>0</quantity_un_received>
                <tax_rate>null</tax_rate>
                <unit_price>null</unit_price>
            </po_line_result_dto>
        </po_lines>
        <po_number>PO35048033</po_number>
        <project_number>null</project_number>
        <quotation_number>null</quotation_number>
        <requisition_number>PR230674</requisition_number>
        <status>已生效</status>
        <supplier>
            <supplier_code>SU012812</supplier_code>
            <supplier_id>2788</supplier_id>
            <supplier_name>蒋彦霞测试用公司-私人专用</supplier_name>
        </supplier>
        <virtual_pr_number>null</virtual_pr_number>
        <status_code>EFFECT</status_code>
        <con_tract_id>123</con_tract_id>
        <available_quantity>123</available_quantity>
    </result>
</alibaba_infop_ceres_po_query_response>

{
    "alibaba_infop_ceres_po_query_response":{
        "result":{
            "account":"591902896910604",
            "attachments":{
                "file_dto":[
                    {
                        "file_download_url":"null",
                        "file_name":"null"
                    }
                ]
            },
            "bank_account_name":"zpptest",
            "bank_branch_name":"招商银行福州分行白马支行",
            "billed_amount":"0",
            "company":{
                "code":"T50",
                "id":127,
                "name":"淘宝(中国)软件有限公司"
            },
            "complement_code_list":{
                "string":[
                    ""
                ]
            },
            "contract_code":"A50201500166",
            "contract_order_end_date":"null",
            "contract_order_files":{
                "file_dto":[
                    {
                        "file_download_url":"null",
                        "file_name":"null"
                    }
                ]
            },
            "contract_order_start_date":"null",
            "currency_code":"CNY",
            "description":"1",
            "no_contract_reason":"null",
            "payee_name":"蒋彦霞测试用公司-私人专用",
            "payment_amount":"0",
            "po_lines":{
                "po_line_result_dto":[
                    {
                        "amount":"800",
                        "category_name":"外包采购-技术服务外包-无线开发",
                        "currency_code":"CNY",
                        "item_name":"岗位测试",
                        "line_type":"按金额",
                        "mpn_id":null,
                        "po_line_num":1,
                        "quantity":"800",
                        "quantity_received":"800",
                        "quantity_un_received":"0",
                        "tax_rate":"null",
                        "unit_price":"null"
                    }
                ]
            },
            "po_number":"PO35048033",
            "project_number":"null",
            "quotation_number":"null",
            "requisition_number":"PR230674",
            "status":"已生效",
            "supplier":{
                "supplier_code":"SU012812",
                "supplier_id":2788,
                "supplier_name":"蒋彦霞测试用公司-私人专用"
            },
            "virtual_pr_number":"null",
            "status_code":"EFFECT",
            "con_tract_id":123,
            "available_quantity":"123"
        }
    }
}

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.infop.ceres.po.query (查询订单信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈