Aún no hay webhooks de salida. Para reaccionar a eventos, consulta periódicamente los endpoints de lectura, bajo 100 solicitudes por minuto.
Lo que existe hoy
La API externa todavía no envía webhooks a tu sistema. Los únicos webhooks en operación son los que Avos recibe de los proveedores de pago, y los clientes no pueden configurarlos. Si necesitas notificación en tiempo real, escribe a soporte mediante el formulario de contacto para que hablemos del caso de uso.
Seguimiento por polling
Para saber cuándo se aprobó o se pagó un período, consulta GET /payroll/periods a intervalos regulares y compara el estado con lo que guardaste la última vez; la misma lógica sirve para empleados nuevos o modificados (GET /employees) y para los registros de asistencia (GET /time-entries, filtrados por fecha).
Con el límite de 100 solicitudes por minuto por clave, una consulta por minuto por recurso queda muy por debajo del tope y da un retraso máximo de un minuto, suficiente para la mayoría de las integraciones de nómina.
Idempotencia de tu lado
Guarda el id y el estado de cada período y empleado que hayas procesado, y trata solo lo que cambió. Avos no reenvía nada ni garantiza el orden entre consultas, así que la deduplicación corresponde al sistema que consume la API.