Desarrolladores

Emite CFDI y consulta el SAT desde tu código

La misma API que usa la app de Clauhub: emite y cancela facturas, descarga tus comprobantes del SAT y revisa a tus proveedores en la lista 69-B. Con una llave de API o desde tus agentes de IA por MCP.

Obtén tu llave de API Leer la documentación

¿Algo a la medida? Habla con ventas →

POST /api/rpc/books/issuance/issue · Emitir un CFDI

curl https://clauhub.ai/api/rpc/books/issuance/issue \
  -H "x-api-key: $CLAUHUB_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "json": {
    "organizationId": "ORGANIZATION_ID",
    "fiscalEntityId": "FISCAL_ENTITY_ID",
    "kind": "mx.cfdi",
    "attemptId": "0b6f9c1e-6a2d-4f7e-9a51-2f0f6c8f3b10",
    "capture": {
      "invoiceType": "sale",
      "voucherType": "I",
      "paymentForm": "03",
      "paymentMethod": "PUE",
      "currency": "MXN",
      "currencyDecimals": 2,
      "exportation": "01",
      "receiver": {
        "rfc": "ICV060329BY0",
        "name": "INMOBILIARIA CVA",
        "receiverTaxPostalCode": "33826",
        "receiverTaxRegime": "601",
        "cfdiUsage": "G03"
      },
      "concepts": [
        {
          "productServiceCode": "81112100",
          "quantity": "1",
          "unitCode": "E48",
          "description": "Suscripción mensual",
          "unitPrice": "239.00",
          "taxObject": "02",
          "taxes": [
            {
              "type": "transfer",
              "tax": "002",
              "factorType": "Tasa",
              "taxRate": "0.160000"
            }
          ]
        }
      ]
    }
  }
}'

const capture = {
  "invoiceType": "sale",
  "voucherType": "I",
  "paymentForm": "03",
  "paymentMethod": "PUE",
  "currency": "MXN",
  "currencyDecimals": 2,
  "exportation": "01",
  "receiver": {
    "rfc": "ICV060329BY0",
    "name": "INMOBILIARIA CVA",
    "receiverTaxPostalCode": "33826",
    "receiverTaxRegime": "601",
    "cfdiUsage": "G03"
  },
  "concepts": [
    {
      "productServiceCode": "81112100",
      "quantity": "1",
      "unitCode": "E48",
      "description": "Suscripción mensual",
      "unitPrice": "239.00",
      "taxObject": "02",
      "taxes": [
        {
          "type": "transfer",
          "tax": "002",
          "factorType": "Tasa",
          "taxRate": "0.160000"
        }
      ]
    }
  ]
};

const response = await fetch("https://clauhub.ai/api/rpc/books/issuance/issue", {
  method: "POST",
  headers: {
    "x-api-key": process.env.CLAUHUB_API_KEY!,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    json: {
      organizationId: "ORGANIZATION_ID",
      fiscalEntityId: "FISCAL_ENTITY_ID",
      kind: "mx.cfdi",
      attemptId: "0b6f9c1e-6a2d-4f7e-9a51-2f0f6c8f3b10",
      capture,
    },
  }),
});
const { json: document } = await response.json();
document.state; // "queued"

{
  "json": {
    "id": "ISSUED_DOCUMENT_ID",
    "kind": "mx.cfdi",
    "state": "queued",
    "status": "stamping",
    "recipientTaxId": "ICV060329BY0",
    "recipientName": "INMOBILIARIA CVA",
    "total": "277.24",
    "currency": "MXN",
    "externalId": null,
    "error": null,
    "createdAt": "2026-10-25T17:04:12.000Z",
    "stampedAt": null
  },
  "meta": [
    [
      "date",
      "createdAt"
    ]
  ]
}

Una factura de ingreso con IVA al 16 %. Responde de inmediato con el documento en cola; el timbrado corre como trabajo y el estado pasa a emitido o rechazado.

Reenviar el mismo attemptId devuelve el mismo documento: nunca se emite dos veces.

Primeros pasos

Tu primera llamada en tres pasos.

Empieza con una vista previa: no guarda nada ni usa timbres.

01
Crea tu llave de API
Con tu cuenta de Clauhub, pide una llave. Se muestra una sola vez (ch_…); guárdala como CLAUHUB_API_KEY.
```
POST /api/rpc/identity/apiKeys/create
→ "key": "ch_…"
```
Cómo crear una llave →Crear cuenta →
02
Haz tu primera llamada
Previsualiza un CFDI: te devuelve el documento, sus totales y avisos. No guarda nada, no toma folio y no usa timbres.
```
POST /api/rpc/books/issuance/preview
→ "totals": { "total": "277.24", … }
```
Formato de una llamada →
03
Emite y revisa el estado
Emite con un attemptId y consulta el documento: pasa de en cola a emitido, con su UUID, o a rechazado con el motivo.
```
POST /api/rpc/books/issuance/get
→ "state": "issued"
```
Ver la documentación →

Qué puedes hacer

Facturación y SAT, por API.

Facturación CFDI

Emite CFDI 4.0 con sus complementos

Previsualiza sin guardar nada, emite con un attemptId que evita duplicados, consulta el estado del timbrado, cancela, descarga el XML y el PDF o envíalo por correo. Cada timbre usa créditos de tu saldo.

POST /api/rpc/books/issuance/preview
POST /api/rpc/books/issuance/issue
POST /api/rpc/books/issuance/cancel
POST /api/rpc/books/issuance/download

Descarga del SAT

Trae tus comprobantes emitidos y recibidos

Pide un mes (o algunos días) de CFDI emitidos o recibidos, o sus metadatos, con tu e.firma guardada. Se registra como trabajo al instante; también puedes pedir un comprobante por su UUID.

POST /api/rpc/books/sync/request
POST /api/rpc/books/sync/requestDocument
POST /api/rpc/books/sync/get

Listas 69-B y 69

Revisa RFC contra las listas del SAT

Consulta si un RFC aparece en la lista 69-B o 69 según la última sincronización diaria, mira qué proveedores de tus facturas aparecen y verifica tus CFDI con el SAT, uno, hasta 500 o todos a la vez.

POST /api/rpc/books/mx/lists/lookup
POST /api/rpc/books/mx/lists/matches
POST /api/rpc/books/mx/verification/verify

POST /api/rpc/books/mx/lists/lookup · ¿Está este RFC en la lista 69-B?

curl https://clauhub.ai/api/rpc/books/mx/lists/lookup \
  -H "x-api-key: $CLAUHUB_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "json": {
    "organizationId": "ORGANIZATION_ID",
    "taxId": "ICV060329BY0"
  }
}'

const response = await fetch("https://clauhub.ai/api/rpc/books/mx/lists/lookup", {
  method: "POST",
  headers: {
    "x-api-key": process.env.CLAUHUB_API_KEY!,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    json: { organizationId: "ORGANIZATION_ID", taxId: "ICV060329BY0" },
  }),
});
const { json: result } = await response.json();
result.listed; // false

{
  "json": {
    "taxId": "ICV060329BY0",
    "listed": false,
    "entries": [],
    "syncedAt": "2026-10-25T06:00:00.000Z"
  },
  "meta": [
    [
      "date",
      "syncedAt"
    ]
  ]
}

Responde si está listado, en qué situación y cuándo se sincronizó la lista por última vez.

Y todo lo demás que hace la app: cada procedimiento que usan las personas está en la API y como herramienta MCP.

MCP

Conecta tus agentes de IA.

Un servidor MCP con las mismas operaciones que la API, para que tu asistente emita, consulte y revise por ti, con tus permisos.

URL del servidorhttps://clauhub.ai/api/mcp

Conectar por MCP

Solo con la URL

Tu cliente MCP descubre dónde iniciar sesión, se registra y te lleva a aceptar el acceso (OAuth con PKCE). La pantalla de consentimiento dice qué aplicación lo pide.

O con tu llave de API

Envíala como Authorization: Bearer ch_… y funciona igual que x-api-key.

Cada procedimiento, una herramienta

Herramientas con nombre, descripción y esquema de entrada, como books_issuance_issue. Cada llamada se hace como tú: cada servicio decide con tus permisos.

Seguridad

Tu llave actúa como tú, y nada más.

La llave (ch_…) se muestra una sola vez y se guarda solo como hash.
Actúa como su usuario: los mismos roles y permisos, revisados en el servidor en cada llamada.
Desactívala, vuelve a activarla o bórrala cuando quieras; una llave desactivada o borrada responde 401.
Crear una llave queda en la bitácora de auditoría.

Cómo protegemos tu información →

Precio

Pagas los timbres. Las llamadas vienen en tu plan.

$299.52

MXN + IVA por 100 timbres

($347.44 con IVA)

Un timbre por CFDI emitido, de tu saldo de créditos. Si el timbrado se rechaza, el crédito se libera.

Llamadas de API al mes

Free: 100,000
Team: 100,000
Business: Sin límite
Enterprise: Cotización

En Free y Team, las llamadas después del límite se pagan con créditos: 1 crédito por cada 100,000.

Ver tarifas y límites →

¿Comparando APIs de facturación?

Clauhub y Facturapi, fila por fila: tipos de CFDI, sandbox, webhooks, SDKs, descarga del SAT y precio por timbre.

Ver la comparación →

Empieza a construir.

Crea tu llave y haz tu primera llamada, o cuéntanos qué quieres conectar.

Obtén tu llave de API Habla con ventas