Preview a CFDI 4.0 invoice as an unstamped PDF
curl --request POST \
--url https://api.example.com/invoices/preview/pdf \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"date": "2026-07-30T22:50:00",
"use": "G03",
"items": [
{
"quantity": 1,
"productId": "<string>",
"description": "Servicio de consultoría",
"unitPrice": 100,
"amount": 100,
"productKey": "84111506",
"unitKey": "E48",
"unit": "E48",
"taxObject": "02",
"taxes": [
{
"type": "002",
"factorType": "Tasa",
"rate": "0.160000",
"base": 100,
"amount": 16,
"withholding": false
}
]
}
],
"type": "I",
"relatedInvoiceUuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"relatedCfdis": [
{
"type": "04",
"uuids": [
"d3bfbc57-44af-4390-a064-f0afab85e5df"
]
}
],
"series": "A",
"folioNumber": "1",
"paymentForm": "01",
"paymentMethod": "PUE",
"currency": "MXN",
"exchange": 1,
"export": "01",
"customerId": "<string>",
"idempotencyKey": "order-8421-attempt-1"
}
'import requests
url = "https://api.example.com/invoices/preview/pdf"
payload = {
"date": "2026-07-30T22:50:00",
"use": "G03",
"items": [
{
"quantity": 1,
"productId": "<string>",
"description": "Servicio de consultoría",
"unitPrice": 100,
"amount": 100,
"productKey": "84111506",
"unitKey": "E48",
"unit": "E48",
"taxObject": "02",
"taxes": [
{
"type": "002",
"factorType": "Tasa",
"rate": "0.160000",
"base": 100,
"amount": 16,
"withholding": False
}
]
}
],
"type": "I",
"relatedInvoiceUuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"relatedCfdis": [
{
"type": "04",
"uuids": ["d3bfbc57-44af-4390-a064-f0afab85e5df"]
}
],
"series": "A",
"folioNumber": "1",
"paymentForm": "01",
"paymentMethod": "PUE",
"currency": "MXN",
"exchange": 1,
"export": "01",
"customerId": "<string>",
"idempotencyKey": "order-8421-attempt-1"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2026-07-30T22:50:00',
use: 'G03',
items: [
{
quantity: 1,
productId: '<string>',
description: 'Servicio de consultoría',
unitPrice: 100,
amount: 100,
productKey: '84111506',
unitKey: 'E48',
unit: 'E48',
taxObject: '02',
taxes: [
{
type: '002',
factorType: 'Tasa',
rate: '0.160000',
base: 100,
amount: 16,
withholding: false
}
]
}
],
type: 'I',
relatedInvoiceUuid: 'd3bfbc57-44af-4390-a064-f0afab85e5df',
relatedCfdis: [{type: '04', uuids: ['d3bfbc57-44af-4390-a064-f0afab85e5df']}],
series: 'A',
folioNumber: '1',
paymentForm: '01',
paymentMethod: 'PUE',
currency: 'MXN',
exchange: 1,
export: '01',
customerId: '<string>',
idempotencyKey: 'order-8421-attempt-1'
})
};
fetch('https://api.example.com/invoices/preview/pdf', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/invoices/preview/pdf",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'date' => '2026-07-30T22:50:00',
'use' => 'G03',
'items' => [
[
'quantity' => 1,
'productId' => '<string>',
'description' => 'Servicio de consultoría',
'unitPrice' => 100,
'amount' => 100,
'productKey' => '84111506',
'unitKey' => 'E48',
'unit' => 'E48',
'taxObject' => '02',
'taxes' => [
[
'type' => '002',
'factorType' => 'Tasa',
'rate' => '0.160000',
'base' => 100,
'amount' => 16,
'withholding' => false
]
]
]
],
'type' => 'I',
'relatedInvoiceUuid' => 'd3bfbc57-44af-4390-a064-f0afab85e5df',
'relatedCfdis' => [
[
'type' => '04',
'uuids' => [
'd3bfbc57-44af-4390-a064-f0afab85e5df'
]
]
],
'series' => 'A',
'folioNumber' => '1',
'paymentForm' => '01',
'paymentMethod' => 'PUE',
'currency' => 'MXN',
'exchange' => 1,
'export' => '01',
'customerId' => '<string>',
'idempotencyKey' => 'order-8421-attempt-1'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/invoices/preview/pdf"
payload := strings.NewReader("{\n \"date\": \"2026-07-30T22:50:00\",\n \"use\": \"G03\",\n \"items\": [\n {\n \"quantity\": 1,\n \"productId\": \"<string>\",\n \"description\": \"Servicio de consultoría\",\n \"unitPrice\": 100,\n \"amount\": 100,\n \"productKey\": \"84111506\",\n \"unitKey\": \"E48\",\n \"unit\": \"E48\",\n \"taxObject\": \"02\",\n \"taxes\": [\n {\n \"type\": \"002\",\n \"factorType\": \"Tasa\",\n \"rate\": \"0.160000\",\n \"base\": 100,\n \"amount\": 16,\n \"withholding\": false\n }\n ]\n }\n ],\n \"type\": \"I\",\n \"relatedInvoiceUuid\": \"d3bfbc57-44af-4390-a064-f0afab85e5df\",\n \"relatedCfdis\": [\n {\n \"type\": \"04\",\n \"uuids\": [\n \"d3bfbc57-44af-4390-a064-f0afab85e5df\"\n ]\n }\n ],\n \"series\": \"A\",\n \"folioNumber\": \"1\",\n \"paymentForm\": \"01\",\n \"paymentMethod\": \"PUE\",\n \"currency\": \"MXN\",\n \"exchange\": 1,\n \"export\": \"01\",\n \"customerId\": \"<string>\",\n \"idempotencyKey\": \"order-8421-attempt-1\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/invoices/preview/pdf")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2026-07-30T22:50:00\",\n \"use\": \"G03\",\n \"items\": [\n {\n \"quantity\": 1,\n \"productId\": \"<string>\",\n \"description\": \"Servicio de consultoría\",\n \"unitPrice\": 100,\n \"amount\": 100,\n \"productKey\": \"84111506\",\n \"unitKey\": \"E48\",\n \"unit\": \"E48\",\n \"taxObject\": \"02\",\n \"taxes\": [\n {\n \"type\": \"002\",\n \"factorType\": \"Tasa\",\n \"rate\": \"0.160000\",\n \"base\": 100,\n \"amount\": 16,\n \"withholding\": false\n }\n ]\n }\n ],\n \"type\": \"I\",\n \"relatedInvoiceUuid\": \"d3bfbc57-44af-4390-a064-f0afab85e5df\",\n \"relatedCfdis\": [\n {\n \"type\": \"04\",\n \"uuids\": [\n \"d3bfbc57-44af-4390-a064-f0afab85e5df\"\n ]\n }\n ],\n \"series\": \"A\",\n \"folioNumber\": \"1\",\n \"paymentForm\": \"01\",\n \"paymentMethod\": \"PUE\",\n \"currency\": \"MXN\",\n \"exchange\": 1,\n \"export\": \"01\",\n \"customerId\": \"<string>\",\n \"idempotencyKey\": \"order-8421-attempt-1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/invoices/preview/pdf")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2026-07-30T22:50:00\",\n \"use\": \"G03\",\n \"items\": [\n {\n \"quantity\": 1,\n \"productId\": \"<string>\",\n \"description\": \"Servicio de consultoría\",\n \"unitPrice\": 100,\n \"amount\": 100,\n \"productKey\": \"84111506\",\n \"unitKey\": \"E48\",\n \"unit\": \"E48\",\n \"taxObject\": \"02\",\n \"taxes\": [\n {\n \"type\": \"002\",\n \"factorType\": \"Tasa\",\n \"rate\": \"0.160000\",\n \"base\": 100,\n \"amount\": 16,\n \"withholding\": false\n }\n ]\n }\n ],\n \"type\": \"I\",\n \"relatedInvoiceUuid\": \"d3bfbc57-44af-4390-a064-f0afab85e5df\",\n \"relatedCfdis\": [\n {\n \"type\": \"04\",\n \"uuids\": [\n \"d3bfbc57-44af-4390-a064-f0afab85e5df\"\n ]\n }\n ],\n \"series\": \"A\",\n \"folioNumber\": \"1\",\n \"paymentForm\": \"01\",\n \"paymentMethod\": \"PUE\",\n \"currency\": \"MXN\",\n \"exchange\": 1,\n \"export\": \"01\",\n \"customerId\": \"<string>\",\n \"idempotencyKey\": \"order-8421-attempt-1\"\n}"
response = http.request(request)
puts response.read_bodyinvoices
Preview a CFDI 4.0 invoice as an unstamped PDF
Accepts the exact same request body as POST /invoices, runs the exact same catalog/CFDI 4.0 validations, but never timbra (no PAC call) and never persists anything — no invoice, no cuota consumida, no idempotencyKey handling. Returns a PDF clearly marked as ‘VISTA PREVIA — NO VÁLIDO FISCALMENTE’ so it can never be confused with a real representación impresa.
POST
/
invoices
/
preview
/
pdf
Preview a CFDI 4.0 invoice as an unstamped PDF
curl --request POST \
--url https://api.example.com/invoices/preview/pdf \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"date": "2026-07-30T22:50:00",
"use": "G03",
"items": [
{
"quantity": 1,
"productId": "<string>",
"description": "Servicio de consultoría",
"unitPrice": 100,
"amount": 100,
"productKey": "84111506",
"unitKey": "E48",
"unit": "E48",
"taxObject": "02",
"taxes": [
{
"type": "002",
"factorType": "Tasa",
"rate": "0.160000",
"base": 100,
"amount": 16,
"withholding": false
}
]
}
],
"type": "I",
"relatedInvoiceUuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"relatedCfdis": [
{
"type": "04",
"uuids": [
"d3bfbc57-44af-4390-a064-f0afab85e5df"
]
}
],
"series": "A",
"folioNumber": "1",
"paymentForm": "01",
"paymentMethod": "PUE",
"currency": "MXN",
"exchange": 1,
"export": "01",
"customerId": "<string>",
"idempotencyKey": "order-8421-attempt-1"
}
'import requests
url = "https://api.example.com/invoices/preview/pdf"
payload = {
"date": "2026-07-30T22:50:00",
"use": "G03",
"items": [
{
"quantity": 1,
"productId": "<string>",
"description": "Servicio de consultoría",
"unitPrice": 100,
"amount": 100,
"productKey": "84111506",
"unitKey": "E48",
"unit": "E48",
"taxObject": "02",
"taxes": [
{
"type": "002",
"factorType": "Tasa",
"rate": "0.160000",
"base": 100,
"amount": 16,
"withholding": False
}
]
}
],
"type": "I",
"relatedInvoiceUuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"relatedCfdis": [
{
"type": "04",
"uuids": ["d3bfbc57-44af-4390-a064-f0afab85e5df"]
}
],
"series": "A",
"folioNumber": "1",
"paymentForm": "01",
"paymentMethod": "PUE",
"currency": "MXN",
"exchange": 1,
"export": "01",
"customerId": "<string>",
"idempotencyKey": "order-8421-attempt-1"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
date: '2026-07-30T22:50:00',
use: 'G03',
items: [
{
quantity: 1,
productId: '<string>',
description: 'Servicio de consultoría',
unitPrice: 100,
amount: 100,
productKey: '84111506',
unitKey: 'E48',
unit: 'E48',
taxObject: '02',
taxes: [
{
type: '002',
factorType: 'Tasa',
rate: '0.160000',
base: 100,
amount: 16,
withholding: false
}
]
}
],
type: 'I',
relatedInvoiceUuid: 'd3bfbc57-44af-4390-a064-f0afab85e5df',
relatedCfdis: [{type: '04', uuids: ['d3bfbc57-44af-4390-a064-f0afab85e5df']}],
series: 'A',
folioNumber: '1',
paymentForm: '01',
paymentMethod: 'PUE',
currency: 'MXN',
exchange: 1,
export: '01',
customerId: '<string>',
idempotencyKey: 'order-8421-attempt-1'
})
};
fetch('https://api.example.com/invoices/preview/pdf', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/invoices/preview/pdf",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'date' => '2026-07-30T22:50:00',
'use' => 'G03',
'items' => [
[
'quantity' => 1,
'productId' => '<string>',
'description' => 'Servicio de consultoría',
'unitPrice' => 100,
'amount' => 100,
'productKey' => '84111506',
'unitKey' => 'E48',
'unit' => 'E48',
'taxObject' => '02',
'taxes' => [
[
'type' => '002',
'factorType' => 'Tasa',
'rate' => '0.160000',
'base' => 100,
'amount' => 16,
'withholding' => false
]
]
]
],
'type' => 'I',
'relatedInvoiceUuid' => 'd3bfbc57-44af-4390-a064-f0afab85e5df',
'relatedCfdis' => [
[
'type' => '04',
'uuids' => [
'd3bfbc57-44af-4390-a064-f0afab85e5df'
]
]
],
'series' => 'A',
'folioNumber' => '1',
'paymentForm' => '01',
'paymentMethod' => 'PUE',
'currency' => 'MXN',
'exchange' => 1,
'export' => '01',
'customerId' => '<string>',
'idempotencyKey' => 'order-8421-attempt-1'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/invoices/preview/pdf"
payload := strings.NewReader("{\n \"date\": \"2026-07-30T22:50:00\",\n \"use\": \"G03\",\n \"items\": [\n {\n \"quantity\": 1,\n \"productId\": \"<string>\",\n \"description\": \"Servicio de consultoría\",\n \"unitPrice\": 100,\n \"amount\": 100,\n \"productKey\": \"84111506\",\n \"unitKey\": \"E48\",\n \"unit\": \"E48\",\n \"taxObject\": \"02\",\n \"taxes\": [\n {\n \"type\": \"002\",\n \"factorType\": \"Tasa\",\n \"rate\": \"0.160000\",\n \"base\": 100,\n \"amount\": 16,\n \"withholding\": false\n }\n ]\n }\n ],\n \"type\": \"I\",\n \"relatedInvoiceUuid\": \"d3bfbc57-44af-4390-a064-f0afab85e5df\",\n \"relatedCfdis\": [\n {\n \"type\": \"04\",\n \"uuids\": [\n \"d3bfbc57-44af-4390-a064-f0afab85e5df\"\n ]\n }\n ],\n \"series\": \"A\",\n \"folioNumber\": \"1\",\n \"paymentForm\": \"01\",\n \"paymentMethod\": \"PUE\",\n \"currency\": \"MXN\",\n \"exchange\": 1,\n \"export\": \"01\",\n \"customerId\": \"<string>\",\n \"idempotencyKey\": \"order-8421-attempt-1\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.example.com/invoices/preview/pdf")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"date\": \"2026-07-30T22:50:00\",\n \"use\": \"G03\",\n \"items\": [\n {\n \"quantity\": 1,\n \"productId\": \"<string>\",\n \"description\": \"Servicio de consultoría\",\n \"unitPrice\": 100,\n \"amount\": 100,\n \"productKey\": \"84111506\",\n \"unitKey\": \"E48\",\n \"unit\": \"E48\",\n \"taxObject\": \"02\",\n \"taxes\": [\n {\n \"type\": \"002\",\n \"factorType\": \"Tasa\",\n \"rate\": \"0.160000\",\n \"base\": 100,\n \"amount\": 16,\n \"withholding\": false\n }\n ]\n }\n ],\n \"type\": \"I\",\n \"relatedInvoiceUuid\": \"d3bfbc57-44af-4390-a064-f0afab85e5df\",\n \"relatedCfdis\": [\n {\n \"type\": \"04\",\n \"uuids\": [\n \"d3bfbc57-44af-4390-a064-f0afab85e5df\"\n ]\n }\n ],\n \"series\": \"A\",\n \"folioNumber\": \"1\",\n \"paymentForm\": \"01\",\n \"paymentMethod\": \"PUE\",\n \"currency\": \"MXN\",\n \"exchange\": 1,\n \"export\": \"01\",\n \"customerId\": \"<string>\",\n \"idempotencyKey\": \"order-8421-attempt-1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/invoices/preview/pdf")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"date\": \"2026-07-30T22:50:00\",\n \"use\": \"G03\",\n \"items\": [\n {\n \"quantity\": 1,\n \"productId\": \"<string>\",\n \"description\": \"Servicio de consultoría\",\n \"unitPrice\": 100,\n \"amount\": 100,\n \"productKey\": \"84111506\",\n \"unitKey\": \"E48\",\n \"unit\": \"E48\",\n \"taxObject\": \"02\",\n \"taxes\": [\n {\n \"type\": \"002\",\n \"factorType\": \"Tasa\",\n \"rate\": \"0.160000\",\n \"base\": 100,\n \"amount\": 16,\n \"withholding\": false\n }\n ]\n }\n ],\n \"type\": \"I\",\n \"relatedInvoiceUuid\": \"d3bfbc57-44af-4390-a064-f0afab85e5df\",\n \"relatedCfdis\": [\n {\n \"type\": \"04\",\n \"uuids\": [\n \"d3bfbc57-44af-4390-a064-f0afab85e5df\"\n ]\n }\n ],\n \"series\": \"A\",\n \"folioNumber\": \"1\",\n \"paymentForm\": \"01\",\n \"paymentMethod\": \"PUE\",\n \"currency\": \"MXN\",\n \"exchange\": 1,\n \"export\": \"01\",\n \"customerId\": \"<string>\",\n \"idempotencyKey\": \"order-8421-attempt-1\"\n}"
response = http.request(request)
puts response.read_bodyAuthorizations
apiKeybearer
API Key for authentication (sk_test_... for sandbox, sk_live_... for production)
Headers
Required for Supabase session auth. Ignored when authenticating with an API key (the organization resolves from the key).
Body
application/json
Example:
"2026-07-30T22:50:00"
SAT uso CFDI catalog code
Example:
"G03"
Show child attributes
Show child attributes
Ingreso, Egreso, or Traslado (default: I)
Available options:
I, E, T Example:
"I"
Required when type is E (Egreso/nota de crédito) — UUID fiscal of the original Ingreso CFDI it credits. Must belong to this organization and be a vigente Ingreso.
Example:
"d3bfbc57-44af-4390-a064-f0afab85e5df"
CFDI relacionados. Fase actual: un solo elemento { type: "04", uuids: [<uuid del CFDI que se sustituye>] }, solo para Ingreso y Traslado. Para Egreso usa relatedInvoiceUuid.
Show child attributes
Show child attributes
Opcional: si no se manda se usa la serie predeterminada del tipo (I y T: A, E: NC, salvo que la organización la cambie). De 1 a 25 caracteres, sin |.
Maximum string length:
25Example:
"A"
Opcional: si no se manda se usa el siguiente folio de la serie. Un folio que ya existe en la serie se rechaza con 409 FOLIO_ALREADY_USED. De 1 a 40 caracteres, sin |.
Maximum string length:
40Example:
"1"
SAT forma de pago catalog code — required unless type is T (Traslado)
Example:
"01"
Default: PUE
Available options:
PUE, PPD Example:
"PUE"
Default: MXN
Example:
"MXN"
Default: 1
Example:
1
SAT clave de exportación catalog code — default: 01
Example:
"01"
Show child attributes
Show child attributes
Existing customer ID — mutually exclusive with customer
Client-supplied key to safely retry this request without double-stamping. If an invoice was already created for this organization with the same key, that invoice is returned instead of stamping again.
Example:
"order-8421-attempt-1"
Response
PDF de vista previa del CFDI