Concepto de webhooks
Un webhook es una llamada HTTP que LX CloudPos realiza al sistema del integrador para notificar que ocurrió un evento (típicamente, que Hacienda resolvió un comprobante). La dirección de la llamada es la opuesta a la del resto de la API: en lugar de que el integrador consulte de forma reiterada si el resultado ya está disponible, LX CloudPos emite la notificación en el momento en que el resultado se produce.
Por qué webhook y no polling
| Webhook | Polling | |
|---|---|---|
| Latencia | Inmediato (<2 s) | Depende del intervalo (típico 30 s+) |
| Costo | 1 llamada | N llamadas, la mayoría redundantes |
| Carga en LX CloudPos | Baja | Alta |
| Confiabilidad | Con reintentos persistentes | La implementa el integrador |
| Complejidad inicial | Requiere endpoint público | Más simple para probar |
Se recomienda el uso de webhook siempre que sea posible. El polling debe reservarse para los casos en que no es posible exponer un endpoint público (intranets aisladas, aplicaciones móviles sin backend).