Hoe koppel je je webshop aan Twinfield?

Met de API-voorwaarden van januari 2026 is "even zelf een scriptje tegen Twinfield" geen optie meer. Die voorwaarden van Wolters Kluwer verplichten elke koppeling met de Twinfield Boekhouden API tot certificering, als onderdeel van een doorlopend API-abonnement dat de gebruiker afsluit (Wolters Kluwer, Algemene API voorwaarden Twinfield, januari 2026{target="_blank" rel="noopener noreferrer"}).

Voor een webshop betekent dat: je kiest een connector die dat traject al heeft gelopen, of je laat een koppeling bouwen door een partij die het abonnement en de certificering regelt. Een losse plugin van een onbekende ontwikkelaar, zonder certificering, is een risico op je boekhouding.

De techniek is daarbij het kleinste probleem. Wat een Twinfield-koppeling goed of slecht maakt, zijn drie keuzes die je vooraf met je boekhouder maakt.

Die keuzes staan hieronder, per webshopplatform uitgewerkt. Het bredere kader over bouwen en koppelen vind je in onze kennisbank over maatwerk software.

De eerste keuze: boek je de factuur door, of laat je Twinfield factureren?#

Twinfield kent twee manieren om omzet binnen te krijgen, en ze werken fundamenteel anders.

Een verkoopfactuur is het document voor je klant. Twinfield maakt die aan in de facturatiemodule van Twinfield Classic, geeft hem een nummer uit de reeks van het factuurtype en boekt pas een transactie zodra je de factuur definitief maakt (Twinfield, Sales invoices{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026).

Een verkoopboeking is alleen de financiële kant: een transactie in het verkoopdagboek, met een totaalregel voor de debiteur, een of meer omzetregels exclusief btw en een btw-regel. Het factuurnummer stuur je zelf mee, tot 40 tekens; een dubbel nummer levert een waarschuwing op (Twinfield, Sales transactions{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026).

Ons advies voor bijna elke webshop: verkoopboeking. Je klant heeft bij het afrekenen al een factuur gekregen; een tweede factuur uit Twinfield met een ander nummer maakt je administratie dubbel en je klantenservice onduidelijk.

De uitzondering is een B2B-shop waar zakelijke klanten op rekening kopen en je de factuur, de herinnering en de aanmaning vanuit Twinfield wilt versturen. Dan is de webshop alleen het bestelkanaal en wordt Twinfield de factuurbron.

De connectors kiezen dezelfde route. De WooCommerce-plugin van Combidesk maakt orders en terugbetalingen "als verkoopboeking aan in Twinfield", niet als factuur (Combidesk, Twinfield voor WooCommerce{target="_blank" rel="noopener noreferrer"}, versie van september 2026).

Per platform: waar de order vandaan komt en wat er onderweg wegvalt#

Elk webshopplatform levert de order anders aan, en elk platform laat iets weg wat Twinfield wel nodig heeft. Deze tabel is onze eigen samenvatting van de platformdocumentatie, gelezen met de vraag: wat moet de koppeling zelf aanvullen?

WooCommerce: webhooks die stil uitvallen#

WooCommerce heeft een REST-API onder /wp-json/wc/v3 met endpoints voor orders en voor terugbetalingen per order (WooCommerce REST API docs{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026). Webhooks melden nieuwe en gewijzigde orders direct.

Het risico zit in één regel van de documentatie: WooCommerce zet een webhook automatisch uit na meer dan vijf opeenvolgende mislukte leveringen (WooCommerce, Webhooks{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026). Ligt je koppeling een kwartier plat tijdens een drukke middag, dan komt er daarna niets meer binnen, zonder foutmelding in je webshop.

Daarom bouwen wij naast de webhook altijd een periodieke controle die de orders van de afgelopen dagen vergelijkt met wat er in Twinfield staat. De webhook geeft snelheid, de controle geeft volledigheid.

Een eigen factuurnummer zit niet in de standaard ordergegevens van WooCommerce: dat komt van een factuurplugin, als je die gebruikt. Bepaal vooraf welk nummer in Twinfield het factuurnummer wordt, het ordernummer of het pluginnummer, en houd je daar aan.

Shopify: GraphQL, een 60-dagengrens en netto uitbetalingen#

Shopify noemt de REST Admin API sinds 1 oktober 2024 legacy; nieuwe publieke apps moeten sinds 1 april 2025 uitsluitend op de GraphQL Admin API (Shopify, REST Admin API{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026). Een nieuwe koppeling bouw je dus op GraphQL.

Twee details uit het Order-object raken je boekhouding direct (Shopify, Order{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026):

• Het ordernummer (name, zoals #1001) is een weergavenummer en niet uniek over meerdere winkels.
• Standaard zie je alleen orders van de laatste 60 dagen; voor oudere orders vraag je de scope read_all_orders aan.

Dat eerste punt bijt bij wie twee Shopify-winkels in één Twinfield-administratie boekt: #1001 bestaat dan twee keer, en een prefix per winkel in het factuurnummer lost dat op.

Het tweede punt bijt bij een historie-import bij de start: zonder die scope krijg je maar twee maanden terug.

PrestaShop: alles los, en XML erin#

De PrestaShop-webservice is een CRUD-API op de database van je winkel, met een sleutel als gebruikersnaam en zonder wachtwoord. Sinds versie 8.1 kan hij JSON teruggeven, maar geen JSON lezen: wat je erin schrijft, is XML (PrestaShop, Webservice getting started{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026).

Voor de boekhouding telt vooral dat order, factuur, creditnota en betaling aparte resources zijn: orders, order_invoices, order_slip en order_payments (PrestaShop, Webservice resources{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026). Een retour staat dus niet in de order, maar in een creditnota die je apart ophaalt en als negatieve verkoopboeking doorzet.

Een kant-en-klare PrestaShop-connector voor Twinfield vonden we bij ons onderzoek niet. Voor deze combinatie is maatwerk dus meestal de enige route.

Magento en Adobe Commerce: boek de factuur, niet de order#

In Magento is de order een bestelling en de factuur een apart object, dat je pas aanmaakt als de betaling binnen is (Adobe Commerce, Create an invoice{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026). Een terugbetaling maakt een creditmemo (Adobe Commerce, Issue a refund{target="_blank" rel="noopener noreferrer"}).

Boek je op de order, dan staat er omzet in Twinfield voor bestellingen die nooit betaald zijn. Laat de koppeling daarom luisteren naar facturen en creditmemo's: dat zijn de documenten die je boekhouder ook als omzet ziet.

Btw en OSS: per land en tarief een eigen btw-code#

Verkoop je aan particulieren in andere EU-landen, dan telt de drempel van €10.000 per kalenderjaar voor al je afstandsverkopen samen. Daaronder geldt meestal Nederlandse btw; verwacht je erboven te komen, dan reken je meteen de btw van het land van je klant en geef je die per kwartaal aan via de Unieregeling, het eenloketsysteem (Belastingdienst, Afstandsverkopen binnen de EU{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026).

In Twinfield is een btw-code een verkoop- of inkoopcode met een percentage per ingangsdatum en een grootboekrekening waarop de btw landt (Twinfield, VAT{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026). Eén code draagt dus op elk moment één tarief.

Verkoop je in Duitsland en België tegen hun hoge en lage tarief, dan heb je per land en per tarief een eigen code nodig.

De koppeling moet daarom per orderregel drie dingen weten: het land van aflevering, het tarief dat de webshop rekende en de Twinfield-code die daarbij hoort. Die vertaaltabel stel je eenmalig op met je boekhouder; de koppeling past hem daarna op elke order toe.

Drie randgevallen die we in de intake altijd langslopen:

• Verzendkosten krijgen een btw-code die past bij de producten in de order; bij gemengde tarieven spreek je de verdeling af.
• Kortingen horen op de omzetregel met hetzelfde tarief, anders klopt de btw-regel niet.
• Zakelijke EU-klanten met een geldig btw-nummer vallen buiten OSS en krijgen een eigen code.

Dat tweede punt is geen detail: Twinfield rekent de btw van een verkoopboeking na en weigert de boeking als de bedragen niet kloppen (Twinfield, Sales transactions{target="_blank" rel="noopener noreferrer"}). Een korting die de webshop over de hele order uitsmeert, levert afrondingsverschillen op die je pas ziet als de eerste boeking terugkomt.

Het geld komt apart binnen: Mollie, Shopify Payments en Stripe#

De order is de vordering, de uitbetaling is het geld. Die twee lopen nooit gelijk, en daar gaat het bij de meeste webshopkoppelingen mis.

Een Mollie-settlement is een overboeking van je Mollie-saldo naar je bank. Hij bundelt betalingen, trekt terugbetalingen en chargebacks af en toont per kalendermaand de omzet en de ingehouden kosten per betaalmethode (Mollie, Get settlement{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026).

Een Shopify Payments-uitbetaling is een netto bedrag met een samenvatting van kosten en bruto per transactietype (Shopify, ShopifyPaymentsPayout{target="_blank" rel="noopener noreferrer"}). Stripe werkt op dezelfde manier (Stripe, Payout reconciliation{target="_blank" rel="noopener noreferrer"}).

Op je bankafschrift staat dus één bedrag voor tientallen orders, minus kosten en retouren. Zo zetten wij die uitbetaling in Twinfield neer:

Wie dit overslaat, houdt na een maand honderden openstaande posten van een paar euro over, en een tussenrekening die nooit op nul komt. Hoe het afletteren technisch via de matching-service werkt, staat in onze uitleg van de Twinfield API.

Verkoop je ook via bol of Amazon, dan is de uitbetaling nog een stap ingewikkelder: daar zijn commissie en kosten al van de omzet afgetrokken voordat er iets naar je bank gaat. Dat is een eigen vraag met een eigen boekingsopzet, en valt buiten deze pagina.

Debiteuren: één verzameldebiteur of elke klant een eigen code?#

In Twinfield is een klant een dimensie van het type DEB binnen een administratie (office), met een vast codeformaat (Twinfield, Dimension types{target="_blank" rel="noopener noreferrer"}). De koppeling moet dus beslissen of elke webshopklant zo'n code krijgt.

Bij een B2C-webshop kiezen wij meestal voor één verzameldebiteur per verkoopkanaal, met het ordernummer en de naam in de omschrijving. Je debiteurenlijst blijft overzichtelijk en je bewaart geen klantgegevens dubbel.

Bij B2B ligt het andersom. Zakelijke klanten op rekening krijgen een eigen DEB-code, omdat je per klant de openstaande posten, de betaaltermijn en de aanmaningen wilt volgen.

De Picqer-koppeling met Twinfield zoekt bijvoorbeeld eerst een bestaande klant op naam voordat hij een nieuwe aanmaakt (Picqer, Twinfield koppelen{target="_blank" rel="noopener noreferrer"}, geraadpleegd november 2026). Dat werkt, maar twee klanten met dezelfde naam worden dan één; een match op btw-nummer of klantnummer is betrouwbaarder.

Boek je meerdere webshops in aparte BV's, dan hoort elke winkel bij zijn eigen office. Regel dan bij de autorisatie dat de koppeling in al die administraties mag schrijven.

Connector of maatwerk: zo beslis je#

Een connector is voor een eenvoudige WooCommerce-webshop de goedkoopste route. De Combidesk-plugin kost na een proefperiode van 30 dagen €18 per maand, synchroniseert elke 60 tot 120 minuten (nagenoeg realtime in de duurdere supportpakketten) en is geschikt voor OSS (Combidesk, september 2026).

Kies een connector als alle vier kloppen:

• één webshop, één administratie;
• je webshop is de factuurbron en je boekt als verkoopboeking;
• je retouren zijn volledige retouren, geen deelretouren met een deel van de verzendkosten;
• je betaalprovider heeft zelf een Twinfield-koppeling voor het afletteren, of je doet dat met de hand.

Kies maatwerk zodra een van deze speelt:

• PrestaShop, waarvoor we geen kant-en-klare Twinfield-connector vonden;
• meerdere winkels of BV's in één koppeling;
• OSS met verkoop in meerdere landen en meerdere tarieven;
• uitbetalingen die automatisch per order moeten worden afgeletterd.

Controleer bij elke connector ook welke Twinfield je draait. Picqer meldt op zijn helppagina dat hij alleen met Twinfield Classic kan koppelen, omdat Twinfield derde partijen nog niet laat koppelen met de nieuwe omgeving (Picqer, geraadpleegd november 2026).

Meer over die valkuil staat in ons stuk over Picqer koppelen.

Draait je Twinfield bij je accountant, overleg dan eerst daar. Het kantoor heeft soms al een connector in gebruik en wil meestal meebeslissen over de btw-codes en de verzameldebiteur.

Wat een Twinfield-webshopkoppeling kost#

Onze prijzen voor een boekhoudkoppeling hangen af van het aantal kanalen en landen, niet van het platform. Deze bandbreedtes gebruiken wij ook in onze offertes, met een vaste prijs vooraf:

Een koppeling die meer doet dan de webshopstroom, zoals voorraad terug naar de webshop of een eigen ERP ertussen, valt onder een API-koppeling. Wat die kost per richting en per aantal systemen, lees je in wat een API-koppeling laten maken kost.

Reken ook op een kostenpost die je in een offerte zelden ziet: Twinfield vraagt geld voor API-gebruik.

Volgens Invantive, een partij die zelf Twinfield-koppelingen levert, rekent Twinfield sinds 1 september 2025 per administratie waartoe een koppeling toegang heeft; een heffing op dataverkeer boven een fair-use-grens is aangekondigd, maar uitgesteld tot na 2025 (Invantive forum, 30 juli 2025{target="_blank" rel="noopener noreferrer"}). Een openbare prijslijst daarvoor vonden we niet; vraag je leverancier of die kosten in zijn maandprijs zitten.

Van intake tot live in drie stappen#

1. Intake met je boekhouder. Verkoopboeking of factuur, de btw-vertaaltabel, de debiteurkeuze en de grootboekrekeningen voor omzet, verzendkosten en transactiekosten.
2. Bouwen en testen in conceptstatus. We testen in een aparte testadministratie en boeken voorlopig, zodat niets definitief wordt voordat je boekhouder het heeft gezien.
3. Live met controle-ronde. De koppeling draait, en de dagelijkse vergelijking tussen webshop en Twinfield meldt elk verschil.

Met WooCommerce of Shopify is een standaardkoppeling bij ons in twee tot drie weken live; met meerdere kanalen of OSS reken je op vier tot zes weken. De uitwerking per stap staat op de dienstpagina webshop-boekhoudkoppeling.

Wil je weten of jouw shop met een connector toe kan of maatwerk nodig heeft? Stuur ons je platform, je betaalprovider en de landen waar je naartoe verkoopt.

Neem contact op, bel 085 016 0118 of plan een gesprek: je krijgt een eerlijk advies, ook als dat een connector van €18 per maand is.