接口描述

请求地址：域名/openapi/zfs-ers/api/batchSaveVoucherAsync

接口编号：FSSC-API-000142

接口诞生版本：V3.8.5

所属系统：电子档案系统

所属微服务：zfs-ers

接口说明：接收外部核算系统会计凭证数据至电子档案系统

单次调用最大条数：1000

注意事项：

1、此接口接收数据时需做的前置校验：

1.批次条数限制校验（单批次推送的数据量最多不超过1000条，单条数据（单个凭证）的子数据（凭证行列表）不超过20000条，单批次推送的总凭证行数不超过100000条;

2.校验入参中的“批次号”必填、长度、同一批次唯一、数据库唯一；

3.每批次只能同步同一集团同一档案类型的凭证；

只要有一条数据不满足校验，则整个批次返回接收失败，接收后返回接收结果给外系统。

2、我方系统最多一次同时接收100万条数据进行处理，如果一次同步的数据超出100万，请通过查询接口查询批次是否已处理完后再同步数据。

3、接收数据后，档案异步执行入库，执行入库时按文档所示进行校验：

1.通过“凭证编号+账套+核算主体+会计期间+档案小类”（voucherNum+sobCode+leCode+periodName+voucherType）组合校验唯一性：

①若凭证已在系统存在，则需判断凭证的状态：

⑴如果是【草稿】、【未匹配】状态，则更新所有变更字段，但凭证原始状态不变，附件关联关系保持不变，生成封面标识修改为未生成封面（0），覆盖更新；

⑵如果是【已匹配】【审核已退回】、【待审核】状态，还需判断报账单号和凭证流水号字段是否有更新

⒜无，则更新所有变更字段，但凭证原始状态不变，附件关联关系保持不变，生成封面标识修改为未生成封面（0），覆盖更新；

⒝有，则提示不允许更新

⑶如果已存在的凭证状态不是这几种状态，则此条数据同步失败；

②若“凭证编号+账套+核算主体+会计期间+档案小类”（voucherNum+sobCode+leCode+periodName+voucherType）五项不一致，则新增一条凭证信息，状态为【未匹配】;

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

4、外系统可通过“”凭证异步同步结果查询接口“”进行同步状态的查询。

请求参数

参数名	中文名称	类型	是否必填	示例	参数说明
▼data		array	Y		请求数据
rowId	行ID	String	N	38ffbdb043f544e034b	该参数由接口自动处理，无需传值
rowNum	行号	String	N	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
batchName	批次号	String	Y	be43563bffffcf30b539b	1、核算系统导入处理的批次信息，需唯一 2、文本格式，校验字段长度不超过64位
groupCode	集团CODE	String	Y	XY	1、共享系统中的集团编码值 2、校验同批次内此字段值一致 3、校验存在且有效
voucherType	档案小类	String	Y	ZE	1.档案系统中的档案小类编码值 2.校验同批次唯一 3、校验是否有效
secretGrade	档案密级	String	模板配置	CATAGORY_SECURITY_OPEN	填值校验是否在全局编码ERS_CATAGORY_SECURITY存在： CATAGORY_SECURITY_TOP_SECRET：绝密 CATAGORY_SECURITY_OPEN：对内公开 CATAGORY_SECURITY_SECRET：机密不填值，默认赋值“CATAGORY_SECURITY_OPEN：对内公开”
voucherNum	凭证编号	String	Y	ZE001	凭证编号为文本格式，校验字段长度不超过64位
currencyCode	币种	String	Y	CNY	1、共享系统的币种编码 2、校验是否存在
periodName	会计期间	String	Y	202305	会计期间为日期格式yyyyMM
sobCode	账套编码	String	Y	ZT001	校验在共享系统的当前集团下账套编码是否存在
leCode	核算主体编码	String	Y	XYTX	校验在共享系统的当前集团账套下核算主体是否存在
bizCategoryCode	业务类型编码	String	模板配置	ZSF	校验在共享中配置的业务类型编码是否存在
boeTypeCode	单据类型编码	String	模板配置	HHCLBZD	校验在共享中配置的单据类型编码是否存在
boeNum	报账单号	String	特殊必填	XY-001^XY-002	1、报账单号和凭证流水号必填其一； 2、若存在关联多个报账单号，尖角符号表示间隔 3、文本格式，校验字段长度不超过500位
voucherSeqValue	凭证流水号	String	特殊必填	PZ000001	1、凭证流水号为核算系统凭证唯一键，校验唯一性； 2、文本格式，校验字段长度不超过64位 3、报账单号和凭证流水号必填其一；
attachment	纸质附件张数	String	模板配置	10	只允许输入非负整数，且校验字段长度不超过4位，输入其他，则提示：attachment仅支持4位非负整数
voucherAmount	凭证金额	String	模板配置	12.34	仅支持输入金额（正负0都支持），金额格式统一为13+2，输入其他，则提示：voucherAmount仅支持13+2的数字格式
voucherDate	凭证日期（总账日期）	String	Y	2023-05-01	日期格式为yyyy-mm-dd
userDate	制单日期	String	模板配置	2023-05-01	日期格式为yyyy-mm-dd
approverDate	复核日期	String	模板配置	2023-05-01	日期格式为yyyy-mm-dd
bookKeepDate	记账日期	String	模板配置	2023-05-01	日期格式为yyyy-mm-dd
voucherName	凭证名称/摘要	String	模板配置	手续费	文本格式，校验字段长度不超过500位
serialNumber	序列号	String	模板配置	1	1、凭证连号分册时可用该字段排序 2、填值校验为正整数，且位数不超过16位
voucherSource	凭证来源	String	模板配置	金蝶接口同步	1、数据的来源说明; 2、校验字段长度不超过64位
xblnr	SAP_参考凭证号	String	N	SAP_XY_123	文本格式，校验字段长度不超过64位
originVoucherId	凭证原主键	String	Y	ce43563bffffcf30b539b	1、第三方系统中的凭证主键ID； 2、文本格式，校验字段长度不超过64位
originVoucherStatus	凭证原状态	String	N	已过账	1、在核算系统的状态； 2、文本格式，校验字段长度不超过64位
voucherCategory	凭证类别	String	N	付款凭证	文本格式，校验字段长度不超过64位
user	制单人	String	模板配置	张三	文本格式，校验字段长度不超过64位
approver	复核人	String	模板配置	李四	文本格式，校验字段长度不超过64位
financeExecutive	会计主管	String	模板配置	王五	文本格式，校验字段长度不超过64位
cashier	出纳	String	模板配置	赵六	文本格式，校验字段长度不超过64位
account	报销人	String	模板配置	孙七	文本格式，校验字段长度不超过64位
bookKeeper	记账人	String	模板配置	周八	文本格式，校验字段长度不超过64位
expands1	扩展字段1	String	模板配置		1.校验根据自定义模板配置决定（模板配置使用时才会启用，否则本字段不启用）： 2.若配置为文本，则校验是否在配置的长度范围之内 3.若配置为数字，则则校验是否在配置的长度范围之内 4.若配置为金额，则校验格式是否满足13+2 5.若配置为日期，则校验格式，是否为yyyy-mm-dd或者yyyy/mm/dd 6.若配置为选择框(单选、多选、下拉、弹出)，则校验在选择的数据源范围内是否存在：档案主数据、快速编码（只校验第二级）、基础数据需校验数据存在且有效。"
expands2	扩展字段2	String	模板配置
expands3	扩展字段3	String	模板配置
expands4	扩展字段4	String	模板配置
expands5	扩展字段5	String	模板配置
expands6	扩展字段6	String	模板配置
expands7	扩展字段7	String	模板配置
expands8	扩展字段8	String	模板配置
expands9	扩展字段9	String	模板配置
expands10	扩展字段10	String	模板配置
▼voucherLineList	凭证明细表数据	List<VoucherLineApiDTO>	Y		凭证行数据大于0
rowId	行ID	String	N	38ffbdb043f0454b	该参数由接口自动处理，无需传值
rowNum	行号	String	N	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
expenseNum	凭证行行号	String	模板配置	1	1.单个凭证封面中凭证行按本行号排序 2.只允许输入非负整数，且长度不得超过5位字符 3.导入成功后，详情界面和封面的分录行按照行号从小到大顺序排序，若重复则随机排序
originVoucherId	凭证头原主键	String	Y	ce43563bfffe539b	与头表一致
summary	摘要	String	Y	收到货款存银行	文本格式，校验字段长度不超过500位
subjectCode	科目代码	String	Y	ZC	文本格式，限制长度不超过50位
subjectName	科目名称	String	Y	银行存款	文本格式，校验字段长度不超过64位
assistAccount	辅助核算	String	模板配置	生产部门	文本格式，校验字段长度不超过1000位
exchangeRate	汇率	String	Y	0.7	只能填写正数，汇率格式支持16+10
dcFlag	借/贷标识	String	Y	debt	只能填写 debt 或 credit ；debt借/credit贷
drAmount	借本币金额	String	Y	1.23	1、仅支持输入金额（正负0都支持），金额格式统一为13+2 2、行上借贷标识为借则借本币金额必填，只取借方，贷方需传值0。如果借贷标识为贷则贷本币金额为必填，只取贷本币金额，借方需传值0
crAmount	贷本币金额	String	Y	1.23	1、仅支持输入金额（正负0都支持），金额格式统一为13+2 2、行上借贷标识为借则借本币金额必填，只取借方，贷方需传值0。如果借贷标识为贷则贷本币金额为必填，只取贷本币金额，借方需传值0
drForeignAmount	借外币	String	模板配置	1.23	1、仅支持输入金额（正负0都支持），金额格式统一为13+2 2、根据行上的借贷标识只取借方或贷方的值。
crForeignAmount	贷外币	String	模板配置	1.23	1、仅支持输入金额（正负0都支持），金额格式统一为13+2 2、根据行上的借贷标识只取借方或贷方的值展示。
foreigncurrencyCode	外币币种编码	String	模板配置	USD	校验在共享系统中币种编码是否存在
expands1	扩展字段1	String	模板配置		1.校验根据自定义模板配置决定（模板配置使用时才会启用，否则本字段不启用）： 2.若配置为文本，则校验是否在配置的长度范围之内 3.若配置为数字，则则校验是否在配置的长度范围之内 4.若配置为金额，则校验格式是否满足13+2 5.若配置为日期，则校验格式，是否为yyyy-mm-dd或者yyyy/mm/dd 6.若配置为选择框(单选、多选、下拉、弹出)，则校验在选择的数据源范围内是否存在：档案主数据、快速编码（只校验第二级）、基础数据需校验数据存在且有效。"
expands2	扩展字段2	String	模板配置
expands3	扩展字段3	String	模板配置
expands4	扩展字段4	String	模板配置
expands5	扩展字段5	String	模板配置
expands6	扩展字段6	String	模板配置
expands7	扩展字段7	String	模板配置
expands8	扩展字段8	String	模板配置
expands9	扩展字段9	String	模板配置
expands10	扩展字段10	String	模板配置

返回参数

参数名	中文名称	参数类型	示例	参数说明
code	编码	string	0	0-全部成功;非0失败
msg	信息	string	全部成功	消息提示
successNum	成功条数	string	200	接收成功返回接收成功条数，接收失败返回null
failNum	失败条数	string	0	接收成功返回0，接收失败返回null
data		list		返回空

请求参数示例

{
    "data": [
        {
            "attachment": "10", 
            "approver": "李四", 
            "approverDate": "2024-04-01", 
            "account": "孙七", 
            "batchName": "be43563bffffcf30b2b2444999", 
            "bookKeepDate": "2024-04-01", 
            "bookKeeper": "周八", 
            "boeNum": "XY-001^XY-005", 
            "bizCategoryCode": "", 
            "boeTypeCode": "", 
            "cashier": "赵六", 
            "currencyCode": "CNY", 
            "expands4": "", 
            "expands3": "", 
            "expands2": "", 
            "expands1": "", 
            "expands8": "", 
            "expands7": "", 
            "expands6": "", 
            "expands5": "", 
            "expands9": "", 
            "expands10": "", 
            "financeExecutive": "王五", 
            "groupCode": "XY", 
            "leCode": "XYTX", 
            "originVoucherId": "ce43563bffffcf30b2b221a3b1b2b7ae539b", 
            "originVoucherStatus": "已过账", 
            "periodName": "202404", 
            "rowNum": "1", 
            "rowId": "38ffbdb043f045ed544eb1b9b2ae034b", 
            "sobCode": "ZT001", 
            "userDate": "2024-04-01", 
            "user": "张三", 
            "voucherAmount": "12.34", 
            "voucherNum": "VT001111", 
            "voucherCategory": "付款凭证", 
            "voucherDate": "2024-04-01", 
            "voucherSource": "金蝶接口同步", 
            "voucherType": "VT001", 
            "voucherLineList": [
                {
                    "summary": "收到货款存银行", 
                    "drForeignAmount": "1.29", 
                    "originVoucherId": "ce43563bffffcf30b2b221a3b1b2b7ae539b", 
                    "expands9": "", 
                    "rowId": "38ffbdb043f045ed544eb1b9b2ae034b", 
                    "expands4": "", 
                    "expands3": "", 
                    "expenseNum": "1", 
                    "dcFlag": "debt", 
                    "expands10": "", 
                    "expands2": "", 
                    "foreigncurrencyCode": "USD", 
                    "expands1": "", 
                    "expands8": "", 
                    "exchangeRate": "0.7", 
                    "expands7": "", 
                    "expands6": "", 
                    "expands5": "", 
                    "rowNum": "1", 
                    "crForeignAmount": "1.23", 
                    "drAmount": "1.23", 
                    "subjectCode": "ZC", 
                    "crAmount": "1.23", 
                    "subjectName": "银行存款"
                }
            ], 
            "voucherSeqValue": "PZ000001", 
            "voucherName": "手续费", 
            "xblnr": "SAP_XY_123"
        }
    ]
}

返回参数示例

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

标准凭证批量同步接口（异步）

标准凭证批量同步接口（异步）

关于作者

目录