#Conciliación anual

Compara la suma de tus CFDIs del ejercicio contra las cifras de tu Declaración Anual presentada ante el SAT, para una Fiscal Entity. El resultado es un delta por lado (ingresos y deducciones) que sirve como observación, no como conclusión.

Los montos son NUMERIC serializados como string.

#Conciliación del ejercicio

GET/fiscal-entities/{fiscal_entity_id}/annual-reconciliation/{year}

#Parámetros de ruta

Parámetro	Tipo	Descripción
`fiscal_entity_id`	string	Identificador de la `FiscalEntity` (`fe_…`).
`year`	integer	Ejercicio fiscal a conciliar.

curl https://api.clarisfy.com/v1/fiscal-entities/fe_9a1c2b3d4e5f6071/annual-reconciliation/2025 \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "year": 2025,
  "cfdi_ingresos": "5810000.00",
  "cfdi_deducciones": "3690000.00",
  "declarado_ingresos_nominales": "5800000.00",
  "declarado_ingresos_acumulables": "5800000.00",
  "declarado_deducciones_autorizadas": "4400000.00",
  "delta_ingresos": "10000.00",
  "delta_ingresos_pct": "0.17",
  "delta_deducciones": "-710000.00",
  "delta_deducciones_pct": "-16.14",
  "notes": [
    "El delta de ingresos puede deberse a timing o a ingresos sin CFDI.",
    "cfdi_deducciones es costo de lo vendido (CFDIs de egreso), no el total de deducciones autorizadas fiscales."
  ],
  "source": {
    "document_id": "doc_01j9z3n8q7f2v6m4k1c0abcdef",
    "filename": "estados_financieros_2025.xlsx"
  },
  "disclaimer": "Comparativo entre tus CFDIs y tu Declaración Anual; el delta es una observación, no una conclusión ni consejo fiscal."
}

Campo	Tipo	Descripción
`year`	integer	Ejercicio conciliado.
`cfdi_ingresos`	string	Suma de los CFDIs de ingreso del ejercicio.
`cfdi_deducciones`	string	Suma de los CFDIs de egreso (COGS), no deducciones autorizadas fiscales.
`declarado_ingresos_nominales`	string \| null	Ingresos nominales de tu Declaración Anual. `null` si el renglón no está.
`declarado_ingresos_acumulables`	string \| null	Ingresos acumulables declarados. `null` si no está.
`declarado_deducciones_autorizadas`	string \| null	Deducciones autorizadas declaradas. `null` si no está.
`delta_ingresos`	string \| null	`cfdi_ingresos − declarado`. `null` si falta el declarado.
`delta_ingresos_pct`	string \| null	Delta de ingresos en %. `null` si no aplica.
`delta_deducciones`	string \| null	`cfdi_deducciones − declarado`. `null` si falta el declarado.
`delta_deducciones_pct`	string \| null	Delta de deducciones en %. `null` si no aplica.
`notes`	string[]	Notas contextuales sobre cómo leer los deltas.
`source.document_id`	string	Documento (Declaración Anual) del que se tomaron las cifras declaradas.
`source.filename`	string	Nombre del archivo fuente.
`disclaimer`	string	Recordatorio de que el delta es observación, no conclusión.

#Errores

Código HTTP	Causa
`202`	El reporte aún se está calculando. Cuerpo: `{"status":"computing","report_kind":"…","fiscal_entity_id":"fe_…","retry_after_seconds":15}`, más el header `Retry-After`. Reintenta después de los segundos indicados (`retry_after_seconds`).
`400`	`fiscal_entity_id` con formato inválido.
`404`	No hay Declaración Anual almacenada para ese año, o tu organización no tiene una conexión activa a esa Fiscal Entity.