SDK de JavaScript
Emití desde Node.js con tipos para cada campo, reintentos seguros y la espera del veredicto de Hacienda resuelta.
const doc = await fe.documentos
.emitirFactura(datos, {
esperar: true,
});
doc.status; // 'accepted'API de factura electrónicapara Costa Rica
Vos hacés un POST. El XML v4.4, la firma y Hacienda corren por nuestra cuenta.
Desde ₡2,49 por documento + IVA.
- Emisores ilimitados
- Cualquier lenguaje
- Sandbox gratis
POST /documents/factura
curl -X POST \
https://api.facturaencr.com/v2/efactura/documents/factura \
-H "X-API-Key: efk_live_…" \
-H "X-API-Secret: efs_…" \
-H "Idempotency-Key: pedido-2026-0412" \
-H "Content-Type: application/json" \
-d '{
"emisorLegalId": "3101000000",
"condicionVenta": "01",
"medioPago": ["01"],
"detalle": [{
"codigoCabys": "8999999999013",
"detalle": "Honorarios contables",
"cantidad": 1,
"precioUnitario": 85000
}]
}'Ya están emitiendo con nosotros
Sistemas de gestión, tiendas y puntos de venta de todo el país mandan su venta por la API y el comprobante sale firmado y aceptado.
- +0
- comprobantes en toda la plataforma
- 99,2 %
- aceptados a la primera
- +0
- integradores activos en la API
Novedades
NuevoFacturá conversando con tu IA
Conectá tu cuenta a Claude o ChatGPT y pedile facturas, tiquetes o consultas con tus palabras. Antes de emitir, siempre te muestra el comprobante para que lo confirmes.
Con la API, por ahora, solo en sandbox.
Facturale ₡25.000 a Ana Mora por el diseño del logo.
Este es el comprobante. ¿Lo emito?
Factura electrónicaSandbox
Ana Mora
Diseño de logotipo₡25.000,00
IVA 13 %₡3.250,00
Total₡28.250,00
Sí.
Aceptada en sandbox
Gratis, sin tarjeta
Probá el sandbox gratis.
Creá tu cuenta y emití contra el ambiente de pruebas real de Hacienda — 100 comprobantes al mes, sin costo y sin hablar con ventas. Cuando estés listo, cambiás la llave y ya estás en producción.
Sin tarjeta ni compromiso
Creás la cuenta y ya podés emitir. No pedimos medio de pago para probar.
100 comprobantes al mes
Emitís los 7 tipos contra el sandbox real de Hacienda, con la misma firma que producción.
API key al instante
Generás tu llave de sandbox en el portal y hacés tu primer POST en minutos.
Pasás a producción sin recodear
Cuando estés listo, cambiás la llave por la de producción. El código es el mismo.
Cómo funciona
Generá, enviá, recibí.
01
Generá tu API key
Creá tu llave en el portal en segundos. Ambientes de sandbox y producción separados.
02
Enviá el comprobante
Un POST con la venta en JSON. Armamos el XML v4.4, calculamos impuestos y CABYS, firmamos y enviamos a Hacienda.
03
Recibí la respuesta de Hacienda
Te avisamos por webhook firmado — o consultás el estado: aceptado o rechazado, con el XML firmado y el PDF.
No es solo una API
Emisores ilimitados, y te ayudamos a integrar.
Emisores ilimitados
Una sola API key, sin límite de emisores. Integrás una vez y emitís por todas las cédulas —físicas o jurídicas— de tus clientes o negocios, sin abrir una cuenta ni pagar una mensualidad por cada una. Ideal si construís un ERP, un POS o una plataforma multi-cliente.
Persona física Persona jurídica Régimen simplificado
Asistencia en la integración
No integrás solo. Nuestro equipo te acompaña en la puesta en marcha: dudas del flujo, revisión de tu primer envío y el paso a producción. Documentación completa incluida.
Todo incluido
El ciclo de vida completo del comprobante.
Los 7 comprobantes
FE, TE, NC, ND, FEC, FEE y REP — los 7 documentos oficiales de Hacienda en v4.4, más el Mensaje Receptor.
Firma XAdES-EPES
Firmamos con tu certificado y la clave de 50 dígitos, incluidas cédulas alfanuméricas.
Envío + polling a Hacienda
Autenticamos OAuth2, enviamos y seguimos el estado hasta la aceptación o el rechazo.
Webhooks firmados
Eventos con HMAC-SHA256, anti-replay y reintentos con backoff. Sin andar consultando.
Correo al receptor
Add-on que envía el XML, la respuesta de Hacienda y el PDF. Sin configurar SMTP.
Custodia 5 años
Guardamos el XML firmado cifrado por el plazo legal (CNPT art. 109), accesible por API.
Idempotencia
Con Idempotency-Key un reintento nunca genera doble documento ni doble cobro.
Precios accesibles para todos los niveles
Tarifa por documento que baja con el volumen y sin mínimos obligatorios — del negocio más chico al que factura miles.
Sandbox de pruebas
Ambiente de pruebas contra la API real de Hacienda, gratis.
Por qué integrar con nosotros
Una API que da gusto integrar.
Todo lo que hay entre tu sistema y Hacienda, resuelto: firma, envío, seguimiento, custodia y el PDF con tu marca. Vos escribís un POST.
Respuesta en menos de 3 segundos
Recibís la clave y el consecutivo en el mismo request. El envío a Hacienda corre en segundo plano y te avisamos por webhook cuando responde.
Cualquier lenguaje
REST sobre HTTPS con JSON: la integrás desde JavaScript, Python, PHP, Go, C#, Java o lo que sea que hable HTTP. Sin SDK obligatorio.
Documentación completa, paso a paso
Guía de conexión de punta a punta, ejemplos en varios lenguajes, colección de Postman y tablas de referencia — no un swagger pelado.
Sandbox real de Hacienda
Probás contra el ambiente de pruebas real de Hacienda, con la misma firma y estructura que producción. Cambiás la llave y ya estás en vivo.
Custodia incluida
El XML firmado se guarda cifrado por los 5 años de ley, y los certificados de tus emisores viven cifrados con AES-256-GCM. Vos no guardás nada.
Los 7 tipos de comprobante
FE, TE, NC, ND, FEC, FEE y REP en v4.4, con exoneraciones y los dos regímenes: tradicional y simplificado.
PDF y correo a tu marca
El PDF del comprobante y el correo al receptor salen con tu diseño y tu logo. Tu cliente ve tu marca, no la nuestra.
Sin cobros por cédula
Das de alta emisores, sucursales y terminales con una sola llave, dentro de los límites de tu plan. No cobramos por cada cédula que agregues.
Precio que escala con vos
Mensualidad, prepago o pago por documento, con descuentos por volumen: el costo por documento baja conforme integrás más, sin mínimos mensuales.
Idempotencia con Idempotency-Key·Webhooks firmados con HMAC-SHA256·Scopes e IP whitelist por llave·Asistencia por WhatsApp y correo·Exoneraciones·Consulta de estado y descarga del XML
Precios API
Pagá solo por lo que emitís.
Tomá una mensualidad con documentos incluidos, pagá solo lo que emitís o comprá documentos por adelantado (vigencia 1 año). El precio por comprobante baja fuerte con el volumen.
Planes mensuales con bloque de documentos incluido. Ideal si tu volumen es estable: el excedente se cobra al promedio del plan, nunca te cortamos la emisión.
500
documentos / mes
₡11.490/mes+ IVA
Documento extra₡22,98+ IVA
Al pasar los 500 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
1 000
documentos / mes
₡19.000/mes+ IVA
Documento extra₡19+ IVA
Al pasar los 1 000 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
2 500
documentos / mes
₡28.500/mes+ IVA
Documento extra₡11,40+ IVA
Al pasar los 2 500 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
5 000
documentos / mes
₡36.500/mes+ IVA
Documento extra₡7,30+ IVA
Al pasar los 5 000 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
10 000
documentos / mes
₡43.500/mes+ IVA
Documento extra₡4,35+ IVA
Al pasar los 10 000 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
25 000
documentos / mes
₡95.500/mes+ IVA
Documento extra₡3,82+ IVA
Al pasar los 25 000 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
50 000
documentos / mes
₡165.500/mes+ IVA
Documento extra₡3,31+ IVA
Al pasar los 50 000 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
100 000
documentos / mes
₡275.000/mes+ IVA
Documento extra₡2,75+ IVA
Al pasar los 100 000 incluidos no te cortamos la emisión: cada extra al mismo precio.
- Los 7 comprobantes de Hacienda (v4.4)
- Emisores ilimitados
- Sucursales y terminales ilimitadas
- Asistencia en el desarrollo (WhatsApp y correo)
- Webhooks firmados y reintentos automáticos
- Sandbox real de Hacienda
- Custodia del XML firmado por 5 años
- PDF y correo al receptor con tu marca
- Exoneraciones y ambos regímenes
- Excedente al promedio del plan, sin cortar la emisión
+ Correo al receptor (add-on API): ₡5.000/mes + IVA con 10 000 envíos incluidos. En los planes de facturación por portal, el correo va incluido sin costo.
Pasar a producción: un pago único por integración
₡50.000+ IVA · pago único
No es por cliente: lo pagás una sola vez y cubre a todos los comercios que factures con tu integración. Probar en sandbox es gratis siempre.
- Soporte durante todo el proceso
- Reuniones para aclarar dudas
- Actualizaciones de Hacienda
₡50.000
+ IVA · pago único
Tu volumen no calza en los tramos
Si emitís por encima de los tramos publicados, manejás muchos emisores o necesitás condiciones distintas, armamos un precio para tu caso.
Guías
Lo que conviene saber antes de emitir.
Preguntas
Lo que preguntan antes de integrarse.
- ¿Qué es una API de factura electrónica y para qué sirve?
- Es una interfaz REST que tu sistema llama para emitir comprobantes electrónicos ante Hacienda sin que nadie los cargue a mano. Tu programa manda la venta en JSON, nosotros armamos el XML v4.4, calculamos el IVA y el CABYS, lo firmamos con el certificado del emisor, lo enviamos a Hacienda y te devolvemos la respuesta. Sirve para cualquier sistema que ya facture: un ERP, una tienda en línea, un punto de venta o un software a la medida.
- ¿Cómo integro la factura electrónica de Costa Rica en mi sistema?
- Creás una cuenta, generás tu API key de sandbox y hacés un POST a https://api.facturaencr.com/v2/efactura con la venta en JSON. La llamada se autentica con dos cabeceras, X-API-Key y X-API-Secret, y responde de inmediato con la clave y el consecutivo del comprobante; el envío a Hacienda sigue en segundo plano y te avisamos por webhook cuando responde. Cuando funcione en pruebas, cambiás la llave por la de producción: el código es el mismo.
- ¿Hay alguna API de facturación electrónica gratuita?
- El sandbox es gratis y sin tarjeta: 100 comprobantes al mes contra el ambiente de pruebas real de Hacienda, con la misma firma y la misma estructura que producción. Podés desarrollar e integrar entera tu solución sin pagar nada. En producción se paga por documento emitido, desde ₡2,49, y el precio baja con el volumen.
- ¿Qué comprobantes puedo emitir por la API?
- Los siete de la versión 4.4: factura electrónica (01), nota de débito (02), nota de crédito (03), tiquete electrónico (04), factura de compra (08), factura de exportación (09) y recibo electrónico de pago (10). También el mensaje de receptor, para aceptar o rechazar las facturas que te emiten tus proveedores.
- ¿En qué lenguaje se programa la integración?
- En el que ya uses. Es REST sobre HTTPS con JSON, así que se integra desde JavaScript, Python, PHP, Go, C#, Java o cualquier cosa que hable HTTP. No hay SDK obligatorio ni librería que instalar; la documentación trae ejemplos en varios lenguajes y una colección de Postman.
- ¿Necesito el certificado de Hacienda de cada cliente?
- Sí, la firma es del emisor: cada contribuyente sube su archivo .p12 y su PIN una vez, y queda cifrado con AES-256-GCM. De ahí en adelante emitís por él con tu misma API key. No cobramos por cédula: podés dar de alta emisores, sucursales y terminales sin cargo adicional dentro de tu plan.
- ¿Quién guarda el XML firmado durante los cinco años de ley?
- Nosotros. El XML firmado y la respuesta de Hacienda quedan en custodia cifrada por los cinco años que exige la ley, y los consultás o los descargás por la API cuando los necesités. No tenés que montar almacenamiento ni respaldos para eso.
- ¿Qué pasa si Hacienda rechaza un comprobante?
- Te llega el rechazo por webhook con el código y el detalle que devolvió Hacienda, y la documentación trae la tabla completa de códigos con qué significa cada uno. La API también valida antes de enviar —estructura, impuestos, CABYS y consecutivos— para que la mayoría de los rechazos ni siquiera lleguen a quemarte un consecutivo.
Tu primera integración arranca hoy.
Creá tu cuenta, generá una API key y emití en sandbox contra la API real de Hacienda, sin costo.
Probá la API gratis en el sandbox
100 comprobantes al mes contra el ambiente real de Hacienda. Sin tarjeta.