Preview Invoice PDF

Preview a CFDI 4.0 invoice as an unstamped PDF

curl --request POST \
  --url https://api.timbrix.mx/organizations/{organizationId}/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,
      "amount": 100,
      "productId": "<string>",
      "description": "Servicio de consultoría",
      "unitPrice": 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",
  "paymentForm": "01",
  "paymentMethod": "PUE",
  "currency": "MXN",
  "exchange": 1,
  "export": "01",
  "customerId": "<string>",
  "idempotencyKey": "order-8421-attempt-1"
}
'

import requests

url = "https://api.timbrix.mx/organizations/{organizationId}/invoices/preview/pdf"

payload = {
    "series": "A",
    "folioNumber": "1",
    "date": "2026-07-30T22:50:00",
    "use": "G03",
    "items": [
        {
            "quantity": 1,
            "amount": 100,
            "productId": "<string>",
            "description": "Servicio de consultoría",
            "unitPrice": 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",
    "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,
        amount: 100,
        productId: '<string>',
        description: 'Servicio de consultoría',
        unitPrice: 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',
    paymentForm: '01',
    paymentMethod: 'PUE',
    currency: 'MXN',
    exchange: 1,
    export: '01',
    customerId: '<string>',
    idempotencyKey: 'order-8421-attempt-1'
  })
};

fetch('https://api.timbrix.mx/organizations/{organizationId}/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.timbrix.mx/organizations/{organizationId}/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,
                'amount' => 100,
                'productId' => '<string>',
                'description' => 'Servicio de consultoría',
                'unitPrice' => 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',
    '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.timbrix.mx/organizations/{organizationId}/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      \"amount\": 100,\n      \"productId\": \"<string>\",\n      \"description\": \"Servicio de consultoría\",\n      \"unitPrice\": 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  \"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.timbrix.mx/organizations/{organizationId}/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      \"amount\": 100,\n      \"productId\": \"<string>\",\n      \"description\": \"Servicio de consultoría\",\n      \"unitPrice\": 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  \"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.timbrix.mx/organizations/{organizationId}/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      \"amount\": 100,\n      \"productId\": \"<string>\",\n      \"description\": \"Servicio de consultoría\",\n      \"unitPrice\": 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  \"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_body

"<string>"

POST

organizations

{organizationId}

invoices

preview

pdf

Preview a CFDI 4.0 invoice as an unstamped PDF

curl --request POST \
  --url https://api.timbrix.mx/organizations/{organizationId}/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,
      "amount": 100,
      "productId": "<string>",
      "description": "Servicio de consultoría",
      "unitPrice": 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",
  "paymentForm": "01",
  "paymentMethod": "PUE",
  "currency": "MXN",
  "exchange": 1,
  "export": "01",
  "customerId": "<string>",
  "idempotencyKey": "order-8421-attempt-1"
}
'

import requests

url = "https://api.timbrix.mx/organizations/{organizationId}/invoices/preview/pdf"

payload = {
    "series": "A",
    "folioNumber": "1",
    "date": "2026-07-30T22:50:00",
    "use": "G03",
    "items": [
        {
            "quantity": 1,
            "amount": 100,
            "productId": "<string>",
            "description": "Servicio de consultoría",
            "unitPrice": 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",
    "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,
        amount: 100,
        productId: '<string>',
        description: 'Servicio de consultoría',
        unitPrice: 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',
    paymentForm: '01',
    paymentMethod: 'PUE',
    currency: 'MXN',
    exchange: 1,
    export: '01',
    customerId: '<string>',
    idempotencyKey: 'order-8421-attempt-1'
  })
};

fetch('https://api.timbrix.mx/organizations/{organizationId}/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.timbrix.mx/organizations/{organizationId}/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,
                'amount' => 100,
                'productId' => '<string>',
                'description' => 'Servicio de consultoría',
                'unitPrice' => 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',
    '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.timbrix.mx/organizations/{organizationId}/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      \"amount\": 100,\n      \"productId\": \"<string>\",\n      \"description\": \"Servicio de consultoría\",\n      \"unitPrice\": 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  \"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.timbrix.mx/organizations/{organizationId}/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      \"amount\": 100,\n      \"productId\": \"<string>\",\n      \"description\": \"Servicio de consultoría\",\n      \"unitPrice\": 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  \"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.timbrix.mx/organizations/{organizationId}/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      \"amount\": 100,\n      \"productId\": \"<string>\",\n      \"description\": \"Servicio de consultoría\",\n      \"unitPrice\": 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  \"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_body

"<string>"

Generates 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 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 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.

The resulting PDF is visibly marked as a preview so it can never be mistaken for a real representación impresa:

A red banner reading “VISTA PREVIA — NO VÁLIDO FISCALMENTE”
No folio fiscal (UUID)
No digital seals (sellos)
No SAT verification QR code

None of those exist until the CFDI is actually stamped, so the preview simply omits them.

Authentication

Accepts either:

A Supabase Bearer session (Authorization: Bearer <token>) — the authenticated user must be a member of organizationId.
An API key (X-API-Key: sk_...) with the write:invoices scope — the key’s own organization must match organizationId in the URL, or the request is rejected with 403 Forbidden.

Path Parameters

Parameter	Type	Required	Description
`organizationId`	string (UUID)	Yes	Organization ID

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/organizations/550e8400-e29b-41d4-a716-446655440000/invoices/preview/pdf \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -o preview.pdf \
  -d '{
    "series": "A",
    "folioNumber": "1",
    "date": "2026-07-30T15:50:00",
    "paymentForm": "01",
    "paymentMethod": "PUE",
    "use": "G03",
    "customerId": "590ce6c56d04f840aa8438af",
    "items": [
      {
        "quantity": 1,
        "amount": 100,
        "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(
  "550e8400-e29b-41d4-a716-446655440000",
  {
    series: "A",
    folioNumber: "1",
    date: "2026-07-30T15:50:00",
    paymentForm: "01",
    paymentMethod: "PUE",
    use: "G03",
    customerId: "590ce6c56d04f840aa8438af",
    items: [
      {
        quantity: 1,
        amount: 100,
        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"`

Common Errors

400 Bad Request

Invalid or incomplete invoice payload — 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 organizationId, the API key does not have the write:invoices scope, or the API key belongs to a different organization than the one in the URL.

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 organizationId counts as not found.

Authorizations

X-API-Key

string

header

required

API Key for authentication (format: sk_...)

Path Parameters

organizationId

string

required

Body

application/json

series

string

required

Example:

"A"

folioNumber

string

required

Example:

"1"

date

string

required

Example:

"2026-07-30T22:50:00"

use

string

required

SAT uso CFDI catalog code

Example:

"G03"

items

object[]

required

Show child attributes

type

enum<string>

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"

paymentForm

string

SAT forma de pago catalog code — required unless type is T (Traslado)

Example:

"01"

paymentMethod

enum<string>

Default: PUE

Available options:

PUE,

PPD

Example:

"PUE"

currency

string

Default: MXN

Example:

"MXN"

exchange

number

Default: 1

Example:

1

export

string

SAT clave de exportación catalog code — default: 01

Example:

"01"

customer

object

Show child attributes

customerId

string

Existing customer ID — mutually exclusive with customer

idempotencyKey

string

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

The response is of type file.

API documentation

Organizations

Members

Invites

Auth

OAuth

Customers

SAT Catalogs

Invoices

Products

Users

Webhooks

API Keys

Preview Invoice PDF

Authentication

Path Parameters

Request Body

Example Request

Example Response

Common Errors

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

Authorizations

Path Parameters

Body

Response

​Authentication

​Path Parameters

​Request Body

​Example Request

​Example Response

​Common Errors

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

Authorizations

Path Parameters

Body

Response

Authentication

Path Parameters

Request Body

Example Request

Example Response

Common Errors

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found