ISF-10 Filing Risk Alert n8n Workflow: GPT-4o-mini + Telegram/Gmail

Stop ISF-10 deadline risk before it becomes a compliance issue

The ISF-10 Filing Risk Alert n8n Workflow continuously monitors open ocean shipments, detects ISF-10 filing risk changes, and immediately escalates red-tier cases with GPT-4o-mini, Telegram, Gmail, and an internal compliance API—so your team can act fast.

What this workflow does

• Runs every two hours on a schedule to stay ahead of ISF-10 filing deadlines.
• Fetches all open ocean shipments from a freight forwarder API and processes them one bill of lading at a time.
• Reads each bill of lading’s prior status from an n8n Data Table (“isf_filing_state”) and calculates hours-to-vessel-load and a green/yellow/red risk tier based on whether ISF is filed.
• Alerts only on change: it proceeds when the risk tier has changed since the last check, reducing noise.
• For red-tier (unfiled and imminent) shipments: confirms the latest vessel load time via the forwarder API, uses OpenAI (GPT-4o-mini) to draft a red-tier escalation memo, sends an urgent Telegram alert, and posts the memo to an internal compliance API.
• For non-red tier changes: records the update in the Data Table without paging.
• Sends a Gmail run summary for the batch so operations can review outcomes.

Use cases

• Freight forwarding and trade operations teams needing real-time ISF-10 escalation for high-risk shipments.
• SaaS operators monitoring customer lanes where ISF status changes must be acted on within tight timelines.
• Automation engineers implementing n8n risk monitoring workflows with audit-friendly state tracking.

Technical details

• Integration: freight forwarder API, internal compliance API (HTTP Header Auth credentials).
• AI: OpenAI Chat Model using GPT-4o-mini to draft escalation memos.
• Messaging: Telegram for urgent alerts.
• Email reporting: Gmail batch run summary.
• Core n8n nodes/logic: if, set, code, merge, split out.
• State storage: n8n Data Table named isf_filing_state with columns billOfLading, riskTier, filedStatus, lastChecked.