接口名称t100.oapi.sales.order.data.create接口说明创建销售订单资料程序代号wssp00182输入参数说明参数代号型态是否必填参数说明范例值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是接收方产品名称T100namestring是服务名称t100.oapi.sales.order.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring是企业编号99CompanyIdstring是营运据点DSCTC参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring是企业编号99xmdaentsite_nostring是营运据点DSCTCxmdasiteis_digiwin_productstring是是否为鼎捷产品(Y,N)Nso_master—是订单主档(单头节点，支持多数组)doc_slipstring是订单单号(传入单别，根据此入参取得ERP单号)LX5xmdadocnodoc_datedate否订单日期格式：yyyyMMdd若无传值则预设值g_today20200214xmdadocdtsales_nostring否业务人员10554xmda002sales_department_nostring否业务部门BP0240xmda003customer_nostring是客户编号2330xmda004so_kindstring否订单性质1.一般订单,2.换货订单,3.签收订单,4.调拨订单,5.预先订单1xmda005source_typestring否资料来源1.人工输入,2.预先订单,3.报价单,5.销退换货,6.多角抛转,7.协作转入,9.EC,11.CRM报价单转入,12.CRM样品单转入,13.分销订单转入1xmda007source_nostring否来源单号16584-TEST-APIxmda008payment_condition_nostring否收款条件编号212xmda009trade_condition_nostring否交易条件编号CFRxmda010tax_nostring否税别编号1250xmda011tax_ratenumeric否税率5xmda012is_price_taxstring否单价含税否Yxmda013currencystring否币别TWDxmda015exchange_ratenumeric否汇率1xmda016valuation_method_nostring否取价方式编号001xmda017customer_contractor_nostring否客户连络人编号00000000000000000130xmda027sales_channel_nostring否销售通路编号001xmda023sales_type_nostring否销售分类A03xmda024retain_cause_nostring否留置原因代码11xmda032customer_so_nostring否客户订购单号TW20200214xmda033last_customer_nostring否最终客户编号2330xmda034invoice_typestring否发票类型31xmda035total_trans_curr_not_tax_amountnumeric否订单总未税金额952xmda041total_trans_curr_tax_amountnumeric否订单总含税金额1000xmda042total_trans_curr_taxnumeric否订单总税额48xmda043rate_calculation_typestring否汇率计算基准1.依订单日汇率,2.依Invoice日汇率,3.依出货日汇率,4.依立帐日汇率,5.依立帐日月平均汇率1xmda049remarkstring否备注Test_API_remarkxmda071delivery_addressstring否出货地址0002xmda025local_nostring否地区编号xmda208county_city_nostring否县市编号xmda209province_nostring否省区编号xmda210area_nostring否区域编号xmda211disposable_customer_namestring否一次性客户姓名pmak003contact_addressstring否联络地址pmak005disposable_customer_mobilestring否一次性客户手机号pmak007domestic_foreign_salesstring否内外销1:内销2:外销1xmda048origin_placestring否起运地001xmda037transport_modestring否交运方式2xmda020allow_over_delivery_ratenumeric否允许超交率不使用deposit_ratenumeric否订金比率不使用shipping_ratenumeric否出货比率不使用deposit_payment_condition_nostring否订金收款条件编号不使用shipping_payment_condition_nostring否出货收款条件编号不使用modify_nostring否资料修改者若无传值则预设值g_user10554xmdacrtidcreate_datedatetime否资料创建日格式：yyyyMMddHHmmss若无传值则预设值cl_get_current()20200214090901xmdacrtdtdoc_approve_setstring否单据签核设定(Y,N)Yso_detail—是订单主要明细档(单身节点，支持多数组)so_seqnumeric是项次1xmdcseqitem_nostring是料件编号00000xmdc001item_feature_nostring否产品特征xmdc002bom_featurestring否BOM特性xmdc062component_featurestring否子件特性1.一般,2.CKD,3.SKD,9.样品1xmdc019sales_unit_nostring否销售单位SETxmdc006so_qtystring是销售数量1xmdc007reference_unit_nostring否参考单位SETxmdc008reference_qtystring否参考数量1xmdc009valuation_unitstring否计价单位SETxmdc010valuation_qtystring否计价数量1xmdc011so_due_datedate否约定交货日格式：yyyyMMdd若无传值则预设值g_today20200214xmdc012receive_datedate否预定签收日格式：yyyyMMdd若无传值则预设值g_today20200214xmdc013pricenumeric否单价1000xmdc015tax_nostring否税别编号1250xmdc016tax_ratenumeric否税率5xmdc017emergencystring否急料1.一般,2.紧急,3.特急1xmdc020customer_item_nostring否客户料号ETESTxmdc027customer_item_namestring否客户料号品名customer_item_specstring否客户料号规格warehouse_nostring否仓库编号WA001xmdc028storage_spaces_nostring否储位WA001-01xmdc029lot_nostring否批号xmdc030inventory_management_featuresstring否库存管理特征xmdc057project_codestring否项目编号xmdc036delivery_type_nostring否取货模式1.企业运送,2.客户自取,3.供应商直送,4.外包物流,5.寄销1xmdc032trans_curr_not_tax_anumeric否未税金额952xmdc046mounttrans_curr_tax_amountnumeric否含税金额1000xmdc047trans_curr_taxnumeric否税额48xmdc048customer_so_seqstring否客户订单项次xmdc051remarkstring否备注xmdc050so_delivery_detail—否订单交期明细档(子单身节点，支持多数组)so_seqnumeric否项次1xmdfseqbatch_seqnumeric否分批序1xmdfseq2so_batch_qtynumeric否分批订购数量1xmdf002so_due_datedate否约定交货日期格式：yyyyMMdd若无传值则预设值g_today20200214xmdf003receive_datedate否预计签收日期格式：yyyyMMdd若无传值则预设值g_today20200214xmdf004Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:8a07714c391a67af7eab2da78e755300digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"T100","name":"t100.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":[{"doc_slip":"订单单号","doc_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":"客户料号","customer_item_name":"客户料号品名","customer_item_spec":"客户料号规格","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是服务执行结果状态代码000000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果datakeyerp_nostring是ERP编号CTC-LX5-202002140001xmdadocno参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0：正确<>0：FAIL（原因代码）0sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述so_master—是订单主档(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)CTC-LX5-202002140001xmdadocnosource_nostring否来源单号(编号)回传入参中的PK栏位值CTC-LX5-202002140001execute_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: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（原因代码）aws-00102sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述[T100_message]处理笔数1,成功0,失败1so_master—是订单主档(单头节点，支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传，若执行失败回传空值)source_nostring否来源单号(编号)回传入参中的PK栏位值CTC-LX5-202002140001execute_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":"是否自动确认"}]}}}
