ClarisfyDocsDaaS API

#Conecta un RFC y consulta sus CFDIs

Esta guía te lleva de cero a leer los CFDIs de un contribuyente: conectas el RFC en el Panel y luego lo consultas desde la API.

#Antes de empezar

  • Una organización con plan API activo.
  • Un par API key + secret (clf_{env}_key_… / clf_{env}_secret_…, entorno live o test). Ver Autenticación.
  • La CIEC del contribuyente que vas a conectar.

#Paso 1 — Conecta el RFC en el Panel

La conexión inicial (que requiere la CIEC) se hace en el Panel, no por API. Esto mantiene la CIEC fuera de tu código.

  1. Entra al Panel y abre Fiscal Entities → Conectar RFC.
  2. Captura el RFC y la CIEC del contribuyente.
  3. Clarisfy valida la conexión con el SAT y crea la FiscalEntity.

#Paso 2 — Encuentra el id de la FiscalEntity

Con la conexión lista, lista tus entidades y toma su id.

cURL
curl "https://api.clarisfy.com/api/v1/fiscal-entities?status=active" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

#Paso 3 — Espera la primera sincronización

La descarga inicial de CFDIs corre de forma asíncrona. Cuando termine recibirás el webhook cfdi.received, o puedes hacer polling al resumen mensual hasta que devuelva datos. Ver Webhooks.

#Paso 4 — Lee los CFDIs

Consulta los comprobantes emitidos del último semestre.

cURL
curl "https://api.clarisfy.com/api/v1/cfdi?fiscal_entity_id=fe_9a1c2b3d4e5f6071&direction=issued&from=2026-01-01&to=2026-06-30" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

#Paso 5 — Mantente al día

En vez de repetir la consulta, suscríbete a cfdi.received y cfdi.canceled para reaccionar en tiempo casi real. Así proteges el flujo de caja: una factura cancelada que ya cobraste rompe tu conciliación, y quieres enterarte hoy, no a fin de mes.

#Listo

Ya conectaste un RFC y leíste sus CFDIs. Sigue con: