接口名称tt.oapi.sales.order.change.data.create接口说明创建销售订单变更单资料程序代号soap_oapi00001输入参数说明参数代号型态是否必填参数说明范例值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是接收方产品名称TIPTOPnamestring是服务名称tt.oapi.sales.order.change.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring是企业编号CompanyIdstring否营运据点so_nostring是订单单号100-23061701change_seqnumeric否变更序1so_seqnumeric是项次1参数代号型态是否必填参数说明范例值ERP字段enterprise_nostring否企业编号不使用site_nostring否营运中心不使用is_digiwin_productstring是是否为鼎捷产品(Y,N)Yso_change_master—是订单变更单主档(单头节点，支持多数组)so_nostring是订单单号100-23061701oep01change_seqnumeric否变更序1oep02change_datedate否变更日期格式：yyyyMMdd若无传值则预设值g_today20230619oep04change_reasonstring否变更理由Q01oep13change_remarkstring否变更备注不使用sales_nostring否业务人员不使用sales_department_nostring否业务部门不使用source_nostring否来源单号不使用payment_condition_nostring否收款条件编号002oep07btrade_condition_nostring否交易条件编号不使用tax_nostring否税别编号S201oep14btax_ratenumeric否税率不使用is_price_taxstring否单价含税否不使用currencystring否币别CNYoep08bexchange_ratenumeric否汇率不使用valuation_method_nostring否取价方式编号syc-3oep10bbilling_customerstring否账款客户编号不使用delivery_customer_nostring否收货客户编号不使用sales_channel_nostring否销售通路编号不使用sales_type_nostring否销售分类P01oep25bcustomer_contractor_nostring否客户连络人编号不使用customer_so_nostring否客户订购单号CUS-2306001oep15blast_customer_nostring否最终客户编号不使用invoice_typestring否发票类型不使用total_trans_curr_not_tax_amountnumeric否订单总未税金额不使用total_trans_curr_tax_amountnumeric否订单总含税金额不使用total_trans_curr_taxnumeric否订单总税额不使用rate_calculation_typestring否汇率计算基准不使用remarkstring否备注订单出货日延后oer04local_curr_tax_amountstring否本币含税总金额create_employee_nostring否建档人员编号若无传值则预设值g_user16584oep12/oepuserdelivery_addressstring否出货地址台湾大道100号之2oep06blocal_nostring否地区编号不使用county_city_nostring否县市编号不使用province_nostring否省区编号不使用area_nostring否区域编号不使用disposable_customer_namestring否一次性客户姓名不使用contact_addressstring否联络地址不使用disposable_customer_mobilestring否一次性客户手机号不使用closed_stusstring否订单结案否不使用domestic_foreign_salesstring否内外销1.内销订单2.外销订单3.视同外销订单(合约转厂使用)1oep16borigin_placestring否起运地SHANGHAIoep41btransport_modestring否交运方式LANDoep11bdeposit_amountnumeric否订金金额0oep261bshipping_amountnumeric否出货金额1782oep262bbalance_amountnumeric否尾款金额0oep263bdoc_approve_setstring否单据签核设定(Y,N)Yso_change_detail—是订单变更单明细档(单身节点，支持多数组)so_seqnumeric是项次1oeq03item_nostring否料件编号01303-Aoeq04aitem_feature_nostring否产品特征不使用bom_featurestring否BOM特性不使用component_featurestring否子件特性不使用sales_unit_nostring否销售单位PCSoeq05aso_qtystring否销售数量80oeq12areference_unit_nostring否参考单位oeq23areference_qtystring否参考数量oeq25avaluation_unitstring否计价单位PCSoeq26avaluation_qtystring否计价数量80oeq27aso_due_datestring否约定交货日格式：yyyyMMdd20230617oeq15areceive_datestring否预定签收日不使用pricenumeric否单价9.9oeq13atax_nostring否税别编号不使用tax_ratenumeric否税率不使用emergencystring否急料不使用customer_item_nostring否客户料号XY-2300792oeq11awarehouse_nostring否限定库位不使用location_nostring否限定储位不使用lot_nostring否限定批号不使用project_codestring否项目编号TU23-001oeq31adelivery_type_nostring否取货模式不使用trans_curr_not_tax_amountnumeric否未税金额742.5oeq14atrans_curr_tax_amountnumeric否含税金额742.5oeq14tatrans_curr_taxnumeric否税额不使用customer_so_seqstring否客户订单项次不使用remarkstring否备注数量增加30oeq50inventory_management_featuresstring否库存管理特征不使用body_closestring否单身结案不使用close_reason_nostring否结案理由码不使用so_change_delivery_detail—否订单变更单交期明细档(子单身节点，支持多数组)so_seqnumeric否项次不使用so_sub_seqnumeric否项序不使用batch_seqnumeric否分批序不使用so_batch_qtynumeric否分批订购数量不使用so_due_datedate否约定交货日期不使用receive_datedate否预计签收日期不使用Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:18d56c33ac9534af91d0ac639c8426d4digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"TIPTOP","name":"tt.oapi.sales.order.change.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","so_no":"订单单号","change_seq":"变更序","so_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是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)000100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果datakeyerp_nostring否ERP编号100-23061701oep01erp_no_primary_keystring否ERP编号-PK1oep02source_nostring否来源单号(编号)100-23061701oep01source_no_primary_keystring否来源单号-PK1oep02参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0：正确<>0：FAIL（原因代码）0sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述执行成功！so_change_master—是订单变更单主档(单头节点，支持多数组)erp_nostring否ERP编号100-23061701oep01erp_no_primary_keystring否ERP编号-PK1oep02source_nostring否来源单号(编号)100-23061701oep01source_no_primary_keystring否来源单号-PK1oep02execute_descriptionstring否执行描述is_auto_confirmstring否是否自动审核(Y,N)NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:663bd876-c894-4d9b-a345-55471fab1bb4digi-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:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果100参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws1380sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述抛转笔数:1笔成功笔数：0笔失败笔数:1笔!so_change_master—是订单变更单主档(单头节点，支持多数组)erp_nostring否ERP编号oep01erp_no_primary_keystring否ERP编号-PKoep02source_nostring否来源单号(编号)100-23061701oep01source_no_primary_keystring否来源单号-PK1oep02execute_descriptionstring否执行描述订单单号不可为空is_auto_confirmstring否是否自动审核(Y,N)NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:663bd876-c894-4d9b-a345-55471fab1bb4digi-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":"是否自动审核"}]}}}
