Naar inhoud
Beschikbaar

Koppel je eigen software aan TRONVoice

Met de TRONVoice API maak je klanten, facturen, offertes en abonnementen aan vanuit je webshop, CRM of eigen app.

De API is een REST-API met JSON. Je maakt in TRONVoice een API-sleutel aan, kiest wat die sleutel mag, en je ontwikkelaar kan aan de slag. Facturen versturen, PDF's downloaden en creditfacturen maken werkt via de API net zoals in de app. De interactieve documentatie staat open voor iedereen, ook zonder account.

  • Klanten, facturen, offertes en abonnementen
  • Per sleutel bepaal je wat hij mag
  • Documentatie waarin je direct verzoeken uitprobeert

Wat is de TRONVoice API? Een REST-API waarmee je webshop, CRM of eigen software klanten, facturen, offertes en abonnementen aanmaakt in TRONVoice. Elke API-sleutel hoort bij één administratie en krijgt alleen de rechten die je aanvinkt. De documentatie op app.tronvoice.eu/api/docs is openbaar, ook zonder account.

Wat je ermee doet

Klanten, facturen, offertes en abonnementen: alles om te factureren

De API werkt op dezelfde gegevens als de app. Wat je via de API aanmaakt, zie je meteen in TRONVoice terug.

Klanten

Je klantenbestand. De API controleert je invoer: KvK-nummer van 8 cijfers, btw-nummerformaat en postcode.

  • Aanmaken, opvragen en bijwerken
  • Verwijderen
  • Zoeken op naam, e-mail, KvK-nummer of klantnummer

Facturen

Maak conceptfacturen met regels. Btw, korting en totalen rekent TRONVoice zelf uit, precies zoals in de app.

  • Aanmaken, opvragen en bijwerken (concept)
  • Versturen per e-mail
  • Creditfactuur maken en PDF downloaden

Offertes

Offertes opstellen en naar je klant sturen, inclusief de link waarmee de klant de offerte accepteert.

  • Aanmaken, opvragen en bijwerken
  • Versturen met accepteer-link
  • PDF downloaden

Abonnementen

Beheer terugkerende facturatie. TRONVoice maakt de factuur automatisch aan op de volgende factuurdatum. Via de API kun je ook zelf een factuur uit een actief abonnement laten genereren.

  • Aanmaken, opvragen en bijwerken
  • Verwijderen
  • Factuur genereren uit een abonnement

Zo werkt het

In vier stappen een eigen koppeling

Jij maakt de sleutel aan en bepaalt wat hij mag. Je ontwikkelaar doet de rest.

1

Maak een API-sleutel aan

Ga in TRONVoice naar Instellingen en dan API-sleutels. Geef de sleutel een naam en kies de administratie waar hij bij hoort.

2

Kies wat de sleutel mag

Per sleutel kies je lezen of schrijven voor klanten, facturen, offertes en abonnementen, of volledige toegang. Lezen en schrijven zijn aparte rechten, dus vink beide aan als je koppeling ook moet opzoeken. Stel eventueel een vervaldatum in.

3

Bouw je koppeling

Stuur de sleutel mee als Bearer-token in de Authorization-header. Je krijgt JSON terug met Nederlandse veldnamen.

4

Houd het overzicht

In de lijst zie je per sleutel wanneer en vanaf welk IP-adres hij voor het laatst is gebruikt. Intrekken kan altijd, met directe werking.

Zo ziet een verzoek eruit

Eén header met je sleutel en je haalt je klanten op. Zo begint elke koppeling.

# Klanten ophalen
curl https://app.tronvoice.eu/api/v1/clients
  -H "Authorization: Bearer jouw-sleutel"
  -H "Accept: application/json"
# Antwoord (ingekort)
{
  "data": [
    {
      "id": "9d2f6c1e-3b4a-4f8e-9c2d-1a2b3c4d5e6f",
      "bedrijfsnaam": "Acme B.V.",
      "kvk_nummer": "12345678",
      "email": "facturen@acme.nl",
      "updated_at": "2026-09-11T09:41:00+02:00"
    }
  ],
  "meta": { "current_page": 1, "per_page": 25, "total": 1 }
}

Lijsten zijn gepagineerd (standaard 25 per pagina, maximaal 100) en ondersteunen filter, sort en include. Veldnamen zijn Nederlands, net als in de app.

Veilig en afgebakend

Jij bepaalt wat een koppeling mag zien en doen

Een API-sleutel geeft een extern systeem toegang tot je administratie. Daarom is elke sleutel zo strak mogelijk afgebakend: één administratie, alleen de rechten die je aanvinkt, en op elk moment in te trekken.

  • Eén sleutel, één administratie

    Elke sleutel is gekoppeld aan precies één administratie. Gegevens van andere administraties zijn voor die sleutel onzichtbaar, ook als ze in dezelfde organisatie zitten.

  • Alleen de eigenaar maakt sleutels

    Alleen de eigenaar van je organisatie kan sleutels aanmaken en intrekken. Elke keer dat een sleutel wordt aangemaakt of ingetrokken, wordt dat gelogd.

  • Je ziet de sleutel maar één keer

    TRONVoice bewaart alleen een hash van de sleutel. De sleutel zelf zie je alleen bij het aanmaken. Kwijt? Trek hem in en maak een nieuwe.

  • Vervaldatum en intrekken

    Geef een sleutel een vervaldatum, of laat hem doorlopen. Een ingetrokken of verlopen sleutel wordt bij het eerstvolgende verzoek geweigerd.

  • Limiet op het aantal verzoeken

    Standaard mag een sleutel 120 verzoeken per minuut en 20.000 per dag doen. Daarnaast geldt een limiet per IP-adres. Kom je erboven, dan krijg je een 429 met een Retry-After-header.

Voorbeelden

Wat je met de API bouwt

Overal waar je nu gegevens overtypt tussen twee systemen, kan een koppeling het werk overnemen.

  • Webshop-bestellingen automatisch factureren

    Maak bij elke bestelling de klant aan (of zoek hem op), maak de factuur met de bestelregels en verstuur hem direct per e-mail. Zonder overtypen.

  • Klanten in sync met je CRM

    Houd je klantgegevens op één plek. Nieuwe of gewijzigde relaties in je CRM zet je via de API door naar TRONVoice, en andersom.

  • Je eigen dashboard

    Haal verzonden, betaalde en vervallen facturen op, met of zonder regels, en toon ze in je eigen rapportage of managementoverzicht.

  • Doorzetten naar je boekhouding

    Haal met filter[updated_since] alleen de facturen op die sinds je vorige run zijn gewijzigd en verwerk ze in je boekhoudpakket.

Documentatie

Lees de documentatie en probeer het uit

Elk endpoint staat beschreven met parameters, velden en foutcodes. Plak je sleutel in de documentatie en voer verzoeken direct uit vanuit je browser. De OpenAPI-specificatie kun je downloaden om een client te genereren in de taal van je keuze.

Opent in een nieuw tabblad op app.tronvoice.eu. Geen account nodig om te lezen.

Factureren vanuit je eigen systemen

Veel ondernemers werken met een webshop, een CRM of eigen software naast hun facturatie. Elke bestelling of opdracht betekent dan opnieuw overtypen. Met de TRONVoice API laat je die systemen rechtstreeks met TRONVoice praten: klanten en facturen ontstaan automatisch, en je verstuurt ze vanuit je eigen proces. Alles wat de API aanmaakt zie je gewoon in de app terug, inclusief factuurnummers, btw en totalen.

Dezelfde regels als in de app

De API gebruikt dezelfde berekeningen en controles als TRONVoice zelf. Btw wordt per factuurregel berekend, inclusief btw verlegd en vrijgesteld. Een factuur die je via de API verstuurt, krijgt zijn definitieve factuurnummer op het moment van versturen, net als in de app. Bewerken en verwijderen kan alleen zolang een factuur nog concept is. Zo blijft je administratie kloppen, ook als een koppeling iets doet wat je niet had voorzien.

Gebouwd voor ontwikkelaars

De API is een REST-API onder /api/v1 met JSON in en uit. Je authenticeert met een Bearer-token, lijsten zijn gepagineerd en ondersteunen filter, sort en include. Met filter[updated_since] haal je alleen op wat sinds je vorige run is gewijzigd, handig voor een periodieke sync. Fouten komen altijd terug als JSON met een duidelijke melding, en bij validatiefouten zie je per veld wat er mis is. Met GET /api/v1/me controleer je welke administratie en rechten bij een sleutel horen.

Combineer met andere koppelingen

Een factuur die je via de API verstuurt, gaat via dezelfde verzendroute als een factuur uit de app. Combineer dat met de Mollie integratie, zodat je klant direct via iDEAL | Wero betaalt, en met de Ponto bankkoppeling, zodat overboekingen automatisch worden gematcht. Je eigen koppeling levert de facturen aan, TRONVoice regelt de rest.

Bekijk ook onze andere facturatie features zoals abonnementen, offertes en de e-facturatie met UBL.

Veelgestelde vragen

Alleen de eigenaar van je organisatie. Je vindt het scherm in TRONVoice onder Instellingen, API-sleutels. Daar maak je sleutels aan, zie je wanneer ze voor het laatst zijn gebruikt en trek je ze in.

Nee. Elke sleutel hoort bij precies één administratie. Heb je meerdere administraties, dan maak je per administratie een eigen sleutel. Zo weet je altijd zeker in welke administratie een koppeling werkt.

Versturen via de API werkt precies zoals in de app: voor een verstuurde factuur of offerte wordt een credit gebruikt, een creditfactuur versturen is gratis. Om een factuur te versturen moet er een IBAN in je administratie staan. Aanmaken en opvragen kost geen credits.

Op dit moment niet. Wil je wijzigingen bijhouden, dan haal je ze periodiek op met filter[updated_since] op klanten, facturen, offertes of abonnementen. Je krijgt dan alleen de records terug die sinds dat moment zijn gewijzigd.

Nee. Een sleutel werkt altijd op de echte gegevens van de gekoppelde administratie. Begin daarom met een sleutel die alleen mag lezen en maak daarna een nieuwe sleutel met meer rechten aan zodra je koppeling werkt (de rechten van een bestaande sleutel kun je niet aanpassen).

Op app.tronvoice.eu/api/docs. Daar staat elk endpoint beschreven en kun je met je eigen sleutel verzoeken uitproberen. De OpenAPI-specificatie kun je daar ook downloaden, handig als je een client wilt genereren.

Bouw je eigen koppeling

Maak een account, genereer een API-sleutel en laat je systemen samenwerken.