Checklist de habilitación como emisor electrónico ante Hacienda Costa Rica
Checklist completo para habilitar un nuevo emisor electrónico ante Hacienda Costa Rica: requisitos, pasos en ATV, configuración técnica, errores frecuentes y tiempos estimados.
Por Ing. Carlos Méndez | 4 de septiembre de 2026
Ing. Carlos Méndez es arquitecto de software con más de 10 años integrando sistemas fiscales en América Latina. Ha liderado implementaciones de facturación electrónica en Colombia, México y Centroamérica para ISVs de mediana y gran escala.
Un ISV consigue un nuevo cliente en Costa Rica. El cliente necesita emitir facturas electrónicas desde mañana. El problema: nadie en el equipo del ISV sabe exactamente qué pasos hay que completar ante Hacienda, en qué orden, y cuánto tiempo toma cada uno. La habilitación de un nuevo emisor no es complicada, pero tiene dependencias entre pasos que, si se ignoran, alargan el proceso varios días.
Este checklist recorre todos los pasos necesarios para habilitar un nuevo emisor electrónico ante Hacienda Costa Rica: desde los requisitos previos hasta la primera emisión exitosa en producción, con tiempos estimados por etapa y los errores más comunes en cada paso.
Fase 1: Requisitos previos (Antes de tocar Hacienda)
Antes de iniciar cualquier trámite ante Hacienda, el emisor debe tener resueltos estos puntos:
Checklist Fase 1 — Requisitos previos: ☐ Cédula jurídica activa y al día en el Registro Nacional ☐ Inscripción activa ante Hacienda (obligado tributario) ☐ Régimen fiscal confirmado (Tributación Directa o Simplificado) ☐ Código de Actividad Económica (CIIU) registrado ante Hacienda ☐ Certificado digital válido (BCCR o PSC autorizado) — puede gestionarse en paralelo ☐ Correo electrónico institucional activo para notificaciones de Hacienda Tiempo estimado: 0-5 días (si todo está al día) o hasta 4 semanas (si hay que gestionar el certificado digital)
Error frecuente en Fase 1: Código de Actividad Económica incorrecto
El código CIIU de 4 dígitos que usa el emisor en sus comprobantes debe coincidir exactamente con el código registrado ante Hacienda. Un emisor que tiene registrado el código 6201 (Programación informática) pero emite facturas con el código 6209 (Otras actividades de TI) recibirá rechazo de Hacienda en el procesamiento del comprobante.
Fase 2: Configuración en el portal ATV de Hacienda
El portal ATV requiere autenticación con la firma digital del representante legal. Los pasos en ATV son:
Checklist Fase 2 — Portal ATV (https://www.hacienda.go.cr): ☐ Acceder a ATV con firma digital del representante legal ☐ En sección 'Comprobantes Electrónicos', registrar el sistema de emisión ☐ Obtener Client ID y Client Secret para OAuth (producción) ☐ Repetir para ATVCERT (sandbox): obtener credenciales separadas ☐ Registrar el callback URL para recibir notificaciones de Hacienda (opcional) ☐ Configurar el correo electrónico de notificaciones Tiempo estimado: 1-3 días hábiles (dependiendo de validación de Hacienda)
Error frecuente en Fase 2: confundir credenciales de ATVCERT con las de producción
Las credenciales OAuth de ATVCERT y las de producción son distintas y no intercambiables. Usar el Client ID de producción en el endpoint de ATVCERT devuelve 401. Usar el de ATVCERT en producción también devuelve 401. Documentar claramente cuáles son las credenciales de cada ambiente es crítico, especialmente en equipos donde más de una persona gestiona la integración.
Fase 3: Configuración técnica del sistema de emisión
Checklist Fase 3 — Sistema técnico: ☐ Cargar el XSD v4.3 de Hacienda en el validador del sistema ☐ Configurar las credenciales OAuth (Client ID + Client Secret) para ATVCERT ☐ Cargar el certificado .p12 del emisor en el componente de firma ☐ Verificar que el componente de firma usa Canonical XML 1.0 (no Exclusive C14N) ☐ Verificar que el bloque Signature se posiciona como último hijo del elemento raíz ☐ Implementar gestión de token OAuth (renovación automática antes de los 5 minutos) ☐ Implementar la lógica de Clave (50 dígitos) con todos los segmentos correctos ☐ Configurar la gestión de consecutivos por tipo de comprobante Tiempo estimado: 3-10 días (según complejidad del sistema y experiencia del equipo)
Fase 4: Pruebas en ATVCERT antes de ir a producción
Checklist Fase 4 — Pruebas en ATVCERT: ☐ Emitir una Factura Electrónica (tipo 01) en ATVCERT con datos reales del emisor ☐ Emitir un Tiquete Electrónico (tipo 04) ☐ Emitir una Nota de Crédito (tipo 03) referenciando la FE anterior ☐ Verificar el estado de los comprobantes con GET /comprobante/{clave} ☐ Confirmar que el campo detalleMensaje indica 'aceptado' para todos ☐ Probar el flujo con un comprobante intencionalmente malo y verificar el rechazo ☐ Verificar que el sistema maneja correctamente la respuesta asíncrona Tiempo estimado: 2-5 días hábiles
Error frecuente en Fase 4: ATVCERT no replica todos los errores de producción
Algunos errores solo aparecen en producción con datos reales. Los más comunes son: el código CIIU que no coincide con el registrado en Hacienda, el correo del receptor con formato inválido, y el campo de zona horaria en fechas que en ATVCERT a veces se acepta mal formado pero en producción no.
Fase 5: Primer emisión en producción
Checklist Fase 5 — Arranque en producción: ☐ Cambiar credenciales OAuth de ATVCERT a producción ☐ Cambiar endpoint base de ATVCERT a producción ☐ Emitir la primera FE real en horario de soporte (para poder atender errores) ☐ Verificar el estado en producción con GET /comprobante/{clave} ☐ Verificar que el emisor recibe la confirmación de Hacienda en su correo ☐ Configurar monitoreo de errores y alertas de vencimiento de certificado Tiempo estimado: 1 día
Tiempo total estimado de habilitación
El tiempo total de habilitación de un nuevo emisor en Costa Rica varía entre 1 semana y 6 semanas, dependiendo principalmente de dos factores: si el certificado digital ya existe o hay que gestionarlo (puede tomar de 3 a 20 días hábiles según el PSC), y si el equipo de desarrollo tiene experiencia previa con la integración ATV.
Los ISVs que usan un proveedor de API intermediario para Costa Rica reducen este tiempo significativamente: el proveedor gestiona el certificado, las credenciales ATV y el componente de firma, dejando al ISV solo la integración contra la API del proveedor. La API de Alanube para Costa Rica incluye gestión de habilitación de nuevos emisores como parte del servicio, reduciendo el proceso a días en lugar de semanas para equipos sin experiencia previa en ATV.
Preguntas frecuentes
¿Cuál es el tiempo mínimo real para habilitar un emisor electrónico en Costa Rica?
Si el emisor ya tiene certificado digital vigente, la inscripción activa ante Hacienda al día y un equipo con experiencia en la integración ATV, el proceso puede completarse en 3-5 días hábiles. El cuello de botella más frecuente es la emisión del certificado digital cuando no existe previamente.
¿Cómo puedo verificar si un emisor ya está habilitado para facturación electrónica en Hacienda?
En el portal ATV de Hacienda, accediendo con la firma digital del representante legal, se puede verificar si el contribuyente tiene configurado un sistema de emisión electrónica. Si ya está habilitado, el sistema mostrará las credenciales OAuth activas. Si no, mostrará el formulario de registro.
¿Qué diferencia hay entre el proceso de habilitación en ATVCERT y en producción?
Son dos procesos paralelos e independientes. Para ATVCERT, se obtienen credenciales separadas en el portal ATV, sección de certificación. Para producción, se obtienen en la sección de producción. No hay una dependencia secuencial obligatoria: se puede habilitar en ambos ambientes en el mismo día si se hacen los dos trámites. Lo recomendable es habilitar ATVCERT primero para poder probar antes de produccción.
¿Es posible habilitar a un emisor electrónico en Costa Rica sin que el representante legal tenga firma digital?
No directamente. El acceso al portal ATV para registro de sistemas de emisión requiere autenticación con firma digital del representante legal. Si el representante no tiene firma digital, debe obtenerla primero (BCCR o PSC autorizado). Algunos proveedores de API ofrecen un proceso de habilitación asistida que acompaña al representante en el trámite, pero no pueden sustituir la firma digital.
Sobre el autor
Ing. Carlos Méndez es arquitecto de software con más de 10 años integrando sistemas fiscales en América Latina. Ha liderado implementaciones de facturación electrónica en Colombia, México y Centroamérica para ISVs de mediana y gran escala.
Artículos Relacionados
Receptor electrónico en Costa Rica: cómo recibir y confirmar comprobantes via API
Guía técnica para implementar el rol de receptor electrónico en Costa Rica: cómo recibir comprobantes de Hacienda, confirmar, aceptar o rechazar, y automatizar el flujo vía API.
Firma digital XAdES-BES en Costa Rica: requisitos técnicos para comprobantes electrónicos
Cómo funciona la firma digital XAdES-BES en Costa Rica, qué certificados acepta Hacienda, el proceso de firma sobre el XML del comprobante y qué errores genera una firma mal formada.
Tipos de comprobantes electrónicos en Costa Rica: FE, FEE, TE, NC, ND y TEC
Guía técnica sobre los seis tipos de comprobantes electrónicos en Costa Rica: cuándo emitir cada uno, reglas de negocio, campos obligatorios y consecuencias fiscales de una selección incorrecta.