CustomsLens – Een compleet douaneplatform bouwen, van scratch

Waar het begon

Met CustomsLens lossen wij een duidelijk probleem op: douane-afhandeling kost te veel tijd en gaat te vaak fout. Hun klanten – importeurs, exporteurs, expediteurs – waren uren kwijt aan administratie die grotendeels repetitief was.

De vraag was simpel: kunnen jullie dit automatiseren?

Wat we gebouwd hebben

We zijn begonnen met de grootste pijnpunten. Eerst de factuurverwerking, want daar zat de meeste tijdverspilling.

De AI-extractie

Dit is waar het interessant werd. We gebruiken OpenAI's Vision API om commercial invoices te lezen. Niet alleen de tekst – de AI begrijpt de structuur. Hij weet dat het bedrag rechtsonder meestal het totaal is, dat de tabel in het midden de goederenregels bevat, en dat het adres linksboven de exporteur is.

Het werkt niet perfect. Soms pakt hij een verkeerd veld, soms mist hij een regel. Maar in 90%+ van de gevallen klopt het, en de gebruiker hoeft alleen te corrigeren in plaats van alles zelf in te typen. Dat is het verschil tussen 20 minuten en 2 minuten per factuur.

De TARIC-integratie

HS-codes zijn de classificatiecodes voor goederen bij de douane. Er zijn er duizenden, en de juiste kiezen is cruciaal – verkeerde code betekent verkeerde invoerrechten.

We hebben een directe koppeling gebouwd met de EU TARIC-database. Je zoekt op beschrijving ("hardhouten tuinmeubelen") of op code ("9403.60"), en je krijgt direct het tarief en eventuele beperkingen te zien. Geen PDF's meer doorspitten.

De rest van het platform

Daaromheen bouwden we wat je verwacht van een modern SaaS-platform:

• Document management met categorieën en status tracking
• Digitale ondertekening via DocuSeal
• Shipment wizard die je door het proces leidt
• Dashboard met filters, zoeken, en bulk-acties
• Locatie tracking via Google Maps
• Team management met uitnodigingen en rollen

De integraties

Dit project heeft ons weer geleerd hoeveel werk externe integraties zijn. We koppelden met:

• OpenAI Vision (document AI)
• EU TARIC API (douanetarieven)
• DocuSeal (ondertekening)
• Google Places (locaties)
• KVK API (bedrijfsgegevens NL)
• VAT Sense (BTW-validatie EU)
• Twilio (SMS-verificatie)
• SendGrid (e-mail)

Elke integratie heeft zijn eigen quirks. Rate limits, authenticatie-flows, error handling, edge cases. Het is nooit "even een API aansluiten."

De technische keuzes

Supabase als backend – We wilden snel kunnen bouwen zonder een complete backend te schrijven. Supabase geeft je PostgreSQL, authenticatie, en storage out-of-the-box. Row Level Security zorgt dat data van verschillende organisaties strikt gescheiden blijft.

Next.js 14 met App Router – Server components waar het kan, client components waar het moet. Goede performance, goede developer experience.

Tailwind + shadcn/ui – Geen tijd verspillen aan custom design systems. shadcn geeft je solide componenten die je kunt aanpassen.

Wat we geleerd hebben

Elk project leert je iets. Bij CustomsLens:

1. AI is krachtig maar niet magisch – Je moet edge cases afvangen, feedback loops inbouwen, en accepteren dat het niet 100% wordt
2. Domeinkennis is essentieel – We hebben veel tijd gestoken in begrijpen hoe douane-afhandeling werkt. Zonder die kennis bouw je de verkeerde dingen
3. Multi-tenant is complex – Vijf gebruikersrollen met verschillende rechten, gecombineerd met organisatie-niveau permissies. Dat moet je vanaf het begin goed ontwerpen

Waar het nu staat

CustomsLens wordt nu gebruikt door bedrijven die dagelijks met douane te maken hebben. De feedback is positief – vooral de AI-extractie en de HS-code zoekfunctie worden veel genoemd.

Er is nog genoeg te bouwen. Meer automatisering, slimmere suggesties, betere rapportages. Maar de basis staat, en die basis werkt.