#CFDI

Consulta los CFDIs (facturas) de una FiscalEntity, tanto emitidos como recibidos, y sus resúmenes agregados por periodo.

#El objeto CFDI

Campo	Tipo	Descripción
`uuid`	string	Folio fiscal (UUID) que asigna el SAT.
`fiscal_entity_id`	string	`FiscalEntity` dueña del comprobante.
`direction`	string	`issued` (emitido) o `received` (recibido).
`cfdi_type`	string	Tipo: `I`, `E`, `N`, `P`, `T`. Ver Conceptos.
`version`	string	Versión del CFDI (`3.3` o `4.0`).
`issuer_rfc`	string	RFC del emisor.
`receiver_rfc`	string	RFC del receptor.
`total`	string	Total del comprobante, decimal en string.
`currency`	string	Moneda ISO 4217 (`MXN`, `USD`).
`status`	string	`valid` o `canceled`.
`issued_at`	string	Fecha de emisión (ISO 8601).

#Lista de CFDIs

GET/cfdi

#Parámetros de query

Parámetro	Tipo	Descripción
`fiscal_entity_id`	string	Requerido. RFC a consultar (`fe_…`).
`direction`	string	`issued` o `received`. Sin valor, ambos.
`cfdi_type`	string	Filtra por tipo (`I`, `E`, `N`, `P`, `T`).
`status`	string	`valid` o `canceled`.
`from`	string	Fecha inicial (ISO 8601). Ventana máxima de 24 meses.
`to`	string	Fecha final (ISO 8601).
`limit`	integer	Resultados por página (1–100, por defecto 25).
`cursor`	string	Cursor de paginación.

#Ejemplo

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"

{
  "data": [
    {
      "uuid": "5f2c1a9b-8d3e-4a70-b1c2-9e8f7a6b5c4d",
      "fiscal_entity_id": "fe_9a1c2b3d4e5f6071",
      "direction": "issued",
      "cfdi_type": "I",
      "version": "4.0",
      "issuer_rfc": "GACJ850315AB1",
      "receiver_rfc": "XAXX010101000",
      "total": "18560.00",
      "currency": "MXN",
      "status": "valid",
      "issued_at": "2026-05-14T11:05:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJvIjoyNX0"
}

#Resumen mensual

GET/cfdi/summary/monthly

Devuelve totales agregados por mes: monto emitido, recibido y conteo de comprobantes. Útil para dashboards sin descargar cada CFDI.

#Parámetros de query

Parámetro	Tipo	Descripción
`fiscal_entity_id`	string	Requerido. RFC a consultar.
`from`	string	Mes inicial (`2026-01`).
`to`	string	Mes final (`2026-06`).

{
  "data": [
    {
      "period": "2026-05",
      "issued_total": "142300.00",
      "received_total": "88120.50",
      "issued_count": 34,
      "received_count": 19,
      "currency": "MXN"
    }
  ]
}