接口描述

请求地址：/api/batchElectronicReceipt

接口编号：FSSC-API-000137

接口诞生版本：3.8.0

所属系统：电子档案系统

所属微服务：zfs-ers

接口说明：外系统批量同步电子回单至档案系统归档

单次调用最大条数：1000

注意事项：

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

2.通过“回单编号+交易流水号+收款账号+付款账号+金额+交易日期+交易类型+币种+档案流水号+报账单号”（ebankslipNo+transFlow+recAccNo+payAccNo+transAmount+transDate+transType+transCurreny+voucherSeq+boeNum）组合校验是否重复：

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

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

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	N	ZXXZT	校验在共享系统的当前集团下账套编码是否存在
leCode	核算主体编码	String	Y	ZXXHS	校验在共享系统的当前集团账套下核算主体是否存在
bankReceiptId	电子回单主键ID	String	Y		1、网银系统回单表唯一性字段 2、文本格式 3、校验字段长度不超过64位
ebankslipNo	回单编号	String	N	0008541128816	1、文本格式 2、校验字段长度不超过64位 3、“回单编号+交易流水号+收款账号+付款账号+金额+交易日期+交易类型+币种+档案流水号+报账单号”组合校验回单是否重复
transType	交易类型	String	Y	其他	1、文本格式 2、校验字段长度不超过64位
transDate	记账日期，交易日期	String	Y	2023/05/24	日期格式：yyyy-mm-dd 或yyyy/mm/dd
transFlow	交易流水号	String	N	20230524030000001	1、文本格式 2、校验字段长度不超过64位
transCurreny	交易币种	String	N	CNY	校验在共享系统中币种编码是否存在
transAmount	交易金额	String	N	500	仅支持输入金额（正负0都支持），金额格式统一为13+2
payAccName	付款户名	String	N	长沙百兴服务有限公司	1、文本格式 2、校验字段长度不超过64位
payAccNo	付款账号	String	N	9886875436	1、文本格式 2、校验字段长度不超过64位
payAccBank	付款账号开户行	String	N	中信银行长沙支行营业部	1、文本格式 2、校验字段长度不超过64位
recAccName	收款户名	String	N	中兴新云服务有限公司	1、文本格式 2、校验字段长度不超过64位
recAccNo	收款账号	String	N	987488888	1、文本格式 2、校验字段长度不超过64位
recAccBank	收款账号开户行	String	N	中信银行深圳支行营业部	1、文本格式 2、校验字段长度不超过64位
voucherSeq	档案流水号	String	N	ZXXHS-202305240000345	1、回单关联的档案流水号（凭证流水号：凭证主键字段。）； 2、文本格式； 3、支持填写多个，多个时用 ^符号分割，不得超过100个，每个流水号不能超过64位字符：超过100个，则提示：档案流水号超过上限100个。单个档案流水号不超过64位字符长度，否则报错提示“单个voucherSeq不得超过64位字符长度” 4、若回单关联的档案流水号或者报账单号存在多个时，档案写入优先按档案流水号分开存储（只要有一个字段存在多个，则只取档案流水号的个数，作为写入的条数，报账单号不写入）。比如，回单A关联档案流水号B、C，关联报账单号D，那么档案在写入时，写入2条数据：a、回单A关联档案流水B，关联报账单号为空；b、回单A关联档案流水C，关联报账单号为空。只有当两条数据都通过校验写入成功，才返回这个回单写入成功，否则都不写入，返回失败。 5、自动匹配时，优先按照档案流水号进行匹配
boeNum	报账单号	String	N	ZTEDD-BX2302100018GZH	1、回单关联的报账单号； 2、文本格式； 3、支持输入多个，多个时用 ^符号分割，不得超过100个，每个报账单号不能超过64位字符：超过100个，则提示：报账单号超过上限100个。单个报账单号不超过64位字符长度，否则报错提示“单个boeNum不得超过64位字符长度” 4、若回单关联的档案流水号或者报账单号存在多个时，档案写入优先按档案流水号分开存储（只要有一个字段存在多个，则只取档案流水号的个数，作为写入的条数，报账单号不写入）。比如，回单A关联档案流水号B、C，关联报账单号D，那么档案在写入时，写入2条数据：a、回单A关联档案流水B，关联报账单号为空；b、回单A关联档案流水C，关联报账单号为空。只有当两条数据都通过校验写入成功，才返回这个回单写入成功，否则都不写入，返回失败。 5、自动匹配时，优先按照档案流水号进行匹配
bankSource	回单来源	String	N	中信银行	1、文本格式 2、校验字段长度不超过64位
filePath	文件路径	String	Y	group1/M00/01/09/wKgCyGOcJOCAGEAVAAKahuF2Hws232.pdf	1、电子回单文件存储的路径：内部文件服务器上传的路径。注意：如果是外部服务器路径，则项目还需自己二开相关逻辑，打通财务云查看外部文件服务器文件的通道。通过在内部文件服务器中，获得电子回单文件的地址; 2、校验在文件服务器上是否存在
identifyingCode	校验码	String	N	C103031100045520190303，90296600243000000000019444	记录银行电子回单的唯一标识，即由银行电子回单签发机构、回单编号和校验位共同构成（试点电子凭证适用）
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	String	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": [
        {
            "bankReceiptId": "38ffbdb043f045ed544eb1b9b2ae034b", 
            "bankSource": "中信银行", 
            "boeNum": "ZTEDD-BX2302100018GZH", 
            "expands4": "", 
            "expands3": "", 
            "expands2": "", 
            "expands1": "", 
            "expands8": "", 
            "expands7": "", 
            "expands6": "", 
            "expands5": "", 
            "ebankslipNo": "0008541128817", 
            "expands9": "", 
            "expands10": "", 
            "filePath": "group1/2024/01/30/5F23CB9A8AF89FDDFDD5B1B7B2AE2605.pdf", 
            "groupCode": "ZTEDD", 
            "leCode": "HHS01", 
            "payAccName": "长沙百兴服务有限公司", 
            "payAccBank": "中信银行长沙支行营业部", 
            "payAccNo": "9886875436", 
            "recAccBank": "中信银行深圳支行营业部", 
            "rowNum": "1", 
            "rowId": "38ffbdb043f045ed544eb1b9b2ae034b", 
            "recAccName": "中兴新云服务有限公司", 
            "recAccNo": "987488888", 
            "sobCode": "", 
            "transDate": "2024/01/24", 
            "transFlow": "20230524030000001", 
            "transCurreny": "CNY", 
            "transAmount": "500", 
            "transType": "其他", 
            "voucherSeq": "ZXXHS-202305240000345"
        }
    ]
}

返回参数示例

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

标准银行回单批量同步接口(3.8.0)

标准银行回单批量同步接口(3.8.0)

关于作者

目录