报关单生成器

痛点：手工填报关单的繁琐与易错性

在进出口业务中，准备报关单（报关托书/清单）是一项高度结构化但极其繁琐的工作。业务人员通常需要从外销发票、合同、装箱单等多份文件中提取信息，并严格按照海关要求的 Excel 模板进行填报。这不仅涉及数十个必填和选填字段，还对格式（如合并单元格、下拉菜单、特定数值格式）有严格限制。手工复制粘贴和核对不仅耗时，还极易出现 HS 编码错误、金额格式不符或漏填关键信息等问题，导致报关流程受阻。

核心机制：从数据校验到动态生成

该技能旨在将报关资料整理过程自动化，其工作流程严格遵循“先校验、后生成”的原则：

1. 信息提取与校验：读取用户提供的文本或文件附件，对照 fields_reference.md 中的必填字段清单（如外销发票号、合同协议号、成交术语等），精准识别缺失项。
2. 分批交互补全：避免一次性抛出十几个问题造成体验割裂，技能会按“基本信息 -> 收发货人 -> 商品明细”的优先级，每次最多询问 3-5 个字段，逐步补全数据。
3. 脚本动态渲染：数据收集完毕后，调用 generate_customs_declaration.py 脚本。该脚本底层依赖 create_template.py 和 openpyxl，从零构建包含合并单元格、列宽行高及数据验证下拉列表的模板，自动填充并计算合计行，最终输出标准 Excel 文件。

适用边界与数据规范

虽然该技能大幅降低了填报门槛，但在使用时仍需注意以下硬性约束：

• 枚举值限制：成交术语（如 FOB、CIF）和运输方式（如 BY SEA、BY AIR）必须严格从预设的固定列表中选择。
• 数据一致性：工厂抬头必须与开票工厂名称完全一致，HS 编码需为有效的海关商品编码。
• 格式要求：数值字段（数量、重量、体积、金额）必须为纯数字类型；日期统一使用 YYYY-MM-DD 格式；多行地址需使用 \n 换行符分隔。
• 环境依赖：运行生成脚本前，需确保 Python 环境中已安装 openpyxl 库。