runbookify
← All plans
Logistics & Transportation / Customs / Import-Export Docs

Per-Shipment Customs Document Checklist: Never Strand a Shipment on a Missing Form

Pick a destination and commodity, get the exact required-document checklist, upload and track each form, and have a coordinator verify it complete and approve before release to your broker.

BeginnerAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where you pick a destination country and commodity, it generates the required-document checklist from your own rules table, you upload and track each document to complete, a coordinator verifies the set against the checklist and approves, and it releases a clean document packet to your forwarder or broker.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.

Before you start

  • A Supabase account (free)
  • A Vercel account (free)
  • A Resend account (free)
  • A CSV of your destination/commodity document rules
  • Claude Code or any AI coding agent

The problem this kills

A shipment is built, booked, and ready to roll — then it sits on a dock because the certificate of origin never got chased, or the fumigation certificate for that wooden crate was missed, or the destination needed a specific import permit nobody flagged. Every export coordinator knows the sick feeling: the freight is fine, the customer is waiting, and the whole thing is stuck for one piece of paper.

The maddening part is that the rules are knowable. This country plus that commodity needs a commercial invoice, a packing list, a certificate of origin, and a fumigation cert — every time. But those rules live in someone's head, in a tangle of emails, or in a spreadsheet nobody trusts. So coordinators rebuild the list from memory for each shipment, and sooner or later something falls through. You do not need to be a developer to fix this. You need a tool that turns your own rules into a checklist, tracks every document to done, and won't let a shipment release until a person confirms the packet is complete.

What you'll build

A simple internal web tool for your export desk. You keep a rules table — destination country plus commodity maps to the documents that shipment requires. For any new shipment you pick the destination and commodity, and the tool generates the exact required-document checklist. You (or your team) upload each document as you collect it, and the checklist tracks what's in, what's still outstanding, and what's expiring. When everything's gathered, a coordinator reviews the assembled set against the checklist and approves — and only then does the tool release a clean document packet to your forwarder or broker. No more stranded freight, no more "I thought you had that form."

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — your export process and who runs it, the systems and spreadsheets you use, your real destination and commodity codes, how your current document rules are written, your typical and peak shipment volumes, your approval rules, and the messy edge cases (multi-commodity shipments, transshipment, expiring permits). It reads a short spec back to you for a thumbs-up, then builds the tool around your rules instead of a generic template. From there it walks the agent through the data model, the rules-table import, the checklist generator, document upload and tracking with file Storage, the coordinator's verify-and-approve gate, and the released packet. Every step ends with a ready-to-copy prompt.

The governance it includes (this is the point)

This isn't a toy. The plan builds in the controls a real logistics operation needs: login so only your team can use it, row-level security so people only see their own organization's shipments, a complete audit trail of every document uploaded and every approval (who, what, when), a hard human-approval gate so no packet is released to the broker until a coordinator verifies the set is complete, and duplicate guards keyed on the shipment ID so the same shipment can't be processed twice. The whole tool exists to make a careful human sign-off easy — the system assembles and checks, a person approves.

Who it's for

Export coordinators, traffic and documentation desks, and freight-forwarder clients who own the paperwork that lets a shipment clear customs. If you can describe which documents your destinations and commodities require, you can build this.

You've got this — open the plan, paste the first prompt, and you'll be generating your first real shipment's checklist this afternoon.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.