XML de Hacienda 4.4: qué cambió frente a la 4.3

Desde el 1 de septiembre de 2025, toda factura electrónica en Costa Rica se emite en la versión 4.4 del formato de Hacienda. Para quien emite fue un cambio de sistema; para quien recibe facturas el cambio pasó casi desapercibido, pero trae datos nuevos que sirven al declarar —y un par de trampas cuando se mezclan facturas viejas y nuevas.

Esta guía resume qué cambió entre la 4.3 y la 4.4, separado entre lo que le importa a quien recibe y lo que le toca a quien emite.

Desde cuándo rige la 4.4

La resolución MH-DGT-RES-0027-2024 definió el formato. Las dos versiones convivieron desde el 1 de abril de 2025, y Hacienda extendió el plazo de adopción hasta el 1 de septiembre de 2025: desde esa fecha solo se acepta la 4.4.

Las facturas emitidas antes siguen siendo válidas en la versión en que se hicieron. Si trabajás con meses de 2025 —o importás el histórico de una empresa— vas a tener las dos versiones mezcladas, y cualquier herramienta que las lea tiene que entender ambas.

Lo que cambia para quien recibe la factura

• SINPE Móvil aparece como medio de pago. En la 4.3 se podían marcar hasta cuatro medios, pero solo con su código —efectivo, tarjeta, cheque, transferencia, recaudado por terceros u otros— y sin decir cuánto se pagó con cada uno. En la 4.4 cada medio es un bloque con el tipo y el monto (TipoMedioPago y TotalMedioPago), y se agregan 06 SINPE Móvil y 07 plataforma digital. Una factura pagada mitad en efectivo y mitad por SINPE ahora dice cuánto fue por cada lado.
• Tu actividad económica puede venir en la factura. El campo nuevo CodigoActividadReceptor lleva el código de actividad de quien compra. El propio esquema lo describe para cuando hace falta respaldar un crédito fiscal o un gasto deducible, así que conviene darle tu código al proveedor junto con tu cédula.
• Dos tipos de identificación nuevos. El receptor puede ser 05 extranjero no domiciliado o 06 no contribuyente, dentro del mismo campo de identificación. El campo aparte que usaba la 4.3 para extranjeros (IdentificacionExtranjero) desaparece. Más detalle en la guía de tipos de identificación.
• Dos tarifas de IVA nuevas que dan cero. El código de tarifa pasa a llamarse CodigoTarifaIVA y suma el 10 (tarifa exenta) y el 11 (0% sin derecho a crédito). En la 4.3, lo exento se marcaba con el 01; en la 4.4 el 01 queda solo para la tarifa cero. Por qué esos ceros no se pueden sumar está en la guía de códigos de tarifa.

El resumen trae el IVA desglosado por tarifa

Al final de cada comprobante, el resumen de la 4.4 suma un bloque nuevo, TotalDesgloseImpuesto, con el impuesto total por código y por tarifa: cuánto IVA al 13%, cuánto al 4%, y así. En la 4.3 ese desglose solo se podía armar recorriendo línea por línea.

Es justo lo que pide el D-104, que separa las compras y las ventas por tarifa. También aparecen totales para lo no sujeto (TotalServNoSujeto, TotalMercNoSujeta, TotalNoSujeto), que en la 4.3 no tenían campo propio.

Lo que cambia para quien emite

Esto lo resuelve el sistema de facturación, pero ayuda a entender por qué algunos proveedores tardaron en migrar:

• El sistema de facturación se identifica. El campo obligatorio ProveedorSistemas lleva la cédula de la empresa que provee el sistema con el que se emite.
• La actividad del emisor cambia de nombre: CodigoActividad pasa a CodigoActividadEmisor, al lado del nuevo del receptor.
• El código CABYS tiene su propio campo, CodigoCABYS, de 13 dígitos. En la 4.3 iba en un campo genérico llamado Codigo.
• Cambian las condiciones de venta. Salen la 09 (pago del servicio prestado al Estado) y la 11 (pago de venta a crédito en IVA hasta 90 días), y entran la 12 mercancía no nacionalizada, la 13 bienes usados de un no contribuyente, la 14 arrendamiento operativo y la 15 arrendamiento financiero. Para la 99 (otros) hay un campo nuevo que dice cuál.
• Combos y paquetes. Un producto que es la suma de otros (un combo, una canasta) puede detallar sus componentes en DetalleSurtido, cada uno con su CABYS y su impuesto.
• Tipo de transacción por línea (TipoTransaccion): venta normal, autoconsumo, bienes de capital, entre otros.
• El fax desaparece de los datos de contacto.

Los cambios en una tabla

Cuando se mezclan facturas de las dos versiones

Los mismos datos viven en campos con nombres distintos según la versión, así que una planilla o una macro hecha para la 4.3 deja columnas vacías con una factura 4.4 —la actividad, el CABYS, la tarifa— sin avisar. El error típico es una columna de código de actividad en blanco justo en los meses en que el proveedor migró.

Inbox Factura lee las dos versiones y lleva cada dato a la misma columna: la actividad del emisor sale del campo que corresponda, la tarifa se lee con su código de cualquiera de las dos, y la identificación del receptor se toma del lugar donde la puso cada versión. Al pasar las facturas a Excel, un mes con facturas viejas y nuevas sale con las mismas columnas.