#Estimaciones fiscales (ISR e IVA)

Estos endpoints estiman tu pago provisional de ISR y tu posición de IVA de un periodo a partir de los CFDIs de una Fiscal Entity. Cuelgan de https://api.clarisfy.com/v1/cfdi/ y son tenant-gated: tu organización debe tener una conexión activa al RFC (fiscalEntityId), o el endpoint responde 404.

Los montos son NUMERIC serializados como string.

#Pago provisional de ISR

GET/cfdi/tax/isr-provisional

Estima el pago provisional de ISR acumulado y el del periodo con la estructura del Art. 14 de la LISR, usando tu coeficiente de utilidad declarado (tomado de tu Declaración Anual) y tus ingresos nominales acumulados hasta el mes consultado. La tasa aplicada es 30% (persona moral).

Supuestos explícitos: no descuenta los pagos provisionales que ya presentaste (no los tenemos), ni amortiza pérdidas de ejercicios anteriores. Las retenciones de ISR se muestran solo como referencia, no se restan del estimado.

Parámetro (query)	Tipo	Descripción
`fiscalEntityId`	string	Requerido. Identificador de la `FiscalEntity` (`fe_…`).
`year`	integer	Requerido. Año del periodo.
`month`	integer	Requerido. Mes del periodo (1–12).

curl "https://api.clarisfy.com/v1/cfdi/tax/isr-provisional?fiscalEntityId=fe_9a1c2b3d4e5f6071&year=2026&month=6" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "fiscal_entity_id": "fe_9a1c2b3d4e5f6071",
  "year": 2026,
  "month": 6,
  "coeficiente_utilidad": "0.2155",
  "coeficiente_source_year": 2025,
  "ingresos_nominales_acumulados": "3100000.00",
  "utilidad_fiscal_estimada_acumulada": "668050.00",
  "ptu_pagada": "0.00",
  "retenciones_isr_acumuladas": "12400.00",
  "isr_causado_acumulado_estimado": "200415.00",
  "isr_provisional_periodo_estimado": "33200.00",
  "coeficiente_note": "Coeficiente de utilidad tomado de tu Declaración Anual (LISR Art. 14 fracc. I). Es tu dato declarado, no un cálculo de Clarisfy.",
  "nota_estimacion": "Estimación con la estructura del Art. 14 LISR; no descuenta pagos provisionales ya presentados ni pérdidas de ejercicios anteriores.",
  "disclaimer": "Estimación calculada sobre tus CFDIs; no es la cantidad a pagar ni tu declaración."
}

Campo	Tipo	Descripción
`coeficiente_utilidad`	string \| null	Coeficiente de utilidad declarado usado en la estimación. `null` si no hay declaración disponible.
`coeficiente_source_year`	integer \| null	Ejercicio de la Declaración Anual de donde se tomó el coeficiente.
`ingresos_nominales_acumulados`	string	Ingresos nominales acumulados de enero al mes consultado.
`utilidad_fiscal_estimada_acumulada`	string \| null	Utilidad fiscal estimada = ingresos acumulados × coeficiente. `null` si falta el coeficiente.
`ptu_pagada`	string	PTU pagada considerada (referencia).
`retenciones_isr_acumuladas`	string	Retenciones de ISR acumuladas. Solo referencia, no se restan del estimado.
`isr_causado_acumulado_estimado`	string \| null	ISR causado acumulado estimado (tasa 30%). `null` si falta el coeficiente.
`isr_provisional_periodo_estimado`	string \| null	Pago provisional estimado del periodo. `null` si falta el coeficiente.
`coeficiente_note`	string	Detalle sobre el origen del coeficiente.
`nota_estimacion`	string	Supuestos de la estimación.
`disclaimer`	string	Recordatorio de que es una estimación, no la cantidad a pagar.

#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`	`fiscalEntityId` malformado.
`404`	Tu organización no tiene conexión activa al RFC.

#Posición de IVA

GET/cfdi/tax/iva-position

Estima tu posición de IVA del periodo: el IVA trasladado (que cobras) menos el acreditable (que pagas) y el retenido, para saber si el mes te resulta a cargo o a favor.

Parámetro (query)	Tipo	Descripción
`fiscalEntityId`	string	Requerido. Identificador de la `FiscalEntity` (`fe_…`).
`year`	integer	Requerido. Año del periodo.
`month`	integer	Requerido. Mes del periodo (1–12).

curl "https://api.clarisfy.com/v1/cfdi/tax/iva-position?fiscalEntityId=fe_9a1c2b3d4e5f6071&year=2026&month=6" \
  -H "Authorization: Bearer clf_live_secret_9K3mZ1pQ7rTx8vB4nH6dLwYe"

{
  "iva_trasladado": "92800.00",
  "iva_acreditable": "49672.12",
  "iva_retenido": "1600.00",
  "iva_a_cargo_o_favor": "41527.88",
  "base": "devengado",
  "nota_base": "La posición se calcula sobre los CFDIs del mes (base devengado), no sobre cobros/pagos efectivos (flujo).",
  "disclaimer": "Estimación calculada sobre tus CFDIs; no es la cantidad a pagar ni tu declaración."
}

Campo	Tipo	Descripción
`iva_trasladado`	string	IVA trasladado (el que cobras en tus emitidas).
`iva_acreditable`	string	IVA acreditable (el que pagas en tus recibidas).
`iva_retenido`	string	IVA retenido declarado en los CFDIs.
`iva_a_cargo_o_favor`	string	Posición del periodo. Negativo ⇒ a favor; positivo ⇒ a cargo.
`base`	string	Siempre `"devengado"` — ver el callout.
`nota_base`	string	Aclaración de la base devengado vs. flujo.
`disclaimer`	string	Recordatorio de que es una estimación, no la cantidad a pagar.

#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`	`fiscalEntityId` malformado.
`404`	Tu organización no tiene conexión activa al RFC.