接口名称tt.oapi.sales.order.data.create接口说明创建销售订单资料程序代号soap_oapi00182输入参数说明参数代号型态是否必填参数说明范例值requestkeystring是检核编码(MD5)13cc69fb4d4861d95d29331b7f02711ctypestring是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是接收方产品名称TIPTOPnamestring是服务名称tt.oapi.sales.order.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topproddatakeyEntIdstring是企业编号CompanyIdstring是营运据点DS1参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring否企业编号不使用site_nostring否营运据点不使用is_digiwin_productstring是是否为鼎捷产品(Y,N)Nso_master—是订单主档(单头节点，支持多数组)so_nostring是订单单号(传入单别，根据此入参取得ERP单号)LX5oea01doc_datedate否订单日期格式：yyyyMMdd若无传值则预设值g_today20200214oea02sales_nostring否业务人员10554oea14sales_department_nostring否业务部门BP0240oea15customer_nostring是客户编号2330oea03so_kindstring否订单性质1.一般订单,2.换货订单,3.出至境外仓,4.境外仓出货,6.调货订单,7.寄销订单1oea00source_typestring否资料来源1.人工输入,2.退补,3.合约转入,4.估价单转入,5.报价单转入,7.出至境外仓出货,X.EC转入,Y.CRM报价单,Z.CRM样品申请单1oea11source_nostring否来源单号16584-TEST-APIoea12payment_condition_nostring否收款条件编号212oea32trade_condition_nostring否交易条件编号不使用tax_nostring否税别编号1250oea21tax_ratenumeric否税率5oea211is_price_taxstring否单价含税否Yoea213currencystring否币别TWDoea23exchange_ratenumeric否汇率1oea24valuation_method_nostring否取价方式编号不使用customer_contractor_nostring否客户连络人编号不使用sales_channel_nostring否销售通路编号不使用sales_type_nostring否销售分类A03oea25retain_cause_nostring否留置原因代码11oeaholdcustomer_so_nostring否客户订购单号TW20200214oea10last_customer_nostring否最终客户编号不使用invoice_typestring否发票类型不使用total_trans_curr_not_tax_amountnumeric否订单总未税金额952oea61total_trans_curr_tax_amountnumeric否订单总含税金额1000oea1008total_trans_curr_taxnumeric否订单总税额不使用rate_calculation_typestring否汇率计算基准不使用remarkstring否备注Test_API_remarkoao06delivery_addressstring否出货地址0002oea044local_nostring否地区编号不使用county_city_nostring否县市编号不使用province_nostring否省区编号不使用area_nostring否区域编号不使用disposable_customer_namestring否一次性客户姓名不使用contact_addressstring否联络地址不使用disposable_customer_mobilestring否一次性客户手机号不使用domestic_foreign_salesstring否内外销1:内销2:外销3:视同外销订单1oea08origin_placestring否起运地001oea41transport_modestring否交运方式2oea43allow_over_delivery_ratenumeric否允许超交率(%)10oea09deposit_ratenumeric否订金比率(%)10oea161shipping_ratenumeric否出货比率(%)10oea162deposit_payment_condition_nostring否订金收款条件编号oea80shipping_payment_condition_nostring否出货收款条件编号oea81modify_nostring否资料修改者若无传值则预设值g_user10554oeausercreate_datedatetime否资料创建日格式：yyyyMMdd若无传值则预设值g_today20200214oeadatedoc_approve_setstring否单据签核设定(Y,N)Yso_detail—是订单主要明细档(单身节点，支持多数组)so_seqnumeric是项次1oeb03item_nostring是料件编号00000oeb04item_feature_nostring否产品特征不使用bom_featurestring否BOM特性不使用component_featurestring否子件特性不使用sales_unit_nostring否销售单位SEToeb05so_qtystring是销售数量1oeb12reference_unit_nostring否参考单位SEToeb913reference_qtystring否参考数量1oeb915valuation_unitstring否计价单位SEToeb916valuation_qtystring否计价数量1oeb917so_due_datedate否约定交货日格式：yyyyMMdd若无传值则预设值g_today20200214oeb15receive_datedate否预定签收日不使用pricenumeric否单价1000oeb13tax_nostring否税别编号1250oea21tax_ratenumeric否税率5oea211emergencystring否急料不使用customer_item_nostring否客户料号ETESToeb11warehouse_nostring否仓库编号WA001oeb09storage_spaces_nostring否储位WA001-01oeb091lot_nostring否批号oeb092inventory_management_featuresstring否库存管理特征不使用project_codestring否项目编号oeb41delivery_type_nostring否取货模式不使用trans_curr_not_tax_amountnumeric否未税金额不使用trans_curr_tax_amountnumeric否含税金额不使用trans_curr_taxnumeric否税额不使用customer_so_seqstring否客户订单项次oeb71remarkstring否备注oao06so_delivery_detail—否订单交期明细档(子单身节点，支持多数组)so_seqnumeric否项次不使用batch_seqnumeric否分批序不使用so_batch_qtynumeric否分批订购数量不使用so_due_datedate否约定交货日期不使用receive_datedate否预计签收日期不使用Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:8a07714c391a67af7eab2da78e755300digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_TW","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"tt","name":"tt.oapi.sales.order.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点"}{"std_data":{"parameter":{"enterprise_no":"企业别","site_no":"营运中心","is_digiwin_product":"是否为鼎捷产品","so_master":[{"so_no":"订单单号","so_date":"订单日期","sales_no":"业务人员","sales_department_no":"业务部门","customer_no":"客户编号","so_kind":"订单性质","source_type":"资料来源","source_no":"来源单号","payment_condition_no":"收款条件编号","trade_condition_no":"交易条件编号","tax_no":"税别编号","tax_rate":"税率","is_price_tax":"单价含税否","currency":"币别","exchange_rate":"汇率","valuation_method_no":"取价方式编号","customer_contractor_no":"客户连络人编号","sales_channel_no":"销售通路编号","sales_type_no":"销售分类","retain_cause_no":"留置原因代码","customer_so_no":"客户订购单号","last_customer_no":"最终客户编号","invoice_type":"发票类型","total_trans_curr_not_tax_amount":"订单总未税金额","total_trans_curr_tax_amount":"订单总含税金额","total_trans_curr_tax":"订单总税额","rate_calculation_type":"汇率计算基准","remark":"备注","delivery_address":"出货地址","local_no":"地区编号","county_city_no":"县市编号","province_no":"省区编号","area_no":"区域编号","disposable_customer_name":"一次性客户姓名","contact_address":"联络地址","disposable_customer_mobile":"一次性客户手机号","domestic_foreign_sales":"内外销","origin_place":"起运地","transport_mode":"交运方式","allow_over_delivery_rate":"允许超交率","deposit_rate":"订金比率","shipping_rate":"出货比率","deposit_payment_condition_no":"订金收款条件编号","shipping_payment_condition_no":"出货收款条件编号","modify_no":"资料修改者","create_date":"资料创建日","doc_approve_set":"单据签核设定","so_detail":[{"so_seq":"项次","item_no":"料件编号","item_feature_no":"产品特征","bom_feature":"BOM特性","component_feature":"子件特性","sales_unit_no":"销售单位","so_qty":"销售数量","reference_unit_no":"参考单位","reference_qty":"参考数量","valuation_unit":"计价单位","valuation_qty":"计价数量","so_due_date":"约定交货日","receive_date":"预定签收日","price":"单价","tax_no":"税别编号","tax_rate":"税率","emergency":"急料","customer_item_no":"客户料号","warehouse_no":"仓库编号","storage_spaces_no":"储位","lot_no":"批号","inventory_management_features":"库存管理特征","project_code":"项目编号","delivery_type_no":"取货模式","trans_curr_not_tax_amount":"未税金额","trans_curr_tax_amount":"含税金额","trans_curr_tax":"税额","customer_so_seq":"客户订单项次","remark":"备注","so_delivery_detail":[{"so_seq":"项次","batch_seq":"分批序","so_batch_qty":"分批订购数量","so_due_date":"约定交货日期","receive_date":"预计签收日期"}]}]}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000datakeyerp_nostring是ERP编号LX5-202002140001oea01参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0：正确<>0：FAIL（原因代码）0sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述so_master—是订单主档(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)LX5-202002140001oea01source_nostring否来源单号(编号)回传入参中的PK栏位值LX5-202002140001execute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)is_auto_confirmstring否是否自动审核(Y,N)NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:933b2c71-2752-4a45-b776-820383407b4fdigi-protocol:rawdigi-srvver:1.0digi-srvcode:000digi-datakey:{"erp_no":"ERP编号"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"so_master":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动确认"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果100参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws1380sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述[TIPTOP]处理笔数1,成功0,失败1so_master—是订单主档(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)source_nostring否来源单号(编号)回传入参中的PK栏位值LX5execute_descriptionstring否执行描述(执行成功则回传空值；执行失败则回传失败描述)传入的单别不存在或已失效is_auto_confirmstring否是否自动审核NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:933b2c71-2752-4a45-b776-820383407b4fdigi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"so_master":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动确认"}]}}}
