Create Invoice

Create and stamp a CFDI 4.0 invoice via the configured PAC

curl --request POST \
  --url https://api.timbrix.mx/invoices \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "series": "A",
  "folioNumber": "1",
  "date": "2026-07-30T22:50:00",
  "paymentForm": "01",
  "use": "G03",
  "items": [
    {
      "quantity": 1,
      "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
        }
      ]
    }
  ],
  "type": "I",
  "paymentMethod": "PUE",
  "currency": "MXN",
  "exchange": 1,
  "export": "01",
  "customerId": "<string>",
  "idempotencyKey": "order-8421-attempt-1"
}
'

import requests

url = "https://api.timbrix.mx/invoices"

payload = {
    "series": "A",
    "folioNumber": "1",
    "date": "2026-07-30T22:50:00",
    "paymentForm": "01",
    "use": "G03",
    "items": [
        {
            "quantity": 1,
            "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
                }
            ]
        }
    ],
    "type": "I",
    "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',
    paymentForm: '01',
    use: 'G03',
    items: [
      {
        quantity: 1,
        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}]
      }
    ],
    type: 'I',
    paymentMethod: 'PUE',
    currency: 'MXN',
    exchange: 1,
    export: '01',
    customerId: '<string>',
    idempotencyKey: 'order-8421-attempt-1'
  })
};

fetch('https://api.timbrix.mx/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.timbrix.mx/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([
    'series' => 'A',
    'folioNumber' => '1',
    'date' => '2026-07-30T22:50:00',
    'paymentForm' => '01',
    'use' => 'G03',
    'items' => [
        [
                'quantity' => 1,
                '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
                                ]
                ]
        ]
    ],
    'type' => 'I',
    '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/invoices"

	payload := strings.NewReader("{\n  \"series\": \"A\",\n  \"folioNumber\": \"1\",\n  \"date\": \"2026-07-30T22:50:00\",\n  \"paymentForm\": \"01\",\n  \"use\": \"G03\",\n  \"items\": [\n    {\n      \"quantity\": 1,\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        }\n      ]\n    }\n  ],\n  \"type\": \"I\",\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/invoices")
  .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  \"paymentForm\": \"01\",\n  \"use\": \"G03\",\n  \"items\": [\n    {\n      \"quantity\": 1,\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        }\n      ]\n    }\n  ],\n  \"type\": \"I\",\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/invoices")

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  \"paymentForm\": \"01\",\n  \"use\": \"G03\",\n  \"items\": [\n    {\n      \"quantity\": 1,\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        }\n      ]\n    }\n  ],\n  \"type\": \"I\",\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": "valid",
  "series": "A",
  "folioNumber": "1",
  "total": 116,
  "date": "2026-07-30T22:50:00",
  "xml": "<string>",
  "createdAt": "2026-07-30T22:50:03.412Z"
}

POST

invoices

Create and stamp a CFDI 4.0 invoice via the configured PAC

curl --request POST \
  --url https://api.timbrix.mx/invoices \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "series": "A",
  "folioNumber": "1",
  "date": "2026-07-30T22:50:00",
  "paymentForm": "01",
  "use": "G03",
  "items": [
    {
      "quantity": 1,
      "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
        }
      ]
    }
  ],
  "type": "I",
  "paymentMethod": "PUE",
  "currency": "MXN",
  "exchange": 1,
  "export": "01",
  "customerId": "<string>",
  "idempotencyKey": "order-8421-attempt-1"
}
'

import requests

url = "https://api.timbrix.mx/invoices"

payload = {
    "series": "A",
    "folioNumber": "1",
    "date": "2026-07-30T22:50:00",
    "paymentForm": "01",
    "use": "G03",
    "items": [
        {
            "quantity": 1,
            "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
                }
            ]
        }
    ],
    "type": "I",
    "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',
    paymentForm: '01',
    use: 'G03',
    items: [
      {
        quantity: 1,
        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}]
      }
    ],
    type: 'I',
    paymentMethod: 'PUE',
    currency: 'MXN',
    exchange: 1,
    export: '01',
    customerId: '<string>',
    idempotencyKey: 'order-8421-attempt-1'
  })
};

fetch('https://api.timbrix.mx/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.timbrix.mx/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([
    'series' => 'A',
    'folioNumber' => '1',
    'date' => '2026-07-30T22:50:00',
    'paymentForm' => '01',
    'use' => 'G03',
    'items' => [
        [
                'quantity' => 1,
                '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
                                ]
                ]
        ]
    ],
    'type' => 'I',
    '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/invoices"

	payload := strings.NewReader("{\n  \"series\": \"A\",\n  \"folioNumber\": \"1\",\n  \"date\": \"2026-07-30T22:50:00\",\n  \"paymentForm\": \"01\",\n  \"use\": \"G03\",\n  \"items\": [\n    {\n      \"quantity\": 1,\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        }\n      ]\n    }\n  ],\n  \"type\": \"I\",\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/invoices")
  .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  \"paymentForm\": \"01\",\n  \"use\": \"G03\",\n  \"items\": [\n    {\n      \"quantity\": 1,\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        }\n      ]\n    }\n  ],\n  \"type\": \"I\",\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/invoices")

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  \"paymentForm\": \"01\",\n  \"use\": \"G03\",\n  \"items\": [\n    {\n      \"quantity\": 1,\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        }\n      ]\n    }\n  ],\n  \"type\": \"I\",\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": "valid",
  "series": "A",
  "folioNumber": "1",
  "total": 116,
  "date": "2026-07-30T22:50:00",
  "xml": "<string>",
  "createdAt": "2026-07-30T22:50:03.412Z"
}

Builds, validates, and stamps (timbra) a CFDI 4.0 invoice through the configured PAC (Proveedor Autorizado de Certificación) in a single call. On success, the invoice is fiscally valid at the SAT and is recorded in the organization’s invoice history.

Authentication

Requires an API key with the write:invoices scope, sent via the X-API-Key header. The issuing organization is resolved from the API key — there is no organizationId parameter anywhere in this request. The issuer’s RFC, legal name, régimen fiscal, and ZIP code are resolved from the organization’s fiscal profile (PUT /organizations/:organizationId/legal) — configure that before creating your first invoice, or this endpoint returns a 400. This endpoint does not accept Supabase Bearer tokens, since a logged-in user can belong to multiple organizations and the organization can’t be resolved unambiguously that way.

Request Body

Field	Type	Required	Description
`series`	string	Yes	Invoice series (e.g. `A`)
`folioNumber`	string	Yes	Invoice folio number
`date`	string	Yes	Issuance date-time (ISO 8601, no timezone)
`paymentForm`	string	Yes	SAT forma de pago catalog code
`use`	string	Yes	SAT uso CFDI catalog code
`customer`	object	One of*	Inline customer — see below
`customerId`	string	One of*	Existing customer ID (from the Customers resource)
`items`	array	Yes	Line items — see below
`type`	string	No	`I` (Ingreso), `E` (Egreso), or `T` (Traslado) — default: `I`
`paymentMethod`	string	No	`PUE` or `PPD` — default: `PUE`
`currency`	string	No	Currency code — default: `MXN`
`exchange`	number	No	Exchange rate — default: `1`
`export`	string	No	SAT clave de exportación — default: `01`
`idempotencyKey`	string	No	See Idempotency below

* Exactly one of customer or customerId is required — sending both, or neither, returns a 400. subtotal and total are not request fields — they’re computed automatically from items.

`customer` (inline)

Field	Type	Required	Description
`legalName`	string	Yes	Customer legal name
`taxId`	string	Yes	Customer RFC
`taxSystem`	string	No	SAT régimen fiscal code — required unless the customer is público en general
`zip`	string	No	Customer ZIP code

`items[]`

Field	Type	Required	Description
`quantity`	number	Yes	Quantity
`description`	string	Yes	Line item description
`unitPrice`	number	Yes	Unit price
`amount`	number	Yes	Line total (`quantity * unitPrice`)
`productKey`	string	Yes	SAT product/service key
`unitKey`	string	Yes	SAT unit key
`unit`	string	No	Unit label — defaults to `unitKey`
`taxObject`	string	No	SAT objeto de impuesto code — defaults based on `taxes`
`taxes[]`	array	No	Transferred tax lines — `type`, `factorType`, `rate`, `base`, `amount`

Business rules applied automatically

The issuer (RFC, legal name, régimen fiscal, ZIP) is resolved from organization_legal, matching how Facturapi resolves the issuer from the account profile instead of requiring it on every request.
base is required on every tax line in CFDI 4.0 — filled from the item’s amount if omitted.
subtotal/total are computed from items[].amount and items[].taxes[].amount.
Invoices to público en general (customer.taxId = XAXX010101000, customer.legalName = PUBLICO EN GENERAL, type = I) automatically get the SAT InformacionGlobal node and use = S01.
The customer’s RFC, régimen fiscal, and uso CFDI are validated against the SAT catalog compatibility matrix before stamping (see Create Customer for the same validation rules).

See docs/PAC_CFDI_CONTRACT.md in the repository for the internal payload contract this endpoint translates into before calling the PAC.

Idempotency

Stamping is not safe to blindly retry — if your request to POST /invoices times out, you can’t tell whether the CFDI was actually stamped at the SAT before the timeout. Pass a unique idempotencyKey (e.g. your own order ID) and retry with the same key: if an invoice was already created for your organization with that key, the existing invoice is returned instead of stamping a second one.

{
  "series": "A",
  "folioNumber": "1",
  "idempotencyKey": "order-8421",
  "...": "..."
}

Without an idempotencyKey, every request stamps a new CFDI — retries are your responsibility to avoid.

Example Request

curl -X POST https://api.timbrix.mx/invoices \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "series": "A",
    "folioNumber": "1",
    "date": "2026-07-30T15:50:00",
    "paymentForm": "01",
    "paymentMethod": "PUE",
    "use": "G03",
    "customerId": "590ce6c56d04f840aa8438af",
    "items": [
      {
        "quantity": 1,
        "description": "Servicio de consultoría",
        "unitPrice": 100,
        "amount": 100,
        "productKey": "84111506",
        "unitKey": "E48",
        "taxes": [
          {
            "type": "002",
            "factorType": "Tasa",
            "rate": "0.160000",
            "amount": 16
          }
        ]
      }
    ]
  }'

Example Response

{
  "id": "0f2a1c3e-1a2b-4c3d-9e8f-1234567890ab",
  "uuid": "d3bfbc57-44af-4390-a064-f0afab85e5df",
  "status": "valid",
  "series": "A",
  "folioNumber": "1",
  "total": 116,
  "date": "2026-07-30T15:50:00",
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><cfdi:Comprobante ...>",
  "createdAt": "2026-07-30T15:50:03.412Z"
}

Common Errors

400 Bad Request

Invalid or incomplete invoice payload, an issuing organization without complete fiscal data, sending both/neither customer and customerId, 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 timbrar.",
  "error": "BAD_REQUEST"
}

401 Unauthorized

Missing or invalid API key.

403 Forbidden

The API key does not have the write:invoices scope.

404 Not Found

customerId does not exist, or belongs to a different organization than the one owning the API key.

503 Service Unavailable

The PAC did not respond after automatic retries, or returned a transient error. Safe to retry.

Authorizations

X-API-Key

string

header

required

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

Body

application/json

series

string

required

Example:

"A"

folioNumber

string

required

Example:

"1"

date

string

required

Example:

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

paymentForm

string

required

SAT forma de pago catalog code

Example:

"01"

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"

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

string

required

Timbrix invoice record ID

Example:

"0f2a1c3e-1a2b-4c3d-9e8f-1234567890ab"

uuid

string

required

Folio fiscal UUID asignado por el SAT vía PAC

Example:

"d3bfbc57-44af-4390-a064-f0afab85e5df"

status

enum<string>

required

Available options:

valid

Example:

"valid"

series

string

required

Example:

"A"

folioNumber

string

required

Example:

"1"

total

number

required

Example:

116

date

string

required

Example:

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

xml

string

required

XML del CFDI timbrado (UTF-8)

createdAt

string

required

Example:

"2026-07-30T22:50:03.412Z"

SAT Catalogs List Products

API documentation

Organizations

Members

Invites

Auth

OAuth

Customers

SAT Catalogs

Invoices

Products

Users

Webhooks

API Keys

Authentication

Request Body

`customer` (inline)

`items[]`

Business rules applied automatically

Idempotency

Example Request

Example Response

Common Errors

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

503 Service Unavailable

Authorizations

Body

Response

​Authentication

​Request Body

​customer (inline)

​items[]

​Business rules applied automatically

​Idempotency

​Example Request

​Example Response

​Common Errors

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

​503 Service Unavailable

Authorizations

Body

Response

Authentication

Request Body

`customer` (inline)

`items[]`

Business rules applied automatically

Idempotency

Example Request

Example Response

Common Errors

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

503 Service Unavailable