#Declaración anual

Devuelve las cifras clave de la Declaración Anual de una Fiscal Entity, extraídas de los archivos que Clarisfy ya descargó del SAT. Incluye el balance, el estado de resultados y la conciliación contable-fiscal (con la utilidad fiscal del ejercicio) para el ejercicio actual y el anterior, más la Determinación del ISR del ejercicio actual (ingresos nominales, deducciones autorizadas) y el coeficiente de utilidad.

#Cifras de la declaración

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

#Parámetros de ruta

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

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

Cada cifra es un par { "current": …, "prior": … } (ejercicio actual y anterior), con los montos NUMERIC como string o null si el renglón no está en el archivo. Las cifras de utilidad/pérdida vienen con signo (una pérdida es negativa).

{
  "fiscal_entity_id": "fe_9a1c2b3d4e5f6071",
  "year": 2025,
  "prior_year": 2024,

  "utilidad_fiscal_del_ejercicio": { "current": "1250000.00", "prior": "900000.00" },
  "resultado_neto_contable": { "current": "1100000.00", "prior": "820000.00" },
  "resultado_fiscal": { "current": "1250000.00", "prior": "900000.00" },
  "ptu_pagada": { "current": "0.00", "prior": "0.00" },
  "amortizacion_perdidas_anteriores": { "current": "0.00", "prior": "0.00" },
  "total_ingresos_fiscales_no_contables": { "current": "0.00", "prior": "0.00" },
  "total_deducciones_contables_no_fiscales": { "current": "150000.00", "prior": "80000.00" },
  "total_deducciones_fiscales_no_contables": { "current": "0.00", "prior": "0.00" },
  "total_ingresos_contables_no_fiscales": { "current": "0.00", "prior": "0.00" },

  "ingresos_netos": { "current": "5800000.00", "prior": "4900000.00" },
  "utilidad_bruta": { "current": "2100000.00", "prior": "1700000.00" },
  "utilidad_operacion": { "current": "1400000.00", "prior": "1050000.00" },
  "impuestos_a_la_utilidad": { "current": "375000.00", "prior": "270000.00" },

  "total_activo": { "current": "8200000.00", "prior": "6900000.00" },
  "total_pasivo": { "current": "3100000.00", "prior": "2800000.00" },
  "total_capital": { "current": "5100000.00", "prior": "4100000.00" },

  "determinacion_isr": {
    "ingresos_nominales": "5800000.00",
    "ingresos_acumulables": "5800000.00",
    "deducciones_autorizadas": "4400000.00",
    "utilidad_fiscal_del_ejercicio": "1250000.00",
    "ptu_pagada": "0.00"
  },
  "coeficiente_utilidad": "0.2155",
  "coeficiente_utilidad_note": "Coeficiente de utilidad = utilidad fiscal ÷ ingresos nominales de tu Declaración Anual (LISR Art. 14 fracc. I). Es tu dato, presentado ante el SAT — no un cálculo ni asesoría fiscal de Clarisfy. Verifica con tu contador.",
  "source": {
    "document_id": "doc_01j9z3n8q7f2v6m4k1c0abcdef",
    "filename": "estados_financieros_2025.xlsx"
  },
  "disclaimer": "Datos tomados de tu Declaración Anual presentada ante el SAT; no es un cálculo ni una certificación de Clarisfy."
}

#Campos

Grupo	Campo	Descripción
—	`year` / `prior_year`	Ejercicio actual y anterior del archivo.
Conciliación contable-fiscal	`utilidad_fiscal_del_ejercicio`	Utilidad (o pérdida, con signo) fiscal del ejercicio.
	`resultado_neto_contable`	Utilidad/pérdida neta contable.
	`resultado_fiscal`	Resultado fiscal.
	`ptu_pagada`	PTU pagada en el ejercicio.
	`amortizacion_perdidas_anteriores`	Amortización de pérdidas de ejercicios anteriores.
	`total_ingresos_fiscales_no_contables`, `total_deducciones_contables_no_fiscales`, `total_deducciones_fiscales_no_contables`, `total_ingresos_contables_no_fiscales`	Los cuatro totales de la conciliación.
Estado de resultados	`ingresos_netos`, `utilidad_bruta`, `utilidad_operacion`, `impuestos_a_la_utilidad`	Cifras del estado de resultados.
Balance	`total_activo`, `total_pasivo`, `total_capital`	Totales del estado de situación financiera.
Determinación del ISR (`determinacion_isr`)	`ingresos_nominales`, `ingresos_acumulables`, `deducciones_autorizadas`, `utilidad_fiscal_del_ejercicio`, `ptu_pagada`	Cifras de la Determinación del ISR del ejercicio actual (valores simples, no pares). Objeto `null` si no hay declaración en PDF disponible para ese año.
—	`coeficiente_utilidad`	Coeficiente de utilidad (`utilidad fiscal ÷ ingresos nominales`, 4 decimales) o `null`. Ver el callout.

#Errores

Código HTTP	Causa
`400`	`fiscal_entity_id` con formato inválido.
`404`	No hay Declaración Anual para ese año, o tu organización no tiene una conexión activa a esa Fiscal Entity.