适用场景
当需要确认的标识达到一定数量,逐条手工查询容易遗漏,也不便于留存。批量解析把标识按行组织成文件,一次提交后按行返回结果,成功项和失败项都带行号。
批量解析不改变登记内容,只做查询。结果用于核对目标地址、记录版本和错误类型,不替代登记变更。
批量结果应归档,作为后续核对和问题反馈的依据。
提交前先确认文件编码与行数,行数异常时先修正文件再提交,避免结果相互覆盖。
输入格式
输入文件按行组织,每行一个完整标识。文件格式保持稳定,可以减少格式类失败。空行和以 # 开头的行不参与解析,可用于分隔和注释。
- 每行一个完整标识,行首行尾不留空格。
- 空行和以 # 开头的行不参与解析。
- 单批数量以接入通知为准,超过上限时分批提交。
- 文件使用 UTF-8 编码,扩展名不限。
结果结构
结果按输入行返回,便于定位问题。成功项保留目标地址和记录版本;失败项保留错误类型和记录编号。记录编号用于后续查询本次处理记录。
| 字段 | 说明 |
|---|---|
| 行号 | 对应输入文件中的行号 |
| 标识 | 本次处理的完整标识 |
| 结果 | 成功、失败或跳过 |
| 目标地址 | 成功时返回的地址 |
| 记录版本 | 当前记录版本 |
| 错误类型 | 失败时返回的错误分类 |
| 记录编号 | 本次处理的记录编号 |
失败处理
批量结果逐行返回,成功项与失败项分开列出。整批重提会重复处理已成功项,也会放大解析压力,因此先按错误类型分类再重提。
只重提失败行,并在重提文件中保留原行号或建立对应关系。失败原因没有查清前,不要连续提交同一批标识。
- 格式错误:修正标识后重提。
- 标识不存在:核对来源,不重复提交同一标识。
- 校验失败:暂停使用结果,联系运营人员。
- 无权限:检查调用方授权范围。
提交与复核
批量结果进入台账前,先核对记录版本。版本落后于当前登记的地址不应继续使用。
失败项处理后保留原行号,便于与台账逐条对应,避免漏项或重复更新。
批量结果与台账核对时,以标识和行号双重对应;同一标识在多行出现时,逐行保留结果,不合并处理。行号缺失时按标识顺序重新对齐,不凭数量推测。
- 从业务台账导出待查标识。
- 去重并检查行首行尾空格。
- 按单批上限拆分文件。
- 提交后保存结果文件与记录编号。
- 按错误类型修正失败项并单独重提。
- 汇总成功项的目标地址和记录版本,更新台账。