Conectar tu sistema: API y webhooks

Actualizado el 12/11/2026.

Si tenés un sistema propio, un ERP o una tienda que no es WooCommerce, se conecta con la API de Fluxa para emitir comprobantes, y recibe webhooks cuando cada uno se autoriza o falla. Esta parte la configura quien tenga el rol de desarrollador, administrador o dueño.

Credenciales de la API

1. Andá a Integración → API y tocá Nueva credencial. Creá una por sistema, así podés revocarlas por separado.
2. Copiá el token. Por seguridad no lo vas a poder ver de nuevo: si lo perdés, generá uno nuevo.
3. Guardalo en tu sistema como variable de entorno, nunca en el código.

En la misma pantalla está la Documentación completa de la API, con ejemplos. Dos cosas a tener en cuenta:

• Mandá un encabezado Idempotency-Key con un valor único por venta (por ejemplo, el número de pedido). Si tu sistema reintenta, Fluxa no factura dos veces.
• La API responde enseguida y el CAE llega después: consultalo o, mejor, esperá el webhook.

Webhooks

1. Andá a Integración → Webhooks y tocá Agregar destino con la URL de tu sistema.
2. Guardá el secreto: con él tu sistema verifica que cada aviso viene de Fluxa (encabezado Fluxa-Signature). La pantalla explica cómo verificar la firma.
3. Probá con Enviar prueba.

• Si tu sistema no responde, Fluxa reintenta varias veces. En Entregas recientes ves cada aviso y lo podés reenviar.
• Si un destino falla de forma seguida, se pausa y recibís un mail.
• Al generar un secreto nuevo, durante 24 horas Fluxa manda las dos firmas, para que actualices tu sistema sin perder avisos.