¿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.

¿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.

¿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.

¿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.

¿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.

Proveedor certificado por el Ministerio de Hacienda

Hacé que tu producto facture ante Hacienda.

Vos mandás la venta y Timbre genera el comprobante. Desde cualquier lenguaje que hable REST.

Empezá a construir Leer la documentación

Sandbox gratis e ilimitado
Sin tarjeta
Generá tus llaves al registrarte

Estándar: Factura Electrónica v4.4
Verificado: Ministerio de Hacienda
Estado: Producción

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.

Cada respuesta lleva su environment, así que un documento de sandbox no se puede confundir con uno real.

Dónde encaja Timbre

Cuatro lugares donde una venta de tu software tiene que terminar en una factura electrónica.

Punto de venta

Cada venta en caja sale con su comprobante

Mandás la venta y guardás la clave y el consecutivo que te devolvemos. Sirve para tiquete electrónico y para factura.

Contabilidad y ERP

Un emisor por cliente, desde una sola integración

Cada contribuyente tiene sus propias sucursales y terminales. Facturás a nombre de cada uno sin montar una integración por cliente.

Tienda en línea

Cada orden pagada se factura sola

Si mandás una llave de idempotencia y tu sistema reintenta, recibís el documento que ya existe en vez de emitir otro. Cuando Hacienda resuelve, te llega un aviso firmado.

Ver el caso completo

Software con cobros recurrentes

Facturás cada cobro, y corregís lo ya emitido

Cada cobro se emite como factura desde tu producto. Si algo cambia después, las notas de crédito y de débito lo corrigen contra el documento original.

Ver el caso completo

El ciclo de un documento

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

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.
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.
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.
Aviso
Te avisamos con evidencia, no con un correo
El resultado llega a tu servidor firmado, y Timbre reintenta la entrega hasta confirmar que la recibiste.

Lo que te ahorrás de construir

Emitir ante Hacienda no es un solo llamado. Es esta lista, y alguien tiene que hacerla.

Si lo hacés vos

01Firmar cada documento con XAdES y el certificado de tu cliente
02Asignar clave y consecutivo sin huecos ni repetidos
03Presentar a Hacienda y seguir cada documento hasta su veredicto
04Reintentar lo transitorio, y distinguirlo de lo definitivo
05Custodiar el certificado de firma de cada cliente, con su llave privada
06Conservar el XML, la firma y la respuesta de cada documento

Con Timbre

POST /core/v1/invoices

Das de alta al contribuyente una vez y mandás cada venta en una petición. El resultado lo seguís por estado o por un aviso firmado.

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 y no hay una ventana en la que dejes de poder leer tus propios documentos. 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.
Sesiones revocables: Podés cerrar cualquier sesión al instante, la tuya o la de tu equipo, sin 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.

Una API, no un portal

Todo lo que hace Timbre pasa por HTTP.

Cambia el lenguaje, no el resultado. Timbre es HTTP y JSON: si tu lenguaje puede hacer una petición, puede emitir un documento, sin SDK que instalar ni versión que mantener.

curl -X POST https://api.timbrecr.com/core/v1/invoices \
  -H "Authorization: Bearer timbre_sk_…" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 3f6f0e9e-9d29-4a1e-9a25-2a5f2f0f1b77' \
  -d '{
    "issuerId": "…",
    "branchCode": "001",
    "terminalCode": "00001",
    "documentType": "FE",
    "finalize": true,
    "invoice": {
      "proveedorSistemas": "…",
      "codigoActividadEmisor": "620100",
      "emisor": {},
      "condicionVenta": "01",
      "lines": [
        {
          "lineNumber": 1,
          "cabys": "2312000000300",
          "detail": "Harina de arroz, saco de 25 kg",
          "quantity": "2.000",
          "unitOfMeasure": "Unid",
          "unitPrice": "5000.00000"
        }
      ]
    }
  }'

$payload = <<<'JSON'
{
  "issuerId": "…",
  "branchCode": "001",
  "terminalCode": "00001",
  "documentType": "FE",
  "finalize": true,
  "invoice": {
    "proveedorSistemas": "…",
    "codigoActividadEmisor": "620100",
    "emisor": {},
    "condicionVenta": "01",
    "lines": [
      {
        "lineNumber": 1,
        "cabys": "2312000000300",
        "detail": "Harina de arroz, saco de 25 kg",
        "quantity": "2.000",
        "unitOfMeasure": "Unid",
        "unitPrice": "5000.00000"
      }
    ]
  }
}
JSON;

$ch = curl_init("https://api.timbrecr.com/core/v1/invoices");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer timbre_sk_…",
        "Content-Type: application/json",
        "Idempotency-Key: 3f6f0e9e-9d29-4a1e-9a25-2a5f2f0f1b77",
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$document = json_decode(curl_exec($ch), true);

using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer timbre_sk_…");
client.DefaultRequestHeaders.Add("Idempotency-Key", "3f6f0e9e-9d29-4a1e-9a25-2a5f2f0f1b77");

var payload = """
{
  "issuerId": "…",
  "branchCode": "001",
  "terminalCode": "00001",
  "documentType": "FE",
  "finalize": true,
  "invoice": {
    "proveedorSistemas": "…",
    "codigoActividadEmisor": "620100",
    "emisor": {},
    "condicionVenta": "01",
    "lines": [
      {
        "lineNumber": 1,
        "cabys": "2312000000300",
        "detail": "Harina de arroz, saco de 25 kg",
        "quantity": "2.000",
        "unitOfMeasure": "Unid",
        "unitPrice": "5000.00000"
      }
    ]
  }
}
""";

var response = await client.PostAsync(
    "https://api.timbrecr.com/core/v1/invoices",
    new StringContent(payload, Encoding.UTF8, "application/json"));

var document = await response.Content.ReadAsStringAsync();

import requests

response = requests.post(
    "https://api.timbrecr.com/core/v1/invoices",
    headers={
        "Authorization": "Bearer timbre_sk_…",
        "Idempotency-Key": "3f6f0e9e-9d29-4a1e-9a25-2a5f2f0f1b77",
    },
    json={
        "issuerId": "…",
        "branchCode": "001",
        "terminalCode": "00001",
        "documentType": "FE",
        "finalize": True,
        "invoice": {
            "proveedorSistemas": "…",
            "codigoActividadEmisor": "620100",
            "emisor": {},
            "condicionVenta": "01",
            "lines": [
                {
                    "lineNumber": 1,
                    "cabys": "2312000000300",
                    "detail": "Harina de arroz, saco de 25 kg",
                    "quantity": "2.000",
                    "unitOfMeasure": "Unid",
                    "unitPrice": "5000.00000",
                },
            ],
        },
    },
)

document = response.json()

const invoice = {
  "issuerId": "…",
  "branchCode": "001",
  "terminalCode": "00001",
  "documentType": "FE",
  "finalize": true,
  "invoice": {
    "proveedorSistemas": "…",
    "codigoActividadEmisor": "620100",
    "emisor": {},
    "condicionVenta": "01",
    "lines": [
      {
        "lineNumber": 1,
        "cabys": "2312000000300",
        "detail": "Harina de arroz, saco de 25 kg",
        "quantity": "2.000",
        "unitOfMeasure": "Unid",
        "unitPrice": "5000.00000"
      }
    ]
  }
}

const response = await fetch("https://api.timbrecr.com/core/v1/invoices", {
  method: "POST",
  headers: {
    Authorization: "Bearer timbre_sk_…",
    "Content-Type": "application/json",
    "Idempotency-Key": "3f6f0e9e-9d29-4a1e-9a25-2a5f2f0f1b77",
  },
  body: JSON.stringify(invoice),
})

const document = await response.json()

Ver el ejemplo completo

Respuesta201

{
  "id": "0b6f2c1e-3a5d-4f0e-9c7b-2d8e4a1f6b90",
  "status": "finalized",
  "clave": "50621092600310123456700100001010000000042112345678",
  "numeroConsecutivo": "00100001010000000042"
}

Igual en todos los lenguajes

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, con reintentos automáticos hasta confirmar la entrega, 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: todo en tiempo real, en JSON o en formato Prometheus.

Calcular sin emitir

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
'catalogVersion': '2026-08-01'// 3 months 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': [
]
}

Recursos

Para quien decide y para quien integra

Guías sin jerga, casos según el tipo de producto y la documentación técnica completa. Todo abierto, sin crear cuenta.

Guías

Si estás decidiendo

La facturación electrónica explicada en términos de negocio, para evaluarla sin depender de tu equipo técnico.

Ver todas las guías

Casos de uso

Si querés ver tu caso

Cómo se ve dentro de distintos tipos de software y en qué momento se emite cada comprobante.

Ver todos los casos

Documentación

Si vas a integrar

La referencia técnica completa: autenticación, emisión, estados y webhooks, con ejemplos para probar en sandbox.

Ir a la documentación

Un plan para cuando factures en serio

Empezá gratis. Cuando tu volumen crezca, Pro es el paso que más eligen los equipos que ya están facturando en producción.

Más elegido

₡24 900,00 / mes

1000 documentos reales al mes ante Hacienda

Documentos reales ante Hacienda, sin límite de proyectos.
Sandbox ilimitado contra el entorno de pruebas.
Soporte por correo.

SuscribirmeVer todos los planes

¿Estás empezando? Podés probar Timbre gratis, sin tarjeta.

Antes de arrancar

Lo que conviene saber antes de integrar, y antes de decidirte. El resto está 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 cuenta Leer la documentación