文档中心 > API类目 > 信息平台-采购

qimen.alibaba.pur.mall.po.send.new (新版外部商家对接-PO信息推送)

新版外部商家对接-PO信息推送

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
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。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
po_id	Number	必须	123245		采购订单id
po_number	String	必须	PO123		采购订单编号
po_submitter_id	String	必须	12345		采购订单提交人id
company_name	String	必须	阿里巴巴（中国）有限公司		采购订单费用归属公司名称
po_item_list	PoItemList []	必须		最大列表长度：999	采购订单详情
└ po_item_id Number 必须 12345678 采购订单行id，后台主键 └ quantity String 必须 2 数量 └ unit_price String 必须 2.3 单价 └ amount String 必须 4.6 金额 └ currency String 必须 CNY 币种 └ receiver_name String 可选张三收货人 └ receiver_phone String 可选 13333333333 收货人电话 └ receive_address String 可选浙江省杭州市xx路xx号收货地址 └ source_product_id String 必须 111222 外部商家原始产品id └ source_sku_id String 必须 222333 外部商家原始skuid └ pr_item_id Number 必须 122 采购申请行id └ pr_number String 必须 PR123 采购申请单号 └ po_item_num Number 必须 1 采购订单行号，页面可见
company_tax_no	String	可选	913301XXXX655058B		公司税号
company_address	String	可选	杭州市西湖区西斗门路XXXX座		公司开票地址
company_telephone	String	可选	0571-850220XX		公司电话
company_bank	String	可选	招商银行XXXX行		公司开户银行
company_bank_account	String	可选	571905XXXXX0		公司银行账号

响应参数

名称	类型	示例值	描述
error_message	String	失败	失败信息详情
error_code	String	0001	失败信息代码
success	Boolean	true	是否成功

请求示例

{"po_submitter_id":"12345","po_number":"PO123","po_id":123245,"po_item_list":[{"amount":"4.6","quantity":"2","pr_item_id":122,"unit_price":"2.3","source_sku_id":"222333","po_item_id":12345678,"receiver_name":"张三","source_product_id":"111222","pr_number":"PR123","currency":"CNY","po_item_num":1,"receiver_phone":"13333333333","receive_address":"浙江省杭州市xx路xx号"}],"company_telephone":"0571-850220XX","company_tax_no":"913301XXXX655058B","company_bank_account":"571905XXXXX0","company_name":"阿里巴巴（中国）有限公司","company_bank":"招商银行XXXX行","company_address":"杭州市西湖区西斗门路XXXX座"}

响应示例

{
    "error_message":"失败",
    "error_code":"0001",
    "success":true
}

验签示例

{"error_message":"Illegal request","success":"false","error_code":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

信息平台-采购

qimen.alibaba.pur.mall.po.send.new (新版外部商家对接-PO信息推送)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ

用户导航

用户反馈

用户反馈

用户反馈