接口名称tt.oapi.purchase.inspection.return.data.create接口说明建立采购验退单资料程序代号soap_oapi00112输入参数说明参数代号型态是否必填参数说明范例值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.createsrvverstring否接收方产品版本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是验退单号471rvu01source_nostring是来源单号(传入方)D230724001rvu25doc_datedate否单据日期不使用datedate是退货日期格式：yyyyMMdd若无传值则预设值g_today20230724rvu03applicant_nostring是申请人编号01234rvu07application_departmentstring是申请部门00000rvu06receipt_nostring是收货单号452-23072401rvu02remarkstring否备注不使用create_employee_nostring否建档人员编号00272rvuusercreate_datedatetime否资料建立日格式：yyyyMMdd若无传值则预设值g_today20230724rvucratdoc_approve_setstring否单据签核设定purchase_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:cd017fa2a6ccfc39d531bfc61ef1651edigi-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.create","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":"备注","create_employee_no":"建档人员编号","create_date":"资料建立日","doc_approve_set":"单据签核设定","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否执行描述(执行成功则回传空值；执行失败则回传失败描述)is_auto_confirmstring否是否自动审核NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:bd8fac91-e837-4ffc-8073-64b8b6d5d194digi-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":"执行描述","is_auto_confirm":"是否自动审核"}]}}}失败返回参数说明参数代号型态是否必填参数说明范例值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是执行描述(执行成功则回传空值；执行失败则回传失败描述)传入的资料不存在或已失效is_auto_confirmstring否是否自动审核NResponse范例Content-Type:application/json;charset=utf-8digi-code:019digi-message:RUFJIFJlc3BvbnNlOuW5s+WPsOWbnuimhuWQjOatpee1kOaenA==digi-reqid:fe2cb005-f0f0-43ba-8166-cbc50a42509fdigi-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":"执行描述","is_auto_confirm":"是否自动审核"}]}}}
