Factuur via de API: 1 cent verschil met de betaling

Wat er gebeurt

Maak je facturen met je eigen software, bijvoorbeeld een klantportaal of een abonnementensysteem, en stuurt die software de facturen via de jortt API naar jortt? Dan kan het gebeuren dat je klant net 1 cent te weinig betaalt. De factuur in jortt blijft dan openstaan met een restje van € 0,01.

Dat gebeurt als twee dingen samenkomen:

1. Je software stuurt de bedragen exclusief btw naar jortt. Jortt rekent dan zelf de btw en het totaal van de factuur uit, en rondt af op hele centen.
2. Je klant betaalt niet via de betaallink in de factuurmail van jortt, maar via een eigen betaallink, bijvoorbeeld in je klantportaal. Die link rekent het totaal zelf uit.

Rondt je eigen systeem de btw net anders af dan jortt, bijvoorbeeld door af te kappen in plaats van af te ronden, of per regel in plaats van over het totaal, dan verschilt het totaal een cent. Betalingen via de betaallink van jortt kloppen wel: die gebruikt het totaal van de jortt-factuur.

Een rekenvoorbeeld

Koertt verkoopt een abonnement van € 38,95 per maand, exclusief btw. Het klantportaal van Koertt maakt de factuur via de API in jortt aan en stuurt € 38,95 exclusief btw mee.

Jortt rondt de btw van € 8,1795 af op € 8,18. Het portaal kapt hem af op € 8,17. Op de factuur in jortt staat dus € 47,13, maar de klant betaalt via de link in het portaal € 47,12. In jortt blijft € 0,01 openstaan, elke maand opnieuw.

De oplossing: stuur de bedragen inclusief btw

Laat je software de bedragen inclusief btw naar jortt sturen. Jortt neemt het bedrag dan over als totaal en rekent de btw daaruit terug. Het totaal van de factuur is dan precies het bedrag dat je systeem heeft verstuurd. Factuur en betaling komen zo altijd overeen, ook als je klant via je eigen betaallink betaalt.

Zo stel je het in, of vraag je je ontwikkelaar om het in te stellen:

1. Zet bij het aanmaken van de factuur in de API het veld net_amounts op true.
2. Geef bij elke factuurregel in amount_per_unit het bedrag inclusief btw mee. In het voorbeeld is dat € 47,13 of € 47,12, het bedrag dat je portaal ook als betaalbedrag toont.
3. Geef bij elke regel het btw-tarief mee, net als nu.

De naam is verwarrend: net_amounts op true betekent dat de btw al in je bedragen zit. Staat het veld op false of stuur je het niet mee, dan zijn je bedragen exclusief btw en rekent jortt de btw erbovenop. Dat is de situatie waarin het centverschil ontstaat.

In het voorbeeld stuurt het portaal van Koertt dan € 47,12 inclusief btw. Jortt maakt een factuur van € 47,12, met € 38,94 exclusief btw en € 8,18 btw. De klant betaalt € 47,12 en de factuur staat op betaald.

De volledige beschrijving van de velden staat in de documentatie op developer.jortt.nl.

Kun je de bedragen niet inclusief btw versturen, laat je eigen betaallink dan het totaal van de jortt-factuur gebruiken. De API geeft dat terug als invoice_total_incl_vat. Of laat je klant betalen via de betaallink in de factuurmail van jortt.

Is er al 1 cent te weinig betaald?

Koppel de bijschrijving aan de factuur, zoals altijd. Het verschil van € 0,01 boek je daarna op de categorie Betalingsverschillen. Dan staat de factuur op betaald en hoef je je klant niet om die cent te vragen. Hoe dat gaat, lees je bij een betalingsverschil boeken.