接口描述

请求地址： /api/batchSaveAttachment

接口编号：FSSC-API-000138

接口诞生版本：3.8.0

所属系统：电子档案系统

所属微服务：zfs-ers

接口说明：外系统同步电子附件至档案系统归档

单次调用最大条数：1000

注意事项：

1.外系统同步电子附件时需先将电子附件文件上传至我方内部文件服务器，然后将在我方内部文件服务器上的文件路径和结构化数据通过此接口同步给电子档案系统。

2.用文件ID判断是否重复：

⑴若文件内重复,则报重复，同步失败；

⑵若文件内不重复，再判断和系统内的附件是否重复，①如果也不重复，则直接新增，附件表中新增附件和凭证的匹配关系为【未匹配】；②若系统内重复，则判断系统内重复的附件是否为【已匹配】状态，⒜如果为【已匹配】状态，则报重复，同步失败；⒝若为【未匹配】状态，则覆盖更新系统内原附件数据。

3.同一批次，失败的数据不影响成功的数据的写入;

4.推送方注意推送时间：T-360日≦其他附件进入档案日期≦T+360日（T为凭证进入档案的时间）;

请求参数

参数名	中文名称	类型	是否必填	示例	参数说明
▼data		array	Y		请求数据
rowId	行ID	String	N	38ffbdb043f045ed544eb1b9b2ae034b	该参数由接口自动处理，无需传值
rowNum	行号	String	N	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
groupCode	集团CODE	String	Y	XY	1、共享系统中的集团编码值 2、校验同批次内此字段值一致 3、校验存在且有效
sobCode	账套编码	String	Y	ZXXZT	校验在共享系统的当前集团下账套编码是否存在
leCode	核算主体编码	String	Y	ZXXHS	校验在共享系统的当前集团账套下核算主体是否存在
boeNum	匹配关键字	String	Y	ZTEDD-BX2302100019GZH	1、用于和凭证/条目匹配的关键字。比如填值“报账单号"，用于和凭证匹配。 2、文本格式 3、校验字段长度不超过64位
filePath	文件访问路径	String	Y	group1/M00/01/09/wKgCyGOcJOCAGEAVAAKahuF2Hws232.pdf	1、其他附件文件存储的路径：在内部文件服务器上传的路径 2、校验在文件服务器上是否存在
fileName	文件名	String	Y	云山采购合同.pdf	1、文本格式 2、校验字段长度不超过64位
fileId	文件ID	String	Y	ae43563bffffcf30b2b221a3b1b2b7ae3566b	1、文件ID为附件唯一标识，全局唯一 2、文本格式 3、校验字段长度不超过64位
serialNumber	文件流水号	String	N	775759890	1、全局唯一 2、文本格式 3、校验字段长度不超过64位
fileNum	文件编号	String	N	ZXXHS-2023052400001	1、全局唯一 2、文本格式 3、校验字段长度不超过64位
fileNote	备注	String	N	购买电脑1台	1、文本格式 2、校验字段长度不超过64位
uploader	上传人员编码	String	N	20230120	1、单据的提单人/文件上传人，所属的共享系统中的人员编码 2、校验存在和有效
uploadDate	上传时间，单据提单时间	String	N	日期字符串：2023-06-01 11:22:33	日期格式，yyyy-MM-dd HH:mm:ss
ersAttachmentType	其他附件类型	String	N	01	填值，校验在全局编码ERS_ATTACHMENT_TYPE中存在： 01-单据附件、02-银行对账单、03-财务报告、04-会计账簿
expands1	扩展字段1	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands2	扩展字段2	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands3	扩展字段3	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands4	扩展字段4	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands5	扩展字段5	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands6	扩展字段6	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands7	扩展字段7	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands8	扩展字段8	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands9	扩展字段9	String	N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展
expands10	扩展字段10		N		数据库长度500，最大输入长度166字符该字段为预留字段，用于后续拓展

返回参数

参数名	中文名称	参数类型	示例	参数说明
code	编码	string	0	0-全部成功;1-全部失败;2-部分成功
msg	信息	string	全部成功	消息提示
successNum	成功条数	string	0
failNum	失败条数	string	1
▼data	数据	array
rowId	行ID	string		接口平台数据同步标识
rowNum	行号	string	1
errMsg	错误信息	string		每行错误消息

请求参数示例

{
    "data": [
        {
            "boeNum": "ZTEDD-BX2302100019GZH", 
            "extendS8": "", 
            "extendS7": "", 
            "extendS6": "", 
            "extendS5": "", 
            "extendS4": "", 
            "extendS10": "", 
            "extendS3": "", 
            "extendS2": "", 
            "extendS1": "", 
            "extendS9": "", 
            "fileName": "云山采购合同.pdf", 
            "fileNum": "ZXXHS-2023052400001", 
            "filePath": "group1/M01/A2/0E/rBK9KGU4e6-AcMWKAANCPHjsi3g705.rar", 
            "fileNote": "购买电脑1台", 
            "fileId": "ae43563bffffcf30b2b221a3b1b2b7ae3566b", 
            "groupCode": "ZTEDD", 
            "leCode": "HHS01", 
            "rowId": "38ffbdb043f045ed544eb1b9b2ae034b", 
            "rowNum": "1", 
            "serialNumber": "775759890", 
            "sobCode": "HHZT", 
            "uploadDate": "2024-01-01 11:22:33", 
            "uploader": "20210120"
        }
    ]
}

返回参数示例

{
  "msg": "全部成功",
  "code": "0",
  "failNum": "0",
  "data": [],
  "successNum": "1"
}

标准其他附件批量同步接口（3.8.0）

标准其他附件批量同步接口（3.8.0）

关于作者

目录