Boekhouding & administratie

Twinfield-koppeling laten maken

Ik koppel Twinfield aan je webshop, bank, CRM of eigen software via de API van Wolters Kluwer, op jouw eigen account en API-toegang. Orders worden boekingen, betalingen worden afgeletterd en de betaalstatus gaat terug naar je CRM. Voor accountantskantoren en softwarebedrijven bouw ik ook complete apps op Twinfield, over veel administraties tegelijk.

Alle integraties

Zo loopt de data

voorbeeldopzet

Sync-log, zoals je hem in het logboek terugziet (voorbeeld)

Webshoporders worden verkoopboekingen in Twinfield, uitbetalingen van de betaalprovider worden afgeletterd tegen de openstaande posten, inkoopfacturen komen via Basecone binnen en de betaalstatus gaat terug naar je CRM.
  • Order, Refund, wordt Verkoopboeking: van Webshop naar Twinfield, direct, via webhook.
  • Uitbetaling, wordt Afgeletterd: van Betaalprovider naar Twinfield, per batch.
  • Inkoopfactuur, wordt Inkoopboeking: van Basecone naar Twinfield, op verzoek.
  • Betaalstatus: van Twinfield naar CRM, periodiek opgevraagd.

Kort antwoord

Werkgebied: Nederland · Bijgewerkt op door Alisina Nawabi

Wat het is
Een Twinfield-koppeling verbindt Twinfield Boekhouden met je andere systemen via de API van Wolters Kluwer. Verkopen worden boekingen, uitbetalingen worden afgeletterd en de betaalstatus gaat terug naar je CRM, per administratie en zonder overtypen.
Voor wie
Mkb-bedrijven en holdings op Twinfield met een webshop, betaalprovider of CRM, accountantskantoren met veel klantadministraties, en softwarebedrijven die Twinfield in hun eigen product willen ondersteunen.
Doorlooptijd
Een eerste koppeling tussen twee systemen staat meestal binnen 2 weken live. Meer objecten, richtingen of administraties kosten meer tijd; dat staat vooraf in de offerte.
Prijsindicatie
vanaf €4.000 voor een basisopzetEen basisopzet is één koppeling tussen twee systemen, gebouwd, getest en gedocumenteerd. Meer objecten, richtingen, administraties of uitzonderingen maken het groter. Je krijgt vooraf een vaste prijs.

Welke data synchroniseer ik?

Zo richt ik het meestal in. De tabel is ook het startpunt van de intake: jij bepaalt per object de richting en de bron.

Welke data de koppeling synchroniseert, in welke richting, wie de bron is en hoe vaak
ObjectRichtingBron van waarheidFrequentie
Debiteurenbeide kantenCRM of webshop voor contactgegevens, Twinfield voor de boekhoudkantBij elke order, plus een dagelijkse controle op wijzigingen
Verkopen en refunds als verkoopboekingMaximaal 1.000 regels per boeking; ik blijf onder de 500 die Twinfield aanraadt.naar TwinfieldWebshop of kassaDirect na de order, of per uur in een bundel
Uitbetalingen en kosten van de betaalproviderAls bankafschrift in Twinfield, daarna afgeletterd tegen de openstaande posten.naar TwinfieldBetaalproviderPer uitbetaling
Betaalstatus en openstaande postenTwinfield heeft geen webhooks; de koppeling vraagt het op.van TwinfieldTwinfieldEen paar keer per dag
Verwijderde boekingenVia de Deleted Transactions-service, zodat ze ook uit je CRM of dashboard verdwijnen.van TwinfieldTwinfieldDagelijks
Grootboekrekeningen, kostenplaatsen en btw-codesvan TwinfieldTwinfieldDagelijks, voor de mapping
Inkoopfacturen via Baseconenaar TwinfieldBaseconeZodra iemand het boekingsvoorstel boekt

Wat je met een Twinfield-koppeling doet

Voor bedrijven die zelf met de software werken, en voor wie er een product op bouwt voor eigen klanten.

  1. Webshoporders als verkoopboeking in Twinfield

    Webshop op PrestaShop, WooCommerce of Shopify

    1. Order of refund in de webshop
    2. Debiteur gevonden of aangemaakt
    3. Verkoopboeking met btw in de juiste administratie
    4. Geweigerd? Dan staat de reden in de foutenlijst

    Je webshop en je boekhouding vertellen hetzelfde verhaal, en geen order verdwijnt stil.

    Wat de API hiervoor biedt: Debiteuren en verkoopboekingen maak je met ProcessXml. Een geweigerde regel komt terug met result="0" en de reden op precies dat element. Een boeking heeft maximaal 1.000 regels.

    Lees de uitwerking in de gids
  2. Uitbetalingen afgeletterd tegen je openstaande posten

    Webshop met een of meer betaalproviders

    1. Uitbetaling met orders, refunds en kosten
    2. Bankafschrift in Twinfield
    3. Afgeletterd tegen de openstaande posten
    4. Alleen de echte verschillen blijven over

    De maandafsluiting gaat over de uitzonderingen, niet over honderden betalingen die al klopten.

    Wat de API hiervoor biedt: Bankafschriften maak je met het ProcessXml-bericht statement. Afletteren gaat met het bericht match, op debiteuren, crediteuren, projecten of tussenrekeningen, en een aflettering is terug te draaien met UndoMatch.

    Lees de uitwerking in de gids
  3. Betaalstatus terug in je CRM

    Bedrijf dat factureert en opvolgt vanuit een CRM

    1. Koppeling vraagt openstaande posten op
    2. Betaalde facturen herkend
    3. Status bijgewerkt in het CRM
    4. Sales ziet wie betaald heeft

    Niemand hoeft de boekhouding te vragen of een klant al betaald heeft.

    Wat de API hiervoor biedt: Finder geeft openstaande verkoopfacturen terug, en browse data geeft boekingsregels met hun afletterstatus. De REST API heeft een audittrail van afletteringen, op te halen vanaf een tijdstip.

Wat de API van Twinfield ondersteunt

Per object wat er via de API kan. Dit bepaalt wat een koppeling wel en niet kan doen.

Per object: lezen, aanmaken, wijzigen, verwijderen en webhook-ondersteuning in de Twinfield-API
ObjectLezenAanmakenWijzigenVerwijderenWebhook
Debiteuren en crediteurendimension DEB / CRDVerwijderen zet de status op deleted; is de relatie al gebruikt, dan wordt hij verborgen.jajajadeelsnee
Grootboekrekeningendimension BAS / PNLjajajadeelsnee
Kostenplaatsen en projectendimension KPL / PRJjajajadeelsnee
Activadimension ASTjajajadeelsnee
Boekingen (verkoop, inkoop, memoriaal, bank, kas)transactionAlleen voorlopige boekingen zijn te verwijderen; een definitieve boeking corrigeer je met een tegenboeking.jajadeelsdeelsnee
VerkoopfacturensalesinvoiceAlleen in de klassieke factuurmodule; een definitieve factuur ligt vast.jadeelsdeelsneenee
AfletterenmatchTerugdraaien met UndoMatch.deelsjaneejanee
Betaal- en incassorunspayandcollect.asmxjajajadeelsnee
Bankafschriftenstatementjajaneeneenee
Btw-codesvatjajajajanee
PeriodenPeriodService.svcVerwijderen kan alleen per heel boekjaar.jajajadeelsnee
BudgettenREST budgeting/budgetsSchrijven alleen via de REST API.jajajajanee
Administratiesofficejaneeneeneenee
Bijlagen bij boekingengeen gedocumenteerde APIDe Documents-service uit het overzicht kent alleen SendDocument, een document versturen via een gateway, en geen bijlagen bij boekingen. Basecone zet een link naar het document in vrij tekstveld 3 van de boeking.neeneeneeneenee

ja kan via de APIdeels kan met beperkingennee kan niet

Techniek en deadlines

De feiten waar een koppeling op rust, met de bron erbij. En wat er de komende tijd verandert.

API
SOAP/XML-webservices op de cluster-URL van je organisatie: ProcessXml voor lezen en schrijven, Finder om te zoeken, browse data voor financiële gegevens, en losse services voor bankafschriften, perioden, afletteren en betaalruns. Daarnaast een kleinere REST API voor onder meer grootboekrekeningen, budgetten, btw-codes en wijzigingen in debiteuren en crediteuren. Boekingen en verkoopfacturen lopen via SOAP.
Cluster
Elke organisatie zit op een van de clusters van Twinfield, api.<cluster>.twinfield.com. De koppeling vindt dat adres via de validatie van het access token.
Authenticatie
OAuth 2.0 met OpenID Connect via login.twinfield.com, met de authorization code flow voor een server-side koppeling en offline_access voor een refresh token. Het access token geldt een uur, het refresh token 25 jaar, tenzij de gebruiker wordt verwijderd, uitgeschakeld of vergrendeld, of zijn wachtwoord verloopt.
Meerdere administraties
Een token hoort bij één gebruiker in één organisatie. Zonder company code geeft ProcessXml de administraties die dat token mag zien; daarna kiest elke call zijn administratie met de CompanyCode in de SOAP-header.
Limieten
Sinds 1 december 2024 werkt Twinfield met credits: een leesactie kost 1 credit, al het andere 3. Per minuut maximaal 1.000 credits per IP-adres, per ClientId en per organisatie, en 500 per combinatie van ClientId en organisatie. Maximaal 20 gelijktijdige calls per ClientId en 10 per ClientId en organisatie. Daarboven volgt een 429; Twinfield vraagt de Retry-After als start van de wachttijd te nemen. Hogere limieten zijn er niet.
Certificering
Wolters Kluwer verplicht certificering van elke koppeling. Die hoort bij een doorlopend, betaald Twinfield API-abonnement dat de gebruiker van de koppeling afsluit, met API-support erbij. Een nieuwe of nog niet gecertificeerde ClientId krijgt 5% van de credits.
Berichtgrootte
Maximaal 1.000 regels per boeking. Voor boekingen en verkoopfacturen raadt Twinfield maximaal 500 regels aan, en zo’n 25 boekingen per bericht.
Foutmeldingen
ProcessXml zet result="0" met een melding op precies het element dat niet klopt, bijvoorbeeld een gesloten periode. De bovenliggende elementen krijgen ook result="0".
Incrementeel bijwerken
Finder filtert stamgegevens op gewijzigd sinds, de REST API geeft gewijzigde debiteuren en crediteuren, en de Deleted Transactions-service geeft verwijderde boekingen met datum, gebruiker en reden.
Webhooks
Geen. Twinfield documenteert geen meldingen bij wijzigingen, dus een koppeling vraagt ze zelf op.
Testen
Er is geen aparte sandbox. Een testomgeving vraag je aan bij Wolters Kluwer.

Deadlines en wijzigingen

Wat de leverancier heeft aangekondigd, en wat het voor een bestaande koppeling betekent.

  1. al ingegaan

    Boekingen met meer dan 1.000 regels geweigerd

    Een grote boeking, zoals een dagomzet met veel regels, moet in delen; anders volgt een 400.

  2. al ingegaan

    Credits en limieten van kracht

    Elke call telt mee. Een koppeling die veel losse calls doet, moet bundelen en lezen wat nodig is.

  3. al ingegaan

    Boven de limiet volgt altijd een 429

    Wie boven de rate- of concurrencylimiet komt, krijgt een 429 en de call wordt niet uitgevoerd. De koppeling moet wachten en opnieuw proberen.

  4. al ingegaan

    Root-element general geweigerd

    Verzoeken die verschillende soorten gegevens in één general-bericht bundelden, moeten worden gesplitst.

  5. al ingegaan

    ProcessXmlCompressed en het template-veld bij gebruikers verdwenen

    Gebruik ProcessXmlString of ProcessXmlDocument met HTTP-compressie, en templatecompanyaccess in plaats van template.

  6. al ingegaan

    API-voorwaarden: certificering verplicht voor elke koppeling

    Elke koppeling moet gecertificeerd zijn, binnen een doorlopend API-abonnement van de gebruiker. Een ongecertificeerde ClientId werkt met 5% van de credits.

Basecone: inkoopfacturen naar Twinfield

Basecone is de inkoopfactuurverwerking van Wolters Kluwer en boekt rechtstreeks in Twinfield. Een eigen Basecone-pagina is er niet: wat je met Basecone kunt koppelen, staat hier.

  • Facturen en bonnen komen binnen via e-mail, upload of de Basecone-app, worden herkend en goedgekeurd, en daarna in Twinfield geboekt.
  • Elke administratie heeft een eigen Basecone-mailadres. Zo levert een portaal, scanner of mailflow stukken aan zonder API, tot 15 MB en 25 pagina’s per mail.
  • Bij het boeken zet Basecone een link naar het document in vrij tekstveld 3 van de boeking in Twinfield. Een koppeling die boekingen uit Twinfield leest, heeft zo ook de factuur.
  • De Basecone API (REST, JSON) importeert documenten, leest boekingen per administratie en stuurt webhooks bij nieuwe documenten en geboekte voorstellen. Boekingsvoorstellen en goedkeuren via de API zijn alleen voor Premium-apps.
  • Inloggen op de API gaat met een Client ID en een API-sleutel per gebruiker, of met een bearer token. OAuth gebruikt Basecone alleen voor zijn eigen verbinding met Twinfield.
  • Sinds eind oktober 2026 geeft Basecone tijdelijk geen nieuwe API Client ID’s uit, terwijl het werkt aan een kader voor nieuwe API-aansluitingen. Een nieuwe koppeling loopt nu via het mailadres van de administratie, of via een Client ID die je al hebt.

App, iPaaS of maatwerk?

Niet elke koppeling hoeft maatwerk te zijn. Zo kies je de route die past.

Kant-en-klare koppeling van een softwarepartij

Past als: Veel pakketten, van urentools tot kassa’s, bieden zelf een Twinfield-koppeling aan. Past die precies op je proces, dan is dat de snelste route.

Grens: Je volgt de logica van die partij. Deelrefunds, meerdere betaalproviders, een holding met veel administraties of je eigen grootboekindeling vallen vaak buiten de standaard.

Zapier, Make of n8n

Past als: Voor een losse stap, zoals een melding als er een nieuwe debiteur bijkomt.

Grens: Elke call kost credits binnen dezelfde limieten, en SOAP/XML waarbij je per organisatie eerst het cluster opzoekt, past slecht in losse stappen. Dubbele boekingen en geweigerde regels vang je zelf af.

Maatwerk op de Twinfield API

Past als: Als er verkopen, betalingen en btw doorheen gaan, als je een holding of veel administraties hebt, of als je Twinfield inbouwt in je eigen product of kantoorportaal.

Grens: Een hogere eenmalige investering, en de koppeling moet gecertificeerd worden op jouw ClientId, met een Twinfield API-abonnement op jouw naam. Ik bereid dat met je voor; de certificering is van jou.

Standaard-app, iPaaS of maatwerk voor Twinfield?

Bestaat er al een app in de marktplaats die precies doet wat je met Twinfield wilt?

Zo pak ik het aan

Vier stappen, met een vaste prijs vooraf. Een basisopzet begint vanaf €4.000.

  1. 1

    Dag 1

    Intake

    Een kort gesprek over je systemen, je proces en wat er misgaat. Ik vul samen met jou de sync-tabel in: welk object, welke richting, wie de bron is en hoe vaak.

  2. 2

    Binnen een paar dagen

    Vaste offerte

    Je krijgt een voorstel met scope, vaste prijs en planning. Geen uurtje-factuurtje: je weet vooraf wat het kost en wat je krijgt.

  3. 3

    Week 1-2

    Bouwen en testen

    Ik bouw de koppeling op jouw eigen account en test met echte voorbeelden, inclusief de randgevallen: creditnota's, dubbele records, een API die even niet antwoordt. Een eerste koppeling staat binnen 2 weken live.

  4. 4

    Daarna

    Live en beheer

    De koppeling gaat live met monitoring en een foutenlijst die je kunt inzien. Je krijgt documentatie en een overdracht. Onderhoud kan, maar hoeft niet bij mij.

Veilig, en van jou

Hoe ik met je toegang omga, en waarom de koppeling op jouw account draait.

Ik vraag nooit om je Twinfield-wachtwoord.

  • Je geeft toestemming via OAuth, op het inlogscherm van Twinfield zelf. De koppeling krijgt tokens, geen wachtwoord.
  • De koppeling ziet alleen de administraties waar de gebruiker die toestemming gaf bij kan. Een aparte koppelgebruiker met alleen de nodige rechten houdt dat overzichtelijk.
  • Intrekken kan altijd: schakel de koppelgebruiker uit of vergrendel hem, en het refresh token werkt niet meer.
  • Tokens staan versleuteld, in jouw omgeving of op een Europese server. Data gaat rechtstreeks tussen jouw systeem en Twinfield.

Wie beheert de koppeling

De koppeling draait op jouw account, niet op dat van mij. Ik bouw, documenteer en onderhoud hem; jij houdt het eigendom en de toegang.

Account
De koppeling draait op een ClientId die jij op het Twinfield-developerportaal registreert, met toestemming van een gebruiker in jouw Twinfield-organisatie. Wolters Kluwer verplicht certificering van elke koppeling, als onderdeel van een doorlopend Twinfield API-abonnement dat de gebruiker afsluit. Dat abonnement en die certificering staan op jouw naam; ik bouw op jouw gecertificeerde toegang.
Sleutels
Client ID, client secret en tokens staan in jouw omgeving. Je beheert de ClientId in je eigen account op het developerportaal, en een beheerder in Twinfield kan de koppelgebruiker op elk moment uitschakelen.
Goedkeuring door de leverancier
Bouw je een product voor je eigen klanten, zoals een app voor accountantskantoren? Dan registreer en certificeer je je eigen ClientId. Tot de certificering rond is, draait die ClientId op 5% van de credits. Ik bouw binnen de fair-use-regels van Twinfield en documenteer de koppeling, zodat je de aanvraag goed voorbereid indient.
  • Jouw account en jouw app-registratie bij de leverancier. Ik verkoop geen eigen koppel-abonnement en zit er niet tussen.
  • Jij bent eigenaar van de code en de documentatie. Stop je met mij, dan kan een andere ontwikkelaar verder.
  • Bouw je zelf een product voor jouw klanten? Dan draait het op jouw toegang en, waar de leverancier dat vraagt, op jouw certificering.

Onderhoud en monitoring

Een koppeling is pas af als je merkt dat er iets misgaat voordat je klant het merkt.

Foutenlijst met herkansing
Wat niet lukt, verdwijnt niet. Het komt in een wachtrij met de reden erbij en wordt opnieuw geprobeerd, met steeds langere tussenpozen.
Geen dubbele of gemiste records
Elke boeking krijgt een vaste sleutel, zodat een herhaalde poging nooit een tweede factuur of order maakt.
Alarm bij stilte
Komt er een tijd geen data binnen terwijl dat wel zou moeten, dan krijg je een melding. Een stilgevallen koppeling merk je zo voordat je klant belt.
Logboek
Per record zie je wanneer het ging, wat er ging en wat het andere systeem antwoordde. Handig voor je boekhouder en voor jezelf.
Zuinig met credits
Elke call kost credits, en een nieuwe ClientId heeft er maar 5% van. Ik bundel schrijfacties, lees alleen de kolommen die nodig zijn en wacht bij een 429 de Retry-After af.
Cluster en tokens
De koppeling haalt per organisatie het cluster op en ververst tokens zelf. Wordt de koppelgebruiker uitgeschakeld of verloopt zijn wachtwoord, dan krijg je een melding om opnieuw toestemming te geven.
Verwijderingen bijhouden
Verwijderde boekingen haal ik op via de Deleted Transactions-service, zodat ze ook uit je CRM of dashboard verdwijnen.
Breaking changes volgen
Twinfield kondigt wijzigingen aan met een deprecated-, sunset- en end-of-life-datum. Ik volg die lijst en pas de koppeling aan voordat een datum valt.

Verder lezen

Mijn gidsen en artikelen die dieper ingaan op Twinfield.

PrestaShop en Twinfield laten koppelen: ik leg kosten, routes en proeforder uit
Gids
Uitgebreide gids16 min

4 aug 09:00

PrestaShop en Twinfield laten koppelen: ik leg kosten, routes en proeforder uit

PrestaShop aan Twinfield koppelen of laten bouwen? Ik vergelijk vier routes, kosten en accountantrechten en controleer de proeforder en reconciliatie.

PrestaShop naar Twinfield: deelrefunds, deelbetalingen en uitzonderingen
Gids
Uitgebreide gids19 min

26 sep 17:00

PrestaShop naar Twinfield: deelrefunds, deelbetalingen en uitzonderingen

Een deelrefund in PrestaShop raakt orderregel, creditnota, btw, betaling en Twinfield-match tegelijk. Bouw een controleerbare keten met idempotente retries, menselijke vrijgave en een uitzonderingsqueue.

Twee PSP’s koppelen aan één ERP: van routing tot menselijke vrijgave
Gids
Uitgebreide gids18 min

15 okt 09:00

Twee PSP’s koppelen aan één ERP: van routing tot menselijke vrijgave

Twee PSP’s koppelen aan één ERP vraagt meer dan twee API’s. Bouw één canoniek transactiedossier voor routing, provider-ID’s, payouts, fees, refunds en chargebacks, met beperkte ERP-writes en menselijke vrijgave voor uitzonderingen.

PSP-fees reconciliëren: van rate card naar herstelboeking
Gids
Uitgebreide gids20 min

12 okt 17:00

PSP-fees reconciliëren: van rate card naar herstelboeking

Controleer PSP-fees per payment-ID tegen je contractuele rate card en settlement. Verklaar drift, claim te veel betaalde kosten en geef een herstelboeking pas vrij na bewijs en read-back.

POS-kassasysteem koppelen aan je boekhouding: dagelijkse sluiting
Gids
Uitgebreide gids18 min

15 okt 17:00

POS-kassasysteem koppelen aan je boekhouding: dagelijkse sluiting

Sluit je fysieke POS elke dag gecontroleerd af met Z-rapport, openingskas, pin, contant, refunds, cash drops en kasverschillen. Met een concreet boekingsmodel, uitzonderingsqueue en rekenvoorbeeld voor SumUp en Moneybird.

Advocatenkantoor: van dossier en gewerkte uren naar een declaratie zonder overtypen
Gids
Uitgebreide gids13 min

3 sep 17:00

Advocatenkantoor: van dossier en gewerkte uren naar een declaratie zonder overtypen

Hoe een klein tot middelgroot advocatenkantoor zijn declaratiestroom inricht: tariefsoort op het dossier, uren op het moment zelf, een omschrijving die niets prijsgeeft, en een factuur die in je boekhouding ontstaat.

Andere koppelingen

Werk je met meer tools? Combineer Twinfield met je andere systemen en zie hoe er één workflow van ontstaat.

FAQ

Veelgestelde vragen over de Twinfield-koppeling

Antwoorden op wat het vaakst gevraagd wordt over Twinfield koppelen.

Klaar om Twinfield te koppelen?

Vertel me welke systemen je gebruikt en wat er nu misgaat. Ik denk mee en zeg eerlijk wat er kan, vrijblijvend.

Bekijk alle integraties

Liever eerst zelf kijken waar de winst zit? Doe de gratis automatiseringsscan