Handleidingen

Klanten beheren

Synchroniseer klanten uit je eigen systeem met ProFactuur.

Bestaande klant zoekenLink naar deze sectie

Zoek eerst of de klant al bestaat, zo vermijd je dubbels.

GET /api/v1/klanten
curl https://profactuur.be/api/v1/klanten?q=peeters \
  -H "Authorization: Bearer $PROFACTUUR_KEY"

Klant aanmakenLink naar deze sectie

Enkel naam is verplicht. Geef een btw-nummer mee als je via Peppol wil factureren.

POST /api/v1/klanten
curl -X POST https://profactuur.be/api/v1/klanten \
  -H "Authorization: Bearer $PROFACTUUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"naam":"Bakkerij Peeters","kbo_btw_nummer":"BE0123456789"}'
Toon voorbeeldresponse
{
  "data": {
    "id": "6f1c...",
    "naam": "Bakkerij Peeters"
  }
}

Klant bijwerkenLink naar deze sectie

Stuur enkel de velden die wijzigen.

PATCH /api/v1/klanten/6f1c...
curl -X PATCH https://profactuur.be/api/v1/klanten/6f1c... \
  -H "Authorization: Bearer $PROFACTUUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"nieuw@peeters.be"}'