接口名称tt.oapi.sales.order.details.data.read.get接口说明读取销售订单明细资料程序代号soap_oapi00002输入参数说明参数代号型态是否必填参数说明范例值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是接收方产品名称TIOTOPnamestring是服务名称tt.oapi.sales.order.details.data.read.getsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring否企业编号CompanyIdstring否营运据点参数代号型态是否必填参数说明范例值ERP字段enterprise_nostring否企业编号不使用site_nostring否营运中心不使用is_digiwin_productstring是是否为鼎捷产品(Y,N)Yso_master—是订单主档(单头节点，支持多数组)so_nostring是订单单号100-23051601oea01Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:eb0e748c8386c32da605a141342fda42digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"TIPTOP","name":"tt.oapi.sales.order.details.data.read.get","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":"订单单号"}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0：正确<>0：FAIL（原因代码）0sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述so_master—是订单变更单主档(单头节点，支持多数组)om_company_idstring否营运公司编号DS1oeaplantso_nostring是订单单号100-23051601oea01versionnumeric否版次0oea06doc_typestring否单别100oea01前3码doc_type_namestring否单别名称订单oaydescso_datedate是订单日期格式：yyyy-mm-dd2023-05-16oea02sales_nostring是业务人员D001oea14sales_namestring否业务人员名称陈小帅gen02sales_department_nostring是业务部门S0001oea15sales_department_namstring否业务部门名称业务部gem02ecustomer_nostring是客户编号00001oea03customer_namestring否客户名称鼎新计算机oea032customer_full_namestring否客户全称鼎新计算机股份有限公司occ18so_kindstring是订单性质1.一般订单2.换货订单3.出至境外仓4.境外仓出货6.调货订单7.寄销订单1oea00source_typestring是资料来源1.输入2.退补3.合约转入4.估价单转入5.报价单转入7.出至境外仓出货X.EC转入Y.CRM报价单Z.CRM样品申请单W.协作转入5oea11source_nostring否来源单号B50-00000023oea12payment_condition_nostring否收款条件编号212oea32payment_condition_namestring否收款条件说明212收款用oag02trade_condition_nostring否交易条件编号不使用trade_condition_namestring否交易条件说明不使用tax_nostring否税别编号S000oea21tax_namestring否税别说明销项零税率0%gec02tax_ratenumeric否税率0oea211is_price_taxstring否单价含税否Noea213currencystring否币别CNYoea23exchange_ratenumeric否汇率4.42212oea24valuation_method_nostring否取价方式编号不使用valuation_method_namestring否取价方式说明不使用customer_contractor_nostring否客户连络人编号不使用customer_contractor_namestring否客户连络人名称不使用sales_channel_nostring否销售通路编号不使用sales_channel_namestring否销售通路说明不使用retain_cause_nostring否留置原因代码oeaholdretain_cause_namestring否留置原因说明oak02customer_so_nostring否客户订购单号CUS-2305001oea10invoice_typestring否发票类型不使用invoice_type_namestring否发票类型说明不使用total_trans_curr_not_tax_amountnumeric是订单总未税金额400oea61total_trans_curr_tax_amountnumeric是订单总含税金额400oea1008total_trans_curr_taxnumeric是订单总税额0oea1008-oea61rate_calculation_typestring否汇率计算基准不使用delivery_addressstring否出货地址A0001oea044delivery_address_descstring否出货地址说明台中市台湾大道100号之1ocd221+ocd222+ocd223+ocd230+ocd231以上5个地址字段字符串串在一起billing_addressstring否帐款地址不使用billing_address_descstring否帐款地址说明不使用confirmorstring否审核者不使用confirm_datestring否审核日格式：yyyy-mm-dd2023-05-16oea72statusstring否状态码N:未审核Y:已审核X:已作废Yoeaconfremarkstring否备注oao06so_detail—是订单主要明细档(单身节点，支持多数组)so_seqnumeric是项次1oeb03item_nostring是料件编号8003000003oeb04item_namestring否料件品名滚轮oeb06item_specstring否料件规格滚轮6mmima021item_feature_nostring否产品特征不使用item_feature_namestring否产品特征说明不使用bom_featurestring否BOM特性不使用component_featurestring否子件特性不使用sales_unit_nostring否销售单位PCSoeb05sales_unit_namestring否销售单位名称件gfe02so_qtystring否销售数量100oeb12reference_unit_nostring否参考单位oeb913reference_qtystring否参考数量oeb915valuation_unitstring否计价单位PCSoeb916valuation_qtystring否计价数量100oeb917so_due_datestring否约定交货日2023-05-31oeb15receive_datestring否预定签收日不使用pricenumeric是单价4oeb13tax_nostring是税别编号S000oea21tax_namestring否税别说明销项零税率0%gec02tax_ratenumeric否税率0oea211emergencystring否急料不使用customer_item_nostring否客户料号oeb11warehouse_nostring否仓库编号A89oeb09warehouse_namestring否仓库名称原料仓imd02storage_spaces_nostring否储位001oeb091storage_spaces_namestring否储位名称第1储位ime03lot_nostring否批号oeb092project_codestring否项目编号oeb41project_namestring否项目名称pja02trans_curr_not_tax_amountnumeric否未税金额400oeb14trans_curr_tax_amountnumeric否含税金额400oeb14ttrans_curr_taxnumeric否税额0oeb14t-oeb14customer_so_seqstring否客户订单项次3oeb71remarkstring否备注oao06statusstring否状态码不使用so_delivery_detail—是订单交期明细档(子单身节点，支持多数组)so_seqnumeric否项次不使用so_sub_seqnumeric否项序不使用batch_seqnumeric否分批序不使用item_nostring是料件编号不使用item_feature_nostring否产品特征不使用component_featurestring否子件特性不使用sales_unit_nostring是销售单位不使用so_qtynumeric否订购总数量不使用so_batch_qtynumeric否分批订购数量不使用so_due_datedate否约定交货日期不使用receive_datedate否预计签收日期不使用sales_notice_qtynumeric否已转出通数量不使用shipping_qtynumeric否已出货量不使用shipping_return_qtynumeric否已销退量不使用shipping_return_change_qtynumeric否销退换货数量不使用reference_unit_nostring否分批参考单位不使用reference_qtynumeric否分批参考数量不使用valuation_unitstring否分批计价单位不使用valuation_qtynumeric否分批计价数量不使用trans_curr_not_tax_amountnumeric否分批未税金额不使用trans_curr_tax_amountnumeric否分批含税金额不使用trans_curr_taxnumeric否分批税额不使用Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:22e4f4f5-a8d5-435a-accf-c49ad00312a7digi-protocol:rawdigi-srvver:1.0digi-srvcode:000{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"so_master":[{"om_company_id":"营运公司编号","so_no":"订单单号","version":"版次","doc_type":"单别","doc_type_name":"单别名称","so_date":"订单日期","sales_no":"业务人员","sales_name":"业务人员名称","sales_department_no":"业务部门","sales_department_name":"业务部门名称","customer_no":"客户编号","customer_name":"客户名称","customer_full_name":"客户全称","so_kind":"订单性质","source_type":"资料来源","source_no":"来源单号","payment_condition_no":"收款条件编号","payment_condition_name":"收款条件说明","trade_condition_no":"交易条件编号","trade_condition_name":"交易条件说明","tax_no":"税别编号","tax_name":"税别说明","tax_rate":"税率","is_price_tax":"单价含税否","currency":"币别","exchange_rate":"汇率","valuation_method_no":"取价方式编号","valuation_method_name":"取价方式说明","customer_contractor_no":"客户连络人编号","customer_contractor_name":"客户连络人名称","sales_channel_no":"销售通路编号","sales_channel_name":"销售通路说明","retain_cause_no":"留置原因代码","retain_cause_name":"留置原因说明","customer_so_no":"客户订购单号","invoice_type":"发票类型","invoice_type_name":"发票类型说明","total_trans_curr_not_tax_amount":"订单总未税金额","total_trans_curr_tax_amount":"订单总含税金额","total_trans_curr_tax":"订单总税额","rate_calculation_type":"汇率计算基准","delivery_address":"出货地址","delivery_address_desc":"出货地址说明","billing_address":"帐款地址","billing_address_desc":"帐款地址说明","confirmor":"审核者","confirm_date":"审核日","status":"状态码","remark":"备注","so_detail":[{"so_seq":"项次","item_no":"料件编号","item_name":"料件品名","item_spec":"料件规格","item_feature_no":"产品特征","item_feature_name":"产品特征说明","bom_feature":"BOM特性","component_feature":"子件特性","sales_unit_no":"销售单位","sales_unit_name":"销售单位名称","so_qty":"销售数量","reference_unit_no":"参考单位","reference_qty":"参考数量","valuation_unit":"计价单位","valuation_qty":"计价数量","so_due_date":"约定交货日","receive_date":"预定签收日","price":"单价","tax_no":"税别编号","tax_name":"税别说明","tax_rate":"税率","emergency":"急料","customer_item_no":"客户料号","warehouse_no":"仓库编号","warehouse_name":"仓库名称","storage_spaces_no":"储位","storage_spaces_name":"储位名称","lot_no":"批号","project_code":"项目编号","project_name":"项目名称","trans_curr_not_tax_amount":"未税金额","trans_curr_tax_amount":"含税金额","trans_curr_tax":"税额","customer_so_seq":"客户订单项次","remark":"备注","status":"状态码","so_delivery_detail":[{"so_seq":"项次","so_sub_seq":"项序","batch_seq":"分批序","item_no":"料件编号","item_feature_no":"产品特征","component_feature":"子件特性","sales_unit_no":"销售单位","so_qty":"订购总数量","so_batch_qty":"分批订购数量","so_due_date":"约定交货日期","receive_date":"预计签收日期","sales_notice_qty":"已转出通数量","shipping_qty":"已出货量","shipping_return_qty":"已销退量","shipping_return_change_qty":"销退换货数量","reference_unit_no":"分批参考单位","reference_qty":"分批参考数量","valuation_unit":"分批计价单位","valuation_qty":"分批计价数量","trans_curr_not_tax_amount":"分批未税金额","trans_curr_tax_amount":"分批含税金额","trans_curr_tax":"分批税额"}]}]}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果100参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws-132sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述没有传入资料Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:22e4f4f5-a8d5-435a-accf-c49ad00312a7digi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"}}}
