Create and stamp a CFDI 4.0 invoice via the configured PAC
curl --request POST \
--url https://api.example.com/invoices \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--header 'x-timbrix-client: <x-timbrix-client>' \
--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"
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-timbrix-client": "<x-timbrix-client>",
"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-timbrix-client': '<x-timbrix-client>',
'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', 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",
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>",
"x-timbrix-client: <x-timbrix-client>"
],
]);
$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"
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-timbrix-client", "<x-timbrix-client>")
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")
.header("x-timbrix-client", "<x-timbrix-client>")
.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")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-timbrix-client"] = '<x-timbrix-client>'
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_body{
"id": "0f2a1c3e-1a2b-4c3d-9e8f-1234567890ab",
"uuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"status": "vigente",
"cancellationStatus": "pendiente",
"cancellationDesynced": false,
"type": "I",
"series": "A",
"folioNumber": "1",
"total": 116,
"date": "2026-07-30T22:50:00",
"xml": "<string>",
"createdAt": "2026-07-30T22:50:03.412Z",
"environment": "production",
"channel": "mcp",
"rfcReceptor": "GODE561231GR8",
"relatedCfdis": [
{
"type": "04",
"uuids": [
"D3BFBC57-44AF-4390-A064-F0AFAB85E5DF"
]
}
],
"substitutedBy": [
{
"uuid": "6F2B1C9A-3D4E-4F5A-8B7C-9D0E1F2A3B4C",
"serie": "A",
"folio": "124",
"status": "vigente"
}
],
"paymentMethod": "PPD",
"balance": 160,
"payment": {
"date": "2026-10-15T12:00:00",
"paymentForm": "03",
"currency": "MXN",
"exchange": 1,
"amount": 1660,
"operationNumber": "SPEI-123",
"documents": [
{
"invoiceUuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"installment": 2,
"previousBalance": 660,
"amountPaid": 500,
"remainingBalance": 160
}
]
},
"warnings": [
{
"code": "RFC_69B_PRESUNTO",
"rfc": "AAA010101AAA",
"role": "receptor",
"message": "El RFC del receptor AAA010101AAA aparece como Presunto en la lista 69-B del SAT (publicado el 25 de junio de 2018). Revisa la operación antes de continuar."
}
]
}invoices
Create and stamp a CFDI 4.0 invoice via the configured PAC
Authenticate with either a Supabase session (send the X-Organization-Id header, must be a member of that organization) or an API key (external integrations, requires the write:invoices scope — the organization is resolved from the key). The customer can be sent inline (customer) or referenced by ID (customerId).
POST
/
invoices
Create and stamp a CFDI 4.0 invoice via the configured PAC
curl --request POST \
--url https://api.example.com/invoices \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--header 'x-timbrix-client: <x-timbrix-client>' \
--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"
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-timbrix-client": "<x-timbrix-client>",
"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-timbrix-client': '<x-timbrix-client>',
'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', 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",
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>",
"x-timbrix-client: <x-timbrix-client>"
],
]);
$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"
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-timbrix-client", "<x-timbrix-client>")
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")
.header("x-timbrix-client", "<x-timbrix-client>")
.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")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-timbrix-client"] = '<x-timbrix-client>'
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_body{
"id": "0f2a1c3e-1a2b-4c3d-9e8f-1234567890ab",
"uuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"status": "vigente",
"cancellationStatus": "pendiente",
"cancellationDesynced": false,
"type": "I",
"series": "A",
"folioNumber": "1",
"total": 116,
"date": "2026-07-30T22:50:00",
"xml": "<string>",
"createdAt": "2026-07-30T22:50:03.412Z",
"environment": "production",
"channel": "mcp",
"rfcReceptor": "GODE561231GR8",
"relatedCfdis": [
{
"type": "04",
"uuids": [
"D3BFBC57-44AF-4390-A064-F0AFAB85E5DF"
]
}
],
"substitutedBy": [
{
"uuid": "6F2B1C9A-3D4E-4F5A-8B7C-9D0E1F2A3B4C",
"serie": "A",
"folio": "124",
"status": "vigente"
}
],
"paymentMethod": "PPD",
"balance": 160,
"payment": {
"date": "2026-10-15T12:00:00",
"paymentForm": "03",
"currency": "MXN",
"exchange": 1,
"amount": 1660,
"operationNumber": "SPEI-123",
"documents": [
{
"invoiceUuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
"installment": 2,
"previousBalance": 660,
"amountPaid": 500,
"remainingBalance": 160
}
]
},
"warnings": [
{
"code": "RFC_69B_PRESUNTO",
"rfc": "AAA010101AAA",
"role": "receptor",
"message": "El RFC del receptor AAA010101AAA aparece como Presunto en la lista 69-B del SAT (publicado el 25 de junio de 2018). Revisa la operación antes de continuar."
}
]
}Authorizations
apiKeybearer
API Key for authentication (sk_test_... for sandbox, sk_live_... for production)
Headers
Canal de origen del CFDI: web, api, sdk, cli o mcp. Si no se envía o no es válido, se registra api. El SDK lo envía como sdk por defecto.
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
Timbrix invoice record ID
Example:
"0f2a1c3e-1a2b-4c3d-9e8f-1234567890ab"
Folio fiscal UUID asignado por el SAT vía PAC
Example:
"d3bfbc57-44af-4390-a064-f0afab85e5df"
Estado fiscal del CFDI registrado en Timbrix: vigente o cancelado. Antes de TIM-243 este campo era siempre "valid". Con una cancelación pendiente (cancellationStatus: pendiente) cuyo plazo de respuesta del receptor ya venció, el SAT pudo haberlo cancelado automáticamente; confírmalo en el portal del SAT.
Available options:
vigente, cancelado Example:
"vigente"
Latest cancellation attempt's status, only while the invoice is still vigente. null if never attempted or already cancelado. A pendiente past the receptor's response deadline may already be cancelado at the SAT. en_proceso: the cancellation was sent and its outcome is being confirmed with the SAT; don't treat the CFDI as vigente yet.
Available options:
pendiente, rechazada, en_proceso true when a cancellation was accepted but the invoice status update failed to apply — indicates the invoice may already be cancelled at the SAT even though it still shows vigente here; needs manual reconciliation.
Example:
false
I = Ingreso, E = Egreso, T = Traslado, P = Pago
Available options:
I, E, T, P Example:
"I"
Example:
"A"
Example:
"1"
Example:
116
Example:
"2026-07-30T22:50:00"
XML del CFDI timbrado (UTF-8)
Example:
"2026-07-30T22:50:03.412Z"
Ambiente en el que se timbró el CFDI. Los CFDI de sandbox no tienen validez fiscal ante el SAT.
Available options:
sandbox, production Example:
"production"
Canal de origen declarado por el cliente con el header X-Timbrix-Client (api si no se envió). null para CFDI anteriores a este campo.
Available options:
web, api, sdk, cli, mcp Example:
"mcp"
RFC del receptor del CFDI
Example:
"GODE561231GR8"
Relaciones de este CFDI (CfdisRelacionados). Con tipo 04 apunta al CFDI que sustituye.
Show child attributes
Show child attributes
CFDI cuya relación 04 apunta a este comprobante (sustitutos emitidos).
Show child attributes
Show child attributes
Método de pago; null en Traslado, Pago y facturas anteriores a este campo.
Available options:
PUE, PPD Example:
"PPD"
Saldo pendiente de una factura PPD (total menos complementos de pago vigentes o en timbrado); null en las demás.
Example:
160
Solo en complementos de pago (type P): el pago y las facturas que liquida.
Show child attributes
Show child attributes
Solo si hay advertencias de la lista 69-B del SAT (receptor Presunto). Un replay por idempotencyKey no las recalcula.
Show child attributes
Show child attributes