POST /generate/document

Endpoint

POST /generate/document

Generate HTML, PNG, and PDF files from a structured document definition.

Request Body

object

required

Document header fields.

Show child attributes

string

default:"guia_despacho"

Document template type: guia_despacho, factura, purchase_order, bill_of_lading

string

Document number

string

Document date (DD/MM/YYYY)

string

Emitter company name

string

Emitter tax ID

string

Emitter business activity

string

Emitter address

string

Emitter phone

string

Emitter email

string

Receiver company name

string

Receiver tax ID

string

Receiver business activity

string

Receiver address

string

Receiver contact person

string

Purchase order number

string

Purchase order date

string

Payment terms

string

Dispatch date

string

Vehicle license plate

string

Driver name

string

Driver tax ID

string

SII regional office

string

SII authorization resolution

string

Person who received goods

string

Receiver personal tax ID

string

Date of receipt

array

required

List of line items.

Show child attributes

string

Product code

string

required

Product description

number

required

Quantity

string

required

Unit of measure

number

default:0

Price per unit

number

default:0

Line total

string

Batch/lot number

string

SAP material number

number

SAP quantity

string

SAP unit of measure

string

default:""

Handwritten notes / observations

string

default:"guia_despacho.html"

Template file name

Response

string

Unique identifier for this generation run

object

Show child attributes

string

Path to generated HTML file

string

Path to generated PNG file

string

Path to generated PDF file

Example

curl -X POST http://localhost:8000/generate/document \
  -H "Content-Type: application/json" \
  -d '{
    "header": {
      "doc_type": "guia_despacho",
      "doc_number": "00054321",
      "date": "15/04/2026",
      "emitter_name": "ACME FOODS S.A.",
      "receiver_name": "DISTRIBUIDORA CENTRAL LTDA."
    },
    "items": [
      {
        "description": "HARINA DE TRIGO PREMIUM 25KG",
        "qty": 40,
        "unit": "UN",
        "unit_price": 12500,
        "total": 500000
      }
    ]
  }'

Response

{
  "run_id": "a1b2c3d4e5",
  "files": {
    "html": "output/a1b2c3d4e5/guia_despacho_00054321.html",
    "png": "output/a1b2c3d4e5/guia_despacho_00054321.png",
    "pdf": "output/a1b2c3d4e5/guia_despacho_00054321.pdf"
  }
}

​Endpoint

​Request Body

​Response

​Example

Endpoint

Request Body

Response

Example