社区论坛

交流工具使用、配置与问题

【官方教程】报关预录单 PDF 校验

官方教程 报关预录单校验 2026-05-25 00:40:05 0 回复

一、功能名称

报关预录单校验(feature_id:preentry_validator

解析报关行返回的 PDF 预录单,按列版式提取字段,与系统数据库/固定值逐项比对。

二、实现逻辑

  • 入口:PreEntryValidatorDialog
  • 使用 configs/preentry_layout/{模板}.json 定义 PDF 各字段坐标/列映射
  • 对比 configs/报关资料.json → fixed_values 及数据库合同/SKU 数据
  • 上次目录记忆:tools_config.json → preentry_validator

三、数据 / 字段 / 配置支撑

  • configs/preentry_layout/default.json大鹏海关_出口报关单.json
  • configs/报关资料.json → fixed_values(境内发货人、境外收货人等)
  • 数据库.xlsx 备货物流信息、产品数据库

四、使用教程

  1. 在工具中选择 PDF 版式模板(如大鹏海关出口报关单)。
  2. 选择待校验的预录单 PDF 文件或文件夹。
  3. 运行校验,查看差异报告(红字标出不一致字段)。
  4. 根据报告联系报关行修正或更新数据库/固定值配置。

五、常见异常

异常情况解决方法
提示「请先选择PDF文件」通过文件选择器指定待校验的预录单 PDF。
提示「校验器未初始化」等待数据库加载完成;重新加载数据库后重试。
「PDF 中无可提取文字(扫描件)」扫描件无法解析;向报关行索要可复制文字的可编辑 PDF。
「未识别到商品项号行」/「未解析到任何商品行」确认 PDF 版式与所选模板一致(如大鹏海关);必要时更新 configs/preentry_layout/ 配置。
「未找到预录单版式配置」检查 configs/preentry_layout/{模板名}.json 是否存在。
「无法解析合同协议号」PDF 版式与模板不匹配,或合同号区域被遮挡;换用正确版式或联系报关行。
「数据库中未找到合同单号」在「备货物流信息」补全该合同号对应行,重新加载数据库。
「SKU … 未找到」或字段比对不一致核对「产品数据库」报关名称/HS/数量等与 PDF 一致;或更新 configs/报关资料.json → fixed_values

全部回复 (0)

暂无回复,来抢沙发吧。