Proveedor certificado por el Ministerio de Hacienda

Hacé que tu producto facture ante Hacienda.

Vos mandás la venta; nosotros la llevamos hasta el acuse. Desde cualquier lenguaje que hable HTTP.

Empezá a construirLeer la documentación
Recorrido de un documento electrónico: la solicitud POST a /internal/v1/invoices con un documento tipo FE y una línea con código CAByS; la derivación del IVA desde el catálogo; la respuesta 201 con la clave y el número consecutivo; la firma XAdES-EPES y el paso por los estados de Hacienda hasta la aceptación; y el webhook firmado que avisa el veredicto.
Estándar
Factura Electrónica v4.4
Verificado
Ministerio de Hacienda
Estado
Pre-release

Probá sin pedirle permiso a nadie.

El sandbox es gratis e ilimitado. El plan gratuito además incluye cinco documentos reales al mes, que es lo que hace falta para probar dentro de tu propio producto y no solo contra un entorno de mentira.

Sin formulario de ventas ni llamada: tus llaves aparecen al registrarte.

Crear una cuenta

Sin tarjeta.

Sandbox

Abierto desde el minuto uno

Contra el sandbox de Hacienda. Ilimitado y sin tarjeta.

Producción

Cuando vos digás

La activás desde el panel cuando tu integración esté lista. No hay una compuerta nuestra en el medio.

Un proyecto queda clavado a un entorno de por vida: cambiar de entorno es otro proyecto, no un interruptor. Cada respuesta lleva su environment, así que un documento de sandbox no se puede confundir con uno real.

Lo que protegemos por vos

El certificado de firma de tu cliente, y la cuenta desde la que manejás todo lo demás.

Tu certificado

El PKCS#12 del contribuyente, con su llave privada.

Timbre

Lo sella localmente bajo una llave de un solo uso.

Gestor de llaves

Envuelve esa llave y devuelve el sobre.

Lo único que sale hacia el gestor de llaves son los 32 bytes de una llave de un solo uso. El certificado nunca se mueve: el gestor jamás llega a ver el .p12 de un contribuyente.

Solo escritura
El certificado entra por la API y no vuelve a salir por ella nunca. Se valida al subirlo, así que una contraseña mala o un certificado vencido se rechazan ahí y no a la hora de firmar.
Rotación verificada
Antes de guardar un valor re-cifrado, Timbre comprueba que vuelva a abrir exactamente igual. Un certificado de firma no se regenera, así que escribirlo mal sería destruirlo — por eso nunca se sobrescribe sin haber verificado antes.
El proveedor puede cambiar, tu documento no
Cada sobre sellado lleva el id de la llave que lo cerró. Si el gestor de llaves detrás cambia, un documento firmado hoy se sigue abriendo igual mañana: no hay que volver a firmarlo, y no hay una ventana en la que dejes de poder leer tus propios documentos.
Sesiones revocables
Podés cerrar cualquier sesión al instante, la tuya o la de tu equipo — no hay que esperar a que expire sola.
Auditoría que no se borra
Cada cambio queda registrado. Ni el código ni un acceso directo a la base pueden editarlo o borrarlo después de escrito.

El ciclo de un documento

Lo que pasa entre tu JSON y el acuse de Hacienda. Cada paso es obligatorio y ninguno queda de tu lado.

  1. Cálculo

    El impuesto sale del catálogo, no lo adivina nadie

    Cada línea de la venta lleva un código oficial (CAByS). De ahí sale la tarifa exacta, y el documento se revisa contra las reglas antes de firmarse — vos no calculás nada, ni nosotros inventamos nada.

  2. Numeración

    Nunca se repite un número, aunque lleguen mil a la vez

    A cada factura le toca su clave y su consecutivo, uno por uno, sin importar cuántas peticiones lleguen al mismo tiempo.

  3. Firma y envío

    Se firma, se presenta, y se sigue hasta la respuesta

    Timbre firma el documento con el certificado de tu cliente y lo presenta ante Hacienda, consultando hasta que hay un veredicto — nunca queda en el aire.

  4. Aviso

    Te avisamos con evidencia, no con un correo

    El resultado llega a tu servidor firmado, con reintentos automáticos si no respondés a tiempo.

Una API, no un portal

Todo lo que hace Timbre se hace por HTTP. No hay pantalla que sea el único camino para algo.

Superficie pública

/invoices
Emitir y consultar documentos
/quotes
Calcular impuestos sin emitir
/issuers
Alta de emisores, certificados y sucursales
/receivers
Validar un receptor contra el registro de Hacienda
/catalogs
Consultar el catálogo CAByS
/webhooks
Endpoints, secretos y entregas
/ops
Resumen operativo y métricas

Tu llave, una sola vez

Se genera al azar y solo guardamos su huella digital. Si alguna vez se filtra, lleva un prefijo que la delata al toque ante cualquier herramienta de seguridad.

Nunca facturás dos veces sin querer

Si tu sistema reintenta la misma petición (un timeout, un reintento automático), te devolvemos el documento que ya existe. No se emite dos veces.

Te avisamos, con evidencia

Cada aviso llega firmado y con reintentos automáticos si tu servidor no responde — no un correo que se puede perder en spam.

Tu historial, siempre disponible

El XML, la firma y la respuesta de Hacienda de cada documento quedan guardados y verificables. Nada se edita ni se borra después de escrito.

Ves todo sin tocar SQL

Cuántos documentos hay en cada estado, cuáles se atascaron y qué avisos no llegaron — en tiempo real, en JSON o en formato Prometheus.

Calcular sin emitir
{
'catalogVersion': '2026-08-01'// 1 month ago,
'lines': [
{
'numeroLinea': 1,
'cabys': '2312000000300',
'subTotal': '10000.00000',
'baseImponible': '10000.00000',
'impuesto': [
{
'codigo': '01',
'codigoTarifaIVA': '08',
'tarifa': '13.00',
'monto': '1300.00000'
}
],
'impuestoNeto': '1300.00000',
'montoTotalLinea': '11300.00000'
}
],
'resumen': {
'totalMercanciasGravadas': '10000.00000',
'totalVenta': '10000.00000',
'totalImpuesto': '1300.00000',
'totalComprobante': '11300.00000'
},
'provenance': [
{
'scope': 'line:1',
'cabys': '2312000000300',
'rule': 'catalog',
'confidence': 'confirmed',
'codigoTarifaIVA': '08'
}
],
'warnings': [
]
}

Gratis mientras lo construimos

Timbre no cobra nada hoy. Queremos que integres, que pongas clientes reales a facturar y que nos digas qué falta, antes de que exista una factura nuestra.

Sandbox

Ilimitado

Emití todo lo que necesites contra el entorno de pruebas. No cuenta para nada.

Producción

5 documentos al mes

Comprobantes reales ante Hacienda, sin costo. Si tu volumen se pasa de ahí, escribinos y lo subimos.

Para empezar

Sin tarjeta

Creás la cuenta y emitís. No pedimos medio de pago porque no hay nada que cobrar.

Empezar gratis

Los precios se van a anunciar cuando existan, con aviso y sin cambiarte las reglas de un día para otro. Nada de lo que emitas durante este periodo se va a facturar después.

Antes de arrancar

Lo que conviene saber antes de integrar, y antes de decidirte. El resto está en la documentación.

¿Es seguro pasar a producción si el estado dice "pre-release"?
Sí. Pre-release describe que todavía no hay un precio, no que la emisión sea de prueba: producción se activa cuando tu build pasa la aceptación de Hacienda, y desde ahí emite comprobantes reales como cualquier proveedor certificado.Ver más en la documentación
¿Quién puede ver el certificado de firma de mis clientes?
Nadie fuera del proceso que lo usa para firmar. Se cifra al subirlo, la API nunca lo devuelve, y si en algún momento vive detrás de un gestor de llaves externo, ese gestor recibe una llave de un solo uso para envolver — nunca el certificado.
¿Qué pasa si en algún momento me quiero ir a otro proveedor?
Te llevás lo tuyo. El XML firmado y la respuesta de Hacienda de cada documento quedan disponibles y verificables por hash, así que tu historial no depende de que sigamos siendo tu proveedor.Ver más en la documentación
¿Necesito el certificado digital desde el principio?
Sí, un PKCS#12 real. Timbre lo valida al subirlo: contraseña incorrecta, sin llave privada, vencido o con una identificación que no coincide se rechazan ahí y no a la hora de firmar. Queda cifrado y la API no lo devuelve nunca.
¿Y si tengo que corregir una factura ya emitida?
Con una nota de crédito o de débito, que Timbre emite igual que una factura. Ambas exigen la clave de 50 caracteres del documento original: existen solo como corrección de algo que Hacienda ya conoce, y una referencia desconocida se rechaza.Ver más en la documentación
¿Qué pasa si Hacienda está caída?
Timbre reintenta solo, esperando cada vez un poco más entre intento e intento. El XML firmado se escribe una sola vez y se reusa en cada reintento, así que un reintento nunca acuña una segunda firma para una clave que Hacienda ya podría tener.Ver más en la documentación
¿Se me pueden hacer huecos en la numeración?
No. Todo rechazo de derivación ocurre antes de consumir un consecutivo, y la numeración se asigna de una en una: dos peticiones simultáneas nunca reciben el mismo número.Ver más en la documentación
¿Qué es la facturación electrónica en Costa Rica?
Es el comprobante que el Ministerio de Hacienda exige por cada venta: un documento XML firmado digitalmente, numerado sin huecos, que Hacienda valida y acepta antes de que la venta cuente como facturada. Reemplaza la factura de papel o el PDF suelto.
¿Qué es un proveedor autorizado, y en qué se diferencia de hacerlo por mi cuenta?
Un proveedor autorizado es una empresa certificada por Hacienda para firmar y presentar comprobantes en nombre de terceros — la certificación que Timbre tiene. Hacerlo por tu cuenta significa construir vos mismo la firma XAdES y el seguimiento ante Hacienda; con un proveedor autorizado, integrás por API y ese trabajo ya está resuelto.
¿Necesito saber de facturación electrónica para integrar Timbre?
No. Mandás los datos de la venta — qué se vendió, a quién, por cuánto — y Timbre calcula el impuesto, numera, firma y presenta el documento ante Hacienda. No hace falta conocer el formato XML ni las reglas de Hacienda para empezar.

Empezá a construir con Timbre.

Creá una cuenta y leé la documentación. Empezás en sandbox y activás producción desde el panel cuando tu integración esté lista.

Crear una cuentaLeer la documentación