Handleidingen
Factuur maken en versturen
Een factuur doorloopt drie stappen: concept, definitief en verstuurd.
1. Concept aanmakenLink naar deze sectie
Geef een klant en minstens één regel mee. Totalen en btw rekent ProFactuur zelf.
POST /api/v1/facturen
curl -X POST https://profactuur.be/api/v1/facturen \
-H "Authorization: Bearer $PROFACTUUR_KEY" \
-H "Content-Type: application/json" \
-d '{"klant_id":"6f1c...","regels":[{"omschrijving":"Webdesign","aantal":8,"eenheidsprijs":75,"btw_percentage":21}]}'Toon voorbeeldresponse
{
"data": {
"id": "9a2b...",
"status": "concept",
"totaal_incl": 726
}
}Gebruik je je prijslijst, geef dan per regel een product_id en een aantal mee.
2. Definitief makenLink naar deze sectie
Nu krijgt de factuur haar doorlopende nummer en gestructureerde mededeling. Daarna kan ze niet meer wijzigen.
POST /api/v1/facturen/9a2b.../definitief
curl -X POST https://profactuur.be/api/v1/facturen/9a2b.../definitief \
-H "Authorization: Bearer $PROFACTUUR_KEY"Toon voorbeeldresponse
{
"data": {
"nummer": "2026-0042",
"ogm": "+++123/4567/89012+++"
}
}3. VersturenLink naar deze sectie
Kies peppol als je klant op Peppol zit, anders email. Bij e-mail gaat de PDF als bijlage mee.
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"}'Toon voorbeeldresponse
{
"data": {
"kanaal": "peppol",
"peppol_status": "verzonden"
}
}Peppol-verzendingen tellen mee voor je maandlimiet. Zie Plannen en verbruik.