Conecta Timbreo por API

1. 1

   Crea una llave de API

   En Configuración → Desarrolladores generas una llave. Guárdala bien: se muestra completa una sola vez.

2. 2

   Elige el entorno: prueba o producción

   Las llaves de prueba timbran CFDI sin validez fiscal y sin gastar saldo — perfectas para desarrollar. Las de producción (live) emiten facturas reales y descuentan saldo.

3. 3

   Da solo los permisos necesarios

   Cada llave tiene permisos por recurso (facturas, clientes, productos, pagos, catálogos). Otorga únicamente lo que tu integración necesita; si intenta algo fuera de su alcance, la API responde 403.

4. 4

   Llama a la API con tu llave

   Envía la llave en la cabecera de autorización de cada petición. Antes de timbrar, la API corre el mismo Escudo Timbreo (validación previa) que el dashboard.

Configura un webhook para que Timbreo avise a tu sistema cuando pasa algo (una factura se creó, se canceló, se registró un pago, etc.), sin que tengas que estar consultando.

1. 1

   Registra tu URL

   En Configuración → Webhooks, agrega la URL de tu servidor y elige los eventos que te interesan.

2. 2

   Verifica la firma

   Cada envío incluye una firma HMAC-SHA256 con el secreto de tu webhook. Valídala para confirmar que el mensaje viene de Timbreo.

3. 3

   Responde 2xx

   Si tu servidor responde con éxito, el evento queda entregado. Si falla, Timbreo reintenta con espera progresiva hasta lograrlo o agotar los intentos.