Concepto · Hacienda v4.4
¿Qué es un comprobante electrónico en Costa Rica?
¿Qué es exactamente un comprobante electrónico?
Es un archivo .xml con una estructura definida por Hacienda (la versión vigente es la 4.4) que describe una operación: quién vende (emisor), quién compra (receptor), qué se vendió (cada línea con su código CABYS) y cuánto impuesto lleva. Ese XML se firma digitalmente y se transmite a Hacienda, que lo valida y lo devuelve aceptado o rechazado.
Tres cosas lo distinguen de una factura de papel o de un simple PDF:
- Tiene una clave numérica de 50 dígitos única e irrepetible, más un consecutivo de 20 dígitos por sucursal y caja.
- Va firmado con un certificado digital (
.p12) mediante firma . - Solo es válido cuando Hacienda lo acepta; el PDF que ve el cliente es la representación, no el comprobante en sí.
El XML manda, el PDF acompaña
¿Cuáles son los 6 tipos de comprobante electrónico?
Bajo el paraguas de "comprobante electrónico" viven seis documentos distintos. No son intercambiables: cada operación usa el suyo. En la 4.4 son estos:
| código | tipo | cuándo se usa |
|---|---|---|
| 01 | Factura electrónica (FE) | Venta a un receptor identificado (con cédula/nombre); soporta gasto deducible. |
| 04 | Tiquete electrónico (TE) | Venta al consumidor final, sin datos del comprador. |
| 03 | Nota de crédito (NC) | Corrige, anula o devuelve sobre un comprobante ya emitido. |
| 02 | Nota de débito (ND) | Aumenta el monto de un comprobante ya emitido. |
| 08 | Factura de compra (FEC) | La emite el comprador cuando le compra a un proveedor de régimen simplificado. |
| 09 | Factura de exportación (FEE) | Ventas al exterior, con los requisitos aduaneros del caso. |
La duda más común del día a día es factura vs. tiquete: la factura (01) identifica al comprador y respalda un gasto deducible; el tiquete (04) es para el consumidor final y no sirve para deducir. Las notas de crédito y débito (03 y 02) nunca van solas: exigen referenciar el documento original que corrigen. Y la factura de compra (08) la emite el comprador cuando le compra a alguien de régimen simplificado, que por regla no factura.
El REP es un caso aparte
¿Cómo funciona el flujo de validación de Hacienda?
Emitir un comprobante electrónico no es "generar un PDF y mandarlo por correo". Es una cadena de pasos técnicos donde cada uno puede fallar. Este es el flujo completo, de la venta a la aceptación:
| paso | qué pasa |
|---|---|
| 1. Se arma el XML v4.4 | Con el emisor, el receptor, las líneas (cada una con su código CABYS) y el desglose de impuestos. |
| 2. Se genera la clave | Una clave numérica de 50 dígitos, única e irrepetible, y el consecutivo de 20 dígitos por sucursal y caja. |
| 3. Se firma con XAdES | Firma XAdES-EPES con tu certificado .p12; sin firma válida, Hacienda no lo recibe. |
| 4. Se envía a Hacienda | El XML firmado viaja a la API de recepción de Hacienda (TRIBU-CR). |
| 5. Hacienda valida (asíncrono) | No responde al instante: valida y devuelve "aceptado" o "rechazado" con un mensaje. |
| 6. Se entrega al receptor | Aceptado el comprobante, se le manda al cliente el PDF y los XML por correo, como exige la norma. |
Hacienda no dice 'aceptado' al instante
¿Qué dice la normativa de Costa Rica?
Facturar electrónicamente no es opcional para quien está inscrito como contribuyente. La versión 4.4 es obligatoria desde el 1 de setiembre de 2025 (se prorrogó desde el 1 de junio), y todo el trámite vive ahora en TRIBU-CR, el portal que reemplazó al viejo ATV. Los detalles y las fechas que todavía vienen están en .
No emitir, o emitir mal, tiene consecuencias: el Código de Normas y Procedimientos Tributarios (CNPT), en sus artículos 83 y 86, contempla multas de hasta 100 salarios base y, por reincidencia, el cierre del negocio. El monto exacto depende del salario base vigente y de la infracción.
Confirmá con tu contador
Ejemplo: una ferretería en Alajuela
Una ferretería le vende materiales a un cliente por ₡50.000. Al ser bienes gravados, aplica el IVA general del 13 %: ₡6.500, para un total de ₡56.500. Ahora, ¿qué comprobante emite?
- Si el que compra es un consumidor final que no pide factura → un tiquete electrónico (04).
- Si es una empresa que quiere deducir el gasto y da su cédula jurídica → una factura electrónica (01) a su nombre.
- Si al día siguiente devuelven la mitad del material → una nota de crédito (03) que referencia esa factura y rebaja ₡28.250.
En los tres casos, el sistema arma el XML con el código CABYS de cada producto (el catálogo tiene más de 20.000 códigos de 13 dígitos), genera la clave de 50 dígitos, firma con el certificado de la ferretería y lo manda a Hacienda. El cliente recibe su PDF y su XML por correo. Todo eso ocurre en segundos, sin que el cajero toque un XML.
¿Cómo emito comprobantes electrónicos con Plaxp?
La parte difícil no es la venta: es el XML v4.4, la firma, los consecutivos, el envío y el manejo de rechazos. Plaxp Invoice se encarga de todo eso. Podés emitir los seis comprobantes desde el panel web o por API REST: hacés un POST con los datos de la venta y nosotros generamos el XML, lo firmamos con XAdES, lo enviamos a Hacienda, consultamos el estado por vos y le mandamos al receptor el PDF y los XML.
- Los 6 comprobantes de la v4.4 desde un solo lugar (panel o API)
- Generamos el XML v4.4 y calculamos el desglose de impuestos con precisión fiscal
- Firma XAdES-EPES con tu certificado .p12 aplicada por nosotros
- Envío a Hacienda y consulta de estado automática, sin que implementes polling
- Correo al receptor con PDF y XML, y consulta pública por clave
Si venís de otra herramienta, mirá también cómo se compara con el facturador gratuito de Hacienda en o con otros sistemas en . Para integrar por código, arrancá en la .
¿Listo para emitir tus comprobantes electrónicos?
Te damos credenciales de sandbox y te acompañamos en la integración. Escribinos y arrancamos hoy.
Solicitar acceso a la APITe acompañamos en la puesta en marcha · soporte rápido de gente real · fácil de usar para todo tu equipo. Somos gente ayudando gente.