Operator's Manual · Vol. II · 22 July 2026

How the machine
actually works

Options 1 and 2, opened up: the exact paperwork (field by field, from the Federal Register), who is legally allowed to press submit, what AI builds versus what you do at 11pm, and the website that runs the whole operation.

Chapter 02 — Option 1 in depth

The postal filing machine

Here is the entire government requirement, verified from the Federal Register (IFR 2026-12669) and CBP's July 8 bulletin. This is the "database" you asked for.

The IMDW — International Mail Duty Worksheet · all 14 fields
#FieldWhere your app gets it
1Filer Code (3-char, CBP-assigned)Client onboarding — stored once
2Bond Number (must match ACE eBond)Client onboarding — stored once
3Description of MerchandiseOrder export → AI normalization
4Country of OriginOrder/supplier data → validated
510-digit HTSUS ClassificationThe AI heart — see pipeline
6Quantity / Weight (only if duty rate is specific)Order export; rule-triggered
7Duty RateHTS database lookup — deterministic
8ValueOrder export
9Total Duty OwedDeterministic math — never AI
10CarrierShipment data
11Flight / Conveyance NumberShipment data
12Tracking Number (foreign postal operator)Shipment data
13Arrival Port (CBP port code)Shipment data → port-code lookup
14Arrival DateShipment data
File format
Excel / CSV
File name
[FilerCode]_[Month]_[Year]_Payment — e.g. 12345_08_2026_Payment
Submit to
CBPDM@cbp.dhs.gov (email)
Deadline
7th of the month after package arrival — July arrivals due Aug 7
Payment
ACH debit on Pay.gov, collection "International Mail Duties" — register via IntlMailDutyHelp@cbp.dhs.gov
Bond
Single-transaction or continuous (Activity Code 1) via ACE eBond, ~$500–700/yr premium — or the broker-partner's bond covers it
Template
CBP's official Excel sheet ships with CSMS #69183472 — email IntlMailDutyHelp@cbp.dhs.gov to obtain (do this Thursday)
Scope
Mail shipments ≤ $2,500; AD/CVD & quota goods always formal entry
The forced roadmap — and why it's good

Oct 22, 2026: goods with Chapter 99 duties (= most China-origin merchandise), PGA requirements, or FTA claims can no longer use the spreadsheet — they must use Entry Type 13, the electronic filing that hits ACE production Sept 22 (test environment July 24). ET13 files via the ACE portal or ABI, and the technical specs (CATAIR guides, INT-057 / CBP-290) are already published. Translation: the spreadsheet is your August wedge; the ET13 integration — built with your broker partner — is the durable, hard-to-displace product. The migration moment is your upsell moment.

Chapter 03 — The AI pipeline

Six stations, one worksheet

Yes — AI produces the monthly output itself. Here's the assembly line, with the model tier that runs each station and what it costs.

Intake Deterministic

Client's order/shipment export lands in the web app — Shopify/Etsy CSV, warehouse spreadsheet, or email drop. Column-mapper remembers each client's format after the first month.

Extraction & normalization Haiku-class

Small cheap model turns messy product rows ("blu wmns linen drs sz M") into clean structured fields. Pennies per thousand lines.

HTS classification Sonnet-class You review

The heart. For each new product: proposes the 10-digit code with reasoning, HTSUS chapter notes, and citations to CBP binding rulings, plus a confidence score. High confidence → through. Low confidence → your 11pm review queue. The memo bank is the moat: every decision is remembered, so month 2 runs ~90% from memory and your marginal cost collapses while price stays. In the self-serve lane the client confirms each new classification (H350722-safe); in the broker lane the broker does.

Duty math Deterministic — never AI

Rate lookup from the HTS database, ad valorem/specific calc, totals. Code, not language models. Nothing that goes to the government is arithmetic'd by an LLM.

Validation Deterministic

Every line checked against the 14-field spec: filer code format, bond on file, port codes, conditional quantity/weight rule, exclusion screens (AD/CVD, quota, and — after Oct 22 — Ch. 98/99, PGA, FTA → routed to ET13/formal instead).

Output Deterministic

The finished IMDW Excel (CBP's exact template), correctly named; a Pay.gov payment checklist; and a per-line audit log — who/what classified it, on what basis, confirmed by whom. The audit trail is what a broker buys.

Runtime AI cost per client (call-type table)
Call typeTierVolume (1,000-line client)Est. cost/mo
Extraction/normalizationHaiku 4.5~1,000 lines, batched< $1
Classification — novel SKUsSonnet 4.6~300 novel month 1 → ~30 by month 3$3–6 → < $1
Review-queue explanationsHaiku 4.5~50 memos< $1
Duty calc, validation, file buildCode ($0)everything$0
Total AI cost per client per month (vs. $500–1,500 price)≈ $5–10

Design rules baked in: memo-bank first, AI only for novel items (lazy generation); batched calls; cached system prompt; per-client spend cap; and the app still works with the API off — memory + manual entry. That's a >98% gross-margin engine.

Chapter 04 — Option 2 in depth

The refund rescue, mechanically

The surprise: the CAPE declaration itself is a CSV with one column. The money is lost in everything around it — 15% of declarations get rejected, and only ~6% of affected importers even had ACE accounts when this started.

The actual file
Format
CSV, UTF-8 without BOM — .xlsx is rejected
Header
Exactly Entry Number — any variation rejects the whole file
Rows
One 11-char entry number per row, ≤ 9,999; no blanks, no duplicates; apostrophe-prefix to keep leading zeros
Upload
ACE Portal → Accounts → CAPE Declarations → New — by the importer (or their original filing broker)
Amendments
None — a rejected/wrong declaration means a fresh file
Eligible codes
9903.01.xx / 9903.02.xx lines only — 9903.88 (Section 301) look similar and are not refundable here
The four-step guided rescue (what clients pay for)

Eligibility scan Deterministic

Client (or their broker) pulls the standard ES-003 report from ACE using your click-by-click runbook and uploads it. Your parser finds 9903.01/9903.02 lines, computes the refund estimate, flags the fakes. No ACE access? Playbook: broker provides 7501 copies + ES-003; meanwhile spin up their ACE account (modernized April 2026 — same-session if their Form 5106 contact email is current).

Deadline triage Deterministic date math

Every entry lands in a zone (table below). This is the report that makes the phone call urgent and honest.

Unblocking Checklist engine You shepherd

Form 5106 contact fix → ACE account → SF-3881 ACH refund enrollment (bank signs, 7–10 business days — no ACH, no money; ~1,880 refund batches were stuck exactly here) → optional Form 4811 if refunds should route to a designee.

File & submit Generator Screen-share, they drive

Your tool emits the perfect CSV; the client uploads it in their ACE session with you on a screen-share. Rejection linter runs first (the 9 known causes). They press the button. Flat $500–2,000 vs. a market at $125–350/entry or 3–8% contingency.

The broker nuance that shapes referrals

When a broker must file, it generally must be the broker who filed the original entry (the filer code is baked into the entry number). So "do-it-for-me" CAPE clients usually route to their own broker, not your partner. Your partner broker's lane is the protest tier (Zone 3) and fresh work. Your software + runbook is the product; the screen-share is the service.

Chapter 05 — The clock

Every entry lives in a zone

ZoneEntry statusChannelDeadline
1Not yet liquidatedCAPE Phase 1File before liquidation
2Liquidated ≤ 80 days agoCAPE Phase 1Sliding daily window
3Liquidated 81–180 days agoProtest (Form 19) → broker/attorneyDay 180 — hard cutoff. Jan-2026 liquidations expire THIS MONTH
4Liquidated 181 days–2 yrsCIT suit / pending class action2-year statute
5Beyond 2 yearsForeclosed

Phase 3 (finally-liquidated entries — where small importers disproportionately sit) is programming for end-of-July launch but currently covers only the ~3,700 companies that sued at the CIT; a class action to cover everyone else is pending, and the government is appealing. Don't promise Zone 4 outcomes — triage into Zones 1–3 and refer the rest.

Chapter 06 — The website

One stack runs both businesses

Your default platform — Cloudflare — fits this exactly, and I build all of it with you: schema, pipeline, prompts, site.

CLOUDFLARE STACK
  Pages/Workers ......... app + client portal (login via magic link)
  D1 (SQLite) ........... the operating database (schema below)
  R2 .................... document vault (exports, 7501s, generated IMDWs, audit PDFs)
  Queues ................ monthly batch jobs, classification runs
  Workers AI / API ...... Haiku + Sonnet calls (tiered, capped, cached)
  Stripe ................ $500–1,500/mo subscriptions + flat rescue fees

D1 SCHEMA (the operating database)
  clients        brokerage / importer, filer_code, bond_no, tier, POA-path
  products       THE MEMO BANK — sku, description, hts10, confidence,
                 ruling_citations, confirmed_by, confirmed_at
  shipments      carrier, conveyance, tracking, port, arrival_date
  line_items     shipment → product, value, qty/weight, duty_rate, duty
  filings        type (IMDW | ET13 | CAPE-kit), period, file_hash,
                 status: draft → review → delivered → client-submitted
  refund_cases   entries, zones, es003_import, deadlines, ach_status
  payments       Stripe refs, invoices
  audit_log      every AI suggestion + every human confirmation — the
                 thing a broker actually buys

Degradation rule: with the AI API off, the app still works — memo bank + manual classification entry. AI is margin, never a single point of failure.

Chapter 07 — Division of labor

What AI does. What I do. What only you can do.

Runtime AI (in the product)Me, build-time (your CTO-in-a-box)Only you
Extraction & normalization · classification proposals with citations · review memos · client-email drafts The entire codebase & schema · classification prompt + memo-bank design · ES-003 parser · rejection linter · runbooks & screen-share scripts · sales one-pagers · this page Read the UPS agreement · the 20 calls · classification sign-off until the memo bank is trained · the broker handshake · the attorney opinion letter · pressing nothing on anyone else's behalf
Chapter 08 — The next 30 days

Calls → concierge → software

Jul 24–25 · This week

Process goes live Friday. 20 calls off the CBP broker CSV. Email IntlMailDutyHelp@cbp.dhs.gov for the official template + Pay.gov registration steps. Bar: 3 paid/committed pilots.

Jul 28–Aug 7 · Concierge

First IMDW cycle (July arrivals due Aug 7). I generate the worksheets with you reviewing every line — no app yet, just the pipeline run by hand+AI. Cash arrives. Run refund scans as the second offer.

Aug · Build under load

Weekend build of the portal on Cloudflare: intake → memo bank → IMDW generator → audit log. NimbleLogic verdict Aug 31 — on evidence, in parallel.

Sep–Oct · The moat

ET13 hits ACE production Sep 22; Ch-99/PGA goods forced off the spreadsheet Oct 22 — your upsell moment. Build the ET13 path with your broker partner. Attorney opinion letter on the self-serve lane.

The shape of the whole thing

Option 2 is the sprint: mostly deterministic software, urgent deadlines, fast flat-fee cash, and it fills your pipeline with importers. Option 1 is the engine: recurring monthly filings where the memo bank compounds and ET13 integration makes you hard to remove. Same stack, same buyer list, same phone calls. Calls first. Code second.

▸ AUDIO — Operator's Manual, Vol. II · nova · listen while you read
0:00 –:––