Skip to content
papii

Documentsjabloon · generic.business.invoice

Commerciële factuur

  • Rendering geverifieerd
  • Commercieel
  • Versie 1.0.0

Country-agnostic commercial invoice. Intended to be complemented by the caller's country profile for local legal mentions (Art. 226 Council Directive 2006/112/EC for EU callers, equivalent national rules elsewhere).

JSON Schema

Velden in dit sjabloon

Data die naar de API wordt gestuurd, wordt gevalideerd tegen het JSON-schema van het sjabloon vóór er iets wordt gerenderd. Dit sjabloon definieert 36 velden:

Veld Verplicht Type Beschrijving
supplier Verplicht object
supplier.name Verplicht string
supplier.address Verplicht string
supplier.vat_id Optioneel string Optional. Supplier VAT identification, e.g. BE0123456789.
supplier.contact_email Verplicht string
customer Verplicht object
customer.name Verplicht string
customer.address Verplicht string
customer.vat_id Optioneel string Optional. Customer VAT identification.
invoice Verplicht object
invoice.number Verplicht string
invoice.issue_date Verplicht date
invoice.due_date Verplicht date
invoice.reference Optioneel string Optional customer order reference.
invoice.notes Optioneel string Optional free-form note printed under the totals.
invoice.language_currency_overrides Optioneel object Optional overrides when the rendering locale differs from the country profile.
lines Verplicht array of object
lines[].description Verplicht string
lines[].quantity Verplicht number
lines[].unit Verplicht string Unit of measure (e.g. 'pcs', 'hour', 'kg').
lines[].unit_price Verplicht number
lines[].vat_rate_pct Verplicht number
lines[].amount_net Verplicht number
totals Verplicht object
totals.subtotal Verplicht number
totals.vat_total Verplicht number
totals.total Verplicht number
totals.currency Verplicht string ISO 4217 code, e.g. 'EUR'.
payment Verplicht object
payment.iban Optioneel string Optional IBAN in electronic format, e.g. BE68539007547034.

+6 extra velden — het volledige JSON-schema is beschikbaar in het dashboard en via de API.

POST /render

Genereer het

Eén POST /render-oproep: stuur je JSON, ontvang de afgewerkte PDF. Of sla de JSON over en beschrijf het document in gewone taal op chut.app.

curl 
curl -X POST https://api.papii.eu/render \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "generic.business.invoice",
    "data": { ... },
    "options": {"language": "nl"}
  }' -o invoice.pdf
Genereren met AI op chut.app Proberen in het dashboard

Veelgestelde vragen

Wat is een “Commerciële factuur”?

Country-agnostic commercial invoice. Intended to be complemented by the caller's country profile for local legal mentions (Art. 226 Council Directive 2006/112/EC for EU callers, equivalent national rules elsewhere). Op papii is dit document beschikbaar als sjabloon generic.business.invoice: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.

Kan ik een “Commerciële factuur” genereren met AI?

Ja. chut.app — de AI-backoffice aangedreven door papii — vult dit sjabloon in op basis van een beschrijving in gewone taal: jij beschrijft het document in één zin, de AI structureert de data, papii valideert die tegen het schema en rendert de PDF. Ontwikkelaars kunnen de papii-API ook rechtstreeks aanroepen met gestructureerde JSON.

Is het sjabloon “Commerciële factuur” juridisch conform?

Dit sjabloon heeft een geverifieerde rendering: het schema, de voorbeelddata en de PDF-uitvoer worden bij elke release automatisch getest. Het is gepubliceerd met status “ready”, wat betekent dat het de finale juridische review van papii nog niet heeft doorlopen. Waar het naar specifieke wetgeving verwijst, staat dat vermeld in de sjabloonbeschrijving — laat documenten met juridische gevolgen altijd door een professional nakijken voor je erop vertrouwt.