Skip to content

Document template · generic.business.proforma_invoice

Proforma Invoice

  • Render-verified
  • Commercial
  • Version 1.0.0

Everyday commercial documents: quotes, receipts, purchase orders, delivery notes, and more.

JSON Schema

Fields in this template

Data sent to the API is validated against the template’s JSON Schema before anything is rendered. This template defines 24 fields:

Field Required Type Description
company Required object
company.name Required string
company.address Optional string
company.phone Optional string
company.email Optional string
company.vat Optional string
company.iban Optional string
company.bic Optional string
company.logo_base64 Optional string
client Required object
client.name Required string
client.address Optional string
client.vat Optional string
proforma Required object
proforma.number Required string
proforma.date Required string
proforma.valid_until Optional string
proforma.reference Optional string
proforma.lines Required array of object
proforma.total_excl_vat Required string
proforma.total_vat Required string
proforma.total_incl_vat Required string
proforma.payment_terms Optional string
proforma.notes Optional string

POST /render

Generate it

One POST /render call: send your JSON, get the finished PDF back. Or skip the JSON entirely and describe the document in plain language on 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.proforma_invoice",
    "data": { ... },
    "options": {"language": "en"}
  }' -o proforma-invoice.pdf

Frequently asked questions

What is “Proforma Invoice”?

Everyday commercial documents: quotes, receipts, purchase orders, delivery notes, and more. On papii this document is available as template generic.business.proforma_invoice: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Proforma Invoice with AI?

Yes. chut.app — the AI back office papii powers — fills this template from a plain-language description: you describe the document in one sentence, the AI structures the data, papii validates it against the schema and renders the PDF. Developers can also call the papii API directly with structured JSON.

Is the Proforma Invoice template legally compliant?

This template is render-verified: its schema, sample data and PDF output are automatically tested on every release. It is published with status “ready”, meaning it has not yet been through papii’s final legal review. Where it references specific legislation, that is stated in the template description — always have a professional check documents with legal effect before relying on them.