接口名称tt.oapi.purchase.inspection.return.data.update接口说明更新采购验退单程序代号soap_oapi00113输入参数说明参数代号型态是否必填参数说明范例值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是接收方产品名称TIPTOPnamestring是服务名称tt.oapi.purchase.inspection.return.data.updatesrvverstring否接收方产品版本1.0ipstring否接收方IP位置10.20.86.223idstring否接收方产品识别码,提供同一产品多台主机辨别之用topprddatakeyEntIdstring否企业编号CompanyIdstring否营运据点DS1参数代号型态是否必填参数说明范例值ERP字段enterprise_nostring否企业编号不使用site_nostring否营运据点不使用is_digiwin_productstring是是否为鼎捷产品(Y,N)Ypurchase_inspection_return—是采购验退(单头节点,支持多数组)doc_typenumeric是单据性质1.验退单'REG'、2.委外验退单'SUB'1rvu00+rvu08doc_nostring是验退单号471-23070001rvu01source_nostring是来源单号(传入方)D230724001rvu25doc_datedate是单据日期不使用datedate是退货日期格式:yyyyMMdd若无传值则预设值g_today20230724rvu03applicant_nostring是申请人编号01234rvu07application_departmentstring是申请部门00000rvu06receipt_nostring是收货单号452-23072401rvu02remarkstring是备注不使用modify_nostring否资料修改者00272rvumodumodify_datedatetime否资料修改日格式:yyyyMMdd若无传值则预设值g_today20230724rvudatepurchase_inspection_return_detail—是采购验退明细(单身节点,支持多数组)seqnumeric是项次1rvv02receipt_nostring是收货单号452-23072401rvv04receipt_seqnumeric是收货项次1rvv05purchase_nostring是采购单号423-23020001rvv36purchase_seqnumeric是采购项次1rvv37line_seqnumeric是采购项序不使用batch_seqnumeric是采购分批序不使用item_nostring是料件编号01303-Arvv31unit_nostring是单位PCSrvv35doc_qtynumeric是退货数量2rvv17reference_unit_nostring是参考单位不使用reference_qtynumeric是参考数量不使用valuation_unit_nostring是计价单位PCSrvv86valuation_qtynumeric是计价数量2rvv87qc_nostring是验收单号不使用qc_seqnumeric是验收单项次不使用shipping_nostring是出货单号不使用shipping_seqnumeric是出货单项次不使用body_remarkdate是单身备注不使用Request范例Content-Type:application/json;charset=utf-8digi-protocol:rawdigi-type:syncdigi-key:774fe02e2b6ebabfdce1a238252a96c3digi-host:{"prod":"OAPI","ip":"10.20.88.30","lang":"zh_CN","timestamp":"20161018132542116","acct":"tiptop"}digi-service:{"prod":"TIPTOP","name":"tt.oapi.purchase.inspection.return.data.update","ip":"10.20.88.75","id":"topprod"}digi-datakey:{"EntId":"企业编号","CompanyId":"营运据点"}{"std_data":{"parameter":{"enterprise_no":"企业编号","site_no":"营运据点","is_digiwin_product":"是否为鼎捷产品","purchase_inspection_return":[{"doc_type":"单据性质","doc_no":"验退单号","source_no":"來源單號(傳入方)","doc_date":"单据日期","date":"退货日期","applicant_no":"申请人编号","application_department":"申請部門","receipt_no":"收货单号","remark":"备注","modify_no":"资料修改者","modify_date":"资料修改日","purchase_inspection_return_detail":[{"seq":"项次","receipt_no":"收货单号","receipt_seq":"收货项次","purchase_no":"采购单号","purchase_seq":"采购项次","line_seq":"采购项序","batch_seq":"采购分批序","item_no":"料件编号","unit_no":"单位","doc_qty":"退货数量","reference_unit_no":"参考单位","reference_qty":"参考数量","valuation_unit_no":"计价单位","valuation_qty":"计价数量","qc_no":"验收单号","qc_seq":"验收单项次","shipping_no":"出货单号","shipping_seq":"出货单项次","body_remark":"单身备注"}]}]}}}成功返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如发生信息检核不通过等情况,导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0:正确<>0:FAIL(原因代码)00sql_codestring否失败时数据库回传代码00descriptionstring是错误问题描述purchase_inspection_return—是采购验退(单头节点,支持多数组)erp_nostring是ERP编号(执行成功时把PK值回传,若执行失败回传空值)471-23070001rvu01source_nostring是来源单号(编号)回传入参中的PK(来源单号)字段值。D230724001rvu25execute_descriptionstring否执行描述(执行成功则回传空值;执行失败则回传失败描述)Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:6729c85b-f947-4802-bfab-142961a9248edigi-protocol:rawdigi-srvver:1.0digi-srvcode:000{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"purchase_inspection_return":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值ERP字段srvverstring是服务版本1.0srvcodestring是服务执行结果状态代码000:服务按照正常流程,并产生预期的结果(Basicflow)100:服务未按照正常流程执行,例如发生信息检核不通过等情况,导致无法完成预期的结果000参数代号型态是否必填参数说明范例值ERP字段statuscodestring是错误码0:正确<>0:FAIL(原因代码)aws1380sql_codestring否失败时数据库回传代码0descriptionstring是错误问题描述抛转笔数:1笔成功笔数:0笔失败笔数:1笔purchase_inspection_return—是采购验退(单头节点,支持多数组)erp_nostring否ERP编号(执行成功时把PK值回传,若执行失败回传空值)source_nostring是来源单号(编号)回传入参中的PK(来源单号)字段值。D230724001rvu25execute_descriptionstring是执行描述(执行成功则回传空值;执行失败则回传失败描述)传入的资料不存在或已失效Response范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:f8be8261-b0c6-48b1-a4ae-6b807988f43ddigi-protocol:rawdigi-srvver:1.0digi-srvcode:100{"std_data":{"execution":{"code":"错误码","sql_code":"数据库回传代码","description":"错误问题描述"},"parameter":{"purchase_inspection_return":[{"erp_no":"ERP编号","source_no":"来源单号(编号)","execute_description":"执行描述"}]}}}