Resources

Producten

GET en POST /api/v1/products. Producten zijn herbruikbare factuurregels met een prijs en btw-tarief.

Producten ophalen

GET /api/v1/products vraagt products:read en geeft maximaal honderd producten terug.

Antwoord

{
  "data": [
    {
      "id": "9d3e…",
      "name": "Websiteonderhoud",
      "unit_price": 7500,
      "vat_rate_bps": 2100,
      "unit": "uur",
      "sku": "MAINT-01"
    }
  ]
}

Product aanmaken

POST /api/v1/products vraagt products:write en accepteert Idempotency-Key.

Veld	Type	Verplicht	Toelichting
`name`	string	ja	Naam zoals op de factuurregel
`unitPriceCents`	integer	nee	Prijs in centen, standaard `0`
`vatRateBps`	integer	nee	`2100`, `900` of `0`, standaard `2100`
`unit`	string	nee	Eenheid, standaard `stuk`
`sku`	string	nee	Eigen artikelcode

vatRateBps is het tarief in basispunten: 2100 voor 21%, 900 voor 9%, 0 voor vrijgesteld of verlegd. De fijnere nuance per regel (bijvoorbeeld reverse_charge) zit op de factuurregel zelf, zie Facturen.