Overzicht
Twinfield is een cloudgebaseerd boekhoudplatform dat breed wordt gebruikt door mid-market bedrijven, accountantskantoren en multi-entiteitsorganisaties in Nederland en heel Europa. Onderdeel van de Wolters Kluwer-groep biedt Twinfield grootboekboekhouding, debiteuren, crediteuren, vaste activa, projectboekhouding en de rapportage-infrastructuur die professionele financiële administratie vereist. Voor organisaties die Twinfield gebruiken als hun financieel systeem van record is integratie tussen Twinfield en de omringende operationele systemen een veelvoorkomende en vaak bedrijfskritische vereiste.
Twinfield's integratie-interface verschilt van het REST API-model gebruikt door modernere boekhoudplatforms. Twinfield gebruikt een SOAP-gebaseerde XML API, samen met een recentere OAuth 2.0 authenticatielaag. De API biedt toegang tot Twinfield's kern boekhoudingsobjecten — transacties, klanten (debiteuren), leveranciers (crediteuren), rekeningen, kostenplaatsen en dimensies.
Wij bouwen Twinfield-integraties voor Nederlandse en Europese bedrijven, accountantskantoren en softwareplatforms die hun operationele systemen moeten verbinden met de financiële administratie van Twinfield.
Wat Twinfield Integratie Dekt
OAuth 2.0 authenticatie. Twinfield's huidige authenticatiemodel gebruikt OAuth 2.0 via het Wolters Kluwer-identiteitsplatform.
OAuth applicatieregistratie: de Twinfield-applicatie geregistreerd in het Twinfield-ontwikkelaarsportaal — de client-ID en clientgeheim.
Autorisatiecodestroom: de OAuth 2.0-autorisatiecodestroom voor gebruikersgerichte integraties. De autorisatieCodeUitwisseling voor toegangstoken en vernieuwingstoken via POST https://login.twinfield.com/auth/authentication/connect/token.
Client credentials stroom: voor server-naar-server integraties waarbij geen gebruikersinteractie vereist is.
Tokenbeheer: Twinfield-toegangstokens verlopen na een gedefinieerde periode. De vernieuwingstoken gebruikt om een nieuw toegangstoken te verkrijgen voor vervaldatum.
Clusterbepaling: Twinfield organiseert accounts over clusters. Na authenticatie moet de integratie bepalen welk cluster het doelbedrijf host. De clusterspecifieke basis-URL (https://{cluster}.twinfield.com/) gebruikt voor alle volgende API-aanroepen.
SOAP XML API-structuur. Twinfield's API gebruikt SOAP-gebaseerde XML-communicatie in plaats van REST JSON.
SOAP eindpunt: de Twinfield ProcessXml-service op https://{cluster}.twinfield.com/webservices/processxml.asmx. De SOAP-envelop-structuur die elk Twinfield API-verzoek omhult — de <soapenv:Envelope> met de <soapenv:Header> en de <soapenv:Body>.
Header-authenticatie: het <Header> element in het Twinfield SOAP-verzoek dat het toegangstoken en de bedrijfscode bevat — <AccessToken> en <CompanyCode>.
ProcessXml operatie: de primaire Twinfield SOAP-operatie — <ProcessXmlString> die een Twinfield XML-document accepteert en een XML-respons retourneert.
Respons parseren: de SOAP XML-respons die Twinfield retourneert — de XML-payload binnen het <ProcessXmlStringResult> element.
Transactieboekingen. De kern Twinfield integratieoperation — journaalposten en boekhoudkundige transacties boeken naar het Twinfield grootboek.
Transactie XML-structuur: de Twinfield transactie XML die een journaalpost definieert. Het <transaction> element met de <header> en de <lines> verzameling. De header met <code> (de journaalcode — VRK voor verkoop, INK voor inkoop, MEM voor memoriale), <date> (de transactiedatum in YYYYMMDD formaat), <period> (de boekhoudperiode in YYYY/PP formaat), <currency>.
Transactieregel structuur: elke <line> met <type> (detail, vat, total), <dim1> (de primaire dimensie — de grootboekrekening), <dim2> (de secundaire dimensie — de debiteur- of crediteurcode), <debit> of <credit>, <vatcode> en <description>.
Verkoopfactuur boeken: de Twinfield VRK-transactie die een verkoopfactuur registreert. De debiteurrekening in dim1 van de totaalregel, de omzetrekeningen in dim1 van de detailregels en de BTW-regels.
Inkoopfactuur boeken: de Twinfield INK-transactie voor leveranciersfacturen. De crediteurcode in dim2 van de totaalregel, de kostenrekeningen in dim1 van de detailregels.
Grootboekposten: de MEM-transactie voor aanpassingen, overlopende posten en andere grootboekposten.
Kostenplaatsallocatie: het <dim3> element in transactieregels voor kostenplaatsallocatie — de kostenplaatscode die het transactiebedrag koppelt aan een specifieke kostenplaats of project.
Stamdata toegang. Twinfield's stamdata lezen — rekeningcodes, dimensies, kostenplaatsen, BTW-codes.
Read XML operaties: het <read> XML-operatietype in Twinfield voor het ophalen van stamdata.
Grootboekrekeningen: het rekeningschema lezen van Twinfield — de dimensiedata voor BAS (balans) en PNL (winst en verlies) rekeningtypen.
Debiteur (klant) data: het DEB dimensietype voor Twinfield-debiteuren — de klantcode, naam, adres, kredietlimiet en betalingstermijnen.
Crediteur (leverancier) data: het CRE dimensietype voor Twinfield-crediteuren — de leverancierscode, naam, adres en bankrekening.
Kostenplaatsen: het KPL dimensietype voor Twinfield-kostenplaatsen en -projecten.
BTW-codes: Twinfield's geconfigureerde BTW-codes en hun percentages lezen — de BTW-codemapping die zorgt dat de integratie de correcte Twinfield BTW-codes gebruikt.
Query XML operaties. Twinfield-data zoeken en filteren met de browse/query interface.
Browse data: de Twinfield browse-functionaliteit voor het bevragen van transactiegeschiedenis en stamdata met filters.
Transactiegeschiedenis: geposte transacties bevragen vanuit Twinfield voor reconciliatie, rapportage en auditdoeleinden.
Open posten: open posten bevragen — onbetaalde facturen en onopgeloste transacties.
Bedrijfs- en kantoorstructuur. Twinfield's multi-bedrijfsorganisatiemodel.
Bedrijfscodes: elke Twinfield-administratie heeft een bedrijfscode die alle operaties scopeert. Multi-bedrijfsintegraties die opereren over meerdere Twinfield-administraties.
Periode en jaarbeheer. Twinfield's boekhoudperiode structuur.
Periodenotatie: Twinfield gebruikt YYYY/PP periodenotatie — 2024/01 voor januari 2024. De periodeberekening die een transactiedatum omzet naar de correcte Twinfield periodenotatie.
Open en gesloten perioden: Twinfield-perioden kunnen open of gesloten zijn — boeken naar een gesloten periode retourneert een fout. De periodestatus controle die verifieert dat de doelperiode open is voor het indienen van transacties.
Foutafhandeling. Twinfield's XML-foutreacties en de afhandeling die ze vereisen.
Foutrespons structuur: Twinfield retourneert fouten binnen de XML-respons — het <messages> element met <message> elementen die foutcodes en beschrijvingen bevatten.
Validatiefouten: de vooraf-boeking validatie die Twinfield uitvoert — vereiste velden, geldige dimensiecodes, gebalanceerde transacties, open perioden.
Herproberenlogica: de fouttypen die herproberen rechtvaardigen (voorbijgaande serverfouten) versus die applicatieniveau-afhandeling vereisen.
Integratiepatronen
Operationeel systeem naar Twinfield. Het meest voorkomende Twinfield-integratiepatroon — transacties gegenereerd in een operationeel systeem geboekt naar Twinfield voor financiële administratie.
Twinfield naar rapportage-infrastructuur. Twinfield-financiële data lezen voor managementrapportage, consolidatie en analytics.
Debiteur en crediteur synchronisatie. Klant- en leveranciersstamdata consistent houden tussen Twinfield en CRM, ERP of e-commercesystemen.
Accountantskantoor platform integratie. Accountantskantoren die Twinfield gebruiken voor klantadministraties die hun praktijkbeheer- en klantcommunicatietools verbinden met Twinfield.
Gebruikte Technologieën
- C# / ASP.NET Core — primaire Twinfield integratie implementatie .NET's
System.ServiceModelgebruikend voor SOAP-communicatie - Python — Twinfield-integratie voor Python-gebaseerde datapijplijnen
zeepof directe HTTP voor SOAP-verzoeken gebruikend - TypeScript / Node.js — Twinfield-integratie
soapnpm-pakket of directe HTTP XML-constructie gebruikend - Rust / Axum — Twinfield-integratie voor hoge-prestatie dataverwerkingspijplijnen
- SOAP / XML — Twinfield ProcessXml API-communicatie
- OAuth 2.0 — Twinfield authenticatie via het Wolters Kluwer-identiteitsplatform
- SQL (PostgreSQL / MySQL) — synchronisatiestatus, transactiemapping, dimensiecodecache, foutlog
- Redis — toegangstoken caching, synchronisatietaakcoördinatie, herproberen status
- Hangfire / geplande taken — geplande transactieBoekingen, periodieke reconciliatie, stamdata synchronisatie
- Docker — gecontaineriseerde integratiedienst implementatie
- GitHub Actions — CI/CD pijplijn voor integratiedienst implementatie
Twinfield in het Nederlandse Boekhoudecosysteem
Twinfield bezet een specifieke positie in de Nederlandse en Europese boekhoudsoftwaremarkt — het cloudBoekhoudplatform voorkeur voor mid-market bedrijven en accountantskantoren die meer capaciteit vereisen dan eenvoudige boekhoudtools bieden.
Voor bedrijven en accountantskantoren die Twinfield hebben gestandaardiseerd is de integratievereiste bijna universeel — de operationele data die door het bedrijf stroomt moet automatisch in Twinfield's financiële administratie verschijnen in plaats van via handmatige herinvoer. De SOAP XML API is, hoewel minder ontwikkelaarsvriendelijk dan moderne REST API's, volwassen en stabiel.
Twinfield Verbonden met Uw Financiële Operaties
Twinfield-integraties gebouwd op productiestandaarden — correct OAuth 2.0 tokenbeheer met clusterbepaling, robuuste SOAP XML-constructie en respons parseren, transactie XML die correct mapt naar Twinfield's journaalstructuur, dimensiecodefvalidatie voor boekingen, periodestatus controle die gesloten-periode fouten voorkomt en de monitoring die boekingsfouten oppervlakt voor ze financiële reconciliatiegaten veroorzaken.