界面名称tt.oapi.sales.return.data.create界面说明创建销退单资料程序代号soap_oapi00162输入参数说明参数代号型态是否必填参数说明范例值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.data.createsrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码,提供同一产品多台主机辨别之用topprddatakeyEntIdstring否企业编号CompanyIdstring否营运据点DS1doc_type_nostring否单别参数代号型态是否必填参数说明范例值ERP栏位enterprise_nostring否企业编号若无传值则预设值g_enterprisesite_nostring否营运中心DS1is_digiwin_productstring是是否为鼎捷产品(Y,N)sales_return_data—是销退信息(单头节点,支持多数组)source_nostring是来源单号oha01doc_type_nostring是单别998-210600000002doc_datedate否单据日期格式:yyyyMMdd若无传值则预设值g_today2021/06/22sales_nostring否业务人员12133sales_department_nostring否业务部门BP0240sd_nostring否出货单号customer_nostring是客户编号payment_condition_nostring否收款条件编号190910-1trade_condition_nostring否交易条件编号200tax_nostring否税别编号1251currencystring否币别RMBexchange_ratenumeric否汇率4.000000billing_customerstring否收款客户编号190910-1invoice_customer_nostring否发票客户编号190910-1invoice_typestring否发票类型2internal_external_saleString否内外销1:内销2:外销1rate_calculation_typestring否汇率计算基准1:依订单日汇率2:依Invoice日汇率3:依出货日汇率4:依立帐日汇率5:依立帐日月平均汇率2valuation_method_nostring否取价方式编号P001remarkstring否备注create_employee_nostring否建档人员编号12133create_datedate否资料创建日格式:yyyyMMddHHmmss若无传值则预设值cl_get_current()2021-06-2211:39:07doc_approve_setstring否单据签核设定sales_return_detail—是销退明细(单身节点,支持多数组)seq_nostring是项次1sd_nostring否出货单号return_stock_out_seqstring否出库项次so_nostring否订单单号so_seqstring否订单项次so_term_seqstring否订单项序batch_seqstring否订单分批序item_nostring是品号KST987-1product_featurestring否产品特征qtynumeric是数量7.000000unit_nostring否单位编号PCSwarehouse_nostring否库位编号KST01location_nostring否储位lot_nostring否批号inventory_management_featuresstring否库存管理特征reason_codestring否理由码001project_codestring否项目编号wbs_codestring否WBS编码activity_nostring否活动编号body_remarkstring否单身备注Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:11d965150f91489ab38263fb679ad29adigi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_TW","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"tt","name":"tt.oapi.sales.return.data.create","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点","doc_type_no":"单别"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","sales_return_data":[{"source_no":"来源单号","doc_type_no":"单别","doc_date":"单据日期","sales_no":"业务人员","sales_department_no":"业务部门","sd_no":"出货单号","customer_no":"客户编号","payment_condition_no":"收款条件编号","trade_condition_no":"交易条件编号","tax_no":"税别编号","currency":"币别","exchange_rate":"汇率","billing_customer":"收款客户编号","invoice_customer_no":"发票客户编号","invoice_type":"发票类型","internal_external_sale":"内外销","rate_calculation_type":"汇率计算基准","valuation_method_no":"取价方式编号","remark":"备注","create_employee_no":"建档人员编号","create_date":"资料创建日","doc_approve_set":"单据签核设定","sales_return_detail":[{"seq_no":"项次","sd_no":"出货单号","return_stock_out_seq":"出库项次","so_no":"订单单号","so_seq":"订单项次","so_term_seq":"订单项序","item_no":"品号","product_feature":"产品特征","qty":"数量","unit_no":"单位编号","warehouse_no":"库位编号","location_no":"储位","lot_no":"批号","inventory_management_features":"库存管理特征","reason_code":"理由码","project_code":"项目代号","wbs_code":"WBS编码","activity_no":"活动编号","body_remark":"单身备注"}]}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如000发生信息检核不通过等情况,导致无法完成预期的结果datakeyerp_nostring是ERP编号998-210600000002oha01source_nostring是来源单号(编号)998-210600000002oha01参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0:正确<>0:FAIL(原因代码)0sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述sales_return_data—是销退信息(单头节点,支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传,若执行失败回传空值)998-210600000002oha01source_nostring否来源单号(编号)回传入参中的PK(来源单号)栏位值。998-210600000002oha01execute_descriptionstring否执行描述(执行成功则回传空值;执行失败则回传失败描述)is_auto_confirmstring否是否自动审核NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:75341395-aa51-465c-a058-e88973686da9digi-protocol:rawdigi-srvver:1.0digi-srvcode:000digi-datakey:{"erp_no":"ERP编号","source_no":"来源单号(编号)"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"sales_return_data":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动确认"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP栏位srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如发生信息检核不通过等情况,导致无法完成预期的结果000datakeyerp_nostring是ERP编号998-210600000002oha01source_nostring是来源单号(编号)998-210600000002oha01参数代号型态是否必填参数说明范例值ERP栏位statuscodestring是错误码0:正确<>0:FAIL(原因代码)aws-00102sql_codestring否失败时数据库回传代码descriptionstring是错误问题描述[tt_message]处理笔数1,成功0,失败1sales_return_data—是销退信息(单头节点,支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传,若执行失败回传空值)oha01source_nostring否来源单号(编号)回传入参中的PK(来源单号)栏位值。998-210600000002oha01execute_descriptionstring否执行描述(执行成功则回传空值;执行失败则回传失败描述)传入的资料不存在或已失效is_auto_confirmstring否是否自动审核NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:75341395-aa51-465c-a058-e88973686da9digi-protocol:rawdigi-srvver:1.0digi-srvcode:100digi-datakey:{"erp_no":"ERP编号","source_no":"来源单号(编号)"}{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"sales_return_data":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述","is_auto_confirm":"是否自动确认"}]}}}