Guía completa: Factura electrónica en Costa Rica (v4.4)
Todo lo que necesitás para emitir, firmar y enviar tus comprobantes a Hacienda sin enredos: requisitos, ejemplos XML, errores comunes y mejores prácticas.
Quiero ayuda para implementarloAutomatizá, ordená y hacé crecer tu negocio con tecnología hecha en Costa Rica.
Todo lo que necesitás para emitir, firmar y enviar tus comprobantes a Hacienda sin enredos: requisitos, ejemplos XML, errores comunes y mejores prácticas.
Quiero ayuda para implementarloRepaso rápido para entender el “por qué” y el “cómo” antes de emitir tu primer comprobante.
Un comprobante digital con estructura XML estandarizada, firmado y validado por Hacienda.
Es el medio legal para sustentar ventas, deducciones y control fiscal desde 2018 en Costa Rica.
A profesionales, comercios y empresas. Si vendés o prestás servicios, debés emitir comprobantes.
Riesgo de rechazos, multas, imposibilidad de deducir gastos y pérdida de oportunidades de negocio.
Implementación guiada, herramientas gratuitas y soporte local para que emitas sin fricciones.
Tip: empezá probando con nuestro validador y las plantillas XML para reducir rechazos al mínimo.
La factura electrónica es un comprobante digital con estructura XML estandarizada, firmado digitalmente y validado por el Ministerio de Hacienda de Costa Rica.
A diferencia de las facturas en papel, este documento digital cumple con estándares técnicos rigurosos que garantizan:
El formato XML contiene toda la información relevante de la transacción: emisor, receptor, productos o servicios, impuestos, totales y datos de validación.
Desde 2018, la factura electrónica es el único medio legal válido para sustentar ventas, deducciones y control fiscal en Costa Rica.
Esta obligatoriedad surge de la necesidad de modernizar el sistema tributario y combatir la evasión fiscal mediante:
El Reglamento de Facturación Electrónica (DGT-R-48-2016) establece que todos los sujetos obligados deben emitir comprobantes electrónicos.
La obligación de emitir facturas electrónicas aplica a todos los profesionales, comercios y empresas registrados en Costa Rica que realicen actividades comerciales.
Esto incluye:
En términos prácticos: si vendés bienes o prestás servicios, estás obligado a emitir comprobantes electrónicos. No hay excepciones por volumen de ventas o tipo de actividad.
El incumplimiento de la normativa de facturación electrónica conlleva graves consecuencias para tu negocio:
Además, el no cumplimiento genera una pérdida de oportunidades con clientes corporativos y entidades gubernamentales que exigen factura electrónica para sus procesos.
Implementación guiada, herramientas gratuitas y soporte local para que emitas sin fricciones
Te acompañamos paso a paso en todo el proceso de adaptación a la factura electrónica
Acceso a validadores, plantillas y utilidades para facilitar tu transición
Equipo de expertos disponibles para resolver tus dudas en tiempo real
Aseguramos que tu implementación cumpla con todas las normativas vigentes
Contenido práctico, al grano y actualizado con la versión 4.4.
Qué es la factura electrónica, tiquete, NC y ND; cuándo usar cada uno y su estructura XML.
Lo que exige el Ministerio de Hacienda en v4.4: OIDC, firma XAdES-EPES y validaciones.
Cómo obtener el token, firmar, enviar y recepcionar comprobantes con estados y acuses.
Listado de códigos del validador 4.4 (p. ej. cvc-complex-type) y cómo resolverlos paso a paso.
La factura electrónica es el documento legal que sustituye a la factura tradicional en papel. Es un archivo XML que contiene toda la información de una transacción comercial y está validado por el Ministerio de Hacienda de Costa Rica.
Debe utilizarse en todas las transacciones B2B (entre empresas) y B2G (empresa a gobierno). Contiene información detallada sobre el emisor, receptor, productos o servicios, impuestos y totales. Su estructura XML sigue el formato definido por Hacienda en la versión 4.4.
Todas las facturas electrónicas deben incluir la firma digital XAdES-EPES y ser enviadas al sistema de Hacienda para su validación antes de ser entregadas al cliente.
El tiquete electrónico es un comprobante simplificado utilizado principalmente en transacciones con consumidores finales (B2C). Se aplica en comercios minoristas, restaurantes, servicios y otros establecimientos donde no se requiere identificar al comprador con detalle.
A diferencia de la factura, el tiquete tiene una estructura XML más simple y no requiere información detallada del receptor. Sin embargo, debe contener todos los datos del emisor, descripción de los productos o servicios, impuestos y totales. Es obligatorio para todas las ventas al por menor.
La Nota de Crédito es un documento que se emite para anular total o parcialmente una factura electrónica ya emitida. Se utiliza en casos de devoluciones, descuentos posteriores a la facturación, o correcciones por errores en la factura original.
Su estructura XML es similar a la de una factura pero contiene campos específicos que hacen referencia a la factura original que está siendo modificada. Debe incluir la razón de la nota de crédito y los montos ajustados.
La Nota de Débito se emite para incrementar el monto de una factura ya emitida. Se utiliza cuando se omite un cargo en la factura original o cuando se aplican recargos posteriores (intereses moratorios, gastos adicionales, etc.).
Al igual que la nota de crédito, su estructura XML hace referencia a la factura original y detalla los conceptos adicionales que se están cargando. Es importante justificar claramente el motivo del débito adicional.
La estructura XML de los comprobantes electrónicos está estrictamente definida por el Ministerio de Hacienda. Todos los documentos deben cumplir con el esquema XSD de la versión 4.4 para ser aceptados.
La estructura básica incluye:
El sistema de autenticación OIDC es el mecanismo requerido para acceder a los servicios web de Hacienda. Reemplaza el sistema anterior basado en tokens de acceso simples.
Para obtener un token OIDC válido, debes:
El token OIDC debe incluirse en el encabezado Authorization de todas las solicitudes al API de Hacienda: Authorization: Bearer <tu_token>
La firma XAdES-EPES (XML Advanced Electronic Signatures - Explicit Policy Electronic Signature) es el estándar requerido para firmar digitalmente los comprobantes electrónicos.
Características clave:
La estructura de la firma en el XML debe seguir exactamente el formato definido por Hacienda, incluyendo referencias, valores de firma y elementos de política.
Hacienda realiza múltiples validaciones sobre los comprobantes electrónicos antes de aceptarlos:
Autenticación con Hacienda usando OIDC para obtener un token de acceso válido. El token tiene una vida útil de 1 hora y debe renovarse automáticamente.
Crear el documento XML según el tipo de comprobante (Factura, Tiquete, NC o ND) siguiendo el esquema definido en la versión 4.4.
Aplicar la firma XAdES-EPES al documento XML utilizando el certificado digital del emisor.
Enviar el XML firmado al endpoint de recepción de Hacienda, incluyendo el token OIDC en el encabezado de autorización.
Recibir y procesar el acuse de recibo que confirma que Hacienda ha recibido el documento.
Monitorear el estado del comprobante hasta recibir la aceptación o rechazo definitivo por parte de Hacienda.
Los comprobantes electrónicos pasan por varios estados durante su procesamiento:
El tiempo máximo de respuesta de Hacienda es de 3 días hábiles. Sin embargo, en la práctica la mayoría de los comprobantes son procesados en menos de 24 horas.
Los acuses son documentos XML que Hacienda devuelve en cada etapa del proceso:
Es obligatorio conservar todos los acuses recibidos por al menos 5 años como parte de la documentación legal.
Estos son algunos de los errores más frecuentes que devuelve el validador de Hacienda v4.4:
Sigue estos pasos para resolver errores comunes:
Lee detenidamente el mensaje de error y localiza el elemento XML problemático.
Revisa el esquema XSD oficial para entender los requisitos del elemento.
Usa un validador XML local para probar correcciones sin enviar a Hacienda.
Ajusta el valor o estructura según lo indicado en el error y el XSD.
Después de cualquier modificación, vuelve a firmar el documento.
Envía nuevamente el comprobante corregido a Hacienda.
Para evitar rechazos, siempre realiza validaciones previas:
Seguí este orden para evitar rechazos y pérdida de tiempo.
Definí actividad económica, consecutivos y claves. Prepará certificados y credenciales.
Firmá los XML con el certificado correspondiente para asegurar integridad y autenticidad.
Obtené y refrescá el token con OIDC/OAuth 2.0 para comunicarte con Hacienda.
Generá el XML (Factura/Tiquete/NC/ND), firmalo y enviá a recepción para validación.
Leé los acuses, gestioná aceptaciones/rechazos y almacená los XML de respaldo.
Antes de comenzar a emitir comprobantes electrónicos, es fundamental configurar correctamente tu sistema con los siguientes elementos:
Verifica la vigencia de tu certificado digital con al menos 30 días de anticipación. La renovación puede tardar varios días.
La firma digital es un requisito indispensable para todos los comprobantes electrónicos. El estándar XAdES-EPES garantiza la autenticidad e integridad de tus documentos.
Los rechazos más frecuentes relacionados con firma incluyen: certificado vencido, política de firma incorrecta, y alteración del XML después de la firma.
Para interactuar con los servicios web de Hacienda, debes obtener un token de acceso mediante el protocolo OIDC (OpenID Connect).
Envía credenciales al endpoint de autenticación
Recibe access_token y refresh_token
Usa refresh_token para obtener nuevo access_token
Generar y enviar comprobantes electrónicos requiere atención a múltiples detalles técnicos para garantizar su aceptación.
Crea el documento según esquema v4.4
Aplica firma XAdES-EPES
Envía a endpoint de recepción
Guarda siempre una copia del XML antes y después de la firma. Implementa reintentos automáticos para fallos de red, pero no para errores de validación.
Después del envío, debes gestionar las respuestas de Hacienda y almacenar correctamente los documentos.
Confirmación de recepción
Validación por parte de Hacienda
Comprobante aprobado
Según la Resolución DGT-R-48-2016, debes conservar los comprobantes electrónicos y sus respaldos por 5 años. Considera:
Te ayudamos a implementar v4.4 con ejemplos, herramientas y soporte local para que cumplás desde hoy.
Quiero que me guíen