发票流程自动化
运营只在飞书表格填 SKU 与数量，剩下的交给 Argent：自动生成发票、登录货代门户导入订单与勾选货件号、 导出进仓单与唛头、下载大货标签，并把文件与状态回写表格。
CAPABILITIES
核心能力
把「运营手工填表 + 门户点鼠标」这一段接过。支持多货代：每家一个独立集成，互不干扰。
运营只填一张表
在「运营填写」视图里填 SKU、数量、箱数、店铺、货代、收货仓，勾选「就绪」即提交。品名、材质、重量、尺寸从 SKU 主数据自动带出；英文品名/材质由 AI 自动翻译回填，不用人工翻。
发票自动生成
按货代模板生成发票文件（命名规则「运单-货件号-箱数-品名」），回写到表格的「发票文件」列，状态从待生成 → 填写中 → 已上传一路自动流转。
货代门户自动跑
登录货代门户 → 导入订单 → 查询并勾选本次货件号 → 导出进仓单与唛头 → 导出 DDP 批量压缩包并改名 → 下载大货标签，全流程自动，产物回写表格。
失败可续跑，不重头来
失败时状态置「失败」并把原因写进「发票错误信息」。补数据后把状态改回「待生成」，下一轮自动重跑；已有的产物不会重复上传（幂等）。
写操作有守卫
只写白名单字段（发票状态 / 发票文件 / 大货标签 / 发票错误信息）；写前整行备份、写后读回验收、逐条审计留痕；终态需人工批准，可回滚。
新增货代可定制
每家货代是一个独立集成（门户地址、模板、错误词表、人工门都写在适配器里）。已支持上海文鳐、鑫中航；换货代或接第三家走定制适配。
PIPELINE
一票发票怎么跑完
每一步都落台账（阶段、产物、退出码）；卡住时不是「卡住」，而是有人被叫来处理。
读表待办
每 5 分钟扫描表格：FULL 状态=已完成 且「发票就绪」已勾选的记录进入发票队列（按货代路由到对应集成）。
缺口判断
缺必填字段（如 HS 编码、重量尺寸、材质）就不硬跑：回写「发票错误信息」、取消勾选「发票就绪」并落卡等人补——运营补齐后重勾即可，不需要谁盯着。
生成发票
按该货代的门户模板填报（只写模板约定的数据行），生成 xlsx 并回写「发票文件」附件。
门户操作
登录门户 → 导入订单 → 查询 → 按货件号勾选 → 导出进仓单/唛头 → 导出 DDP 压缩包并改名。需要人工介入的点（首次登录滑块、访问前确认）会停下来等你。
下载标签并回写
从门户下载大货标签，回写「大货标签」附件，状态推进到「标签已下载」→「已完成」。
留痕与复盘
每个阶段写台账（阶段名 + 产物 + 退出码）；失败按性质分类：可重试的脚本自己重试，需要判断的唤起角色，缺数据的落卡等人。
GUARDRAILS
红线：门户是对方的生产系统
- ▪货代门户是**对方的生产系统**：每次访问前先问过你（人工确认点），不静默操作。
- ▪门户登录的滑块验证码**不做自动化绕过**：首次（或登录失效时）由人工过一次，之后复用持久登录态。
- ▪HS 编码等**报关敏感字段由运营人工维护**：系统不预填、不写候选、不自动确认。
- ▪只写白名单四个字段；写前整行备份、写后读回验收、审计 JSONL 留痕；终态改动需 `--force` 式人工批准。
- ▪任何「我方脚本缺口」都写进表格的错误信息列并落到失败队列，不许静默跳过。
SETUP
配置清单
按顺序完成以下 5 步即可。发票流程不需要紫鸟浏览器，但通常与 FULL 货件自动化一起用。
安装 Argent 并登录
已安装可跳过一条命令安装（Mac / Windows 见安装页），打开 dsh web → 设置 → Argent → 一键登录问述科技账号。
开通企业版
必需发票流程属企业版能力：订阅生效后「美客多 FULL/发票」角色自动解锁（无需装包）。商务开通：service@whyshu.com。
准备客户表与 SKU 主数据
必需FULL 任务表（含「发票就绪 / 发票状态 / 发票文件 / 大货标签 / 发票错误信息」等列）与 SKU 主数据（品名、重量尺寸、材质、海关编码、产品图）。运营用「运营填写」视图维护。
货代门户账号 + 发票模板
按货代每家货代一套门户账号与模板（模板以门户下载版为准）。运营维护账号；首次登录人工过一次滑块验证。
验证一轮再全量
建议先用一条货件跑通（影子 → 真跑），确认发票与标签都对，再交给定时器全量跑。上线核对清单见部署指南。
STATUS
状态对照表
「发票状态」列的变化就是进度条。失败与跳过都可追溯，不存在「跑没跑不知道」。
待生成
已进发票队列，等待生成（缺字段的会写错误信息并把「发票就绪」取消勾选）。
填写中
正在按货代模板填报，发票文件生成后回写附件。
已上传
已上传到货代门户（导入订单 + 勾选货件号）。
标签已下载
大货标签已从门户下载并回写「大货标签」列。
已完成
全流程结束，产物齐备（发票文件 + 大货标签）。
失败
原因写在「发票错误信息」；修正后把状态改回「待生成」即自动重跑。
不开发票
运营手工标记：这票不需要发票，系统跳过。
FAQ
常见问题
需要人工做什么？
三件事：① 运营在表格里填 SKU/数量并勾「就绪」；② 货代门户首次（或登录失效时）人工过一次滑块验证码；③ HS 编码这类报关敏感字段由运营判断后填入（系统不会替你填）。其余步骤自动完成，需要你确认时会在会话/卡片里停下来问。
会写坏我的表吗？
只写白名单字段：发票状态 / 发票文件 / 大货标签 / 发票错误信息。每次写入前整行备份、写入后读回验收，并逐条记审计日志；状态推进到终态需要人工批准。任何异常都能按备份回滚。
支持哪些货代？
已支持上海文鳐（my.ffl-tech.com）与鑫中航（美墨线）。每家货代是一个独立集成：门户地址、模板、错误词表、人工门都在适配器里声明，新增或更换货代属于定制适配（企业版含定制名额）。
发票金额和规格从哪来？
取自 SKU 主数据（重量、尺寸、材质、海关编码、产品图）。上新时维护一次即可全店复用；发货前没录主数据会标记失败并写清原因，不会用错数据硬开票。
失败之后怎么办？
失败会落成两类：脚本能自己重试的（网络抖动等）自动重试；需要判断的会唤起角色排查，缺运营数据的会落卡等补。表格里同时能看到「发票错误信息」；补好数据把状态改回「待生成」，下一轮自动续跑。
想让发票流程跑起来？
发票流程属企业版能力，开通后角色自动解锁。若你的货代不在已支持列表里，我们可以按你的门户与模板做定制适配。