#Preview del año en curso

Devuelve una estimación del desempeño del ejercicio en curso (año a la fecha, YTD) de una Fiscal Entity, agregada a partir de sus CFDIs. Sirve para comparar el año en progreso contra las declaraciones anuales ya presentadas.

#Estimación del año en curso

GET/cfdi/annual-preview

Parámetro (query)	Tipo	Descripción
`fiscalEntityId`	string	Requerido. Identificador de la `FiscalEntity` (`fe_…`).
`year`	integer	Opcional. Ejercicio a estimar; por defecto, el año calendario actual.

curl "https://api.clarisfy.com/v1/cfdi/annual-preview?fiscalEntityId=fe_9a1c2b3d4e5f6071" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "fiscal_entity_id": "fe_9a1c2b3d4e5f6071",
  "year": 2026,
  "as_of_month": 6,
  "ingresos": "1250000.00000000",
  "costos": "430000.00000000",
  "utilidad_estimada": "820000.00000000",
  "disclaimer": "Estimación derivada de tus CFDIs a la fecha; no es tu declaración anual ni tu utilidad fiscal."
}

Campo	Tipo	Descripción
`fiscal_entity_id`	string	La `FiscalEntity` estimada (`fe_…`).
`year`	integer	Ejercicio estimado.
`as_of_month`	integer	Último mes (1–12) del año con CFDIs; `0` si aún no hay datos.
`ingresos`	string	Σ de ingresos (CFDIs emitidos tipo `I` vigentes) de los meses transcurridos. NUMERIC como string.
`costos`	string	Σ de costos (CFDIs recibidos tipo `E` vigentes). NUMERIC como string.
`utilidad_estimada`	string	`ingresos − costos` (proxy bruto de utilidad, no utilidad fiscal).
`disclaimer`	string	Recordatorio de que es una estimación de CFDIs, no tu declaración.

400 si el fiscalEntityId es inválido.
403 si llamas con una API key de un plan no-Enterprise.
404 si tu organización no tiene una conexión activa a esa Fiscal Entity.