Si tenés un negocio en Costa Rica y emitís facturas electrónicas, el XML v4.4 ya es obligatorio. Hacienda lo implementó en septiembre de 2025 y los sistemas que no migraron están generando comprobantes que el receptor técnico rechaza automáticamente.
Esta guía te explica qué cambió, qué tenés que hacer y cómo evitar los errores más comunes.
¿Qué es el XML v4.4 y por qué importa?
El XML v4.4 (también llamado XSD v4.4) es la versión actual del formato técnico que define cómo se estructura un comprobante electrónico en Costa Rica. Es el estándar oficial del Ministerio de Hacienda y toda factura, tiquete o nota de crédito debe cumplirlo para ser válida.
Hacienda recibe el comprobante, lo valida contra el XSD y responde con una de dos cosas:
- Aceptado: el comprobante es válido y tiene valor legal
- Rechazado: el comprobante tiene errores de formato y no tiene valor fiscal
Un comprobante rechazado no sirve para nada. No podés deducirlo, no podés usarlo como respaldo de venta, y si tu cliente lo recibió también queda inválido.
¿Qué cambió del v4.3 al v4.4?
Los cambios más importantes entre la versión anterior y la actual son:
1. Reestructuración de actividades económicas
Las actividades económicas ahora deben corresponder exactamente al código CIIU que tiene registrado el contribuyente en el Registro de Contribuyentes de Hacienda. Antes había más tolerancia en este campo; ahora la validación es estricta.
2. Nuevos campos obligatorios para el receptor
El bloque del receptor (quien recibe la factura) ahora requiere el nombre completo o razón social y el correo electrónico cuando el receptor es contribuyente. Los comprobantes con este bloque incompleto se rechazan.
3. Cambios en el cálculo de impuestos
La estructura del bloque de impuestos cambió para soportar los diferentes regímenes de IVA (13%, 4%, 2%, 1% y exento) de forma más explícita. Cada línea debe especificar claramente su tarifa y su base imponible.
4. Nuevos tipos de documento
Se agregaron tipos de comprobante para operaciones específicas, incluyendo documentos para el régimen de tributación simplificada y para servicios importados digitales.
5. Validación de la clave numérica
La clave de 50 dígitos ahora tiene validaciones adicionales. Cualquier clave que no cumpla el formato exacto genera rechazo inmediato.
¿Cómo saber si tu sistema ya está en v4.4?
Hay tres formas de verificarlo:
1. Consultá el XML del último comprobante emitido
Todo software de facturación te permite descargar el XML del comprobante. Abrilo con un editor de texto (Bloc de notas en Windows) y buscá la línea que dice xmlns. Si ves FacturaElectronica_V4.4, estás en la versión correcta.
2. Preguntale directamente a tu proveedor de software Si usás Alegra, Arca, Facturador Gratuito de Hacienda u otro sistema, preguntales directamente qué versión del XSD están usando. Es una pregunta directa con respuesta directa.
3. Revisá tu historial en ATV de Hacienda En el portal ATV (Administración Tributaria Virtual), podés ver el estado de tus últimos comprobantes. Si ves documentos en estado “Rechazado”, es una señal clara de que algo está mal.
Los errores más comunes al migrar
Después de trabajar con varios negocios en la migración al v4.4, estos son los errores que aparecen más seguido:
Error 1: Actividad económica incorrecta
El código de actividad que tenés en el sistema no coincide con el que registró Hacienda para tu cédula. La solución: consultá en ATV cuál es tu actividad económica registrada y actualizala en tu sistema.
Error 2: Receptor sin datos completos
La factura tiene el campo de receptor vacío o con datos incompletos. Cuando le facturás a otro contribuyente (no consumidor final), debés tener su cédula, nombre y correo.
Error 3: Secuencia de consecutivos rota
El número consecutivo de la factura debe ser secuencial sin saltos. Si tu sistema tuvo un error y saltó un número, los siguientes comprobantes pueden rechazarse.
Error 4: Clave numérica de 52 dígitos
Algunos sistemas viejos generaban claves de 52 dígitos en lugar de 50. El v4.4 es estricto en esto: 50 dígitos exactos o el comprobante se rechaza.
Error 5: IVA mal asignado por tarifa
Mezclar tarifas de IVA (13% y 4% por ejemplo) en el mismo bloque sin distinguirlas correctamente. Cada tarifa debe ir en su propio bloque de impuesto.
¿Qué hacer si tenés comprobantes rechazados?
Los comprobantes rechazados no se pueden “recuperar” — son inválidos. Pero podés emitir nuevos comprobantes corrigiendo los errores, siempre y cuando el período fiscal esté abierto.
Si descubrís que llevás meses emitiendo comprobantes inválidos, lo más importante es:
- Dejar de emitir con el sistema viejo inmediatamente
- Migrar o cambiar el sistema al v4.4
- Evaluar el impacto fiscal: qué ventas no tienen respaldo válido
- Si el impacto es significativo, consultar con un contador antes de tomar acciones
¿El Facturador Gratuito de Hacienda ya está en v4.4?
Sí. El Facturador Gratuito de Contribuyentes que ofrece Hacienda directamente en su portal ya está actualizado al v4.4. Si no querés pagar por un sistema de facturación, es una opción válida para volúmenes bajos (menos de 50 facturas al mes).
La limitación del Facturador Gratuito es que no tiene integración con sistemas de inventario, no genera reportes automáticos y el proceso de emisión es más manual que en sistemas pagos.
¿Cuánto cuesta actualizar el sistema?
Depende del sistema que usés:
- Facturador Gratuito de Hacienda: sin costo, ya actualizado
- Alegra CR: actualización automática, incluida en la suscripción mensual (~$20-35/mes)
- Sistemas propios o a medida: costo variable según el proveedor de software
Si tenés un sistema de facturación propio construido por un desarrollador, el costo de migración puede ser significativo. En ese caso, muchas veces es más conveniente migrar a un SaaS actualizado.
Resumen: lo que tenés que hacer hoy
- Verificar qué versión de XSD está usando tu sistema
- Revisar el historial de comprobantes en ATV para detectar rechazos
- Actualizar o cambiar el sistema si no está en v4.4
- Corregir los errores frecuentes (actividad económica, datos del receptor)
- Probar con un comprobante de prueba antes de volver a emitir en producción
Si este proceso te parece complejo o no tenés tiempo para manejarlo, es exactamente el tipo de cosa que resolvemos en el servicio de Facturación Electrónica de ContaExpert CR.
¿Tenés dudas sobre tu sistema de facturación? Escribime por WhatsApp y te digo en 5 minutos si estás en v4.4 o no.