Client & Importer Onboarding

Onboard an importer once.
File for them forever.

One record per importing company — its legal identity, its CBP registration, its power of attorney, its bond, and its screening, all in one place, with a single readiness light. Every shipment after that inherits the whole picture: no re-keyed EIN, no "is the POA still valid?", no surprise at filing time.

1
record per importer — identity, 5106, POA, bond, screening
5
guided steps from engagement letter to first filed entry
0
importer details re-typed on the next shipment

The problem

"We only find out an importer isn't ready when the entry won't go."

"Every new entry, someone re-types the CBP number and the bond number off a PDF. One transposed digit and it's a rejection."

Re-keyed every time

"The POA expired eight months ago. Nobody knew until CBP bounced the filing."

No expiry visibility

"We have three records that all say 'ACME Corp.' Which one does a filing actually use? Nobody's sure."

Duplicate identities

Onboarding a new importer is a checklist someone keeps in their head — legal entity, Form 5106, POA, bond, screening — run once, never surfaced again, and re-discovered the hard way when something lapses.

How Qubere addresses it

Two objects. One clear job each.

  • Client is who you bill and who signs into the portal — payment terms, rate card, invoices, users. Nothing about CBP.
  • Importer is who you file for — legal identity, CBP importer number, Form 5106, power of attorney, customs bond, denied-party screening. One importer belongs to one client.
  • A client can have several importers — a parent and its subsidiaries, each with its own number and bond — or none yet.
  • Every importer carries one readiness light: green when you can file, amber with the exact thing that's missing and a link straight to it.
  • Onboarding isn't a place you leave — it's the guided mode of the importer record. Come back a year later to renew a POA and it's the same three clicks.

Guided onboarding

Five steps, a readiness meter, one clear next action.

Start from a client, pick the path — standard first-time filer, switching brokers, non-resident — and the wizard walks legal entity, Form 5106, POA, bond, and screening in order. Leave and come back; every step saves. The record always tells you what's done and what's next.

  • Switching brokers? The 5106 is an update, and the existing bond is found, not re-entered
  • Non-resident importer? The wizard collects the resident agent and forces a notarized POA
  • Legal entity and 5106 addresses use live, HERE-backed autocomplete — a verified address, not a typo-prone free-text box, feeding everything downstream including screening
How to demo
Clients and Importers → a client row → + Add importer → walk the stepper. "It won't let this importer near a filing until all five are green — and it tells the operator exactly which one to work next."
Importers/Northwind Foods LLC
RL
Rae · Northwind Brokerage
1 · Legal entitydone
2 · CBP registration (5106)accepted
3 · Power of attorneyout for signature
4 · Customs bondverified with CBP
5 · Screeningcleared
Next action
Chase the POA — sent to cfo@northwindfoods.com 2 days ago

Readiness, everywhere

You always know why you can't file — before you try.

Every importer list shows a readiness light. Filter to "missing a POA" and see exactly those importers. Open one and the amber banner names the blocker and links straight to the tab that fixes it. The same status feeds shipment filing readiness, so a draft importer stops the entry at transmit — not after.

  • An expiring POA or a lapsing bond flips the light back to amber and reopens the record
  • Count fileable importers per client at a glance — "19 of 27 ready"
How to demo
Importers → filter Missing POA → open a row. "The operator never has to remember what's outstanding — the list does."
Importers
RL
Rae · Northwind Brokerage
ImporterClientCBP #BondReadiness
Northwind Retail Inc.Northwind Retail Inc.12-3456789 00$250kReady
Northwind Foods LLCNorthwind Retail Inc.98-7654321 00on parent bondPOA out for signature
Pacific Import PartnersPacific Import Partners55-4433221 00$50k — shortBond increase required
Meridian GmbHMeridian GmbHpending—Onboarding · step 3

Enter once, inherit forever

Pick the importer. Everything else fills itself in.

On a new shipment the importer is one required field — a type-ahead you can also just open. Choose it and the legal name, CBP number, EIN, bond, POA, and the billing client all appear, read-only, each with a chip saying where it came from. Nobody re-types it, and nobody can quietly overwrite it.

  • The billing client is never a separate question — it comes from the importer
  • Override for one shipment if you must — it's an explicit, logged action, not a free-text box
How to demo
Shipments → New Shipment → open the Importer field → pick Northwind Retail. "One choice. The CBP number, the bond, the POA date, the client to invoice — all of it, sourced and shown."
Shipments/New
RL
Rae · Northwind Brokerage
ImporterNorthwind Retail Inc.  Ready
Inherited from onboarding
CBP importer #12-3456789 00 · 5106 accepted
Customs bondContinuous $250,000 · verified with CBP 2026-08-02
Power of attorneyExecuted 2026-07-14 · e-signed by the CFO
Bill toNorthwind Retail Inc. · net 30

The customer's half · partner portal

Invite the importer to do their part.

Send a scoped link and the importer confirms their own legal entity details, provides the officer information the 5106 needs, signs the POA electronically, and uploads their bond paperwork — without an email thread. The broker keeps 5106 transmission, bond verification, screening, and activation.

  • The portal contributes data and the signature — it never activates an importer on its own
  • Everything the importer submits lands on the same record the broker is working
  • Confirming entity details runs through the same live address autocomplete — the importer picks a verified address instead of free-typing one
How to demo
From the onboarding record → Invite importer → open the portal link in a second window → sign the POA. "That signature shows up on the broker's checklist in real time."
Partner portal/Onboarding
NF
CFO · Northwind Foods
Confirm company detailsconfirmed
Officer information for CBPprovided
Sign the power of attorneyready to sign
Upload your customs bondwaiting

Evidence on the record

Every "verified" has the document behind it.

The bond isn't "verified" because someone typed it — it's verified because the CBP importer/bond query came back with a match, and the raw response is on the record. The POA shows the signer, the method, and the completion certificate. Screening shows every name checked and its result. When an auditor asks "how do you know," the answer is one click away.

  • Bond confirmation, e-signature certificate, screening results — all attached to the importer
  • The same evidence-first standard as the rest of the platform: prove it, don't assert it
How to demo
Open a ready importer → Bond tab → expand CBP query response. "This is what CBP returned. We didn't decide the bond was good — CBP did, and here's the receipt."
Importers/Northwind Retail Inc.
RL
Rae · Northwind Brokerage
MethodCBP importer / bond query (KI → KR)
ResultMatch · 2026-08-02 14:22 UTC
SufficiencyRequired $50,000 · on file $250,000 · sufficient
CBP query response
KR  12-3456789  9BOND  CONT  250000  ACTIVE  20260802raw record

Objection handling

Every hard question, answered directly.

"We're moving 200 importers off our old system."Bulk import creates one onboarding record per row. The ones with a valid CBP number and a bond found on file come in ready; the rest land in a triage queue with the exact missing item flagged. Nobody hand-runs 200 wizards.
"One of our clients imports through four legal entities."One client, four importers — each with its own 5106, POA, and bond checklist. The shipment form lets the operator pick which entity; billing still rolls up to the one client.
"What stops someone filing for an importer that isn't ready?"The shipment saves, but transmission is blocked with the specific reason — POA out for signature, bond short, screening not cleared — and a link to fix it. The block is at the entry, not a policy people can forget.
"Can the importer's client change later?"Yes — it's one action, it warns you how many shipments re-associate for billing, and it's logged. Historical invoices are untouched.

The close

"From signed engagement letter to first filed entry — in days, with a receipt for every step."

Clients are how you bill. Importers are how you file. Onboard the importer once — identity, 5106, POA, bond, screening — and every shipment after that inherits the whole picture, with the readiness light telling you the moment anything lapses.

Next step: open a client, add an importer, and watch the shipment form fill itself in.

Full detail: docs/apps/customs/feature/CLIENTS-IMPORTERS-ONBOARDING-REDESIGN.md