Generate draft preview PDF (pre-factura)

POST

https://api.gigstack.io/v2/invoices/draft/{id}/preview

Generate a preview PDF for a draft invoice with a "Sin Validez Fiscal" watermark.

This is the pre-factura feature: it runs the full CFDI pipeline (normalization, XML mapping, PDF generation) without actually stamping with SAT. The generated PDF is saved and can be retrieved later via GET /invoices/draft/{id}.

Requirements:

Draft must have at least a client and one item

What you get:

A PDF that looks like a real CFDI invoice

UUID shows PREFACTURA-0000-0000-0000-SINVALIDEZ

"Sin Validez Fiscal" watermark overlay

Useful for client approval before stamping

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200OK

application/json

Preview PDF generated successfully

Body

🟠400Bad Request

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/invoices/draft//preview?team'

Response Example

200 - Example 1

{
    "message": "Preview PDF generated",
    "data": {
        "pdf": "string"
    }
}

Modified at 2026-03-12 15:02:23

Stamp draft invoice (finalize)

Delete draft invoice