Je facturen uploaden in Clearnox

Je factuurbestanden staan op je servers en je wil ze naar Clearnox sturen om ze in je aanmaningen te integreren. Dit artikel legt uit hoe je dit doet.

Een reeks facturen via de Clearnox API sturen

De publieke API van Clearnox biedt je de mogelijkheid om een hoeveelheid facturen in één keer naar Clearnox te verzenden. Er zijn twee API-aanroepen mogelijk:

1. Met de eerste haal je de lijst op van boekingen die geen bijbehorende factuur hebben, zodat je alleen de ontbrekende facturen verstuurt. Het wordt aanbevolen om paginanummers te gebruiken zoals beschreven in de API documentatie.
   
2. Met de tweede kan je de pdf-bestanden van de facturen in bulk versturen, met behulp van een zip-bestand dat de documenten bevat, evenals een associatiebestand tussen deze documenten en de betreffende boekingen.

De volledige API documentatie is hier beschikbaar en laat je ook toe om de twee bovengenoemde functionaliteiten te testen.

API authenticatie gebruikt dezelfde identifiers als de connector, die in de connector of in de Clearnox Administrator interface "Instellingen> Connector configuratie" te vinden zijn. 

De API instellen

Om in bulk te kunnen versturen, moet een module ontwikkeld worden die de volgende taken uitvoert:

1. Eerste API-aanroep om de lijst met boekingen te verkrijgen die geen factuurbestand in Clearnox hebben,
2. De factuurbestanden van je servers ophalen en een zip-bestand aanleggen,
3. Tweede API-aanroep om het zip-bestand te verzenden.

We raden je aan om deze ontwikkeling te doen net nadat je gegevens zijn gesynchroniseerd.

Er zijn verschillende manieren om deze ontwikkeling uit te voeren, afhankelijk van je situatie: 

- De module zelf ontwikkelen als je interne ontwikkelaars hebt. 
- Aan je partner vragen om de module te ontwikkelen.
- Contact opnemen met het sales team accountmanagers@clearnox.com, dat je kan doorverwijzen naar een partner die je kan helpen.

Je facturen bekijken in Clearnox

Zodra ze in bulk zijn verzonden, zijn de factuurbestanden zichtbaar in het rekening-overzicht van je klanten in de kolom "Facturen".  Klik op het document-pictogram om het te bekijken en downloaden.  

Gefeliciteerd! De facturen zijn nu beschikbaar in je Clearnox-account en je kan ze in je herinneringen integreren, zoals hier wordt uitgelegd.