接口名称t100.oapi.sales.order.change.data.create接口说明创建销售订单变更单资料程序代号wssp00001输入参数说明参数代号型态是否必填参数说明范例值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.sales.order.change.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码,提供同一产品多台主机辨别之用topprddatakeyEntIdstring是企业编号99CompanyIdstring否营运据点DSCTCso_nostring是订单单号CNJ-504-140711000001change_seqnumeric否变更序1source_nostring否来源单号16584-TEST-APIcustomer_so_nostring否客户订购单号so_seqnumeric是项次1so_seqnumeric否项次1so_sub_seqnumeric否项序参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring否企业编号若无传值则预设值g_enterprise99xmeeentsite_nostring否营运中心xmeesiteis_digiwin_productstring是是否为鼎捷产品(Y,N)Yso_change_master—是订单变更单主档(单头节点,支持多数组)so_nostring是订单单号CNJ-504-140711000001xmeedocnochange_seqnumeric否变更序1xmee900change_datedate否变更日期格式:yyyyMMdd若无传值则预设值g_today20230601xmee902change_reasonstring否变更理由Q01xmee903change_remarkstring否变更备注xmee904sales_nostring否业务人员16584xmee002sales_department_nostring否业务部门DC0300xmee003source_nostring否来源单号16584-TEST-APIxmee008payment_condition_nostring否收款条件编号211xmee009trade_condition_nostring否交易条件编号CFRxmee010tax_nostring否税别编号P01xmee011tax_ratenumeric否税率17xmee012is_price_taxstring否单价含税否Nxmee013currencystring否币别TWDxmee015exchange_ratenumeric否汇率0.25xmee016valuation_method_nostring否取价方式编号L01xmee017billing_customerstring否帐款客户编号00000002xmee021delivery_customer_nostring否收货客户编号00111xmee022sales_channel_nostring否销售通路编号20001xmee023sales_type_nostring否销售分类P01xmee024customer_contractor_nostring否客户连络人编号00000000000000000877xmee027customer_so_nostring否客户订购单号xmee033last_customer_nostring否最终客户编号00000002xmee034invoice_typestring否发票类型0xmee035total_trans_curr_not_tax_amountnumeric否订单总未税金额1465.38xmee041total_trans_curr_tax_amountnumeric否订单总含税金额1714.5xmee042total_trans_curr_taxnumeric否订单总税额249.12xmee043rate_calculation_typestring否汇率计算基准1.依订单日汇率,2.依Invoice日汇率,3.依出货日汇率,4.依立帐日汇率,5.依立帐日月平均汇率2xmee049remarkstring否备注Test_API_remarkxmee071local_curr_tax_amountstring否本币含税总金额不使用create_employee_nostring否建档人员编号若无传值则预设值g_user16584xmeecrtiddelivery_addressstring否出货地址TESTxmee025local_nostring否地区编号xmee208county_city_nostring否县市编号xmee209province_nostring否省区编号xmee210area_nostring否区域编号xmee211disposable_customer_namestring否一次性客户姓名pmak003contact_addressstring否联络地址pmak005disposable_customer_mobilestring否一次性客户手机号pmak007closed_stusstring否订单结案否Y:表示要做订单结案N:表示不做订单结案Nxmeeactidomestic_foreign_salesstring否内外销1.内销2.外销1xmee048origin_placestring否起运地xmee037transport_modestring否交运方式9xmee020deposit_amountnumeric否订金金额不使用shipping_amountnumeric否出货金额不使用balance_amountnumeric否尾款金额不使用doc_approve_setstring否单据签核设定(Y,N)Nso_change_detail—是订单变更单明细档(单身节点,支持多数组)so_seqnumeric是项次1xmegseqitem_nostring否料件编号800005xmeg001item_feature_nostring否产品特征xmeg002bom_featurestring否BOM特性xmeg062component_featurestring否子件特性1.一般2.CKD3.SKD4.可选件5.附属零件6.备品7.包装容器8.委外代买9.样品10.拆件主件11.拆件元件1xmeg01912.联产品13.副产品/回收料14.多产出主件sales_unit_nostring否销售单位PCSxmeg006so_qtystring否销售数量3xmeg007reference_unit_nostring否参考单位PCSxmeg008reference_qtystring否参考数量3xmeg009valuation_unitstring否计价单位PCSxmeg010valuation_qtystring否计价数量3xmeg011so_due_datestring否约定交货日格式:yyyyMMdd20140711xmeg012receive_datestring否预定签收日格式:yyyyMMdd20140711xmeg013pricenumeric否单价175.5xmeg015tax_nostring否税别编号P01xmeg016tax_ratenumeric否税率5xmeg017emergencystring否急料1.一般2.紧急3.特急1xmeg020customer_item_nostring否客户料号xmeg027warehouse_nostring否限定库位xmeg028location_nostring否限定储位xmeg029lot_nostring否限定批号xmeg030project_codestring否项目编号xmeg036delivery_type_nostring否取货模式1.企业运送2.客户自取3.供应商直送4.外包物流5.寄销xmeg032trans_curr_not_tax_amountnumeric否未税金额450xmeg046trans_curr_tax_amountnumeric否含税金额526.5xmeg047trans_curr_taxnumeric否税额76.5xmeg048customer_so_seqstring否客户订单项次xmeg051remarkstring否备注xmeg050inventory_management_featuresstring否库存管理特征xmeg057body_closestring否单身结案Y:表示要做单身结案Yxmeg045N:表示不做单身结案close_reason_nostring否结案理由码当单身结案否=Y时结案理由码必须输入A001xmeg053so_change_delivery_detail—是订单变更单交期明细档(子单身节点,支持多数组)so_seqnumeric否项次1xmejseqso_sub_seqnumeric否项序不使用batch_seqnumeric否分批序1xmejseq2so_batch_qtynumeric否分批订购数量2xmej002so_due_datedate否约定交货日期格式:yyyyMMdd20140711xmej003receive_datedate否预计签收日期格式:yyyyMMdd20140711xmej004Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:f3d29090bedd53b185f891391f441987digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"T100","name":"t100.oapi.sales.order.change.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","so_no":"订单单号","change_seq":"变更序","source_no":"来源单号","customer_so_no":"客户订购单号","so_seq":"项次","so_sub_seq":"项序"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","so_change_master":[{"so_no":"订单单号","change_seq":"变更序","change_date":"变更日期","change_reason":"变更理由","change_remark":"变更备注","sales_no":"业务人员","sales_department_no":"业务部门","source_no":"来源单号","payment_condition_no":"收款条件编号","trade_condition_no":"交易条件编号","tax_no":"税别编号","tax_rate":"税率","is_price_tax":"单价含税否","currency":"币别","exchange_rate":"汇率","valuation_method_no":"取价方式编号","billing_customer":"帐款客户编号","delivery_customer_no":"收货客户编号","sales_channel_no":"销售通路编号","sales_type_no":"销售分类","customer_contractor_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":"备注","local_curr_tax_amount":"本币含税总金额","create_employee_no":"建档人员编号","delivery_address":"出货地址","local_no":"地区编号","county_city_no":"县市编号","province_no":"省区编号","area_no":"区域编号","disposable_customer_name":"一次性客户姓名","contact_address":"联络地址","disposable_customer_mobile":"一次性客户手机号","closed_stus":"订单结案否","domestic_foreign_sales":"内外销","origin_place":"起运地","transport_mode":"交运方式","deposit_amount":"订金金额","shipping_amount":"出货金额","balance_amount":"尾款金额","doc_approve_set":"单据签核设定","so_change_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":"限定库位","location_no":"限定储位","lot_no":"限定批号","project_code":"项目编号","delivery_type_no":"取货模式","trans_curr_not_tax_amount":"未税金额","trans_curr_tax_amount":"含税金额","trans_curr_tax":"税额","customer_so_seq":"客户订单项次","remark":"备注","inventory_management_features":"库存管理特征","body_close":"单身结案","close_reason_no":"结案理由码","so_change_delivery_detail":[{"so_seq":"项次","so_sub_seq":"项序","batch_seq":"分批序","so_batch_qty":"分批订购数量","so_due_date":"约定交货日期","receive_date":"预计签收日期"}]}]}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如发生信息检核不通过等情况,导致无法完成预期的结果datakeyerp_nostring否ERP编号erp_no_primary_keystring否ERP编号-PKsource_nostring否来源单号(编号)source_no_primary_keystring否来源单号-PK参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0:正确<>0:FAIL(原因代码)0sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述执行成功!so_change_master—是订单变更单主档(单头节点,支持多数组)erp_nostring否ERP编号CNJ-504-140711000001xmeedocnoerp_no_primary_keystring否ERP编号-PK1xmee900source_nostring否来源单号(编号)CNJ-504-140711000001xmeedocnosource_no_primary_keystring否来源单号-PK1xmee900execute_descriptionstring否执行描述is_auto_confirmstring否是否自动审核(Y,N)NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:c9e510ce-095e-4386-9e9c-aa4cfb29afffdigi-protocol:rawdigi-srvver:1.0digi-srvcode:000digi-datakey:{"erp_no":"ERP编号","erp_no_primary_key":"ERP编号-PK","source_no":"来源单号(编号)","source_no_primary_key":"来源单号-PK"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"so_change_master":[{"erp_no":"ERP编号","erp_no_primary_key":"ERP编号-PK","source_no":"来源单号(编号)","source_no_primary_key":"来源单号-PK","execute_description":"执行描述","is_auto_confirm":"是否自动审核"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如发生信息检核不通过等情况,导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0:正确<>0:FAIL(原因代码)aws-00102sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述[T100_message]处理笔数1,成功0,失败1so_change_master—是订单变更单主档(单头节点,支持多数组)erp_nostring否ERP编号xmeedocnoerp_no_primary_keystring否ERP编号-PKxmee900source_nostring否来源单号(编号)CNJ-504-140711000001xmeedocnosource_no_primary_keystring否来源单号-PK1xmee900execute_descriptionstring否执行描述该笔订单已存在一笔未审核的订单变更单中!is_auto_confirmstring否是否自动审核(Y,N)NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:c9e510ce-095e-4386-9e9c-aa4cfb29afffdigi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"so_change_master":[{"erp_no":"ERP编号","erp_no_primary_key":"ERP编号-PK","source_no":"来源单号(编号)","source_no_primary_key":"来源单号-PK","execute_description":"执行描述","is_auto_confirm":"是否自动审核"}]}}}