- 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.