POST /generate/dataset

Endpoint

POST /generate/dataset

Complete pipeline that generates a document from JSON, renders it to PDF/PNG, and then generates photo variations.

Request Body

object

required

Document header fields (same schema as POST /generate/document).

array

required

List of line items (same schema as POST /generate/document).

string

default:""

Handwritten notes

string

default:"guia_despacho.html"

Template file name

string[]

Photo preset names. If omitted, generates all 8 presets.

string

default:""

Key fields to preserve in photos. Auto-generated from doc_number if empty.

Response

string

Unique identifier for this generation run

object

Generated document files.

Show child attributes

string

Path to HTML file

string

Path to PNG file

string

Path to PDF file

array

Array of photo generation results.

Show child attributes

string

Variation name

string

File path (null if failed)

boolean

Success flag

Example

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

Response

{
  "run_id": "c3d4e5f6g7",
  "document": {
    "html": "output/c3d4e5f6g7/guia_despacho_00054321.html",
    "png": "output/c3d4e5f6g7/guia_despacho_00054321.png",
    "pdf": "output/c3d4e5f6g7/guia_despacho_00054321.pdf"
  },
  "photos": [
    {"name": "full_picture", "path": "output/c3d4e5f6g7/photos/photo_full_picture.png", "ok": true},
    {"name": "blurry", "path": "output/c3d4e5f6g7/photos/photo_blurry.png", "ok": true}
  ]
}

​Endpoint

​Request Body

​Response

​Example

Endpoint

Request Body

Response

Example