淘宝开放平台

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

信息平台-采购

alibaba.infop.ceres.po.create (创建po接口)

多供创建po

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
po_info_dto PoInfoDto 可选 po信息
  • po_line_ext_dto_list
  • PoLineExtDTO []
  • 可选
  • po行信息
  • └ enable_category_changed
  • Boolean
  • 可选
  • false
  • 能否修改采购类目
  • └ can_modify_tax_rate
  • Boolean
  • 可选
  • false
  • 是否可以修改税率
  • └ is_select
  • String
  • 可选
  • n
  • 多供sku创建订单使用，y表示选中行,n表示未选中行
  • └ category_use_name
  • String
  • 可选
  • 1
  • 采购用途名称
  • └ can_modify
  • Boolean
  • 可选
  • false
  • 是否可修改
  • └ category_name
  • String
  • 可选
  • 1
  • PO行采购类别
  • └ receiving
  • Boolean
  • 可选
  • false
  • 是否接收过
  • location_list
  • LocationList []
  • 可选
  • 收货地址信息
  • └ receipt_name
  • String
  • 可选
  • 1
  • 接收人名称
  • po_line_location_d_t_o
  • PoLineLocationExtDto
  • 可选
  • 行地址信息
  • └ shipment_num
  • Number
  • 可选
  • 1
  • 1
  • └ actual_receiving_user_id
  • Number
  • 可选
  • 1
  • 1
  • └ need_by_date_end
  • Number
  • 可选
  • 1
  • 1
  • └ uom
  • String
  • 可选
  • 1
  • 1
  • └ quantity
  • Number
  • 可选
  • 1
  • 1
  • └ quantity_cancelled
  • Number
  • 可选
  • 1
  • 1
  • └ need_by_date
  • Number
  • 可选
  • 1
  • 1
  • └ asset_administrator
  • Number
  • 可选
  • 1
  • 1
  • └ receipt_user_id
  • Number
  • 可选
  • 1
  • 1
  • └ delivery_to_location_id
  • String
  • 可选
  • 1
  • 1
  • └ quantity_received
  • Number
  • 可选
  • 1
  • 1
  • └ org_id
  • Number
  • 可选
  • 1
  • 1
  • └ receipt_work_no
  • String
  • 可选
  • 1
  • 接收人
  • └ location_name
  • String
  • 可选
  • 1
  • 地址
  • └ asset_warehouse_type
  • String
  • 可选
  • 1
  • 是否资产
  • └ is_asset
  • String
  • 可选
  • 1
  • 是否资产
  • └ is_desensitized
  • Boolean
  • 可选
  • false
  • 是否需要脱敏
  • └ received_quantity
  • Number
  • 可选
  • 1
  • 已接收数量
  • └ is_rpo
  • Number
  • 可选
  • 0
  • 直接下单
  • └ is_structure_bom
  • Boolean
  • 可选
  • false
  • PO行是否属于结构化BOM
  • └ received_and_ing_quantity
  • Number
  • 可选
  • 1
  • 已接收（包含审批中的）数量
  • po_line_d_t_o
  • PoLineDto
  • 可选
  • 1
  • └ unit_price
  • Number
  • 可选
  • 1
  • 1
  • └ category_use
  • String
  • 可选
  • 1
  • 1
  • └ amount
  • String
  • 可选
  • 1
  • 1
  • └ quantity
  • String
  • 可选
  • 1
  • 1
  • └ category_code
  • String
  • 可选
  • 1
  • 1
  • └ org_id
  • Number
  • 可选
  • 1
  • 1
  • └ origin_unit_price
  • Number
  • 可选
  • 1
  • 1
  • └ origin_amount
  • String
  • 可选
  • 1
  • 1
  • └ tax_rate
  • String
  • 可选
  • 1
  • 1
  • └ item_name
  • String
  • 可选
  • 1
  • 1
  • └ uom
  • String
  • 可选
  • 1
  • 1
  • └ line_type
  • String
  • 可选
  • 1
  • 1
  • └ line_num
  • Number
  • 可选
  • 1
  • 1
  • └ line_type_ex
  • String
  • 可选
  • 1
  • 1
  • └ contract_quantity
  • Number
  • 可选
  • 1
  • 1
  • └ item_description
  • String
  • 可选
  • 1
  • 1
  • └ category_id
  • Number
  • 可选
  • 1
  • 1
  • └ requisition_line_id
  • Number
  • 可选
  • 1
  • 1
  • └ status
  • String
  • 可选
  • 1
  • 1
  • └ currency_code
  • String
  • 可选
  • 1
  • 币种
  • └ can_cancel
  • Boolean
  • 可选
  • false
  • 是否可取消
  • └ external_code
  • String
  • 可选
  • 1
  • 来源系统标示
  • └ external_value
  • String
  • 可选
  • 1
  • 来源系统单据号
  • └ po_number
  • String
  • 可选
  • 1
  • po单号
  • └ data_source
  • String
  • 可选
  • 1
  • 下单方式
  • po_header_ext_dto
  • PoHeaderExtDto
  • 可选
  • po头信息
  • └ available_modified_currency
  • Boolean
  • 可选
  • false
  • 页面"我要改币种是否可用"(国际化项目第二波)
  • └ apply_description
  • String
  • 可选
  • 1
  • 采购申请说明
  • └ ou_code
  • String
  • 可选
  • 1
  • ouCode
  • └ allow_modified_exchange_rate
  • Boolean
  • 可选
  • false
  • 页面是否允许修改汇率(国际化项目第二波)
  • └ can_modify
  • Boolean
  • 可选
  • false
  • 是否可取消
  • └ is_show_source_id
  • Boolean
  • 可选
  • false
  • 是否展示来源id
  • └ is_ant_buyer
  • Boolean
  • 可选
  • false
  • 是否蚂蚁采购元
  • └ is_owner
  • Boolean
  • 可选
  • false
  • 是否本人订单
  • └ is_change_ou_enable
  • Boolean
  • 可选
  • false
  • 是否允许修改OU
  • └ in_batch_modify_currency
  • Boolean
  • 可选
  • false
  • 是否已在批量修改币种任务中
  • └ requisition_type
  • String
  • 可选
  • 1
  • 默认"NONECATALOG" 必填
  • └ is_comply_project
  • String
  • 可选
  • 1
  • 是否可以发起履约项目
  • └ attach_file_ids
  • String
  • 可选
  • 1
  • 附件
  • └ requisition_url
  • String
  • 可选
  • 1
  • pr链接
  • └ currency_modified_remark
  • String
  • 可选
  • 1
  • 修改币种、汇率时的备注
  • └ requisition_number
  • String
  • 可选
  • 1
  • pr单号
  • └ is_purchase
  • Boolean
  • 可选
  • false
  • 采购员类型（集采：true、非集采：false）
  • └ ou_name
  • String
  • 可选
  • 1
  • ou名称
  • └ is_admin_project
  • Boolean
  • 可选
  • false
  • 是否行政工程
  • po_header_d_t_o
  • PoHeaderDto
  • 可选
  • po头信息
  • └ supplier_id
  • Number
  • 可选
  • 1
  • 供应商id
  • └ interface_source_code
  • String
  • 可选
  • 1
  • 来源code
  • └ origin_currency
  • String
  • 可选
  • 1
  • 原币种
  • └ amount_visible
  • String
  • 可选
  • 1
  • 金额对供应商是否可见
  • └ description
  • String
  • 可选
  • 1
  • 描述
  • └ is_need_do_detail
  • String
  • 可选
  • 1
  • 是否需要发货明细
  • └ revision_num
  • Number
  • 可选
  • 1
  • 版本号
  • └ buyer_id
  • Number
  • 可选
  • 1
  • 采购员
  • └ org_id
  • Number
  • 可选
  • 1
  • 公司
  • └ quotation_header_id
  • Number
  • 可选
  • 1
  • 报价单号
  • └ finance_pre_user_id
  • Number
  • 可选
  • 1
  • 财务初审
  • └ exchange_rate
  • String
  • 可选
  • 1
  • 汇率
  • └ po_type_code
  • String
  • 可选
  • 1
  • po类型
  • └ actual_requestor_id
  • Number
  • 可选
  • 1
  • 实际需求方
  • └ requisition_header_id
  • Number
  • 可选
  • 1
  • pr头id
  • └ consignee_user_id
  • Number
  • 可选
  • 1
  • 账单收件人
  • └ currency_code
  • String
  • 可选
  • 1
  • 币种code
  • └ status
  • String
  • 可选
  • 1
  • 状态
  • └ contract_number
  • String
  • 可选
  • A123456
  • 合同号
  • └ quotation_code
  • String
  • 可选
  • BJD11234425
  • 报价单code
  • └ currency_modified_file_ids
  • String
  • 可选
  • 1
  • 修改币种、汇率附件ids,用于保存
  • └ accuracy_for_currency
  • Number
  • 可选
  • 1
  • 币种精度
  • └ can_reason_be_null
  • Boolean
  • 可选
  • false
  • 先于下单的理由是否可以为空
  • └ data_source
  • String
  • 可选
  • 1
  • 创建po方式
  • └ accuracy_for_origin_currency
  • Number
  • 可选
  • 1
  • 原币种精度
  • └ currency_code
  • String
  • 可选
  • 1
  • 币种
  • └ buyer_work_no
  • String
  • 可选
  • 56771
  • 采购员工号
  • └ buyer_manager
  • String
  • 可选
  • 1
  • 类目主管 & 采购经理
  • payment_ext_d_t_o
  • PaymentExtDto
  • 可选
  • 支付条款
  • payment_header_d_t_o
  • PaymentHeaderDto
  • 可选
  • 支付条款头
  • └ payment_type
  • String
  • 可选
  • PAY_ON_DELIVERY
  • 条款类型(PAY_ON_DELIVERY：货到付款；PAY_ON_MILESTONE：阶段支付)
  • └ pay_on_percent
  • String
  • 可选
  • n
  • 是否按比例支付（货到付款:n；阶段支付：y）
  • └ other_terms
  • String
  • 可选
  • 11
  • 其他条款(补充条款，非必填)
  • payment_line_d_t_o_list
  • PaymentLineDto []
  • 可选
  • 支付条款行信息
  • └ terms
  • String
  • 可选
  • 详细说明
  • 条款内容
  • └ invoice_due_date
  • String
  • 可选
  • 15
  • 在收到供方发票后的指定天数内付款
  • └ day_after_invoicing
  • String
  • 可选
  • 3
  • 供应商开票后天数
  • └ line_type
  • String
  • 可选
  • SCHEDULE
  • 付款条款行类型（SCHEDULE：普通条款；DEPOSIT：质保金）
  • └ need_invoice
  • String
  • 可选
  • n
  • 是否需要开票
  • └ payment_method
  • String
  • 可选
  • PREPAID
  • 付款方式(PREPAID：预付款；POSTPAID：货到付款)
  • └ phase
  • String
  • 可选
  • 1
  • 第几阶段
  • └ is_calendar_day
  • String
  • 可选
  • y
  • 是否自然日

响应参数

名称 类型 示例值 描述
result Result Result 系统自动生成
  • └ code
  • String
  • 0
  • 返回码
  • └ message
  • String
  • 成功
  • 接口返回信息
  • └ value
  • String
  • PR1233
  • pr单号
  • └ is_success
  • Boolean
  • true
  • 成功或失败

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaInfopCeresPoCreateRequest req = new AlibabaInfopCeresPoCreateRequest();
AlibabaInfopCeresPoCreateRequest.PoInfoDto obj1 = new AlibabaInfopCeresPoCreateRequest.PoInfoDto();
List<AlibabaInfopCeresPoCreateRequest.PoLineExtDTO> list3 = new ArrayList<AlibabaInfopCeresPoCreateRequest.PoLineExtDTO>();
AlibabaInfopCeresPoCreateRequest.PoLineExtDTO obj4 = new AlibabaInfopCeresPoCreateRequest.PoLineExtDTO();
list3.add(obj4);
obj4.setEnableCategoryChanged(false);
obj4.setCanModifyTaxRate(false);
obj4.setIsSelect("n");
obj4.setCategoryUseName("1");
obj4.setCanModify(false);
obj4.setCategoryName("1");
obj4.setReceiving(false);
List<AlibabaInfopCeresPoCreateRequest.LocationList> list7 = new ArrayList<AlibabaInfopCeresPoCreateRequest.LocationList>();
AlibabaInfopCeresPoCreateRequest.LocationList obj8 = new AlibabaInfopCeresPoCreateRequest.LocationList();
list7.add(obj8);
obj8.setReceiptName("1");
AlibabaInfopCeresPoCreateRequest.PoLineLocationExtDto obj10 = new AlibabaInfopCeresPoCreateRequest.PoLineLocationExtDto();
obj10.setShipmentNum(1L);
obj10.setActualReceivingUserId(1L);
obj10.setNeedByDateEnd(1L);
obj10.setUom("1");
obj10.setQuantity(1L);
obj10.setQuantityCancelled(1L);
obj10.setNeedByDate(1L);
obj10.setAssetAdministrator(1L);
obj10.setReceiptUserId(1L);
obj10.setDeliveryToLocationId("1");
obj10.setQuantityReceived(1L);
obj10.setOrgId(1L);
list9.setPoLineLocationDTO(obj10);
obj8.setReceiptWorkNo("1");
obj8.setLocationName("1");
obj8.setAssetWarehouseType("1");
list5.setLocationList(list7);
obj4.setIsAsset("1");
obj4.setIsDesensitized(false);
obj4.setReceivedQuantity(1L);
obj4.setIsRpo(0L);
obj4.setIsStructureBom(false);
obj4.setReceivedAndIngQuantity(1L);
AlibabaInfopCeresPoCreateRequest.PoLineDto obj12 = new AlibabaInfopCeresPoCreateRequest.PoLineDto();
obj12.setUnitPrice(1L);
obj12.setCategoryUse("1");
obj12.setAmount("1");
obj12.setQuantity("1");
obj12.setCategoryCode("1");
obj12.setOrgId(1L);
obj12.setOriginUnitPrice(1L);
obj12.setOriginAmount("1");
obj12.setTaxRate("1");
obj12.setItemName("1");
obj12.setUom("1");
obj12.setLineType("1");
obj12.setLineNum(1L);
obj12.setLineTypeEx("1");
obj12.setContractQuantity(1L);
obj12.setItemDescription("1");
obj12.setCategoryId(1L);
obj12.setRequisitionLineId(1L);
obj12.setStatus("1");
list11.setPoLineDTO(obj12);
obj4.setCurrencyCode("1");
obj4.setCanCancel(false);
obj1.setPoLineExtDtoList(list3);
obj1.setExternalCode("1");
obj1.setExternalValue("1");
obj1.setPoNumber("1");
obj1.setDataSource("1");
AlibabaInfopCeresPoCreateRequest.PoHeaderExtDto obj13 = new AlibabaInfopCeresPoCreateRequest.PoHeaderExtDto();
obj13.setAvailableModifiedCurrency(false);
obj13.setApplyDescription("1");
obj13.setOuCode("1");
obj13.setAllowModifiedExchangeRate(false);
obj13.setCanModify(false);
obj13.setIsShowSourceId(false);
obj13.setIsAntBuyer(false);
obj13.setIsOwner(false);
obj13.setIsChangeOuEnable(false);
obj13.setInBatchModifyCurrency(false);
obj13.setRequisitionType("1");
obj13.setIsComplyProject("1");
obj13.setAttachFileIds("1");
obj13.setRequisitionUrl("1");
obj13.setCurrencyModifiedRemark("1");
obj13.setRequisitionNumber("1");
obj13.setIsPurchase(false);
obj13.setOuName("1");
obj13.setIsAdminProject(false);
AlibabaInfopCeresPoCreateRequest.PoHeaderDto obj14 = new AlibabaInfopCeresPoCreateRequest.PoHeaderDto();
obj14.setSupplierId(1L);
obj14.setInterfaceSourceCode("1");
obj14.setOriginCurrency("1");
obj14.setAmountVisible("1");
obj14.setDescription("1");
obj14.setIsNeedDoDetail("1");
obj14.setRevisionNum(1L);
obj14.setBuyerId(1L);
obj14.setOrgId(1L);
obj14.setQuotationHeaderId(1L);
obj14.setFinancePreUserId(1L);
obj14.setExchangeRate("1");
obj14.setPoTypeCode("1");
obj14.setActualRequestorId(1L);
obj14.setRequisitionHeaderId(1L);
obj14.setConsigneeUserId(1L);
obj14.setCurrencyCode("1");
obj14.setStatus("1");
obj14.setContractNumber("A123456");
obj14.setQuotationCode("BJD11234425");
obj13.setPoHeaderDTO(obj14);
obj13.setCurrencyModifiedFileIds("1");
obj13.setAccuracyForCurrency(1L);
obj13.setCanReasonBeNull(false);
obj13.setDataSource("1");
obj13.setAccuracyForOriginCurrency(1L);
obj13.setCurrencyCode("1");
obj13.setBuyerWorkNo("56771");
obj1.setPoHeaderExtDto(obj13);
obj1.setBuyerManager("1");
AlibabaInfopCeresPoCreateRequest.PaymentExtDto obj15 = new AlibabaInfopCeresPoCreateRequest.PaymentExtDto();
AlibabaInfopCeresPoCreateRequest.PaymentHeaderDto obj16 = new AlibabaInfopCeresPoCreateRequest.PaymentHeaderDto();
obj16.setPaymentType("PAY_ON_DELIVERY");
obj16.setPayOnPercent("n");
obj16.setOtherTerms("11");
obj15.setPaymentHeaderDTO(obj16);
List<AlibabaInfopCeresPoCreateRequest.PaymentLineDto> list18 = new ArrayList<AlibabaInfopCeresPoCreateRequest.PaymentLineDto>();
AlibabaInfopCeresPoCreateRequest.PaymentLineDto obj19 = new AlibabaInfopCeresPoCreateRequest.PaymentLineDto();
list18.add(obj19);
obj19.setTerms("详细说明");
obj19.setInvoiceDueDate("15");
obj19.setDayAfterInvoicing("3");
obj19.setLineType("SCHEDULE");
obj19.setNeedInvoice("n");
obj19.setPaymentMethod("PREPAID");
obj19.setPhase("1");
obj19.setIsCalendarDay("y");
obj15.setPaymentLineDTOList(list18);
obj1.setPaymentExtDTO(obj15);
req.setPoInfoDto(obj1);
AlibabaInfopCeresPoCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_infop_ceres_po_create_response>
    <result>
        <code>0</code>
        <message>成功</message>
        <value>PR1233</value>
        <is_success>true</is_success>
    </result>
</alibaba_infop_ceres_po_create_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部