淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
tenant_id	Number	必须	10000		租户id，蚂蚁固定值10000
purchase_order_dto_list	PurchaseOrderDTO []	必须		最大列表长度：999	po信息列表
└ no_contract_reason String 可选写下没有合同的原因没有合同的原因 └ biz_type String 可选 1 业务类型 └ supplier_id Number 必须 628 供应商id └ contract_type String 可选 PURCHASE 合同类型 └ effect_date_range_end Date 可选 2019-12-30 12:00:00 订单有效结束时间 └ description String 可选写这个单子是干嘛的订单描述 └ is_cheque_pay Boolean 可选 true 是否支票支付 └ demander_purchase_org_id Number 可选 2 需求方采购组织，蚂蚁线上是2，线下是1051 └ payee_bank_id Number 可选 1 银行账号ID └ is_delivery_detail Boolean 可选 false 是否按明细发货 └ effect_date_range_start Date 可选 2019-12-30 12:00:00 订单有效开始时间 purchase_order_item_dto_list PurchaseOrderItemDTO [] 必须订单行信息 └ biz_type String 可选 CMALL 业务类型 └ category_code String 可选 IA01 采购类目code └ modified_category_code String 可选 IA01 寻源修改的类目 └ category_use String 可选 default_code 采购用途code └ item_name String 必须测试物品名称 └ item_description String 可选测试物品描述 └ order_type String 必须 AMOUNT 开单方式 └ quantity String 必须 12 数量 └ tax_amount String 必须 1 含税金额 └ tax_rate String 必须 0.17 税率 └ tax_code String 可选税码 taxCode └ tax_code_desc String 可选 1 税码描述 └ tax_unit_price String 必须 111 含税单价 └ uom String 必须 1 单位 └ need_by_date_start Date 可选 2020-01-01 10:00:00 期望交付日期始 └ need_by_date_end Date 可选 2020-01-01 10:00:00 期望交付日期终 └ address_id Number 必须 999 收货地址 └ address_info String 必须 999 收货地址信息 └ receiver String 可选 56771 接收人员工编码 └ pr_type String 可选 PURCHASE PR类型 └ pr_number String 必须 PR752780 pr单号 └ demander String 可选 56771 实际需求方工号 └ pr_item_number String 必须 11679018 pr行id └ quotation_item_number String 可选 845304 报价单行编码 └ sr_number String 可选 674385 需求行id └ project_number String 可选 1 项目编号 └ product_id Number 可选 1 产品id └ sku_id Number 可选 1 商品skuid └ goods_quotation_id Number 可选 1 商品报价ID └ specification String 可选 {\"品牌\":\"玛祖铭立MATSU\",\"主材质\":\"实木\",\"家具适用场景\":\"休闲空间\",\"尺寸\":\"W1300 D500 SH380\",\"运输范围\":\"包含江浙沪、北京、广州、深圳一地的配送费，其他地区据实结算\",\"饰面材质\":\"实木\"} 规格属性 └ incoterm String 可选 1 国际贸易术语 └ address_ext String 可选 1 地址扩展信息 └ is_po_by_detail Boolean 可选 true 是否按照明细下单 structure_item StructureItemDto 可选结构化明细行，自动创建时有结构化报价的场景用，填充参数内部children，按明细下单必填 └ item_id String 可选 82638 业务Item Id mpnId/componentId/itemCode └ item_type String 可选 1 区分服务器/网络设备部件，用以按不同逻辑匹配价格 └ biz_id Number 可选 1 关联业务单据Id └ biz_type String 可选 /** * PR行 / PR_LINE("PR_LINE"), /* * PO行 / PO_LINE("PO_LINE"), /* * 发货行 / DO_LINE("DO_LINE"), /* * 接收行 / RCV_LINE("RCV_LINE"), /* * 报价行 / QUOTATION_LINE("QUOTATION_LINE") 关联业务单据type children Children [] 可选嵌套 └ item_type String 可选 1 1 └ item_id String 可选 1 1 └ item_level String 可选 1 1 properties Properties 可选拓展属性段 └ unit_price String 可选 1 1 └ item_type String 可选 1 1 └ amount String 可选 1 1 └ item_attr_value_list String 可选 1 1 └ quantity String 可选 1 1 └ product_id String 可选 1 1 └ extend_column_value_list String 可选 1 1 └ remark String 可选 1 1 └ item_name String 可选 1 1 └ is_ladder_price String 可选 1 1 └ currency String 可选 1 1 └ item_description String 可选 1 1 └ charge_unit String 可选 1 1 └ item_url String 可选 1 1 └ sku_id String 可选 1 1 └ source_value String 可选 1 唯一来源值 └ data_source String 可选 ANT_LUMOS 费用大类来源 └ source_id String 可选 20201215 费用大类唯一标识 └ tax_rate String 可选 0.12 费用大类的税率 └ charge_type String 可选 INCREASE 增减项 children SecondChildren [] 可选第二层 properties Properties 可选拓展属性段 └ source_value String 可选 1 1 └ sku_id String 可选 1 1 └ charge_unit String 可选 1 1 └ item_description String 可选 1 1 └ currency String 可选 1 1 └ is_ladder_price String 可选 1 1 └ item_name String 可选 1 1 └ remark String 可选 1 1 └ extend_column_value_list String 可选 1 1 └ item_url String 可选 1 1 └ quantity String 可选 1 1 └ product_id String 可选 1 1 └ item_attr_value_list String 可选 1 1 └ amount String 可选 1 1 └ item_type String 可选 1 1 └ unit_price String 可选 1 1 └ data_source String 可选 1 商品明细唯来源标识 └ source_id String 可选 20201215 商品明细唯一标识 └ tax_rate String 可选 0.13 商品明细税率 └ charge_type String 可选 INCREASE 增减项 └ item_level String 可选 1 11 └ item_id String 可选 1 1 └ item_type String 可选 1 1 └ biz_id String 可选 1 1 └ biz_type String 可选 1 1 properties Properties 可选拓展属性段 └ sku_id String 可选 10000123999 商品skuId └ item_url String 可选 %2Fic%2Fproduct%2FadminProductDetail.htm%3FsecurityId%3D352de2e8b82e247cdc901b36bc2a92 物品项地址 └ charge_unit String 可选人/天计价单位 └ item_description String 可选内容制作-互动界面制作 item描述/说明 └ currency String 可选 CNY 现币种 └ is_ladder_price String 可选 false 是否是阶梯价 └ item_name String 可选安装及运输-单趟运输 Item名称 └ remark String 可选搭建工人舞美2车4天，AV设备1车2天备注 └ extend_column_value_list String 可选 [{\"columnName\":\"天数\",\"operationCode\":\"multiply\",\"sort\":0,\"value\":\"2\"},{\"columnName\":\"增值税\",\"operationCode\":\"multiply\",\"sort\":1,\"value\":\"1.06\"}] 扩展列列表 └ product_id String 可选 1 产品id └ quantity String 可选 1 数量 └ item_attr_value_list String 可选帆帆帆帆明细商品规格属性，可保留属性和选中的属性值备用，也可为空 └ amount String 可选 5666 金额/小计 └ item_type String 可选 1 业务item type └ unit_price String 可选 2000 含税单价 └ source_value String 可选 1 来源唯一值 └ data_source String 可选 ANT_LUMOS 结构化总体来源 └ source_id String 可选 20201215 结构化总体唯一标识 └ tax_rate String 可选 0.11 结构化行的税率 └ charge_type String 可选 INCREASE 增减项 └ extra String 可选 PO行扩展字段 └ currency String 可选 CNY 币种 └ payee_id Number 可选 9202 收款方ID └ company_code String 可选 1059 公司编码 └ quotation_number String 可选 BJD10364128 报价单编号 └ amount String 可选 22333 订单金额 payment_plan_dto PaymentPlanDto 可选付款计划 └ payment_plan_item_dto_list String [] 可选付款计划行信息付款计划行信息 └ pay_on_percent String 可选 y获取n 是否按比例支付 └ payment_name String 可选 xxxx付款条款名称条款名称 └ payment_type String 可选 /* 货到付款 / PAY_AFTER_RECEIPT("PAY_AFTER_RECEIPT"), /* 阶段付款 / MILESTONE("MILESTONE"), /* 混合型 / MIX("MIX"), /* 无支付条款 */ NO_PAYMENT("NO_PAYMENT"); 条款类型 └ contract_number String 可选 A50202000051 合同编号 └ is_expire_remind Boolean 可选 false 是否到期提醒 └ is_cash_pay Boolean 可选 false 是否现金支付 └ buyer String 可选 56771 采购员工号 └ source_type String 可选 SOURCE_INQUIRY 来源类型，采购寻源询报价 └ quotation_approved_time Date 可选 2019-12-30 12:00:00 报价审批通过时间 files AecpFile [] 可选附件 └ id String 可选 null resourceId └ name String 可选 null 附件名称 └ url String 可选 null URL └ preview_url String 可选 null 预览URL uploader AliEmployee 可选上传人 └ work_no String 可选 null 工号 └ name String 可选 null 姓名 └ nick_name String 可选 null 花名 └ upload_time Date 可选 2019-12-30 12:00:00 上传时间 └ file_size Number 可选 1 附件大小 └ buyer_manager String 可选 1 采购经理工号 └ external_po_number String 可选 18890025 外部单号（可以用来做幂等） └ extra String 可选 null PO头扩展字段 └ is_settlement_po Boolean 可选 true 是否结算型PO internal_files AecpFile [] 可选供应商不可见附件 └ file_size Number 可选 1 附件大小 └ upload_time Date 可选 2019-12-30 12:00:00 上传时间 uploader AliEmployee 可选上传人 └ nick_name String 可选 null 花名 └ name String 可选 null 姓名 └ work_no String 可选 null 工号 └ preview_url String 可选 null 预览URL └ url String 可选 null URL └ name String 可选 null 附件名称 └ id String 可选 null resourceId └ internal_description String 可选 null 供应商不可见描述 └ ou_code String 可选 Z69 OU

名称	类型	示例值	描述
result	ActionResult	null	获取url的出参
└ success Boolean true 是否成功 └ error_code String null 错误码 contents PoCreateResultDto [] null 结果集 └ po_id Number 7899201 订单id └ po_number String PO5121745 订单编号 └ success Boolean true 操作状态 └ message String null 描述信息 └ error_msg String null 错误信息 └ error_level String null 错误级别

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaPurPoCreateRequest req = new AlibabaPurPoCreateRequest();
req.setTenantId(10000L);
List<AlibabaPurPoCreateRequest.PurchaseOrderDTO> list2 = new ArrayList<AlibabaPurPoCreateRequest.PurchaseOrderDTO>();
AlibabaPurPoCreateRequest.PurchaseOrderDTO obj3 = new AlibabaPurPoCreateRequest.PurchaseOrderDTO();
list2.add(obj3);
obj3.setNoContractReason("写下没有合同的原因");
obj3.setBizType("1");
obj3.setSupplierId(628L);
obj3.setContractType("PURCHASE");
obj3.setEffectDateRangeEnd(StringUtils.parseDateTime("2019-12-30 12:00:00"));
obj3.setDescription("写这个单子是干嘛的");
obj3.setIsChequePay(true);
obj3.setDemanderPurchaseOrgId(2L);
obj3.setPayeeBankId(1L);
obj3.setIsDeliveryDetail(false);
obj3.setEffectDateRangeStart(StringUtils.parseDateTime("2019-12-30 12:00:00"));
List<AlibabaPurPoCreateRequest.PurchaseOrderItemDTO> list6 = new ArrayList<AlibabaPurPoCreateRequest.PurchaseOrderItemDTO>();
AlibabaPurPoCreateRequest.PurchaseOrderItemDTO obj7 = new AlibabaPurPoCreateRequest.PurchaseOrderItemDTO();
list6.add(obj7);
obj7.setBizType("CMALL");
obj7.setCategoryCode("IA01");
obj7.setModifiedCategoryCode("IA01");
obj7.setCategoryUse("default_code");
obj7.setItemName("测试");
obj7.setItemDescription("测试");
obj7.setOrderType("AMOUNT");
obj7.setQuantity("12");
obj7.setTaxAmount("1");
obj7.setTaxRate("0.17");
obj7.setTaxCode("税码");
obj7.setTaxCodeDesc("1");
obj7.setTaxUnitPrice("111");
obj7.setUom("1");
obj7.setNeedByDateStart(StringUtils.parseDateTime("2020-01-01 10:00:00"));
obj7.setNeedByDateEnd(StringUtils.parseDateTime("2020-01-01 10:00:00"));
obj7.setAddressId(999L);
obj7.setAddressInfo("999");
obj7.setReceiver("56771");
obj7.setPrType("PURCHASE");
obj7.setPrNumber("PR752780");
obj7.setDemander("56771");
obj7.setPrItemNumber("11679018");
obj7.setQuotationItemNumber("845304");
obj7.setSrNumber("674385");
obj7.setProjectNumber("1");
obj7.setProductId(1L);
obj7.setSkuId(1L);
obj7.setGoodsQuotationId(1L);
obj7.setSpecification("{\\"品牌\\":\\"玛祖铭立MATSU\\",\\"主材质\\":\\"实木\\",\\"家具适用场景\\":\\"休闲空间\\",\\"尺寸\\":\\"W1300 D500 SH380\\",\\"运输范围\\":\\"包含江浙沪、北京、广州、深圳一地的配送费，其他地区据实结算\\",\\"饰面材质\\":\\"实木\\"}");
obj7.setIncoterm("1");
obj7.setAddressExt("1");
obj7.setIsPoByDetail(true);
AlibabaPurPoCreateRequest.StructureItemDto obj9 = new AlibabaPurPoCreateRequest.StructureItemDto();
obj9.setItemId("82638");
obj9.setItemType("1");
obj9.setBizId(1L);
obj9.setBizType("/**      * PR行      */     PR_LINE(\"PR_LINE\"),          /**      * PO行      */     PO_LINE(\"PO_LINE\"),      /**      * 发货行      */     DO_LINE(\"DO_LINE\"),     /**      * 接收行      */     RCV_LINE(\"RCV_LINE\"),     /**      * 报价行      */     QUOTATION_LINE(\"QUOTATION_LINE\")");
List<AlibabaPurPoCreateRequest.Children> list11 = new ArrayList<AlibabaPurPoCreateRequest.Children>();
AlibabaPurPoCreateRequest.Children obj12 = new AlibabaPurPoCreateRequest.Children();
list11.add(obj12);
obj12.setItemType("1");
obj12.setItemId("1");
obj12.setItemLevel("1");
AlibabaPurPoCreateRequest.Properties obj14 = new AlibabaPurPoCreateRequest.Properties();
obj14.setUnitPrice("1");
obj14.setItemType("1");
obj14.setAmount("1");
obj14.setItemAttrValueList("1");
obj14.setQuantity("1");
obj14.setProductId("1");
obj14.setExtendColumnValueList("1");
obj14.setRemark("1");
obj14.setItemName("1");
obj14.setIsLadderPrice("1");
obj14.setCurrency("1");
obj14.setItemDescription("1");
obj14.setChargeUnit("1");
obj14.setItemUrl("1");
obj14.setSkuId("1");
obj14.setSourceValue("1");
obj14.setDataSource("ANT_LUMOS");
obj14.setSourceId("20201215");
obj14.setTaxRate("0.12");
obj14.setChargeType("INCREASE");
list13.setProperties(obj14);
List<AlibabaPurPoCreateRequest.SecondChildren> list17 = new ArrayList<AlibabaPurPoCreateRequest.SecondChildren>();
AlibabaPurPoCreateRequest.SecondChildren obj18 = new AlibabaPurPoCreateRequest.SecondChildren();
list17.add(obj18);
AlibabaPurPoCreateRequest.Properties obj20 = new AlibabaPurPoCreateRequest.Properties();
obj20.setSourceValue("1");
obj20.setSkuId("1");
obj20.setChargeUnit("1");
obj20.setItemDescription("1");
obj20.setCurrency("1");
obj20.setIsLadderPrice("1");
obj20.setItemName("1");
obj20.setRemark("1");
obj20.setExtendColumnValueList("1");
obj20.setItemUrl("1");
obj20.setQuantity("1");
obj20.setProductId("1");
obj20.setItemAttrValueList("1");
obj20.setAmount("1");
obj20.setItemType("1");
obj20.setUnitPrice("1");
obj20.setDataSource("1");
obj20.setSourceId("20201215");
obj20.setTaxRate("0.13");
obj20.setChargeType("INCREASE");
list19.setProperties(obj20);
obj18.setItemLevel("1");
obj18.setItemId("1");
obj18.setItemType("1");
obj18.setBizId("1");
obj18.setBizType("1");
list15.setChildren(list17);
obj9.setChildren(list11);
AlibabaPurPoCreateRequest.Properties obj21 = new AlibabaPurPoCreateRequest.Properties();
obj21.setSkuId("10000123999");
obj21.setItemUrl("%2Fic%2Fproduct%2FadminProductDetail.htm%3FsecurityId%3D352de2e8b82e247cdc901b36bc2a92");
obj21.setChargeUnit("人/天");
obj21.setItemDescription("内容制作-互动界面制作");
obj21.setCurrency("CNY");
obj21.setIsLadderPrice("false");
obj21.setItemName("安装及运输-单趟运输");
obj21.setRemark("搭建工人舞美2车*4天，AV设备1车*2天");
obj21.setExtendColumnValueList("[{\\"columnName\\":\\"天数\\",\\"operationCode\\":\\"multiply\\",\\"sort\\":0,\\"value\\":\\"2\\"},{\\"columnName\\":\\"增值税\\",\\"operationCode\\":\\"multiply\\",\\"sort\\":1,\\"value\\":\\"1.06\\"}]");
obj21.setProductId("1");
obj21.setQuantity("1");
obj21.setItemAttrValueList("帆帆帆帆");
obj21.setAmount("5666");
obj21.setItemType("1");
obj21.setUnitPrice("2000");
obj21.setSourceValue("1");
obj21.setDataSource("ANT_LUMOS");
obj21.setSourceId("20201215");
obj21.setTaxRate("0.11");
obj21.setChargeType("INCREASE");
obj9.setProperties(obj21);
list8.setStructureItem(obj9);
obj7.setExtra("");
list4.setPurchaseOrderItemDtoList(list6);
obj3.setCurrency("CNY");
obj3.setPayeeId(9202L);
obj3.setCompanyCode("1059");
obj3.setQuotationNumber("BJD10364128");
obj3.setAmount("22333");
AlibabaPurPoCreateRequest.PaymentPlanDto obj23 = new AlibabaPurPoCreateRequest.PaymentPlanDto();
obj23.setPaymentPlanItemDtoList("付款计划行信息");
obj23.setPayOnPercent("y获取n");
obj23.setPaymentName("xxxx付款条款名称");
obj23.setPaymentType("/** 货到付款 */     PAY_AFTER_RECEIPT(\"PAY_AFTER_RECEIPT\"),     /** 阶段付款 */     MILESTONE(\"MILESTONE\"),     /** 混合型 */     MIX(\"MIX\"),     /** 无支付条款 */     NO_PAYMENT(\"NO_PAYMENT\");");
list22.setPaymentPlanDto(obj23);
obj3.setContractNumber("A50202000051");
obj3.setIsExpireRemind(false);
obj3.setIsCashPay(false);
obj3.setBuyer("56771");
obj3.setSourceType("SOURCE_INQUIRY");
obj3.setQuotationApprovedTime(StringUtils.parseDateTime("2019-12-30 12:00:00"));
List<AlibabaPurPoCreateRequest.AecpFile> list26 = new ArrayList<AlibabaPurPoCreateRequest.AecpFile>();
AlibabaPurPoCreateRequest.AecpFile obj27 = new AlibabaPurPoCreateRequest.AecpFile();
list26.add(obj27);
obj27.setId("null");
obj27.setName("null");
obj27.setUrl("null");
obj27.setPreviewUrl("null");
AlibabaPurPoCreateRequest.AliEmployee obj29 = new AlibabaPurPoCreateRequest.AliEmployee();
obj29.setWorkNo("null");
obj29.setName("null");
obj29.setNickName("null");
list28.setUploader(obj29);
obj27.setUploadTime(StringUtils.parseDateTime("2019-12-30 12:00:00"));
obj27.setFileSize(1L);
list24.setFiles(list26);
obj3.setBuyerManager("1");
obj3.setExternalPoNumber("18890025");
obj3.setExtra("null");
obj3.setIsSettlementPo(true);
List<AlibabaPurPoCreateRequest.AecpFile> list32 = new ArrayList<AlibabaPurPoCreateRequest.AecpFile>();
AlibabaPurPoCreateRequest.AecpFile obj33 = new AlibabaPurPoCreateRequest.AecpFile();
list32.add(obj33);
obj33.setFileSize(1L);
obj33.setUploadTime(StringUtils.parseDateTime("2019-12-30 12:00:00"));
AlibabaPurPoCreateRequest.AliEmployee obj35 = new AlibabaPurPoCreateRequest.AliEmployee();
obj35.setNickName("null");
obj35.setName("null");
obj35.setWorkNo("null");
list34.setUploader(obj35);
obj33.setPreviewUrl("null");
obj33.setUrl("null");
obj33.setName("null");
obj33.setId("null");
list30.setInternalFiles(list32);
obj3.setInternalDescription("null");
obj3.setOuCode("Z69");
req.setPurchaseOrderDtoList(list2);
AlibabaPurPoCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaPurPoCreateRequest req = new AlibabaPurPoCreateRequest();
req.TenantId = 10000L;
List<AlibabaPurPoCreateRequest.PurchaseOrderDTODomain> list2 = new List<AlibabaPurPoCreateRequest.PurchaseOrderDTODomain>();
AlibabaPurPoCreateRequest.PurchaseOrderDTODomain obj3 = new AlibabaPurPoCreateRequest.PurchaseOrderDTODomain();
list2.Add(obj3);
obj3.NoContractReason = "写下没有合同的原因";
obj3.BizType = "1";
obj3.SupplierId = 628L;
obj3.ContractType = "PURCHASE";
obj3.EffectDateRangeEnd = DateTime.Parse(2019-12-30 12:00:00");
obj3.Description = "写这个单子是干嘛的";
obj3.IsChequePay = true;
obj3.DemanderPurchaseOrgId = 2L;
obj3.PayeeBankId = 1L;
obj3.IsDeliveryDetail = false;
obj3.EffectDateRangeStart = DateTime.Parse(2019-12-30 12:00:00");
List<AlibabaPurPoCreateRequest.PurchaseOrderItemDTODomain> list5 = new List<AlibabaPurPoCreateRequest.PurchaseOrderItemDTODomain>();
AlibabaPurPoCreateRequest.PurchaseOrderItemDTODomain obj6 = new AlibabaPurPoCreateRequest.PurchaseOrderItemDTODomain();
list5.Add(obj6);
obj6.BizType = "CMALL";
obj6.CategoryCode = "IA01";
obj6.ModifiedCategoryCode = "IA01";
obj6.CategoryUse = "default_code";
obj6.ItemName = "测试";
obj6.ItemDescription = "测试";
obj6.OrderType = "AMOUNT";
obj6.Quantity = "12";
obj6.TaxAmount = "1";
obj6.TaxRate = "0.17";
obj6.TaxCode = "税码";
obj6.TaxCodeDesc = "1";
obj6.TaxUnitPrice = "111";
obj6.Uom = "1";
obj6.NeedByDateStart = DateTime.Parse(2020-01-01 10:00:00");
obj6.NeedByDateEnd = DateTime.Parse(2020-01-01 10:00:00");
obj6.AddressId = 999L;
obj6.AddressInfo = "999";
obj6.Receiver = "56771";
obj6.PrType = "PURCHASE";
obj6.PrNumber = "PR752780";
obj6.Demander = "56771";
obj6.PrItemNumber = "11679018";
obj6.QuotationItemNumber = "845304";
obj6.SrNumber = "674385";
obj6.ProjectNumber = "1";
obj6.ProductId = 1L;
obj6.SkuId = 1L;
obj6.GoodsQuotationId = 1L;
obj6.Specification = "{\\"品牌\\":\\"玛祖铭立MATSU\\",\\"主材质\\":\\"实木\\",\\"家具适用场景\\":\\"休闲空间\\",\\"尺寸\\":\\"W1300 D500 SH380\\",\\"运输范围\\":\\"包含江浙沪、北京、广州、深圳一地的配送费，其他地区据实结算\\",\\"饰面材质\\":\\"实木\\"}";
obj6.Incoterm = "1";
obj6.AddressExt = "1";
obj6.IsPoByDetail = true;
AlibabaPurPoCreateRequest.StructureItemDtoDomain obj7 = new AlibabaPurPoCreateRequest.StructureItemDtoDomain();
obj7.ItemId = "82638";
obj7.ItemType = "1";
obj7.BizId = 1L;
obj7.BizType = "/**      * PR行      */     PR_LINE(\"PR_LINE\"),          /**      * PO行      */     PO_LINE(\"PO_LINE\"),      /**      * 发货行      */     DO_LINE(\"DO_LINE\"),     /**      * 接收行      */     RCV_LINE(\"RCV_LINE\"),     /**      * 报价行      */     QUOTATION_LINE(\"QUOTATION_LINE\")";
List<AlibabaPurPoCreateRequest.ChildrenDomain> list9 = new List<AlibabaPurPoCreateRequest.ChildrenDomain>();
AlibabaPurPoCreateRequest.ChildrenDomain obj10 = new AlibabaPurPoCreateRequest.ChildrenDomain();
list9.Add(obj10);
obj10.ItemType = "1";
obj10.ItemId = "1";
obj10.ItemLevel = "1";
AlibabaPurPoCreateRequest.PropertiesDomain obj11 = new AlibabaPurPoCreateRequest.PropertiesDomain();
obj11.UnitPrice = "1";
obj11.ItemType = "1";
obj11.Amount = "1";
obj11.ItemAttrValueList = "1";
obj11.Quantity = "1";
obj11.ProductId = "1";
obj11.ExtendColumnValueList = "1";
obj11.Remark = "1";
obj11.ItemName = "1";
obj11.IsLadderPrice = "1";
obj11.Currency = "1";
obj11.ItemDescription = "1";
obj11.ChargeUnit = "1";
obj11.ItemUrl = "1";
obj11.SkuId = "1";
obj11.SourceValue = "1";
obj11.DataSource = "ANT_LUMOS";
obj11.SourceId = "20201215";
obj11.TaxRate = "0.12";
obj11.ChargeType = "INCREASE";
obj10.Properties= obj11;
List<AlibabaPurPoCreateRequest.SecondChildrenDomain> list13 = new List<AlibabaPurPoCreateRequest.SecondChildrenDomain>();
AlibabaPurPoCreateRequest.SecondChildrenDomain obj14 = new AlibabaPurPoCreateRequest.SecondChildrenDomain();
list13.Add(obj14);
AlibabaPurPoCreateRequest.PropertiesDomain obj15 = new AlibabaPurPoCreateRequest.PropertiesDomain();
obj15.SourceValue = "1";
obj15.SkuId = "1";
obj15.ChargeUnit = "1";
obj15.ItemDescription = "1";
obj15.Currency = "1";
obj15.IsLadderPrice = "1";
obj15.ItemName = "1";
obj15.Remark = "1";
obj15.ExtendColumnValueList = "1";
obj15.ItemUrl = "1";
obj15.Quantity = "1";
obj15.ProductId = "1";
obj15.ItemAttrValueList = "1";
obj15.Amount = "1";
obj15.ItemType = "1";
obj15.UnitPrice = "1";
obj15.DataSource = "1";
obj15.SourceId = "20201215";
obj15.TaxRate = "0.13";
obj15.ChargeType = "INCREASE";
obj14.Properties= obj15;
obj14.ItemLevel = "1";
obj14.ItemId = "1";
obj14.ItemType = "1";
obj14.BizId = "1";
obj14.BizType = "1";
obj10.Children= list13;
obj7.Children= list9;
AlibabaPurPoCreateRequest.PropertiesDomain obj16 = new AlibabaPurPoCreateRequest.PropertiesDomain();
obj16.SkuId = "10000123999";
obj16.ItemUrl = "%2Fic%2Fproduct%2FadminProductDetail.htm%3FsecurityId%3D352de2e8b82e247cdc901b36bc2a92";
obj16.ChargeUnit = "人/天";
obj16.ItemDescription = "内容制作-互动界面制作";
obj16.Currency = "CNY";
obj16.IsLadderPrice = "false";
obj16.ItemName = "安装及运输-单趟运输";
obj16.Remark = "搭建工人舞美2车*4天，AV设备1车*2天";
obj16.ExtendColumnValueList = "[{\\"columnName\\":\\"天数\\",\\"operationCode\\":\\"multiply\\",\\"sort\\":0,\\"value\\":\\"2\\"},{\\"columnName\\":\\"增值税\\",\\"operationCode\\":\\"multiply\\",\\"sort\\":1,\\"value\\":\\"1.06\\"}]";
obj16.ProductId = "1";
obj16.Quantity = "1";
obj16.ItemAttrValueList = "帆帆帆帆";
obj16.Amount = "5666";
obj16.ItemType = "1";
obj16.UnitPrice = "2000";
obj16.SourceValue = "1";
obj16.DataSource = "ANT_LUMOS";
obj16.SourceId = "20201215";
obj16.TaxRate = "0.11";
obj16.ChargeType = "INCREASE";
obj7.Properties= obj16;
obj6.StructureItem= obj7;
obj6.Extra = "";
obj3.PurchaseOrderItemDtoList= list5;
obj3.Currency = "CNY";
obj3.PayeeId = 9202L;
obj3.CompanyCode = "1059";
obj3.QuotationNumber = "BJD10364128";
obj3.Amount = "22333";
AlibabaPurPoCreateRequest.PaymentPlanDtoDomain obj17 = new AlibabaPurPoCreateRequest.PaymentPlanDtoDomain();
obj17.PaymentPlanItemDtoList = "付款计划行信息";
obj17.PayOnPercent = "y获取n";
obj17.PaymentName = "xxxx付款条款名称";
obj17.PaymentType = "/** 货到付款 */     PAY_AFTER_RECEIPT(\"PAY_AFTER_RECEIPT\"),     /** 阶段付款 */     MILESTONE(\"MILESTONE\"),     /** 混合型 */     MIX(\"MIX\"),     /** 无支付条款 */     NO_PAYMENT(\"NO_PAYMENT\");";
obj3.PaymentPlanDto= obj17;
obj3.ContractNumber = "A50202000051";
obj3.IsExpireRemind = false;
obj3.IsCashPay = false;
obj3.Buyer = "56771";
obj3.SourceType = "SOURCE_INQUIRY";
obj3.QuotationApprovedTime = DateTime.Parse(2019-12-30 12:00:00");
List<AlibabaPurPoCreateRequest.AecpFileDomain> list19 = new List<AlibabaPurPoCreateRequest.AecpFileDomain>();
AlibabaPurPoCreateRequest.AecpFileDomain obj20 = new AlibabaPurPoCreateRequest.AecpFileDomain();
list19.Add(obj20);
obj20.Id = "null";
obj20.Name = "null";
obj20.Url = "null";
obj20.PreviewUrl = "null";
AlibabaPurPoCreateRequest.AliEmployeeDomain obj21 = new AlibabaPurPoCreateRequest.AliEmployeeDomain();
obj21.WorkNo = "null";
obj21.Name = "null";
obj21.NickName = "null";
obj20.Uploader= obj21;
obj20.UploadTime = DateTime.Parse(2019-12-30 12:00:00");
obj20.FileSize = 1L;
obj3.Files= list19;
obj3.BuyerManager = "1";
obj3.ExternalPoNumber = "18890025";
obj3.Extra = "null";
obj3.IsSettlementPo = true;
List<AlibabaPurPoCreateRequest.AecpFileDomain> list23 = new List<AlibabaPurPoCreateRequest.AecpFileDomain>();
AlibabaPurPoCreateRequest.AecpFileDomain obj24 = new AlibabaPurPoCreateRequest.AecpFileDomain();
list23.Add(obj24);
obj24.FileSize = 1L;
obj24.UploadTime = DateTime.Parse(2019-12-30 12:00:00");
AlibabaPurPoCreateRequest.AliEmployeeDomain obj25 = new AlibabaPurPoCreateRequest.AliEmployeeDomain();
obj25.NickName = "null";
obj25.Name = "null";
obj25.WorkNo = "null";
obj24.Uploader= obj25;
obj24.PreviewUrl = "null";
obj24.Url = "null";
obj24.Name = "null";
obj24.Id = "null";
obj3.InternalFiles= list23;
obj3.InternalDescription = "null";
obj3.OuCode = "Z69";
req.PurchaseOrderDtoList_ = list2;
AlibabaPurPoCreateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaPurPoCreateRequest;
$req->setTenantId("10000");
$purchase_order_dto_list = new PurchaseOrderDTO;
$purchase_order_dto_list->no_contract_reason="写下没有合同的原因";
$purchase_order_dto_list->biz_type="1";
$purchase_order_dto_list->supplier_id="628";
$purchase_order_dto_list->contract_type="PURCHASE";
$purchase_order_dto_list->effect_date_range_end="2019-12-30 12:00:00";
$purchase_order_dto_list->description="写这个单子是干嘛的";
$purchase_order_dto_list->is_cheque_pay="true";
$purchase_order_dto_list->demander_purchase_org_id="2";
$purchase_order_dto_list->payee_bank_id="1";
$purchase_order_dto_list->is_delivery_detail="false";
$purchase_order_dto_list->effect_date_range_start="2019-12-30 12:00:00";
$purchase_order_item_dto_list = new PurchaseOrderItemDTO;
$purchase_order_item_dto_list->biz_type="CMALL";
$purchase_order_item_dto_list->category_code="IA01";
$purchase_order_item_dto_list->modified_category_code="IA01";
$purchase_order_item_dto_list->category_use="default_code";
$purchase_order_item_dto_list->item_name="测试";
$purchase_order_item_dto_list->item_description="测试";
$purchase_order_item_dto_list->order_type="AMOUNT";
$purchase_order_item_dto_list->quantity="12";
$purchase_order_item_dto_list->tax_amount="1";
$purchase_order_item_dto_list->tax_rate="0.17";
$purchase_order_item_dto_list->tax_code="税码";
$purchase_order_item_dto_list->tax_code_desc="1";
$purchase_order_item_dto_list->tax_unit_price="111";
$purchase_order_item_dto_list->uom="1";
$purchase_order_item_dto_list->need_by_date_start="2020-01-01 10:00:00";
$purchase_order_item_dto_list->need_by_date_end="2020-01-01 10:00:00";
$purchase_order_item_dto_list->address_id="999";
$purchase_order_item_dto_list->address_info="999";
$purchase_order_item_dto_list->receiver="56771";
$purchase_order_item_dto_list->pr_type="PURCHASE";
$purchase_order_item_dto_list->pr_number="PR752780";
$purchase_order_item_dto_list->demander="56771";
$purchase_order_item_dto_list->pr_item_number="11679018";
$purchase_order_item_dto_list->quotation_item_number="845304";
$purchase_order_item_dto_list->sr_number="674385";
$purchase_order_item_dto_list->project_number="1";
$purchase_order_item_dto_list->product_id="1";
$purchase_order_item_dto_list->sku_id="1";
$purchase_order_item_dto_list->goods_quotation_id="1";
$purchase_order_item_dto_list->specification="{\\"品牌\\":\\"玛祖铭立MATSU\\",\\"主材质\\":\\"实木\\",\\"家具适用场景\\":\\"休闲空间\\",\\"尺寸\\":\\"W1300 D500 SH380\\",\\"运输范围\\":\\"包含江浙沪、北京、广州、深圳一地的配送费，其他地区据实结算\\",\\"饰面材质\\":\\"实木\\"}";
$purchase_order_item_dto_list->incoterm="1";
$purchase_order_item_dto_list->address_ext="1";
$purchase_order_item_dto_list->is_po_by_detail="true";
$structure_item = new StructureItemDto;
$structure_item->item_id="82638";
$structure_item->item_type="1";
$structure_item->biz_id="1";
$structure_item->biz_type="/**      * PR行      */     PR_LINE(\"PR_LINE\"),          /**      * PO行      */     PO_LINE(\"PO_LINE\"),      /**      * 发货行      */     DO_LINE(\"DO_LINE\"),     /**      * 接收行      */     RCV_LINE(\"RCV_LINE\"),     /**      * 报价行      */     QUOTATION_LINE(\"QUOTATION_LINE\")";
$children = new Children;
$children->item_type="1";
$children->item_id="1";
$children->item_level="1";
$properties = new Properties;
$properties->unit_price="1";
$properties->item_type="1";
$properties->amount="1";
$properties->item_attr_value_list="1";
$properties->quantity="1";
$properties->product_id="1";
$properties->extend_column_value_list="1";
$properties->remark="1";
$properties->item_name="1";
$properties->is_ladder_price="1";
$properties->currency="1";
$properties->item_description="1";
$properties->charge_unit="1";
$properties->item_url="1";
$properties->sku_id="1";
$properties->source_value="1";
$properties->data_source="ANT_LUMOS";
$properties->source_id="20201215";
$properties->tax_rate="0.12";
$properties->charge_type="INCREASE";
$children->properties = $properties;
$children = new SecondChildren;
$properties = new Properties;
$properties->source_value="1";
$properties->sku_id="1";
$properties->charge_unit="1";
$properties->item_description="1";
$properties->currency="1";
$properties->is_ladder_price="1";
$properties->item_name="1";
$properties->remark="1";
$properties->extend_column_value_list="1";
$properties->item_url="1";
$properties->quantity="1";
$properties->product_id="1";
$properties->item_attr_value_list="1";
$properties->amount="1";
$properties->item_type="1";
$properties->unit_price="1";
$properties->data_source="1";
$properties->source_id="20201215";
$properties->tax_rate="0.13";
$properties->charge_type="INCREASE";
$children->properties = $properties;
$children->item_level="1";
$children->item_id="1";
$children->item_type="1";
$children->biz_id="1";
$children->biz_type="1";
$children->children = $children;
$structure_item->children = $children;
$properties = new Properties;
$properties->sku_id="10000123999";
$properties->item_url="%2Fic%2Fproduct%2FadminProductDetail.htm%3FsecurityId%3D352de2e8b82e247cdc901b36bc2a92";
$properties->charge_unit="人/天";
$properties->item_description="内容制作-互动界面制作";
$properties->currency="CNY";
$properties->is_ladder_price="false";
$properties->item_name="安装及运输-单趟运输";
$properties->remark="搭建工人舞美2车*4天，AV设备1车*2天";
$properties->extend_column_value_list="[{\\"columnName\\":\\"天数\\",\\"operationCode\\":\\"multiply\\",\\"sort\\":0,\\"value\\":\\"2\\"},{\\"columnName\\":\\"增值税\\",\\"operationCode\\":\\"multiply\\",\\"sort\\":1,\\"value\\":\\"1.06\\"}]";
$properties->product_id="1";
$properties->quantity="1";
$properties->item_attr_value_list="帆帆帆帆";
$properties->amount="5666";
$properties->item_type="1";
$properties->unit_price="2000";
$properties->source_value="1";
$properties->data_source="ANT_LUMOS";
$properties->source_id="20201215";
$properties->tax_rate="0.11";
$properties->charge_type="INCREASE";
$structure_item->properties = $properties;
$purchase_order_item_dto_list->structure_item = $structure_item;
$purchase_order_item_dto_list->extra="";
$purchase_order_dto_list->purchase_order_item_dto_list = $purchase_order_item_dto_list;
$purchase_order_dto_list->currency="CNY";
$purchase_order_dto_list->payee_id="9202";
$purchase_order_dto_list->company_code="1059";
$purchase_order_dto_list->quotation_number="BJD10364128";
$purchase_order_dto_list->amount="22333";
$payment_plan_dto = new PaymentPlanDto;
$payment_plan_dto->payment_plan_item_dto_list="付款计划行信息";
$payment_plan_dto->pay_on_percent="y获取n";
$payment_plan_dto->payment_name="xxxx付款条款名称";
$payment_plan_dto->payment_type="/** 货到付款 */     PAY_AFTER_RECEIPT(\"PAY_AFTER_RECEIPT\"),     /** 阶段付款 */     MILESTONE(\"MILESTONE\"),     /** 混合型 */     MIX(\"MIX\"),     /** 无支付条款 */     NO_PAYMENT(\"NO_PAYMENT\");";
$purchase_order_dto_list->payment_plan_dto = $payment_plan_dto;
$purchase_order_dto_list->contract_number="A50202000051";
$purchase_order_dto_list->is_expire_remind="false";
$purchase_order_dto_list->is_cash_pay="false";
$purchase_order_dto_list->buyer="56771";
$purchase_order_dto_list->source_type="SOURCE_INQUIRY";
$purchase_order_dto_list->quotation_approved_time="2019-12-30 12:00:00";
$files = new AecpFile;
$files->id="null";
$files->name="null";
$files->url="null";
$files->preview_url="null";
$uploader = new AliEmployee;
$uploader->work_no="null";
$uploader->name="null";
$uploader->nick_name="null";
$files->uploader = $uploader;
$files->upload_time="2019-12-30 12:00:00";
$files->file_size="1";
$purchase_order_dto_list->files = $files;
$purchase_order_dto_list->buyer_manager="1";
$purchase_order_dto_list->external_po_number="18890025";
$purchase_order_dto_list->extra="null";
$purchase_order_dto_list->is_settlement_po="true";
$internal_files = new AecpFile;
$internal_files->file_size="1";
$internal_files->upload_time="2019-12-30 12:00:00";
$uploader = new AliEmployee;
$uploader->nick_name="null";
$uploader->name="null";
$uploader->work_no="null";
$internal_files->uploader = $uploader;
$internal_files->preview_url="null";
$internal_files->url="null";
$internal_files->name="null";
$internal_files->id="null";
$purchase_order_dto_list->internal_files = $internal_files;
$purchase_order_dto_list->internal_description="null";
$purchase_order_dto_list->ou_code="Z69";
$req->setPurchaseOrderDtoList(json_encode($purchase_order_dto_list));
$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.create' \
-d 'partner_id=apidoc' \
-d 'sign=A414094B7BD02765C070C7DCDF1021D9' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-16+18%3A47%3A26' \
-d 'v=2.0' \
-d 'purchase_order_dto_list=null' \
-d 'tenant_id=10000'

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

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

req.tenant_id=10000
req.purchase_order_dto_list=""
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.create");
add_param(pRequest,"tenant_id","10000");
add_param(pRequest,"purchase_order_dto_list","数据结构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.create', {
	'tenant_id':'10000',
	'purchase_order_dto_list':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_pur_po_create_response>
    <result>
        <success>true</success>
        <error_code>null</error_code>
        <contents>
            <po_create_result_dto>
                <po_id>7899201</po_id>
                <po_number>PO5121745</po_number>
                <success>true</success>
                <message>null</message>
            </po_create_result_dto>
        </contents>
        <error_msg>null</error_msg>
        <error_level>null</error_level>
    </result>
</alibaba_pur_po_create_response>

{
    "alibaba_pur_po_create_response":{
        "result":{
            "success":true,
            "error_code":"null",
            "contents":{
                "po_create_result_dto":[
                    {
                        "po_id":7899201,
                        "po_number":"PO5121745",
                        "success":true,
                        "message":"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.pur.po.create (创建PO（新中台）)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ