API-referentie

Creditnota's

Creditnota's maken op basis van een factuur en versturen.

Creditnota aanmakenLink naar deze sectie

POST/api/v1/facturen/{id}/creditnota

Maakt een conceptcreditnota met dezelfde regels als de definitieve factuur.

Naam	Type	Verplicht	Uitleg
`id`	uuid	ja	ID van de originele factuur

curl -X POST https://profactuur.be/api/v1/facturen/9a2b.../creditnota \
  -H "Authorization: Bearer $PROFACTUUR_KEY"

Toon voorbeeldresponse

{
  "data": {
    "id": "b3c4...",
    "type": "creditnota",
    "status": "concept",
    "gekoppelde_factuur_id": "9a2b..."
  }
}

Creditnota's oplijstenLink naar deze sectie

GET/api/v1/creditnotas

Geeft creditnota's terug, nieuwste eerst.

Naam	Type	Verplicht	Uitleg
`limit`	integer	nee	1 tot 100, standaard 50
`offset`	integer	nee	Aantal over te slaan, standaard 0
`status`	string	nee	concept, verzonden of betaald
`van`	date	nee	Vanaf datum (YYYY-MM-DD)
`tot`	date	nee	Tot en met datum

curl https://profactuur.be/api/v1/creditnotas \
  -H "Authorization: Bearer $PROFACTUUR_KEY"

Toon voorbeeldresponse

{
  "data": [
    {
      "id": "b3c4...",
      "type": "creditnota",
      "nummer": "2026-0043",
      "status": "verzonden",
      "datum": "2026-10-10",
      "totaal_incl": 726
    }
  ],
  "total": 1
}

Creditnota versturenLink naar deze sectie

POST/api/v1/creditnotas/{id}/versturen

Verstuurt een definitieve creditnota via Peppol of per e-mail.

Naam	Type	Verplicht	Uitleg
`id`	uuid	ja	ID van de creditnota
`kanaal`	string	ja	peppol of email
`email`	string	nee	Ander adres dan dat van de klant (enkel bij email)
`simuleer`	string	nee	Enkel met een testsleutel: afgeleverd (standaard), geweigerd of fout

curl -X POST https://profactuur.be/api/v1/creditnotas/9a2b.../versturen \
  -H "Authorization: Bearer $PROFACTUUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kanaal":"email"}'

Toon voorbeeldresponse

{
  "data": {
    "kanaal": "email",
    "naar": "boekhouding@peeters.be"
  }
}

VorigeFacturen VolgendeInbox