Skip to content

Document template · generic.business.sales_order_confirmation

Sales Order Confirmation

  • Render-verified
  • Commercial
  • Version 1.0.0

Country-agnostic sales-order acknowledgement sent to the customer after acceptance of their purchase order. Incoterms enum references Incoterms 2020 (ICC Publication 723E).

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 33 fields:

Field Required Type Description
supplier Required object
supplier.name Required string
supplier.address Required string
supplier.vat_id Optional string
supplier.contact_email Required string
customer Required object
customer.name Required string
customer.address Required string
customer.vat_id Optional string
customer.delivery_address Optional string
order_number Required string
customer_po_reference Optional string Optional. Customer's own purchase order number.
order_date Required date
requested_delivery_date Required date
confirmed_delivery_date Required date
items Required array of object
items[].sku Required string
items[].description Required string
items[].quantity Required number
items[].unit_price Required number
items[].amount Required number
delivery_terms Required enum Incoterms 2020.
delivery_place Optional string Named place required by most Incoterms 2020 rules (e.g. 'DAP Paris 8e, France').
payment_terms Required string
totals Required object
totals.subtotal Required number
totals.vat_total Required number
totals.total Required number
totals.currency Required string
signatory Optional object

+3 more fields — the full JSON Schema is available in the dashboard and via the API.

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.sales_order_confirmation",
    "data": { ... },
    "options": {"language": "en"}
  }' -o sales-order-confirmation.pdf

Frequently asked questions

What is “Sales Order Confirmation”?

Country-agnostic sales-order acknowledgement sent to the customer after acceptance of their purchase order. Incoterms enum references Incoterms 2020 (ICC Publication 723E). On papii this document is available as template generic.business.sales_order_confirmation: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Sales Order Confirmation 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 Sales Order Confirmation 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.