Skip to content
papii

Modèle de document · generic.business.invoice

Facture commerciale

  • Rendu vérifié
  • Commercial
  • Version 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

Champs de ce modèle

Les données envoyées à l'API sont validées par le schéma JSON du modèle avant tout rendu. Ce modèle définit 36 champs :

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

+6 champs supplémentaires — le schéma JSON complet est disponible dans le tableau de bord et via l'API.

POST /render

Générez-le

Un seul appel POST /render : envoyez votre JSON, recevez le PDF final. Ou passez-vous du JSON et décrivez le document en langage naturel sur 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": "fr"}
  }' -o invoice.pdf
Générer avec l'IA sur chut.app Essayer dans le tableau de bord

Questions fréquentes

Qu'est-ce qu'un « Facture commerciale » ?

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). Sur papii, ce document est disponible sous forme du modèle generic.business.invoice : un schéma JSON associé à un rendu PDF déterministe — les mêmes données produisent toujours le même document.

Puis-je générer un « Facture commerciale » avec l'IA ?

Oui. chut.app — le back-office IA propulsé par papii — remplit ce modèle à partir d'une description en langage naturel : vous décrivez le document en une phrase, l'IA structure les données, papii les valide contre le schéma et génère le PDF. Les développeurs peuvent aussi appeler directement l'API papii avec du JSON structuré.

Le modèle « Facture commerciale » est-il conforme juridiquement ?

Ce modèle est au rendu vérifié : son schéma, ses données d'exemple et sa sortie PDF sont testés automatiquement à chaque version. Il est publié avec le statut « ready », ce qui signifie qu'il n'a pas encore passé la revue juridique finale de papii. Lorsqu'il fait référence à une législation précise, celle-ci est indiquée dans la description du modèle — faites toujours vérifier par un professionnel les documents à portée juridique avant de vous y fier.