Menu

Samenvatting van de Twinfield API

De Twinfield API maakt het mogelijk om vrijwel de volledige boekhoudkundige administratie te automatiseren en te integreren met externe bedrijfssystemen. Via de ProcessXml-service en gespecialiseerde webservices wissel je gestructureerd data uit over transacties, relaties, banken en periodes.
  • Financiële automatisering: Boek verkoop-, inkoop- en memoriaaltransacties automatisch via de ProcessXml-webservice en lees dagboekmutaties terug.
  • Relatiebeheer: Synchroniseer debiteuren, crediteuren en dimensies met je CRM of ERP voor een actueel klant- en leveranciersbestand.
  • Bankintegratie: Importeer bankafschriften en koppel betalingen automatisch via de BankStatement- en Matching-webservices.
  • Verkoopfacturatie: Genereer verkoopfacturen programmatisch en synchroniseer artikelen en prijzen met je webshop of ordersysteem.
  • Periodiek beheer: Beheer boekjaren, periodes en valuta's centraal en automatiseer periodieke afsluitingen.
  • Projecten en uren: Registreer uren, kosten en projecttarieven voor projectgedreven organisaties.
API Quick Facts REST, SOAP
  • Authenticatie OAuth2
  • Methods POST (49)GET (3)
  • Rate limits 1.000 API-credits per minuut per ClientId en per OrganisationId; 500 credits per ClientId en OrganisationId gecombineerd. Maximaal 20 gelijktijdige requests per ClientId, 10 per organisatie.
  • Webhooks Niet beschikbaar
  • Sandbox Beschikbaar
  • Response format XML, JSON
  • SDK's .NET

Laatste ontwikkelingen bij de Twinfield API

Twinfield introduceerde zijn SOAP-webservices al in het begin van de jaren 2000 als onderdeel van een van de eerste cloud-boekhoudplatformen. Lange tijd werd gewerkt met sessie-gebaseerde authenticatie en WSDL-bestanden per service. Wolters Kluwer heeft de API in de loop der jaren gemoderniseerd met OpenID Connect en OAuth 2.0, een cluster-gebaseerde routering voor schaalbaarheid en een aanvullende REST-laag. In 2024 zijn expliciete rate limits en concurrency-limieten geïntroduceerd, en zijn verouderde XML-wortels zoals `general` en `ProcessXmlCompressed` uitgefaseerd. Webhook-ondersteuning ontbreekt nog.

API versies

Rate limiting & concurrency control Major release
1 december 2024

Introductie van harde rate limits (1.000 API-credits per minuut) en concurrency-limieten (20 gelijktijdige requests per ClientId), met 429-responses bij overschrijding.

Root XML element `general` uitgefaseerd
1 maart 2024

Het `general` root-element in XML-requests is afgeschaft. Requests met verschillende entiteiten moeten voortaan worden gesplitst.

OpenID Connect & OAuth 2.0 Major release

Moderne authenticatie via OpenID Connect en OAuth 2.0 met authorization-code- en implicit-flows, cluster-detectie via accesstokenvalidation en refresh tokens met lange levensduur.

SOAP-webservices Major release

Oorspronkelijke lancering van de SOAP-webservices (ProcessXml, Finder, BankStatement, Matching, Declarations, Hierarchies) als basis van de Twinfield-integraties.

Integraties voor Twinfield