界面名称tt.oapi.sales.return.details.data.read.get界面说明读取销退单资料程序代号soap_oapi00164输入参数说明参数代号型态是否必填参数说明范例值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是接收方产品名称ttnamestring是服务名称tt.oapi.sales.return.details.data.read.getsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码，提供同一产品多台主机辨别之用topprddatakeyEntIdstring否企业编号CompanyIdstring否营运据点DS1sales_return_nostring否销退单单号参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring否企业编号若无传值则预设值g_enterprisesite_nostring否营运中心DS1is_digiwin_productstring是是否为鼎捷产品(Y,N)sales_return_data—是销退信息(单头节点，支持多数组)sales_return_nostring是销退单单号998-210600000002oha01Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:be35302235ee0951dc881109ee77a79adigi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_TW","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"tt","name":"tt.oapi.sales.return.details.data.read.get","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","sales_return_no":"销退单单号"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","sales_return_data":[{"sales_return_no":"销退单单号"}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000datekeysales_return_nostring是销退单单号998-210600000002oha01参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0：正确<>0：FAIL（原因代码）0sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述sales_return_data—是销退信息(单头节点，支持多数组)sales_return_nostring是销退单单号998-210600000002oha01doc_datedate否单据日期格式：yyyyMMdd若无传值则预设值g_today2021/06/22oha02sales_nostring否业务人员12133oha14sales_namestring否业务人员名称刘季闽gen02sales_department_nostring否业务部门BP0240oha15sales_department_namestring否业务部门名称T产中台中开发部gem02sd_nostring否出货单号oha16customer_nostring是客户编号190910-1oha03customer_namestring否客户名称190910-1测试oha032delivery_customer_nostring否收货客户编号190910-1oha1001delivery_customer_namestring否收货客户名称190910-1测试shipping_return_typestring否销退方式1:销售退回2:销退依原订单出货3:销退产生新订单出货4:销货折让(纯金额折价)5:销退换货(与帐款无关)1payment_condition_nostring否收款条件编号200payment_condition_namestring否收款条件说明200收款用trade_condition_nostring否交易条件编号CFRtrade_condition_namestring否交易条件说明成本加运费tax_nostring否税别编号1251oha21tax_namestring否税别说明1251_testtax_ratenumeric否税率5.00%oha211is_price_taxstring否单价含税否Noha213currencystring否币别RMBoha23currency_namestring否币别说明exchange_ratenumeric否汇率4.000000oha24billing_customerstring否收款客户编号190910-1oha1001billing_customer_namestring否收款客户名称190910-1测试invoice_customer_nostring否发票客户编号190910-1invoice_customer_namestring否发票客户名称190910-1测试invoice_typestring否发票类型2invoice_type_namestring否发票类型说明普通发票internal_external_saleString否内外销1:内销2:外销1oha08rate_calculation_typestring否汇率计算基准1:依订单日汇率2:依Invoice日汇率3:依出货日汇率4:依立帐日汇率5:依立帐日月平均汇率2valuation_method_nostring否取价方式编号P001valuation_method_namestring否取价方式说明销售取价remarkstring否备注oha48sales_classificationstring否销售分类A02oha25sales_classification_descstring否销售分类说明海外交易sales_channel_nostring否销售通路编号002sales_channel_namestring否销售通路说明分销通路002trans_curr_not_tax_amountnumeric否未税金额7,400.00oha50trans_curr_tax_amountnumeric否含税金额7,770.00oha1008trans_curr_taxnumeric否税额370.00statusstring否状态码Sohaconfmodify_nostring否资料修改者12133ohamodumodify_datedatetime否最近修改日期格式：yyyyMMddHHmmss若无传值则预设值cl_get_current()2021-06-2211:49:13ohadateconfirmorstring否确认者12133confirm_datedatetime否确认日yyyyMMddHHmmss若无传值则预设值cl_get_current()2021-06-2211:49:08sales_return_detail—是销退明细(单身节点，支持多数组)seq_nostring是项次1ohb03sd_nostring否出货单号ohb31return_stock_out_seqstring否出库项次ohb32so_nostring否订单单号ohb33so_seqstring否订单项次ohb34so_term_seqstring否订单项序item_nostring是品号KST987-1ohb04item_namestring否物料名称熊大成品ohb06product_featurestring否产品特征item_feature_namestring否产品特征说明qtynumeric是数量7.000000ohb12unit_nostring否单位编号PCSohb05reference_unit_nostring否参考单位PCSreference_qtynumeric否参考数量7.000valuation_unitstring否计价单位PCSvaluation_qtynumeric否计价数量7.000warehouse_nostring否库位编号KST01ohb09warehouse_namestring否仓库名称保税成品半成品location_nostring否储位ohb091storage_spaces_namestring否储位名称lot_nostring否批号ohb092pricenumeric否单价200.0000ohb13tax_nostring否税别编号1251ohb1008tax_namestring否税别说明1251_testtax_ratenumeric否税率5.00%ohb1009trans_curr_not_tax_amountnumeric否未税金额1,400.00ohb14trans_curr_tax_amountnumeric否含税金额1,470.00ohb14ttrans_curr_taxnumeric否税额70.00inventory_management_featuresstring否库存管理特征reason_codestring否理由码001reason_code_namestring否理由码说明质量不佳project_codestring否项目编号project_namestring否项目名称wbs_codestring否WBS编码wbs_describestring否WBS说明activity_nostring否活动编号activity_namestring否活动名称body_remarkstring否单身备注multiple_warehouse_storage_lot_detail—是多库储批明细/多仓库储位批号详情(子单身节点，支持多数组)seq_nonumeric是项次1line_seqnumeric是项序1item_nostring否品号KST987-1item_namestring否物料名称熊大成品product_featurestring否产品特征item_feature_namestring否产品特征说明qtynumeric是数量7.000unit_nostring否单位编号PCSreference_unit_nostring否参考单位reference_qtynumeric否参考数量Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:28093c66-690b-4991-a380-9652f2015a1edigi-protocol:rawdigi-srvver:1.0digi-srvcode:000digi-datakey:{"sales_return_no":"销退单单号"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"sales_return_data":[{"sales_return_no":"销退单单号","doc_date":"单据日期","sales_no":"业务人员","sales_name":"业务人员名称","sales_department_no":"业务部门","sales_department_name":"业务部门名称","sd_no":"出货单号","customer_no":"客户编号","customer_name":"客户名称","delivery_customer_no":"收货客户编号","delivery_customer_name":"收货客户名称","shipping_return_type":"销退方式","payment_condition_no":"收款条件编号","payment_condition_name":"收款条件说明","trade_condition_no":"交易条件编号","trade_condition_name":"交易条件说明","tax_no":"税别编号","tax_name":"税别说明","tax_rate":"税率","is_price_tax":"单价含税否","currency":"币别","currency_name":"币别说明","exchange_rate":"汇率","billing_customer":"收款客户编号","billing_customer_name":"收款客户名称","invoice_customer_no":"发票客户编号","invoice_customer_name":"发票客户名称","invoice_type":"发票类型","invoice_type_name":"发票类型说明","internal_external_sale":"内外销","rate_calculation_type":"汇率计算基准","valuation_method_no":"取价方式编号","valuation_method_name":"取价方式说明","remark":"备注","sales_classification":"销售分类","sales_classification_desc":"销售分类说明","sales_channel_no":"销售通路编号","sales_channel_name":"销售通路说明","trans_curr_not_tax_amount":"未税金额","trans_curr_tax_amount":"含税金额","trans_curr_tax":"税额","status":"状态码","modify_no":"资料修改者","modify_date":"最近修改日期","confirmor":"确认者","confirm_date":"确认日","sales_return_detail":[{"seq_no":"项次","sd_no":"出货单号","return_stock_out_seq":"出库项次","so_no":"订单单号","so_seq":"订单项次","so_term_seq":"订单项序","item_no":"品号","item_name":"物料名称","product_feature":"产品特征","item_feature_name":"产品特征说明","qty":"数量","unit_no":"单位编号","reference_unit_no":"参考单位","reference_qty":"参考数量","valuation_unit":"计价单位","valuation_qty":"计价数量","warehouse_no":"库位编号","warehouse_name":"仓库名称","location_no":"储位","storage_spaces_name":"储位名称","lot_no":"批号","price":"单价","tax_no":"税别编号","tax_name":"税别说明","tax_rate":"税率","trans_curr_not_tax_amount":"未税金额","trans_curr_tax_amount":"含税金额","trans_curr_tax":"税额","inventory_management_features":"库存管理特征","reason_code":"理由码","reason_code_name":"理由码说明","project_code":"项目代号","project_name":"项目名称","wbs_code":"WBS编码","wbs_describe":"WBS说明","activity_no":"活动编号","activity_name":"活动名称","body_remark":"单身备注","multiple_warehouse_storage_lot_detail":[{"seq_no":"项次","line_seq":"项序","item_no":"品号","item_name":"物料名称","product_feature":"产品特征","item_feature_name":"产品特征说明","qty":"数量","unit_no":"单位编号","reference_unit_no":"参考单位","reference_qty":"参考数量"}]}]}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程，并产生预期的结果(Basicflow)100:服务未按照正常流程执行，例如发生信息检核不通过等情况，导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0：正确<>0：FAIL（原因代码）aws-00102sql_codestring否失败时数据库回传代码descriptionstring是错误问题描述[tt_message]处理笔数1,成功0,失败1Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:28093c66-690b-4991-a380-9652f2015a1edigi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"}}}
