B2B-webshop gekoppeld aan de boekhouding met een eigen Yuki-connector

CleverTech AI bouwde de webshop headless op: een commerce-backend die los staat van de winkelinterface, met daartussen een API. Die keuze is niet cosmetisch — juist doordat de backend een eigen, uitbreidbare kern is, kon de boekhoudkoppeling als volwaardig onderdeel van het systeem worden gebouwd in plaats van als losse export achteraf.

1. Een headless B2B-webshop op Medusa.js v2#

De basis is Medusa.js v2, een open-source commerce-backend, met een eigen Next.js-storefront ervoor. Daaronder draaien PostgreSQL voor de gegevens en Redis voor achtergrondverwerking; Mollie handelt de betalingen af.

Productcatalogus, voorraadstanden, klanten en orders leven in één datamodel, zodat het voorraadbeheer van de webshop en de administratieve verwerking naar dezelfde bron kijken.

De reden om voor headless te kiezen in plaats van een kant-en-klaar winkelpakket is de tweede helft van deze case: een plugin-architectuur waarin je eigen code op commerce-gebeurtenissen kunt laten reageren.

2. De kern: een eigen Yuki-koppeling (medusa-plugin-yuki)#

Het zwaartepunt van het project is een zelfgebouwde connector naar Yuki, het online boekhoudpakket van de klant. Die plugin luistert op gebeurtenissen in de webshop en synchroniseert automatisch drie stromen:

Daarmee verdwijnt de handmatige stap tussen bestelling en boekhouding volledig uit het proces: de webshop schrijft zelf naar de administratie, met de order als bron. Dit is hetzelfde patroon als op onze pagina over de Yuki-koppeling en breder over API-koppelingen en systeemintegratie — hier alleen toegepast op een e-commerce-bron in plaats van een backoffice-systeem.

3. Btw-automatisering en VIES-validatie in de connector#

De connector doet meer dan gegevens doorgeven; hij bepaalt ook de fiscale behandeling. Vier scenario’s zijn ingebouwd:

• 21% — het standaardtarief, van toepassing op bouwgereedschap;
• 9% — het verlaagde tarief;
• 0% intracommunautaire levering — verkoop aan een zakelijke afnemer in een ander EU-land;
• 0% export — levering buiten de Europese Unie.

Het onderscheid tussen het derde scenario en gewoon 21% is precies waar het misgaat als je het met de hand doet, want het hangt af van één gegeven: heeft deze zakelijke koper een geldig EU-btw-identificatienummer?

De connector controleert dat geautomatiseerd tegen VIES, het Europese register waarin lidstaten elkaars btw-nummers valideren. Pas als die controle slaagt, wordt de order als intracommunautaire levering met 0% verwerkt en als zodanig naar Yuki weggeschreven.

“

Ontwerpdoel van deze koppeling: geen enkele order meer handmatig overnemen in de boekhouding, en de btw-behandeling — inclusief de VIES-controle — vastleggen in code in plaats van in een werkinstructie. Dat is het gestelde doel van de bouw, geen na de oplevering gemeten besparing.

4. Wat wél is gebouwd, en wat vervolgstap bleef#

Eerlijk over de status: opgeleverd zijn de webshop-backend met storefront, de betaalafhandeling via Mollie en de Yuki-connector met de vier btw-scenario’s en de VIES-validatie.

De verdergaande B2B-functionaliteit — klantspecifieke prijzen, staffelprijzen, offerteaanvragen (RFQ), betalen op rekening, meerdere gebruikers per bedrijfsaccount, goedkeuringsworkflows en snelbestellen op artikelnummer — is als vervolgstappen ontworpen en op de roadmap gezet, maar in dit traject niet gebouwd.

Zie ook wat daar in bredere zin bij komt kijken op onze pagina over een B2B-webshop laten maken, en voor het ERP en de prijslogica erachter in ons artikel over groothandel software.

Deze case beschrijft dus de gebouwde en in code werkende scope. Er wordt geen livegang, omzet of ordervolume geclaimd: die zijn niet uit de projectbronnen te verifiëren.