Twinfield koppelen met je webshop, CRM en betalingen

Wat je met Twinfield koppelt

• Verkoopfacturen uit je webshop of CRM als boeking in Twinfield
• Relaties (debiteuren en crediteuren) gelijk houden met je CRM
• Betalingen uit Mollie of de bank klaarzetten voor afletteren
• Openstaande posten ophalen voor aanmaningen en dashboards
• Inkoopfacturen uit je mail klaarzetten voor verwerking

Hoe de koppeling werkt

De koppeling logt in via OpenID Connect met een client die in het Twinfield developer portal is geregistreerd. Elke aanroep gaat naar de webservice van jouw cluster, met de administratiecode in de aanroep. Twinfield telt credits per minuut; de koppeling werkt daarom in porties en respecteert de wachttijd die Twinfield teruggeeft. Elke boeking krijgt een vast kenmerk, zodat herhalen veilig is.

Feiten over de API van Twinfield

Gecontroleerd op 2 november 2026 tegen de officiële documentatie. Limieten, prijzen en versies veranderen; de bron staat per regel erbij.

Feit	Wat de documentatie zegt	Bron
Authenticatie	OpenID Connect (OAuth 2.0) met de authorization-code-flow; een client registreer je in het developer portal. Het toegangstoken gaat samen met de administratiecode mee in de SOAP-aanroep.	Twinfield: OpenID Connect
Geldigheid token	Toegangstoken 1 uur in de code-flow. Refresh-token 25 jaar, met de scope offline_access.	Twinfield: OpenID Connect
Limieten	Credits per minuut sinds 1 december 2024: 500 per client en organisatie samen, 1.000 per client en 1.000 per organisatie. Lezen kost 1 credit, schrijven 3. Bij overschrijding 429 met Retry-After; maximaal 10 gelijktijdige aanroepen per client en organisatie.	Twinfield: Fair use policy
Webhooks	Niet in de officiële documentatie.	Twinfield: Web services
Testomgeving	Een testaccount loopt via het partnerprogramma van Wolters Kluwer; voorwaarden niet openbaar gedocumenteerd.	Twinfield: Documentation
Versie en afschaffingen	SOAP-webservices (ProcessXML, Finder, bankboek, budget, documenten en meer). Breaking changes met einddatum: onder meer meer dan 1.000 regels per transactie geeft 400 (sinds oktober 2024) en ProcessXmlCompressed is gestopt (juli 2025).	Twinfield: Breaking changes
Kosten API	Niet in de officiële documentatie; bij structureel hoog gebruik kan Twinfield vragen te minderen of de vergoeding te verhogen.	Twinfield: Fair use policy
n8n	Geen ingebouwde node en geen community-node gevonden; de koppeling loopt via een HTTP-stap in n8n.	n8n-documentatie

Wat jij nodig hebt

• Een client in het developer portal van Twinfield, of toegang via je accountant die al een client heeft
• De administratiecode en een gebruiker met rechten op die administratie
• De btw-codes en grootboekrekeningen per artikel of dienst, afgestemd met je accountant
• Een vast kenmerk per factuur of boeking, zodat niets dubbel wordt geboekt

Waar het vaak misgaat, en hoe ik dat voorkom

• Credits per minuut: Twinfield begrenst het aantal aanroepen per minuut en per client. Een koppeling die alles tegelijk doet, loopt vast op een 429. De koppeling verdeelt het werk.
• Verkeerd cluster: elke organisatie draait op een eigen cluster. De koppeling vraagt het juiste adres eerst op bij Twinfield in plaats van het hard in te stellen.
• Grote boekingen: een transactie met meer dan duizend regels weigert Twinfield. De koppeling splitst waar nodig.
• Btw en grootboek: de indeling van btw-codes en grootboekrekeningen leg ik met jou of je accountant vast voordat er wordt geboekt.

Uit de praktijk

Een Twinfield-koppeling staat bij mij nog niet als In productie. De aanpak is dezelfde als bij Exact Online: eerst tegen een testomgeving, een vast kenmerk per boeking, respect voor de limieten van de leverancier, en een melding in gewone taal als iets niet lukt.

Wat het kost

Een koppeling met Twinfield bouw ik als één afgebakend proces voor een vaste prijs, vanaf €750. Onderhoud en bewaking zijn een maandbedrag: n8n-beheer vanaf €250 per maand, serverbeheer €145 per server. In de gratis scan rekenen we jouw proces door. Alle prijzen en wat erin zit →

Wat ik niet doe

• Ik doe je boekhouding niet; de indeling van btw en grootboek komt van jou of je accountant.
• Ik overschrijd de credits van Twinfield niet bewust; de koppeling wacht als Twinfield dat vraagt.
• Ik bouw niet op webservices die Twinfield heeft afgeschaft.

Veelgestelde vragen over Twinfield koppelen

Heeft n8n een Twinfield-node?

Nee, en er is ook geen community-node gevonden. Ik koppel Twinfield via de webservices met een HTTP-stap in n8n. Dat is maatwerk, maar leesbaar en van jou.

Hoe krijg ik toegang tot de Twinfield API?

Via een client in het developer portal van Twinfield. De link naar een testaccount loopt via het partnerprogramma van Wolters Kluwer. Welke voorwaarden daaraan hangen, staat niet in de openbare documentatie; dat vragen we samen na.

Hoeveel aanroepen per minuut staat Twinfield toe?

Twinfield werkt met credits per minuut: 500 per combinatie van client en organisatie, en 1.000 per client of per organisatie. Een leesaanroep kost één credit, een schrijfaanroep drie. Daarboven geeft Twinfield een 429 met een wachttijd.

Heeft Twinfield webhooks?

Niet volgens de officiële documentatie. De koppeling controleert daarom op vaste momenten op nieuwe of gewijzigde gegevens en houdt bij wat al is verwerkt.

Wat gebeurt er als een boeking mislukt?

De boeking gaat naar een wachtrij en je krijgt een storingsmail met wat er misging en wat je kunt doen. Tijdelijke fouten, zoals een limiet, worden automatisch later opnieuw geprobeerd.