Veel van onze opdrachtgevers leveren vorderingen al gestructureerd aan: via de Moneybird-koppeling of als CSV-export uit het eigen systeem. Die CSV werkt prima, maar blijft een handmatige handeling. Iemand moet exporteren, controleren en versturen. De incasso API haalt die laatste stap weg: uw eigen software, CRM of facturatiesysteem draagt een vordering rechtstreeks over, op het moment dat uw systeem dat bepaalt. Eén bericht en de vordering staat als dossier bij ons klaar. De documentatie is openbaar en de testomgeving is gratis.
Eén koppeling, van factuur tot dossier
Eén verzoek maakt direct een dossier aan, inclusief debiteur, facturen en PDF-bijlagen. U krijgt meteen het dossiernummer terug, samen met eventuele waarschuwingen uit onze controles. U hoeft niets over te typen en niets na te sturen.
Bedragen geeft u op in eurocenten: €1.250,00 is 125000. Dat voorkomt afrondingsfouten, dezelfde keuze die betaalproviders als Stripe en Mollie maken.
De API is één van de vijf manieren om een zaak in te dienen en draait op dezelfde techniek als onze Moneybird-koppeling. Die koppeling draagt al langer automatisch facturen over, dus de onderliggende techniek heeft zich in de praktijk bewezen. De volledige handleiding staat op nl.legal/api, met een interactieve naslag op nl.legal/api/reference en een machine-leesbare OpenAPI 3.1-specificatie die u direct in Postman of uw codegenerator laadt.
Voor wie de API bedoeld is
De koppeling is gebouwd voor ondernemingen die structureel met onbetaalde facturen te maken hebben en het overdragen willen automatiseren:
- Webshops die een vordering automatisch willen overdragen zodra de betaaltermijn verstrijkt
- Hosting- en SaaS-bedrijven met abonnementen en terugkerende facturen
- Vastgoed- en verhuurpartijen die huurachterstanden gestructureerd willen aanpakken
- Softwarebedrijven die debiteurenbeheer voor hun eigen klanten inbouwen
De API is niet voor iedereen de beste route. Heeft u af en toe één onbetaalde factuur, dan is het webformulier op zaak indienen of een mail naar opdrachten@nl.legal sneller. Gebruikt u Moneybird, dan is de bestaande koppeling kant-en-klaar. En voor een periodieke batch uit het boekhoudpakket blijft een CSV-upload prima werken. De API is er voor wie zelf wil bepalen hoe en wanneer een vordering wordt overgedragen, rechtstreeks vanuit het eigen systeem.
Drie controles voordat een dossier ontstaat
De API neemt niet klakkeloos aan wat u instuurt. Bij elke opdracht draaien automatisch deze controles:
| Controle | Wat er gebeurt |
|---|---|
| AI-factuurcontrole | Meegestuurde PDF's worden gelezen en vergeleken met uw opgave en met elkaar. Wijkt een totaalbedrag, adres, factuurnummer of btw-nummer af, dan krijgt u een waarschuwing terug. |
| WIK-aanmaning bij consumenten | Bij een incasso tegen een particulier controleert de API of de wettelijk verplichte 14-dagenbrief is meegestuurd. Ontbreekt die, dan wordt de opdracht geweigerd met een duidelijke uitleg. |
| Samenvoeging bij lopend dossier | Een vervolgfactuur voor een debiteur met een openstaand dossier wordt aan dat dossier toegevoegd in plaats van als nieuw dossier geopend, zoals de Wet Incassokosten dat vraagt. |
Die tweede controle verdient toelichting. De wet verbindt incassokosten bij consumenten aan een voorafgaande aanmaning met een termijn van veertien dagen, geregeld in artikel 6:96 BW. Start u een consumentenincasso zonder die 14-dagenbrief, dan klopt uw kostenvordering juridisch niet. De API houdt u dan tegen voordat het mis kan gaan. Heeft u de aanmaning nog niet verstuurd? Dien de opdracht dan in als pre-incasso, dan versturen wij hem.
Uw opgave blijft leidend
De AI-controle is een hulpmiddel, geen vervanging van uw eigen administratie. Een waarschuwing betekent niet dat wij uw opdracht aanpassen; u bepaalt zelf wat u ermee doet. En andersom geldt het ook: dat er geen waarschuwing komt, is geen garantie dat elk verschil is gevonden.
Volgen en bijsturen zonder te bellen
Na het indienen hoeft u de status niet steeds op te vragen. Zodra er iets gebeurt op een dossier, sturen wij een webhook naar uw eigen endpoint. Dat gebeurt onder meer bij:
- een betaling die op het dossier wordt geboekt
- correspondentie die naar de debiteur is verstuurd
- een wijziging op het dossier of een factuur
- de sluiting van het dossier
De berichten zijn ondertekend, zodat uw systeem de echtheid kan controleren. Wilt u toch zelf opvragen, dan geeft de API per opdracht de actuele dossierstatus en het openstaande saldo terug, inclusief rente en kosten.
Bijsturen kan ook. U vraagt via de API een pauze aan, laat een dossier intrekken of meldt dat de debiteur rechtstreeks aan u heeft betaald. Elke melding komt als taak met instructies bij de behandelaar terecht; de API wijzigt zelf niets aan het dossier. Zo blijft een mens verantwoordelijk voor elke beslissing op het dossier en wordt een intrekking netjes verrekend met de no-cure-no-pay-afspraak.
In drie stappen live
- 1 Test-key aanvragen: u ontvangt eerst een test-key en na akkoord een live-key. De key is gekoppeld aan uw bedrijf, dus u stuurt nooit een opdrachtgever mee.
- 2 Verbinding testen: met één aanroep van het ping-endpoint ziet uw ontwikkelaar direct of de koppeling werkt.
- 3 Opdracht indienen: stuur het type (pre-incasso of incasso), de debiteur, de facturen en eventueel de PDF's mee. U krijgt het dossiernummer direct terug.
Met een test-key doorloopt u de volledige integratie, inclusief alle validaties en de AI-controle, zonder dat er ooit een echt dossier ontstaat. De respons is identiek aan die van een live-opdracht; alleen het dossiernummer blijft leeg. Codevoorbeelden in PHP en Python staan in de API-documentatie.
Veelgestelde vragen
Voor de API gelden dezelfde afspraken als voor elke andere manier van indienen: no cure no pay. Wordt de vordering geïnd, dan verhalen wij de kosten op de debiteur. De testomgeving is gratis.
Ja. Met een test-key doorloopt u de volledige integratie, inclusief validaties en AI-controle. Er wordt dan geen dossier aangemaakt en er gaat niets naar een debiteur.
Die wordt conform de Wet Incassokosten automatisch aan het bestaande dossier toegevoegd. U herkent dit aan de melding in de respons, zodat uw systeem weet dat er geen nieuw dossier is geopend.
Bij een incasso tegen een consument moet de 14-dagenbrief al verstuurd zijn en stuurt u hem als PDF mee. Heeft u dat nog niet gedaan, dien de zaak dan in als pre-incasso; wij versturen de aanmaning dan voor u.
Conclusie
Een incassobureau met een publieke, gedocumenteerde API is in Nederland geen vanzelfsprekendheid. Voor ons is het een logische stap. Wij zijn een legal-tech-bedrijf: we bouwen onze eigen software, werken veel met en voor developers en houden simpelweg van techniek. REX, onze eigen reverse image search voor fotografen, en de Moneybird-koppeling kwamen uit diezelfde keuken. De API maakt die combinatie van juridisch werk en techniek concreet: van factuur tot dossier in één bericht, met controles die fouten signaleren voordat ze een dossier worden.
Wat er na de koppeling gebeurt, verandert niet. Elke opdracht komt in hetzelfde minnelijke incassotraject terecht als een zaak die via het webformulier binnenkomt, behandeld door een vergunninghoudend incassobureau (Justis-register 00030), met een succespercentage van 87% en een gemiddelde doorlooptijd van 18 dagen.
Klaar om te koppelen?
Vraag een gratis test-key aan en probeer de volledige integratie uit. De handleiding, de interactieve naslag en codevoorbeelden in PHP en Python staan openbaar op nl.legal/api.
API-documentatie bekijkenGepubliceerd op
