API de factura electrónica.Integrá gratis, pagá por factura.
Desde ₡2,49 por documento + IVA.
Sin costos de integración ni mínimos mensuales. Firmamos, enviamos a Hacienda, guardamos el XML y te avisamos por webhook — vos hacés un POST.
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": "3101678166",
"condicionVenta": "01",
"medioPago": ["01"],
"detalle": [{
"codigoCabys": "8511100000000",
"detalle": "Honorarios contables",
"cantidad": 1,
"precioUnitario": 85000
}]
}'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.
Generá, enviá, recibí.
Generá tu API key
Creá tu llave en el portal en segundos. Ambientes de sandbox y producción separados.
Enviá el comprobante
Un POST con la venta en JSON. Armamos el XML v4.4, calculamos impuestos y CABYS, firmamos y enviamos a Hacienda.
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.
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.
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.
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, sin mínimos obligatorios ni costos de integración — del negocio más chico al que factura miles.
Sandbox de pruebas
Ambiente de pruebas contra la API real de Hacienda, gratis.
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
Prepago o postpago, con descuentos por volumen: el costo por documento baja conforme integrás más. Sin setup fee.
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
Pagá solo por lo que emitís.
Pagá por tramo según lo que emitas, comprá documentos por adelantado (vigencia 1 año) o tomá un plan mensual con bloque incluido. El precio por comprobante baja fuerte con el volumen.
Tramo aplicado ₡4,35/doc · baja al subir de volumen
+ 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.
Lo que conviene saber antes de emitir.
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 setup fee.
Probá la API gratis en el sandbox
100 comprobantes al mes contra el ambiente real de Hacienda. Sin tarjeta.