Webhooks

La API cuenta con webhooks que pueden ser configurados de forma independiente para cada compañía. Dichos webhooks sirven para que puedas mantener tu sistema sincronizado.

Si quieres una comunicación bidireccional en el modelo de emisión asíncrona requieres configurar un webhook como canal de retorno. En este contexto adquiere un rol fundamental.

Requisitos técnicos clave

✔ Configuración del webhook:

• Los webhooks se configuran a nivel de compañía, actuando como centro de control para todas sus oficinas asociadas.
• Se puede asociar durante el registro de la empresa en el campo webhooks, o posteriormente se puede actualizar la información en cualquier momento.

✔ Configuración de CORS:

• Tu endpoint debe aceptar peticiones desde nuestros dominios:
• https://e-providers-esp-vf-api.alegra.com (producción)
• https://sandbox-e-providers-esp-vf-api.alegra.com (pruebas)

✔ Headers personalizados:

• Los replicamos exactamente como los registraste
• Ejemplo de uso:

Authorization: Bearer [tu_token]
X-Company-ID: [tu_identificador]

✔ Pruebas iniciales:

Verifica en SANDBOX que:

• Tu endpoint responde correctamente a POST
• Puede procesar nuestro payload
• Los headers llegan como esperas