Concepto de webhooks
Un webhook es una llamada HTTP que LX CloudPos hace a tu sistema para notificarte que ocurrió algo (típicamente, que Hacienda resolvió un comprobante). La dirección de la llamada es la opuesta al resto de la API: en vez de que vos preguntés “¿ya está listo?”, nosotros te avisamos cuando lo está.
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 | Tú la implementas |
| Complejidad inicial | Requiere endpoint público | Más simple para probar |
💡 Recomendamos webhook siempre que sea posible. Solo usá polling si no podés exponer un endpoint público (intranets aisladas, apps móviles sin backend).