货代ISF-10申报截止风险自动监控与红色预警

原文要点

作者Swapnil Mandloi的免费n8n模板：定时器每两小时运行，从货代API拉取所有未结海运提单并逐票处理，在n8n Data Table查历史状态，按ISF是否已申报与距装船小时数算绿黄红风险档，仅档位变化才继续；红色档（未申报且临近装船）会再调货代API确认最新装船时间，用OpenAI起草内部升级备忘录，发Telegram紧急告警并把备忘录POST到内部合规API；其他变化只记录；每批次更新数据表并用Gmail发汇总邮件。

这次做成什么

导入该模板，用合成提单数据验证：黄变红的一票触发备忘录+Telegram+合规API三动作，其余档位变化只写数据表，批次结束收到汇总邮件。

准备什么

• n8n账号（版本需支持Data Table功能）并已导入n8n.io/workflows/19581模板
• 货代API与内部合规API的HTTP Header Auth凭据及真实Base URL（替换示例地址）
• OpenAI API凭据用于Chat Model起草备忘录
• Telegram机器人凭据与目标chat ID
• Gmail OAuth2凭据及汇总邮件收件人地址

具体怎么做

1. 建数据表

   在n8n左侧Data Tables新建名为isf_filing_state的表，建四列：billOfLading（文本）、riskTier（文本）、filedStatus（文本）、lastChecked（日期时间）。模板的状态查询与回写节点都按这个名字和列名映射，改名要同步改节点配置。

2. 替换端点与凭据

   把拉取在途提单、红档确认装船时间、提交合规案例三个HTTP节点的示例Base URL换成你的真实端点，并绑定Header Auth凭据；OpenAI节点绑定API凭据；Telegram告警节点填入你的chat ID；Gmail汇总节点改收件人。

3. 注入合成测试数据

   先用隔离的测试环境：临时把拉取提单的HTTP节点换成固定测试数据（见下方CSV），或让测试货代API返回这批合成提单。手动执行一次工作流，让数据表写入初始档位；再改其中一票的装船时间或申报状态，执行第二次，制造一次档位变化。

4. 核对红档三动作与汇总

   对变为红档的提单，确认执行了装船时间二次确认、OpenAI备忘录、Telegram告警、合规API提交四个节点；对仅黄绿变化的票只更新了数据表；最后检查收件箱有本批次Gmail汇总。

可直接复制的材料

billOfLading,isFiled,vesselLoadAt
MSKU0001111,true,2026-09-20T08:00:00Z
OOLU0002222,false,2026-09-18T14:00:00Z
HLCU0003333,false,2026-09-30T09:00:00Z

你是货代合规运营助理。根据以下提单信息起草一封内部升级备忘录（中文）：提单号【billOfLading】、ISF申报状态【filedStatus】、最新确认的装船时间【vesselLoadAt】、距装船剩余【hoursToLoad】小时。备忘录包含：一票一行的风险摘要、若装船前未完成ISF申报的后果说明（滞港、罚金风险）、三条立即执行项（联系申报代理、通知客户、升级值班经理），语气紧急但客观，不超过200字。

输入与输出示例

本站虚构演示，非模板作者运行结果，未实际调用；小时数为示意计算。

输入

数据表已有OOLU0002222上次riskTier=yellow；本轮货代API返回该票isFiled=false、装船时间提前到2026-09-18T14:00:00Z，计算距装船约20小时

对应输出

档位yellow→red触发继续处理：Telegram收到含提单号与装船时间的紧急告警；合规API收到备忘录POST（body含billOfLading=OOLU0002222、riskTier=red、memo全文）；数据表该行更新为riskTier=red、filedStatus=false并刷新lastChecked；Gmail汇总邮件含本批3票、档位变化1票、红档1票的计数行。

做完检查这些

• isf_filing_state表名与四列名和模板节点映射完全一致
• 首次运行全票只写表不告警，第二次注入变化后只有变化票继续处理
• 红档一票同时产生Telegram消息、合规API请求和备忘录文本三件产物
• 每批次结束无论有无告警都收到Gmail汇总邮件

容易卡住的地方

• 绿黄红的具体小时阈值以模板内表达式为准，导入后先打开该节点确认再测试
• 模板只在档位变化时继续，若数据表被清空会导致首跑全员记一次变化
• 示例Base URL是占位地址，不替换会请求失败；测试时用隔离环境凭据，勿用生产合规API
• Telegram chat ID填错会静默告警不到人，先在Bot里发一条测试消息验证