接口名称t100.oapi.purchase.order.data.create接口说明新增采购单资料程序代号wssp00154输入参数说明参数代号型态是否必填参数说明范例值requestkeystring是检核编码(MD5)109c3c41a1441e702b909ed3de58e4b1typestring是Request类型(sync,async)固定传入synchostprodstring是发起方产品名称OAPIverstring是发起方产品版本1.0ipstring是发起方IP位置10.40.71.91idstring否发起方产品识别码，提供同一产品多台主机辨别之用acctstring是登入帐号固定传入tiptoptimestampstring是时间戳记格式：yyyyMMddHHmmssSSS20151211123204361timezonestring否发起方时区(-12~+14)+8langstring是语言别(zh_TW,zh_CN,en,vi)zh_CNserviceprodstring是接收方产品名称T100namestring是服务名称t100.oapi.purchase.order.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring是企业编号99CompanyIdstring否营运据点DSCTC参数代号型态是否必填参数说明范例值ERP字段enterprise_nostring否企业编号若无传值则预设值g_enterprise99pmdlentsite_nostring否营运中心DSCTCpmdlsiteis_digiwin_productstring是是否为鼎捷产品(Y,N)Ypurchase_data—是采购单资料(单头节点，支持多数组)purchase_nostring是采购单号PO1pmdldocnopurchase_datedate否采购日期格式：yyyyMMdd若无传值则预设值g_today20230601pmdldocdtdepartment_nostring否部门编号DC0300pmdl003source_nostring否来源单号16584-XML-addpmdl008supplier_nostring是供应商编号00000002pmdl004purchaser_codestring否采购人员编号16584pmdl002purchase_propertystring否采购性质1.一般采购,2.委外采购,3.VMI采购,4.预先采购,5.重覆性生产委外采购,6.借货采购1pmdl005payment_conditionstring否付款条件101pmdl009trade_condition_nostring否交易条件CFRpmdl010tax_nostring否税别编号001pmdl011tax_ratenumeric否税率0.123pmdl012is_price_taxstring否单价含税否Ypmdl013currencystring否币别TWDpmdl015exchange_ratenumeric否汇率1pmdl016remarkstring否备注pmdl044rate_calculation_typestring否汇率计算基准1.依采购日汇率,2.依收货日汇率,3.依付款日汇率,4.依付款日月平均汇率1pmdl055invoice_typestring否发票类型E1pmdl033valuation_method_nostring否取价方式编号P001pmdl017last_customer_nostring否最终客户编号00000002pmdl032transport_mode_nostring否运输方式2pmdl020delivery_addressstring否送货地址9999pmdl025billing_addressstring否账单地址B002pmdl026total_trans_curr_not_tax_amountnumeric否采购总未税金额0pmdl040total_trans_curr_tax_amountnumeric否采购总含税金额0pmdl041total_trans_curr_taxnumeric否采购总税额0pmdl042create_employee_nostring否建档人员编号16584pmdlcrtiddisposable_customer_namestring否一次性客户姓名pmak003contact_addressstring否联络地址pmak005disposable_customer_mobilestring否一次性客户手机号pmak007doc_approve_setstring否单据签核设定Npurchase_detail—是采购明细(单身节点，支持多数组)seq_nonumeric是项次1pmdnseqitem_nostring是料件编号00000pmdn001item_feature_nostring否产品特征pmdn002unit_nostring否单位编号PCSpmdn006qtynumeric是数量1pmdn007reference_unit_nostring否参考单位PCSpmdn008reference_qtystring否参考数量0pmdn009valuation_unitstring否计价单位PCSpmdn010valuation_qtystring否计价数量1pmdn011delivery_datedate否采购交期格式：yyyyMMdd20230601pmdn012pricenumeric否单价10pmdn015tax_nostring否税别编号C01pmdn016tax_ratenumeric否税率0.05pmdn017emergencystring否急料1.一般,2.紧急,3.特急1pmdn020supplier_item_nostring否供应商料号pmdn027warehouse_nostring否限定库位TEST-01pmdn028location_nostring否限定储位TEST-01pmdn029lot_nostring否限定批号TEST-01pmdn030delivery_type_nostring否取货模式1.供应商运送,2.企业自取,3.供应商直送,4.物流外包,5.寄销1pmdn032project_codestring否项目代号A001pmdn036wbs_codestring否WBS编码0000000001pmdn037activity_nostring否活动编号pmdn038trans_curr_not_tax_amountnumeric否未税金额0pmdn046trans_curr_tax_amountnumeric否含税金额0pmdn047trans_curr_taxnumeric否税额0pmdn048remarkstring否备注TESTpmdn050inventory_management_featuresstring否库存管理特征pmdn053Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:a23f58f671d277a716d995344557c918digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"T100","name":"t100.oapi.purchase.order.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","purchase_no":"采购单号","seq_no":"项次"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","purchase_data":[{"purchase_no":"采购单号","purchase_date":"采购日期","department_no":"部门编号","source_no":"来源单号","supplier_no":"供应商编号","purchaser_code":"采购人员编号","purchase_property":"采购性质","payment_condition":"付款条件","trade_condition_no":"交易条件","tax_no":"税别编号","tax_rate":"税率","is_price_tax":"单价含税否","currency":"币别","exchange_rate":"汇率","remark":"备注","rate_calculation_type":"汇率计算基准","invoice_type":"发票类型","valuation_method_no":"取价方式编号","last_customer_no":"最终客户编号","transport_mode_no":"运输方式","delivery_address":"送货地址","billing_address":"账单地址","total_trans_curr_not_tax_amount":"采购总未税金额","total_trans_curr_tax_amount":"采购总含税金额","total_trans_curr_tax":"采购总税额","create_employee_no":"建档人员编号","disposable_customer_name":"一次性客户姓名","contact_address":"联络地址","disposable_customer_mobile":"一次性客户手机号","doc_approve_set":"单据签核设定","purchase_detail":[{"seq_no":"项次","item_no":"料件编号","item_feature_no":"产品特征","unit_no":"单位编号","qty":"数量","reference_unit_no":"参考单位","reference_qty":"参考数量","valuation_unit":"计价单位","valuation_qty":"计价数量","delivery_date":"采购交期","price":"单价","tax_no":"税别编号","tax_rate":"税率","emergency":"急料","supplier_item_no":"供应商料号","warehouse_no":"限定库位","location_no":"限定储位","lot_no":"限定批号","delivery_type_no":"取货模式","project_code":"项目代号","wbs_code":"WBS编码","activity_no":"活动编号","trans_curr_not_tax_amount":"未税金额","trans_curr_tax_amount":"含税金额","trans_curr_tax":"税额","remark":"备注","inventory_management_features":"库存管理特征"}]}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000datakeyerp_nostring否ERP编号CTC-PO1-230600000001pmdldocnosource_nostring否来源单号(编号)CTC-PO1-230600000001pmdldocno参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码00：正确<>0：FAIL（原因代码）sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述purchase—否采购单(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)CTC-PO1-230600000001pmdldocnosource_nostring是来源单号(编号)(回传入参中的PK字段值)CTC-PO1-230600000001pmdldocnoexecute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:9842817c-6e58-4703-b41a-7854191a9aa0digi-protocol:rawdigi-srvver:1.0digi-srvcode:000{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"purchase":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动确认"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000datakeyerp_nostring否ERP编号source_nostring否来源单号(编号)CTC-PO1-230600000001pmdldocno参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws-00102sql_codestring否失败时数据库回传代码descriptionstring是错误问题描述[T100_message]处理笔数1,成功0,失败1purchase—否采购单(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)source_nostring是来源单号(编号)(回传入参中的PK字段值)CTC-PO1-230600000001pmdldocnoexecute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)传入的资料不存在或已失效Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:0278a273-3984-4bb2-bb93-bd6130708c22digi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"purchase":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动确认"}]}}}
