PrestaShop koppelen aan Twinfield: de route langs het pakket van je accountant

"PrestaShop koppelen aan Twinfield" leest als een technische vraag. Meestal is het er geen. Twinfield wordt in Nederland grotendeels via accountants- en administratiekantoren verkocht, en dan staat jouw administratie niet op jouw abonnement maar in de omgeving van je kantoor. Jij bent de gebruiker. Iemand anders is de licentiehouder.

Dat verschil bepaalt of je koppeling er überhaupt komt, wat hij per maand kost, en wie er belt als hij zaterdagochtend stilvalt. De volgorde is daarom omgekeerd aan de gemiddelde koppelhandleiding: eerst het gesprek met je accountant, dan pas de API-sleutel. Draai je die om, dan heb je straks een werkende koppeling die wacht op een gebruiker die niemand mag aanmaken.

Waarom deze koppeling drie partijen nodig heeft

Een Twinfield-koppeling onder de accountancyregeling is een verbinding waarbij drie partijen elk iets moeten leveren: jij zet je webshop open, de licentiehouder maakt een koppelgebruiker aan in de juiste administratie met het juiste niveau, en de koppelende software heeft een certificering van Wolters Kluwer nodig om de API te mogen gebruiken. Ontbreekt er één, dan draait er niets.

Dat is een andere wereld dan een app op een Moneybird-account dat op jouw naam staat. Bij die koppelingen kies je het triggermoment en de veldmapping en ben je klaar. De keuzes voor een webshop die zelf de bron van je factuurregels is blijven overeind, maar er komt een partij bij die de sleutel van het slot heeft.

De prijskant laat zien waarom je administratie daar hangt. Voor kantoren rekent Wolters Kluwer een staffel vanaf 5,25 euro per administratie per maand, met een minimum instaptarief van 159 euro voor twintig interne administraties. Neem je zelf een abonnement, dan begint Extra Boekhouden bij 58 euro per maand voor één gebruiker en vijf administraties, staat MKB Boekhouden op 78,50 euro en Compleet Boekhouden op 114,50 euro (bedragen exclusief btw, augustus 2026). Een factor tien tot twintig per administratie. Geen accountant zet jou zomaar over, en dat is meestal ook niet in jouw belang.

De vijf vragen die je je accountant stelt voordat er iets technisch kan

Dit is het echte voorwerk. Vijf vragen, en de antwoorden bepalen samen welke route je verderop kunt kiezen. Stuur ze gerust als lijstje per mail, dan hoeft niemand ze uit zijn hoofd te beantwoorden.

1. Onder welk abonnement draait mijn administratie? De accountancyregeling van het kantoor, of een eigen bedrijfsabonnement. Dit antwoord bepaalt alle volgende. Draai je onder het kantoor, dan is jouw kantoor de klant van Wolters Kluwer en jij niet.

2. Mag er een koppelgebruiker komen, en wat kost die? Hier zit het geld. Wolters Kluwer schrijft dat koppelgebruikers gratis zijn in een omgeving onder de accountancyregeling, onder een handvol voorwaarden, waarvan de belangrijkste is dat de partij die koppelt een API-certificeringsabonnement heeft. De gebruikersnaam wordt de naam van het te koppelen pakket, het type is 'Accountant'. Geldt die regeling niet, dan wordt het een gewone extra gebruiker, en dan kost de rol Invoeren en invoerverslag 54 euro per maand, terwijl een Meekijken-gebruiker op 19 euro staat (exclusief btw, augustus 2026). Dat is het verschil tussen een koppeling van 15 euro per maand en een van 69.

3. Welk niveau krijgt die gebruiker? Twinfield deelt gebruikers in niveaus in, en die niveaus bepalen letterlijk wat je koppeling kan. Een gebruiker op niveau 1 (Complete Accounting) mag verkoopfacturen aanmaken; een gebruiker op niveau 3 (SME Accounting) kan alles behalve dat. Vraag je een facturenkoppeling aan en krijg je een niveau 3-gebruiker, dan faalt elke aanroep die een factuur wil maken, met een foutmelding die eruitziet als een technisch probleem. Laat je koppelpartij vooraf opschrijven welk niveau minimaal nodig is en zet dat in de mail.

4. Wie meldt een storing, bij wie, en binnen hoeveel uur? Jij hebt geen contract met Wolters Kluwer, je accountant wel. Een melding over de Twinfield-kant loopt dus via het kantoor, terwijl een melding over de koppeling zelf bij de koppelpartij hoort. Maak die splitsing vooraf expliciet, inclusief wie er kijkt buiten kantooruren. Een koppeling die op vrijdagavond stilvalt en pas maandag opvalt kost je een weekend aan orders die je met de hand terugzoekt, en dat is precies waarom je een stilgevallen koppeling zelf wilt zien voordat je klant belt.

5. Wat gebeurt er als ik overstap? De opzegtermijn van Twinfield is één maand met een minimale looptijd van twaalf maanden, en na beëindiging vervalt je toegang tot de administratie; als back-up genereer je een auditfile, en werk je in de omgeving van een accountant, dan doet je accountant dat. Er is een nettere uitweg: wie via zijn accountant in Twinfield werkt kan zelf een abonnement afsluiten, waarna Wolters Kluwer de administratie van de accountant naar dat nieuwe abonnement kopieert. Vraag hoe je kantoor daarmee omgaat vóórdat je een koppeling bouwt die aan die omgeving hangt.

Pas als deze zes vinkjes staan, is er iets technisch te doen.

Wat je aan jouw kant klaarzet in PrestaShop

Het webshopdeel is het makkelijke deel, mits je één keuze bewust maakt. PrestaShop heeft sinds versie 9 twee API's naast elkaar, en de meeste koppelpartijen gebruiken nog de oude.

De klassieke Webservice-API zet je aan onder Geavanceerde parameters, Webservice, waar je een sleutel aanmaakt en per bron aanvinkt welke methodes hij mag gebruiken. Geef die sleutel leesrechten op orders, customers, addresses en order_details, en laat schrijfrechten uit tenzij je koppeling orderstatussen moet terugzetten. De documentatie is daar zelf streng over en waarschuwt om niet alle rechten op alle bronnen aan één sleutel te geven.

De nieuwe Admin API is de beoogde vervanger, gebouwd op OAuth2 en API Platform, en bestaat omdat de oude Webservice-API beperkt rechtenbeheer heeft en CRUD-bewerkingen doet zonder veel intelligentie. Aanzetten doe je via Geavanceerde instellingen, Nieuwe functies en experimentele functionaliteit, waarna er een eigen Admin API-scherm verschijnt. Mooi, maar PrestaShop noemt hem zelf nog volop in ontwikkeling, met nieuwe endpoints in aankomende updates. Voor een boekhoudkoppeling in productie is de oude sleutel voorlopig de veiligere keuze. Draai je nog op 8.x, dan is dat geen blokkade; de huidige lijn is PrestaShop 9.1 met Hummingbird 2.0, PHP 8.5 en Symfony 6.4 LTS, en 9.2 stond in juli 2026 in bèta.

Verder aan jouw kant: het btw-tarief moet per product kloppen, verzendkosten en kortingen horen aparte regels te zijn, en je kiest één orderstatus als triggermoment (meestal Betaling aanvaard of Verzonden, nooit het aanmaken van de order). Verkoop je over de grens, reken dan de OSS-drempel door voordat je automatiseert, want een domme koppeling plakt overal 21 procent op.

Vier routes van PrestaShop naar Twinfield

Nu de methodekeuze. Er zijn er vier, en de eerste twee dekken verreweg de meeste webshops.

Route 1: een kant-en-klare connector die facturen maakt. Een gecertificeerde koppelpartij haalt je orders op en zet ze als debiteur plus verkoopfactuur in Twinfield. iWebDevelopment, dat zichzelf officieel Twinfield-partner noemt, rekent 21 euro per maand bij maandbetaling of 19 euro bij jaarbetaling voor debiteuren, artikelen en verkoopfacturen, met een maand gratis proef en maandelijkse opzegbaarheid (tarieven augustus 2026). Deze route eist een koppelgebruiker die facturen mág maken, dus niveau 1.

Route 2: een boekingsstroom in plaats van facturen. Dezelfde partijen bieden een lichtere variant die alleen debiteuren en verkoopboekingen wegschrijft, bij iWebDevelopment voor 13 euro per maand met een grens van honderd verkoopboekingen. Webwinkelfacturen zet PrestaShop-orders door naar conceptboekingen of facturen in Twinfield en rekent 80 euro per jaar voor 250 facturen, 130 euro voor duizend en 180 euro voor onbeperkt, met dertig dagen gratis proef (exclusief btw, augustus 2026). Die koppeling stuurt gedurende de dag door en boekt niets dubbel, maar synchroniseert geen artikelen of voorraad. Voor een webshop die zijn facturen al in PrestaShop maakt is dit vaak de betere route: minder rechten nodig, minder dat kan botsen met wat je accountant doet.

Route 3: zelf bouwen op een integratieplatform. Verleidelijk, en hier loopt het meestal stuk. Wolters Kluwer stelt dat het verplicht is een API-certificeringsabonnement af te nemen om met Twinfield Boekhouden te koppelen, waarmee ze samen met de bouwer controleren of de koppeling correct gebouwd is. Zonder die certificering kom je technisch een eind, maar loop je tegen een muur: een niet-gecertificeerde client krijgt volgens integratiespecialist Apideck vijf procent van de normale limiet, dus vijftig credits per minuut in totaal, waarbij een leesactie één credit kost en een schrijfactie drie. Een gecertificeerde client zit op duizend credits per minuut per organisatie en vijfhonderd per combinatie van client en organisatie. Ga je eroverheen, dan krijg je een 429-status terug.

Route 4: maatwerk via een partij die de certificering al heeft. Dit is route 3, maar dan met iemand die het traject al doorlopen heeft en op zijn eigen client id koppelt. Duurder om te bouwen, en de enige route die meebeweegt met een proces dat afwijkt: abonnementen, deelleveringen, een eigen kostenplaatsstructuur, meerdere administraties in één keten. Dezelfde afweging als bij de drie routes naar Exact Online, waar de kant-en-klare connector wint zolang je proces standaard is.

Tarieven augustus 2026, exclusief btw en exclusief het Twinfield-abonnement zelf.

Het stappenplan: van PrestaShop-order naar boeking in Twinfield

Aan het eind van deze zeven stappen heb je een PrestaShop-order die als kloppende verkoopboeking in de Twinfield-administratie van je accountant landt, met de juiste btw-code en je ordernummer als referentie. Voorwaarde vooraf: de koppelgebruiker bestaat al en je koppelpartij heeft de certificering. Zonder die twee blijft stap 5 hangen op het inlogscherm.

Zeven stappen, in deze volgorde. Elke stap levert iets op dat je kunt controleren.

1. Leg de vijf antwoorden van je accountant vast in een mail. Licentievorm, koppelgebruiker plus prijs, minimaal gebruikersniveau, storingsafspraak, exit-route. Dit is je opdrachtbevestiging aan jezelf.
2. Kies je route en dus je koppelpartij. Vraag expliciet naar de certificering: "hebben jullie een API-certificeringsabonnement bij Wolters Kluwer?" Is het antwoord nee, dan valt de gratis koppelgebruiker weg en verandert je rekensom.
3. Laat de koppelgebruiker aanmaken. Gebruikersnaam is de naam van het pakket, type 'Accountant' in een kantooromgeving, met rechten op precies die ene administratie. Een aparte gebruiker per klant is niet alleen netjes maar ook veiliger: koppel je via de eigen inloggegevens van het kantoor, dan krijgt de koppeling zicht op administraties die er niets mee te maken hebben, wat bij verwerkersovereenkomsten onder de AVG een probleem is.
4. Maak de Webservice-sleutel in PrestaShop. Alleen de bronnen die je nodig hebt, alleen de methodes die je nodig hebt. Noteer de sleutel op één plek die niet je mailbox is.
5. Doorloop de autorisatie met de koppelgebruiker. De koppelpartij stuurt je naar het inlogscherm van Twinfield. Log daar in met de nieuwe koppelgebruiker, niet met je eigen meekijkaccount, en ken alle gevraagde rechten toe. Wie dit al eens deed bij een bankkoppeling herkent de stap: bij Wise kies je expliciet of je je accountant uitnodigt of zelf doorgaat naar Twinfield, waarna alle gevraagde permissies nodig zijn omdat de verbinding anders niet werkt. Achter de schermen levert die autorisatie een toegangstoken van 3.600 seconden op plus een refresh token dat nominaal 25 jaar meegaat, waarna de koppeling de juiste cluster-URL van jouw omgeving ophaalt.
6. Map je grootboek en btw-codes. Eén verkoopdagboek, een grootboekrekening per btw-tarief, een aparte rekening voor verzendkosten en een voor betaalkosten. Laat je accountant dit schema goedkeuren, want hij trekt er straks de aangifte uit.
7. Draai twintig echte orders door de keten en tel na. Neem een dag met een retour en een order zonder btw erin. Controleer in Twinfield of de bedragen kloppen, of de debiteur niet dubbel is aangemaakt en of het ordernummer als referentie meekomt. Pas daarna zet je de koppeling op automatisch.

Waar het misgaat: de valkuilen van een pakket dat niet van jou is

De koppeling sterft omdat er iemand bij het kantoor vertrekt. Dit is de gemeenste. Een refresh token gaat nominaal jaren mee, maar hij stopt zonder waarschuwing zodra de gebruiker wordt uitgeschakeld, verwijderd of zijn wachtwoord wijzigt, en het enige signaal dat je krijgt is een mislukte vernieuwing. Koppel je via het persoonlijke account van je vaste contactpersoon, dan is zijn vertrek jouw storing. De mitigatie is precies waarom je een aparte koppelgebruiker vraagt die aan geen enkel mens hangt. Dat koppelingen op naam van een vertrokken medewerker blijven doordraaien tot ze plots niets meer doen is geen Twinfield-eigenaardigheid, maar hier is de vertrekker niet eens van jouw bedrijf.

Het gebruikersniveau is te laag en de foutmelding zegt dat niet. Een niveau 3-gebruiker die een verkoopfactuur probeert te maken krijgt een afwijzing die als schemafout of rechtenfout binnenkomt, niet als "dit niveau mag dit niet". Test daarom stap 7 met een echte factuur, niet met een boeking.

De koppeling schrijft in een administratie waar je accountant ook handmatig werkt. Zolang niet vastligt wie welke boekingssoort maakt, boek je dubbel: jij automatisch vanuit de webshop, hij met de hand vanuit het bankafschrift. Spreek af dat de webshop de bron is voor omzet en dat het kantoor alleen aflettert, en leg dat vast zoals je per veld één bron van waarheid aanwijst voordat je twee systemen laat schrijven.

Je deelt de rate limit met koppelingen die je niet kent. De vijfhonderd credits per minuut gelden per combinatie van client en organisatie, maar de duizend per organisatie deel je met elke andere koppeling op diezelfde Twinfield-organisatie. Draait het kantoor daar ook een scan-en-herken-oplossing en een bankkoppeling, dan tikt dat mee. Bij een paar honderd orders per maand merk je hier niets van; op een piekdag met een importronde erbovenop wel.

Er is geen gratis speeltuin. Een eigen testomgeving hoort bij het certificeringsabonnement, dus die heeft je koppelpartij en jij niet. Testen doe je in een echte administratie. Vraag je accountant om een lege testadministratie in dezelfde omgeving, of accepteer dat je stap 7 in je eigen boeken doet en de proefboekingen daarna terugdraait.

Grote batches lopen tegen een harde grens. De Twinfield-API weigert een transactie met meer dan duizend regels en geeft een 400-status terug. Bij een verzamelboeking over een drukke maand is dat dichterbij dan je denkt, want per orderregel komt er een boekingsregel plus btw bij.

Beslis-kader: kant-en-klaar, maatwerk, of toch een eigen abonnement

Drie assen, in deze volgorde.

As 1: wie is de licentiehouder, en wil je dat zo houden? Draai je onder het kantoor en bevalt dat, dan is een gecertificeerde connector met een gratis koppelgebruiker verreweg de goedkoopste weg. Wil je onafhankelijker worden, dan is de vraag niet welke koppeling maar of je 58 tot 114,50 euro per maand voor een eigen abonnement over hebt. Dat is een inkoopmoment, geen koppelvraag, en dan zet je het naast de alternatieven zoals je een boekhoudpakket op koppelbaarheid kiest in plaats van op functies.

As 2: facturen of boekingen? Maakt PrestaShop al de factuur die je klant krijgt, kies dan de boekingsroute: goedkoper, minder rechten, minder ruzie over factuurnummers. Moet Twinfield de factuur maken, bijvoorbeeld omdat je zakelijke klanten met betalingstermijnen bedient en je debiteurenbeheer daar loopt, dan heb je niveau 1 nodig en dus de factuurroute.

As 3: past je orderstroom in de standaard? Eén webshop, één administratie, één btw-land, geen abonnementen: kant-en-klaar. Meerdere administraties, deelleveringen, marktplaatsverkoop ernaast of een eigen kostenplaatsstructuur: dan begint zelfs de beste connector uitzonderingen te produceren die iemand met de hand oplost, en verschuift het omslagpunt naar maatwerk. Reken dat om in geld voordat je beslist, want de bouw is bij automatisering zelden de grootste post.

Uitgewerkt voorbeeld: 400 orders per maand, administratie bij het kantoor

Een PrestaShop-webshop in onderdelen, 400 orders per maand, gemiddeld 62 euro per order, alleen Nederlandse particulieren. PrestaShop 9.1, facturen komen uit de webshop. De administratie draait in de Twinfield-omgeving van het administratiekantoor, dat ruim honderd klanten onder de accountancyregeling heeft.

De eigenaar stelt de vijf vragen. De antwoorden: accountancyregeling, koppelgebruiker mag als de partij gecertificeerd is, niveau 3 volstaat want de webshop factureert zelf, storingen aan de Twinfield-kant meldt het kantoor binnen één werkdag, en bij een overstap genereert het kantoor de auditfile.

Daarmee valt de keuze op de boekingsroute. 400 orders per maand is 4.800 per jaar, dus het onbeperkte staffelniveau van Webwinkelfacturen op 180 euro per jaar, oftewel 15 euro per maand. De koppelgebruiker is gratis. Totale kosten: 180 euro per jaar plus de tijd voor de inrichting.

Het alternatief dat de eigenaar bijna koos was de facturenconnector op 21 euro per maand. Die had niveau 1 nodig, en dat had het kantoor moeten oplossen met een betaalde rol van 54 euro per maand. Jaarlijks: 252 plus 648 is 900 euro, tegen 180. Eén regel in een mail scheelde 720 euro per jaar, zonder dat er functioneel iets verandert aan wat er in Twinfield belandt.

De druk op de API is verwaarloosbaar. 400 orders betekent ongeveer twintig per werkdag, en per order tikt een debiteurenlookup (één credit) plus een boeking (drie credits) op tot rond de honderd credits per dag. De limiet is duizend per minuut. Bij deze schaal is niet de techniek de beperking maar de administratieve afspraak, en dat is bij deze koppeling bijna altijd zo.

Wat je hier eigenlijk regelt

De hele oefening gaat over één ding: je automatiseert een proces in een systeem waarvan iemand anders de sleutel heeft. Dat is niet erg. Het is zelfs vaak verstandig, want je betaalt een staffelprijs voor iets waar je zelf 58 tot 114,50 euro per maand voor kwijt zou zijn, en je accountant kijkt gratis mee.

Maar het betekent dat je afspraken maakt in plaats van instellingen. Wie de koppelgebruiker aanmaakt, welk niveau hij krijgt, wie hem opnieuw autoriseert als hij stukloopt, en wie de auditfile draait als je ooit vertrekt. Die vier antwoorden staan in een mail, of ze staan nergens. Een koppeling die op mondelinge welwillendheid draait, draait precies tot de dag dat de vaste contactpersoon van kantoor wisselt.