Your Tech Club
KOPPELINGENTWINFIELD

Twinfield koppelen

Een Twinfield-koppeling zorgt dat facturen, relaties en betalingen niet meer met de hand tussen systemen gaan. Voor accountantskantoren en organisaties met meerdere administraties scheelt dat vooral controlewerk aan het eind van de periode. Hieronder lees je hoe de API van Twinfield werkt en waar koppelingen in de praktijk op vastlopen.

Alle koppelingen
4,8 uit 127 reviews
ISO 9001 & 27001
TwinfieldBoekhouding en ERP · Wolters Kluwer
  • Verkoopfacturen en verkooptransacties gaat heen en weer met Je andere systemen
  • Relaties als dimensies gaat heen en weer met Je andere systemen
  • Openstaande posten gaat heen en weer met Je andere systemen
  • Inkooptransacties gaat heen en weer met Je andere systemen
Je andere systemenZoals HubSpot, Salesforce

Onder meer gebouwd voor Tata Steel, M&G Investments, Digistore24, Toppers in Concert, Bar-le-Duc en Loogman

Wat je uitwisselt

Dit zijn de gegevens die organisaties het vaakst tussen systemen laten lopen. Welke daarvan voor jou tellen, hangt af van waar het werk nu blijft liggen.

Verkoopfacturen en verkooptransacties

Twinfield kan zelf een verkoopfactuur maken, of je boekt een factuur uit een ander systeem als verkooptransactie. Welke van de twee kan, hangt ook af van het Twinfield-pakket dat de administratie gebruikt.

Relaties als dimensies

Debiteuren en crediteuren heten in Twinfield dimensies. Op niveau 1 staan grootboekrekeningen, op niveau 2 relaties en kostenplaatsen, op niveau 3 projecten en activa. Een koppeling moet die indeling kennen om boekingen op de goede plek te krijgen.

Openstaande posten

Welke facturen nog open staan en hoe lang al. Dit is de informatie waar sales, service en accountmanagers het vaakst om vragen, en die ze zelden zelf in Twinfield opzoeken.

Inkooptransacties

Facturen van leveranciers, met grootboekrekening, btw-code en waar nodig een kostenplaats of project.

Bankafschriften en afletteren

Elektronische bankafschriften inlezen en betalingen aan openstaande posten koppelen. Twinfield heeft daar aparte webservices voor, zodat een koppeling ook het afletteren kan overnemen.

Standaard of maatwerk

Niet altijd. Doet een bestaande koppeling voor Twinfield precies wat je nodig hebt, dan zeggen we dat ook.

Wat er al bestaat

Koppelingen met Twinfield komen van partijen die het certificeringstraject van Wolters Kluwer hebben doorlopen. Zo'n koppeling is getoetst op bouw en werking. Voor veelgebruikte combinaties bestaat vaak al iets; je accountant of de leverancier van het andere pakket weet meestal welke koppelingen er zijn.

Een standaardkoppeling volstaat als de gegevens één kant op gaan, je met één administratie werkt en de boekingslogica past bij wat je accountant wil. Zodra meerdere administraties, eigen dimensies of een terugkoppeling naar sales nodig zijn, passen standaardkoppelingen vaker maar half.

Wanneer maatwerk nodig is
  • Je werkt met meerdere administraties binnen één organisatie, zoals een holding met werkmaatschappijen, en elke boeking moet in de juiste administratie landen.
  • Je gebruikt kostenplaatsen of projecten die in het bronsysteem anders heten of anders zijn ingedeeld.
  • Je CRM, platform of eigen software heeft geen gecertificeerde Twinfield-koppeling.
  • Financiële gegevens moeten terug naar sales of service, zoals openstaande posten per klant.
  • Je verwerkt grote aantallen regels en moet samenvatten om binnen de limieten en fair-use-regels te blijven.
Hoe het technisch werkt

SOAP-webservices met XML

Twinfield werkt vooral met SOAP-webservices. Via de ProcessXml-service stuur je XML-berichten voor onder meer transacties, dimensies, verkoopfacturen en btw-codes. Daarnaast zijn er aparte services voor zoeken (Finder), afletteren (Matching), perioden en verwijderde transacties. Webhooks staan niet in de documentatie: een koppeling vraagt wijzigingen zelf op.

OpenID Connect en de juiste administratie

Je registreert je applicatie in het Twinfield developer portal en haalt tokens op via OpenID Connect en OAuth 2.0. Met de scope offline_access krijg je ook een refresh-token. In elke SOAP-aanroep zet je het access-token en de code of het ID van de administratie. Uit de tokengegevens haal je ook het cluster waarop de organisatie draait.

Limieten in API-credits

Een opvraging kost 1 credit, een ander verzoek 3. Per IP-adres, per client en per organisatie geldt een maximum van 1000 credits per minuut, per combinatie van client en organisatie 500. Voor een nieuwe, nog niet gecertificeerde client zijn de limieten per client 5 procent daarvan. Een client mag maximaal 20 verzoeken tegelijk doen, en 10 per organisatie. Hogere limieten biedt Twinfield niet aan.

Certificering en testomgeving

Wie met Twinfield wil koppelen, sluit bij Wolters Kluwer een API-certificeringsabonnement af. Daarmee krijg je toegang tot het developer portal, een eigen testomgeving, technische support en een audit van je koppeling.

Grenzen aan berichten

Een transactie mag maximaal 1000 regels hebben; Twinfield adviseert er hooguit 500. Onder de fair-use-regels let Twinfield op het aantal transactieregels, factuurregels en dimensies dat een koppeling aanmaakt, en kan het de gebruiker vragen dat te beperken.

AI ertussen

Een koppeling verplaatst gegevens. AI kan daartussen lezen, sorteren en een voorstel klaarzetten. Waar het ertoe doet, beslist een mens.

Boekingsvoorstel voor inkoop

AI leest een inkoopfactuur uit en stelt de boeking voor: leverancier, grootboekrekening, btw-code en eventueel kostenplaats of project, met een korte uitleg waarom. Een medewerker of accountant keurt het voorstel goed. Pas daarna gaat de boeking naar Twinfield.

Signaleren over administraties heen

Voor een accountantskantoor kan AI per periode nagaan welke administraties opvallen: ontbrekende bankafschriften, ongebruikelijke btw-codes of een klant met sterk oplopende openstaande posten. Het resultaat is een werklijst voor een mens, geen automatische correctie.

Betaalgedrag in gewone taal

Een korte samenvatting van de openstaande posten van een klant, zodat een accountmanager zonder Twinfield-toegang weet wat er speelt. Wie welke gegevens mag zien, bepaal je zelf.

Waar het misgaat

Btw-afrondingsverschillen

Twinfield rekent de btw per regel uit en schuift afrondingsverschillen door naar de volgende regel. Het totaal kan daardoor een cent afwijken van je bronsysteem. Stuur de btw per regel mee, wat Twinfield zelf aanbeveelt, of laat Twinfield verschillen tot 0,01 corrigeren met autobalancevat.

Lage limiet tijdens de bouw

Voor een client die nog niet gecertificeerd is, zijn de limieten per client 5 procent van het normale aantal API-credits. Een eerste volledige import of een test met echte volumes loopt daardoor snel vast. Plan de certificering vroeg in het project.

Pakketniveau

Niet elk Twinfield-pakket ondersteunt dezelfde webservices. Verkoopfacturen aanmaken via de API kan niet in Extra Boekhouden en Basis Boekhouden; daar boek je een verkooptransactie. Projecten en kostenplaatsen ontbreken in Basis Boekhouden.

Codes en maskers

Twinfield werkt met maskers voor de codes van transacties en stamgegevens, en alleen een superuser past die aan. Een klantnummer uit je CRM is dus niet vanzelf een geldige debiteurcode. Spreek vooraf af welke code de koppeling gebruikt.

Zo bouwen we een koppeling

  1. Wat moet waarheen

    Welke gegevens gaan over, in welke richting, en welk systeem leidend is als twee waarden verschillen. Dat staat op papier voordat er iets gebouwd wordt. Voor deze koppeling gaat het om: Verkoopfacturen en verkooptransacties, Relaties als dimensies, Openstaande posten, Inkooptransacties, Bankafschriften en afletteren.

  2. Velden en regels

    Per veld de vertaling tussen de systemen: statussen, btw-codes, grootboekrekeningen, artikelnummers. En wat er gebeurt bij een dubbel of een ontbrekend gegeven. Voor deze koppeling gaat het om: SOAP-webservices met XML, OpenID Connect en de juiste administratie, Limieten in API-credits, Certificering en testomgeving, Grenzen aan berichten.

  3. Testen met echte gevallen

    In een testomgeving of testadministratie, met de uitzonderingen die in de praktijk voorkomen: creditnota's, deelleveringen, gewijzigde klantgegevens.

  4. Live, met logging en bewaking

    Elke synchronisatie wordt gelogd en bij een fout krijgt iemand een melding. Verandert de API van een leverancier, dan passen wij de koppeling aan.

Het team van Your Tech Club op kantoor in Amsterdam
Amsterdam
Wie je spreekt

Geen accountmanager. Je spreekt iemand die zelf koppelingen bouwt, en die zegt het ook als een standaardkoppeling genoeg is.

Joey van VlietJoey van VlietOprichter
Yassine SeghrouchniYassine SeghrouchniOprichter
  • Kantoor aan de Duivendrechtsekade in Amsterdam
  • ISO 9001 en ISO 27001, gecertificeerd door Kiwa
  • 500 projecten opgeleverd
  • 4,8 uit 127 reviews
Veelgestelde vragen

Heeft Twinfield een REST API?

Twinfield werkt vooral met SOAP-webservices en XML-berichten, bijvoorbeeld via de ProcessXml-service. De authenticatie loopt via OpenID Connect en OAuth 2.0. Je stuurt het access-token en de code van de administratie mee in de header van elke SOAP-aanroep.

Is er een testomgeving voor Twinfield?

Ja, als onderdeel van het API-certificeringsabonnement dat Wolters Kluwer verplicht stelt voor partijen die koppelen. Daarmee krijg je een eigen testomgeving, zodat je niet in de administratie van een klant hoeft te testen. Ook technische support en een audit van de koppeling horen erbij.

Wat zijn de API-limieten van Twinfield?

Twinfield rekent in credits: een opvraging kost 1, een ander verzoek 3. Per IP-adres, per client en per organisatie mag je 1000 credits per minuut gebruiken, per combinatie van client en organisatie 500. Ga je erover, dan krijg je status 429 met een Retry-After-header die zegt wanneer je verder kunt.

Kan ik met elk Twinfield-pakket facturen aanmaken via de API?

Nee. Volgens het functieoverzicht van Twinfield kan het aanmaken van verkoopfacturen via de API niet in Extra Boekhouden en Basis Boekhouden. Verkooptransacties, relaties en bankboekingen kunnen wel in alle pakketten. Controleer dus eerst welk pakket je administratie heeft.

Waarom wijkt de btw in Twinfield een cent af van mijn factuur?

Twinfield berekent en rondt de btw per regel af, en neemt het afrondingsverschil mee naar de volgende regel. Bij veel regels kan het totaal daardoor een cent afwijken van een berekening over het totaalbedrag. Stuur de btw-bedragen per regel mee of zet autobalancevat aan.

Heeft Twinfield webhooks?

In de API-documentatie van Twinfield staan geen webhooks. Een koppeling vraagt wijzigingen dus zelf op, bijvoorbeeld op vaste momenten via zoekopdrachten en de service voor verwijderde transacties. Houd daarbij rekening met de limieten per minuut.

Bronnen

De technische feiten op deze pagina komen uit de officiële documentatie van de leveranciers, gecontroleerd op 19 september 2026. Leveranciers passen hun API's en limieten aan; bij een koppeling kijken we altijd naar de actuele stand.