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 '
{
"series": "A",
"folioNumber": "1",
"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"
]
}
],
"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 = {
"series": "A",
"folioNumber": "1",
"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"]
}
],
"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({
series: 'A',
folioNumber: '1',
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']}],
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([
'series' => 'A',
'folioNumber' => '1',
'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'
]
]
],
'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 \"series\": \"A\",\n \"folioNumber\": \"1\",\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 \"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 \"series\": \"A\",\n \"folioNumber\": \"1\",\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 \"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 \"series\": \"A\",\n \"folioNumber\": \"1\",\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 \"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 Invoice 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 '
{
"series": "A",
"folioNumber": "1",
"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"
]
}
],
"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 = {
"series": "A",
"folioNumber": "1",
"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"]
}
],
"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({
series: 'A',
folioNumber: '1',
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']}],
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([
'series' => 'A',
'folioNumber' => '1',
'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'
]
]
],
'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 \"series\": \"A\",\n \"folioNumber\": \"1\",\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 \"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 \"series\": \"A\",\n \"folioNumber\": \"1\",\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 \"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 \"series\": \"A\",\n \"folioNumber\": \"1\",\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 \"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_bodyGenerates a PDF preview of a CFDI 4.0 invoice without stamping it at the SAT and without persisting anything. Use this to let a user review an invoice’s data before confirming the real emission — stamping has a cost (every timbre is billed by the PAC) and can’t be easily undone (it requires a formal cancellation).
Accepts the exact same request body as Create Invoice — same
The resulting PDF is visibly marked as a preview so it can never be mistaken for a real representación impresa:
With an API key, omit the
CreateInvoiceDto shape, same type, customer/customerId, items[], etc. — and runs the exact same SAT catalog / CFDI 4.0 validations, so a payload that would fail to stamp also fails to preview with the same 400.
This endpoint takes noorganizationIdin the URL. Authenticate with either a Supabase Bearer session (send theX-Organization-Id: <org-id>header — the user must be a member of that organization) or an API key (the organization resolves automatically from the key; anyX-Organization-Idheader sent alongside an API key is ignored).
This endpoint never calls the PAC, never writes an invoice record, and never
consumes your plan’s CFDI quota. It also ignores
idempotencyKey if sent —
previews have nothing to deduplicate, since nothing is persisted.- A red banner reading “VISTA PREVIA — NO VÁLIDO FISCALMENTE”
- No folio fiscal (UUID)
- No digital seals (sellos)
- No SAT verification QR code
Authentication
Accepts either:- A Supabase Bearer session (
Authorization: Bearer <token>) with theX-Organization-Id: <org-id>header — the authenticated user must be a member of that organization. - An API key (
X-API-Key: sk_...) with thewrite:invoicesscope — the organization is resolved from the key itself.
Request Body
Same shape as Create Invoice — see that page for the full field reference (customer/customerId, items[], taxes[], etc.). idempotencyKey is accepted for shape compatibility but ignored.
Example Request
cURL
curl -X POST https://api.timbrix.mx/invoices/preview/pdf \
-H "Authorization: Bearer <your_token>" \
-H "X-Organization-Id: 550e8400-e29b-41d4-a716-446655440000" \
-H "Content-Type: application/json" \
-o preview.pdf \
-d '{
"date": "2026-07-30T15:50:00",
"paymentForm": "01",
"paymentMethod": "PUE",
"use": "G03",
"customerId": "590ce6c56d04f840aa8438af",
"items": [
{
"quantity": 1,
"productId": "60f1c3e-prod-8421"
}
]
}'
TypeScript SDK
// Returns a Blob — render it in an <iframe>/<embed> or offer it as a download.
const pdf = await timbrix.invoices.previewPdf(
{
date: "2026-07-30T15:50:00",
paymentForm: "01",
paymentMethod: "PUE",
use: "G03",
customerId: "590ce6c56d04f840aa8438af",
items: [
{
quantity: 1,
productId: "60f1c3e-prod-8421",
},
],
},
"550e8400-e29b-41d4-a716-446655440000"
)
X-Organization-Id header (and the SDK’s organizationId argument) entirely — it’s resolved from the key:
TypeScript SDK (API key)
const pdf = await timbrix.invoices.previewPdf({
date: "2026-07-30T15:50:00",
paymentForm: "01",
paymentMethod: "PUE",
use: "G03",
customerId: "590ce6c56d04f840aa8438af",
items: [
{
quantity: 1,
productId: "60f1c3e-prod-8421",
},
],
})
Example Response
This endpoint does not return a JSON body — it returns the generated PDF file directly in the response body with:| Header | Value |
|---|---|
Content-Type | application/pdf |
Content-Disposition | inline; filename="preview-<series>-<folioNumber>.pdf" (auto in place of the folio when you omit it) |
Common Errors
400 Bad Request
Invalid or incomplete invoice payload, missingX-Organization-Id header on a session-authenticated request — identical validation rules to Create Invoice: an issuing organization without complete fiscal data, sending both/neither customer and customerId, sending both/neither productId and the inline concept fields on an item, or a customer whose RFC/régimen/uso CFDI combination fails SAT catalog validation.
{
"statusCode": 400,
"message": "La organización no tiene datos fiscales completos (RFC, razón social, régimen fiscal y código postal). Complétalos en PUT /organizations/:organizationId/legal antes de generar una vista previa.",
"error": "BAD_REQUEST"
}
401 Unauthorized
Missing or invalid Bearer token / API key.403 Forbidden
The authenticated user is not a member of the organization sent inX-Organization-Id, or the API key does not have the write:invoices scope.
404 Not Found
customerId does not exist, or (for type: "E") relatedInvoiceUuid does not match any invoice — in either case, belonging to a different organization than the authenticated one counts as not found.Authorizations
apiKeybearer
API Key for authentication (format: sk_...)
Headers
Required for Supabase session auth. Ignored when authenticating with an API key (the organization resolves from the key).
Body
application/json
Example:
"A"
Example:
"1"
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
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