ProFactuur

Aan de slag

Testmodus

Met een testsleutel bouw en test je je koppeling zonder dat er iets echt gebeurt.

Testsleutel aanmakenLink naar deze sectie

Kies in Instellingen, API bij het aanmaken voor Test. Een testsleutel begint met pf_test_, een live-sleutel met pf_live_. Beide werken met dezelfde endpoints.

http
Authorization: Bearer pf_test_...

Gescheiden testdataLink naar deze sectie

  • Klanten, offertes, facturen en creditnota's die je met een testsleutel maakt, zijn gemarkeerd als testdata.
  • Testdata verschijnt nooit in de app, rapporten, exports of het boekhoudersportaal.
  • Een testsleutel ziet nooit live-data, en een live-sleutel ziet nooit testdata.
  • Je producten zijn gedeeld, zodat je met je echte prijslijst kan testen.

In Instellingen, API bekijk je je testdata met de schakelaar Testdata bekijken. Met Alle testdata wissen begin je opnieuw.

Eigen nummeringLink naar deze sectie

Testfacturen krijgen een aparte reeks, zoals TEST-2026-0001. Je echte doorlopende nummering wordt nooit aangeraakt.

Peppol simulerenLink naar deze sectie

Niets gaat echt naar het Peppol-netwerk. Je factuur krijgt meteen peppol_status: verzonden en na enkele seconden het eindresultaat. Met simuleer kies je dat resultaat, zodat je ook foutafhandeling kan testen.

POST /api/v1/facturen/9a2b.../versturen
curl -X POST https://profactuur.be/api/v1/facturen/9a2b.../versturen \
  -H "Authorization: Bearer $PROFACTUUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kanaal":"peppol","simuleer":"geweigerd"}'
Toon voorbeeldresponse
{
  "data": {
    "kanaal": "peppol",
    "peppol_status": "verzonden",
    "test": true,
    "simulatie": "geweigerd"
  }
}
simuleerEindstatuspeppol_fout
afgeleverd (standaard)afgeleverdleeg
geweigerdgeweigerdDe ontvanger heeft het document geweigerd
foutfoutVerzending is mislukt
Haal de factuur opnieuw op met GET /facturen/{id} om de nieuwe status te zien.

E-mailLink naar deze sectie

Met kanaal: email gaat de mail enkel naar de eigenaar van je onderneming, met [TEST] in het onderwerp. Je klant krijgt niets.

PDF en UBLLink naar deze sectie

PDF en UBL worden gewoon gemaakt. De PDF draagt een duidelijk TEST-watermerk.

Inbox testenLink naar deze sectie

Maak een fictief ontvangen document aan met POST /test/inbox. Dit werkt enkel met een testsleutel. Het document verschijnt daarna in GET /inbox, met een UBL-bestand om te downloaden.

POST /api/v1/test/inbox
curl -X POST https://profactuur.be/api/v1/test/inbox \
  -H "Authorization: Bearer $PROFACTUUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"leverancier":"Drukkerij Janssens","bedrag":242}'

VerbruikLink naar deze sectie

Testdocumenten tellen nooit mee voor je limieten of meerverbruik. De rate limit van 60 verzoeken per minuut geldt wel.

VorigeAan de slagVolgendeWebhooks