接口描述

请求地址： /api/syncAccountingArchivesBatch

接口编号：FSSC-API-000147

接口诞生版本：3.8.5

所属系统：电子档案系统

所属微服务：zfs-ers

接口说明：外部系统通过此接口批量同步“其他会计资料-归档流程”属性的档案至电子档案系统

单次调用最大条数：1000

注意事项：

1、同一批次只支持同步同一集团，同一档案小类的档案数据

2.单批次推送的数据量最多不超过1000条，单条数据（单个档案）的子数据（明细行列表）不超过10000条，单批次推送的总行数不超过20000条;

3、通过“唯一主键”判断重复：

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

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

⑵如果是【已匹配】【审核已退回】、【待审核】状态，还需判断“匹配关键字”字段是否有更新

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

⒝有，则提示不允许更新

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

②若“唯一主键”不一致，则新增一条档案信息，状态为【未匹配】;

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

请求参数

参数名	中文名称	类型	是否必填	示例	参数说明
▼data		array	Y		请求数据
rowId	行ID	String	N	38ffbdb043f544e034b	该参数由接口自动处理，无需传值
rowNum	行号	String	N	1	外系统传过来的行号，用于接口返回时告知外系统哪一行数据同步失败了
groupCode	集团CODE	String	Y	XY	1、共享系统中的集团编码值 2、校验同批次内此字段值一致 3、校验存在且有效
voucherType	档案小类	String	Y	ZE	1.档案系统中的档案小类编码值 2.校验同批次唯一 3、校验是否有效
batchName	批名	String	Y	be43563bffffcf30b539b	1、对方系统导入处理的批次信息，校验唯一性 2、文本格式，校验字段长度不超过64
leCode	核算主体编码	String	Y	XYTX	校验在共享系统的当前集团核算主体是否存在
ertryName	条目名称	String	Y	202303现金日记账	文本格式，校验字段长度不超过数据库限制300
voucherNum	条目编号	String	Y	XJ202303	文本格式，校验字段长度不超过数据库限制63
periodYear	会计年度	String	Y	2023	校验格式必须为YYYY，且不能超过当前年度
currencyCode	币种	String	Y	CNY	1、共享系统的币种编码 2、校验是否存在
user	编制单位	String	模板配置	总公司财务会计部	文本格式，校验字段长度不超过数据库限制300
userDate	编制日期	String	模板配置	2023-04-01	日期格式yyyy-mm-dd，校验格式及日期不能超过当前日期
secretGrade	档案密级	String	Y	CATAGORY_SECURITY_OPEN	1、校验必填 2、校验是否为枚举值： CATAGORY_SECURITY_OPEN（代表对内公开） CATAGORY_SECURITY_SECRET（代表“机密”） CATAGORY_SECURITY_TOP_SECRET（代表“绝密”）
voucherSource	数据来源	String	模板配置	金蝶接口同步	文本格式，校验字段长度不超过63字符
attachment	纸质附件张数	String	模板配置	10	只允许输入非负整数，且校验字段长度不超过4位，输入其他，则提示：attachment仅支持4位非负整数
boeNum	匹配关键字	String	模板配置	XB-001^XB-002	1、文本格式，校验字段长度不超过500字符 2、存在多个匹配关键字，用英文逗号“^”隔开 3、其他会计资料归档流程属性档案的“匹配关键字”用于和影像任务的“影像任务号”、其他附件的“匹配关键字”匹配
originVoucherId	唯一主键	String	Y	9865b043f544e034bdjhf	第三方系统唯一主键ID，文本格式，校验字段长度不超过63字符
▼voucherLineList	档案明细表数据	List<VoucherLineApiDTO>	模板配置		明细行数据大于0，档案类型对应的档案模板是否配置了明细区，配置了，就按配置进行校验，没配置则不校验，不保存明细区数据
rowId	行ID	String	N	38ffbdb043f0454b	该参数由接口自动处理，无需传值
expenseNum	行号	String	模板配置	1	1.只允许输入非负整数，且长度不得超过5位字符 2、导入成功后，详情界面和封面的分录行按照行号从小到大顺序排序，若重复则随机排序
originVoucherId	唯一主键	String	Y	9865b043f544e034bdjhf	与头表一致
expands1	扩展字段1	String	模板配置		1.校验根据自定义模板配置决定（模板配置使用时才会启用，否则本字段不启用）： 2.若配置为文本，则校验是否在配置的长度范围之内 3.若配置为数字，则则校验是否在配置的长度范围之内 4.若配置为金额，则校验格式是否满足13+2 5.若配置为日期，则校验格式，是否为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-全部成功;1-全部失败;2-部分成功
msg	信息	string	全部成功	消息提示
successNum	成功条数	string	0
failNum	失败条数	string	1
▼data	数据	array
rowId	行ID	string		接口平台数据同步标识
rowNum	行号	string	1
errMsg	错误信息	string		每行错误消息

请求参数示例

{
    "data": [
        {
            "attachment": "10", 
            "batchName": "be43563bffffcf30b2b221a3b1b2b7ae531b", 
            "boeNum": "XY-001^XY-002", 
            "currencyCode": "CNY", 
            "expands4": "", 
            "expands3": "", 
            "expands2": "", 
            "expands1": "", 
            "expands8": "", 
            "expands7": "", 
            "expands6": "", 
            "expands5": "", 
            "expands9": "", 
            "expands10": "", 
            "ertryName": "202403现金日记账", 
            "groupCode": "ZTEDD", 
            "leCode": "HHS01", 
            "originVoucherId": "ce43563bffffcf30b2b221a3b1b2b7ae539c", 
            "periodYear": "2024", 
            "rowNum": "1", 
            "rowId": "3", 
            "secretGrade": "CATAGORY_SECURITY_OPEN", 
            "userDate": "2024-05-01", 
            "user": "总公司财务会计部", 
            "voucherNum": "XJ202403", 
            "voucherSource": "金蝶接口同步", 
            "voucherType": "VVV1", 
            "voucherLineList": [
                {
                    "originVoucherId": "ce43563bffffcf30b2b221a3b1b2b7ae539c", 
                    "expands9": "", 
                    "rowId": "1122", 
                    "expands4": "", 
                    "expands3": "", 
                    "expenseNum": "1", 
                    "expands10": "", 
                    "expands2": "", 
                    "expands1": "", 
                    "expands8": "", 
                    "expands7": "", 
                    "expands6": "", 
                    "expands5": "", 
                    "rowNum": "1"
                }
            ]
        }
    ]
}

返回参数示例

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

其他会计资料归档档案批量同步接口（3.8.5）

其他会计资料归档档案批量同步接口（3.8.5）

关于作者

目录