Documentación

Cómo se usan los endpoints principales

Elige un endpoint abajo para ver la llamada real y la respuesta que recibe tu backend — la misma forma en la que corre en producción.

Auth: Bearer <API_KEY> · Límite: 60 req/min

El flujo completo, de principio a fin

Así viaja un CFDI desde que conectas tu credencial hasta que llega a tu aplicación — NodoCFDI es el puente entre el SAT y tu backend.

GET /v1/cfdis?rfc=GARC850312AB1&tipo=I

El endpoint más usado: trae metadata ya parseada de tus CFDIs, con filtros por RFC, tipo y estatus — sin tocar el XML crudo del SAT.

Request

curl /v1/cfdis?rfc=GARC850312AB1 \
  -H "Authorization: Bearer sk_live_••••••••"

200 OK

{
  "data": [
    {
      "uuid": "3fa2c1e0-9b7a-4e6d-8c2f-1a2b3c4d5e6f",
      "tipo_comprobante": "I",
      "total": 12500.00,
      "estatus_sat": "Vigente"
    }
  ],
  "meta": { "total": 1204 }
}

POST /v1/efirma

Da de alta la e.firma (.cer/.key) de un RFC. Se cifra en el momento de recibirla — nunca queda en texto plano, ni siquiera en tránsito.

Request

curl -X POST /v1/efirma \
  -H "Authorization: Bearer sk_live_••••••••" \
  -F "rfc=GARC850312AB1" \
  -F "cer=@efirma.cer" -F "key=@efirma.key" -F "password=••••••"

201 Created

{
  "data": {
    "rfc": "GARC850312AB1",
    "vigencia": "2027-03-12",
    "estatus": "conectada"
  }
}

GET /v1/cfdis/{uuid}/pdf

El PDF original del comprobante, generado bajo demanda — no ocupa tu cuota de XML almacenados.

Request

curl /v1/cfdis/3fa2c1e0.../pdf \
  -H "Authorization: Bearer sk_live_••••••••" \
  -o factura.pdf

200 OK

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Length: 86417
Content-Disposition: attachment;
  filename="3fa2c1e0.pdf"

GET /v1/69b/{rfc}

Consulta si un RFC está en la lista de operaciones simuladas del SAT, sin salir de tu flujo de validación de proveedores.

Request

curl /v1/69b/GARC850312AB1 \
  -H "Authorization: Bearer sk_live_••••••••"

200 OK

{
  "data": {
    "rfc": "GARC850312AB1",
    "en_lista_69b": false,
    "consultado_en": "2026-09-11T10:32:00Z"
  }
}

Estos son 4 de los 16 endpoints, en 7 grupos. El resto — RFCs, cancelaciones, verificación 69-B completa, documentos fiscales — vive en el catálogo completo.

Ver los 16 endpoints

Endpoints

16 endpoints, 7 grupos, una sola base URL

Documentación estilo Postman incluida: cada endpoint trae parámetros, respuesta de ejemplo y snippet en cURL, PHP, Python, JavaScript, .NET y Java.

Auth: Bearer <API_KEY> · Límite: 60 req/min

10 GET · 6 POST

CFDIs

Metadata paginada, XML, PDF o un ZIP de hasta 200 CFDIs por llamada.

GET/v1/cfdis
POST/v1/cfdis/zip
GET/v1/cfdis/{uuid}/xml
GET/v1/cfdis/{uuid}/pdf

RFCs

Lista tus RFCs, pausa o reanuda su descarga diaria y revisa el estatus de sincronización.

GET/v1/rfcs
POST/v1/rfcs/{rfc}/pausar
POST/v1/rfcs/{rfc}/reanudar
GET/v1/rfcs/{rfc}/sincronizacion

e.firma

Sube .cer y .key: se valida que sea FIEL y que coincida con el RFC, y se guarda cifrada.

POST/v1/efirma

Documentos

Pide la Opinión de Cumplimiento (32-D) o la Constancia de Situación Fiscal: responde 202, haces polling y descargas el PDF.

POST/v1/documentos/opinion
POST/v1/documentos/csf
GET/v1/documentos/{id}
GET/v1/documentos/{id}/pdf

Cuenta

Confirma tu API key y revisa tu licencia, su vigencia y el uso de tu cuota de XML.

GET/v1/me

Cancelaciones

Estatus, fechas, motivo y acuses de cada proceso de cancelación.

GET/v1/cancelaciones

Lista 69-B

Consulta si un RFC está en la Lista 69-B y cuántas de tus contrapartes también lo están.

GET/v1/69b/{rfc}