Exoneraciones Fiscales en Factura Electrónica de Costa Rica: Cómo Implementarlas Correctamente

Cuando usted implementa el módulo de exoneraciones en una plataforma de facturación electrónica para Costa Rica, el primer obstáculo no es el XML sino entender qué documentos de exoneración reconoce el Ministerio de Hacienda, en qué campo exacto se declara el tipo, y qué ocurre cuando el número de orden de exoneración vence entre la emisión y la transmisión. La versión 4.4 del XML de Hacienda amplió los tipos de exoneración reconocidos, pero la documentación oficial no siempre refleja los casos borde que aparecen en producción.

Esta guía explica cómo implementar correctamente las exoneraciones en la factura electrónica de Costa Rica v4.4: tipos de exoneración reconocidos por Hacienda, estructura del elemento Exoneracion en el XML, campos obligatorios por tipo, diferencias con tarifa cero y los errores más comunes al transmitir documentos con exoneración al ATV.

Qué es una exoneración fiscal en el contexto de la factura electrónica

Marco normativo: Ley 6826 y el IVA en Costa Rica

En Costa Rica, el Impuesto al Valor Agregado (IVA) está regulado por la Ley 6826 y sus reformas. La tarifa general es del 13%, pero la ley reconoce exoneraciones para determinados sectores, productos y sujetos, especialmente entidades públicas, organismos internacionales y empresas amparadas por régimenes especiales. Una exoneración no significa que el bien o servicio sea no sujeto al impuesto: significa que el comprador cuenta con un documento emitido por la autoridad competente que lo habilita a no pagar el IVA en esa transacción específica. Esa distinción es crítica para implementar el campo correcto en el XML y para que Hacienda acepte la factura sin inconsistencias.

Diferencia entre exoneración, no sujeto y tarifa reducida

Los tres conceptos generan errores de implementación frecuentes porque tienen consecuencias fiscales distintas: los bienes o servicios no sujetos al IVA no llevan impuesto ni requieren documento de exoneración (ejemplo: servicios de salud en ciertos supuestos). Los de tarifa reducida (1% o 4%) sí generan IVA pero a una tarifa inferior, y se declaran en el campo CodigoTarifa del XML sin necesidad del elemento Exoneracion. Las exoneraciones propiamente dichas sí generan un evento de exoneración documentado: el vendedor declara el código y número del documento de exoneración, y el IVA liquidado es cero aunque la tarifa del producto sea 13%. Mezclar estos tres tratamientos en el código produce facturas que Hacienda rechaza por inconsistencia entre tarifa declarada y monto de impuesto.

Tipos de documentos de exoneración reconocidos por Hacienda

Códigos de tipo de documento en el XML v4.4

El XML v4.4 define el campo CodigoTipoDocumento dentro del elemento Exoneracion con los siguientes valores posibles: 01 (Compras autorizadas), 02 (Ventas exentas a diplomáticos), 03 (Autorizaciones de la DGT), 04 (Exoneración de la DGA), 05 (Transitorio de la Ley del Impuesto sobre las Ventas), 06 (Autorización de la DGPYME), 07 (Otros). El código 01 es el más frecuente en transacciones con el sector público; corresponde a las órdenes de compra emitidas por instituciones del Estado costarricense que están exoneradas del IVA por disposición legal. Usar el código 07 (Otros) cuando existe un tipo específico es un error que no genera rechazo técnico inmediato pero sí inconsistencias en los reportes de Hacienda y potencial cuestionamiento en auditoría.

Órdenes de compra del sector público: el caso más frecuente

Las instituciones públicas en Costa Rica emiten órdenes de compra que incluyen un número de autorización de exoneración. Este número es el que el proveedor debe declarar en el campo NumeroDocumento del elemento Exoneracion. El número tiene una fecha de vencimiento: si la factura se emite después de que la orden ha vencido, Hacienda puede rechazarla. Para plataformas ISV que atienden a proveedores del sector público costarricense, se recomienda almacenar la fecha de vigencia del documento de exoneración al momento en que el usuario lo registra y advertir al operador cuando esté próximo a vencer, antes de que intente emitir una factura con él.

Estructura del elemento Exoneracion en el XML v4.4

Campos obligatorios y sus formatos

El elemento Exoneracion en el XML v4.4 de Hacienda requiere cuatro campos: CodigoTipoDocumento (código de dos dígitos según la tabla anterior), NumeroDocumento (el identificador del documento de exoneración tal como lo emitió la institución), NombreInstitucion (nombre de la entidad que emitió la exoneración, campo de texto libre) y FechaVencimiento (fecha hasta la que es válida la exoneración en formato ISO 8601 YYYY-MM-DD). Los cuatro campos son obligatorios cuando se declara el elemento; omitir cualquiera de ellos produce un error de validación de estructura antes de que Hacienda evalúe el contenido económico.

PorcentajeExoneracion y su impacto en el cálculo del IVA

El campo PorcentajeExoneracion define qué porcentaje del IVA está exonerado. Aunque la mayoría de los casos son exoneraciones totales (100%), la norma permite exoneraciones parciales. Cuando el porcentaje es 100, el monto de IVA de la línea debe ser cero. Cuando es parcial (por ejemplo 50%), el IVA debe calcularse sobre la fracción no exonerada: si el producto tiene tarifa 13% y la exoneración es del 50%, el IVA efectivo es 6.5% del valor de la línea. Un error común es declarar PorcentajeExoneracion igual a 100 pero calcular un IVA distinto de cero en el mismo ítem, lo que genera rechazo por inconsistencia entre el porcentaje declarado y el monto liquidado.

Errores frecuentes al transmitir facturas con exoneración al ATV

Número de orden vencido o inválido

El error más frecuente en producción es transmitir una factura con una exoneración cuya FechaVencimiento ya pasó en la fecha de emisión. Hacienda rechaza el documento con un mensaje de exoneración inválida. Desde el lado del ISV, la validación preventiva debe comparar FechaVencimiento con la fecha de emisión de la factura (IssueDate) antes de llamar al ATV; si la exoneración está vencida, el flujo debe bloquear la emisión y solicitar al usuario que actualice el documento. Adicionalmente, algunos números de autorización del sector público tienen formato específico (por ejemplo, incluyen código de institución y año); la validación de formato es otro punto de intervención útil antes de la transmisión.

Inconsistencia entre porcentaje de exoneración y monto de IVA

El segundo error más común ocurre cuando el código de cálculo aplica la tarifa general (13%) aunque el ítem tenga exoneración del 100%, o cuando aplica tarifa cero sin declarar el elemento Exoneracion. Hacienda calcula el impuesto esperado basándose en el porcentaje declarado y la tarifa del producto; si el monto real difiere, rechaza el documento. Para evitarlo, la lógica de cálculo de IVA debe recibir como parámetro el porcentaje de exoneración y multiplicarlo correctamente: IVA efectivo = base imponible × tarifa del producto × (1 - PorcentajeExoneracion / 100).

Arquitectura de validación de exoneraciones para ISVs

Capa de validación previa antes de llamar al ATV

Se recomienda implementar una capa de validación de exoneración antes de construir el XML: verificar que CodigoTipoDocumento esté en la lista de valores válidos, que FechaVencimiento sea posterior o igual a la fecha de emisión de la factura, que PorcentajeExoneracion esté entre 1 y 100, y que el cálculo de IVA en la línea sea consistente con la tarifa y el porcentaje de exoneración. Esta capa puede ser un servicio interno o delegarse a la capa de la API del proveedor. Para implementaciones que requieran soporte técnico especializado en el mercado costarricense, la solución de facturación electrónica de Alanube para Costa Rica incluye validación de estructura de exoneración antes de la transmisión al ATV.

Exoneraciones parciales en facturas con líneas mixtas

Cuando una factura tiene líneas gravadas y líneas exoneradas, cada línea debe declarar su propio elemento Exoneracion (o no declararlo si está gravada). No existe un elemento de exoneración a nivel de cabecera que aplique globalmente a todas las líneas. El error de aplicar la exoneración a nivel de cabecera y asumir que cubre todas las líneas está documentado en varios rechazos de producción donde el IVA total de la factura no cuadra con la suma de los IVA por línea. Para plataformas que manejan facturación a entes públicos con pedidos mixtos (algunos ítems exonerados, otros no), la interfaz del usuario debe permitir asignar el documento de exoneración línea por línea, no solo a nivel del pedido completo.

Preguntas frecuentes