DocumentaciónAPI ReferenceWebhooks
Webhooks
Establece una conexión Server-to-Server donde Falabella notifica proactivamente eventos predefinidos configurados por el seller. A diferencia de las APIs, el webhook notifica al seller tan pronto como ocurre un evento.
Mejora Continua
Es crucial tener siempre webhooks en tu integración, para que puedas estar informado casi instantáneamente sobre diversos cambios en tus productos y/o órdenes.
Eventos
Establece una conexión Server to Server en la cual proactivamente falabella.com notificará una serie de eventos predefinidos anteriormente por el comercio. A diferencia de las APIS, es el webhook quien notifica al comercio apenas ocurra un evento, sin que este lo solicite y no al revés.
Los eventos que podemos encontrar son los siguientes:
Eventos Relacionados a Feed
- ●onFeedCompleted: Notificación de Feed ejecutado, puede ser con o sin rechazos.
- ●onFeedCreated: Notificación de creación de Feed.
Eventos Relacionados a Órdenes
- ●onOrderCreated: Notificación de generación de creación de una nueva Orden.
- ●onOrderItemsStatusChanged: Notificación cuando existe un cambio de estado en los ítems.
En el caso de las órdenes, en caso de fallas en el feed, este no enviará un evento de error, por lo cual es recomendable usar complementariamente FeedStatus para hacer seguimiento del feed.
Eventos Relacionados a Productos
- ●onProductCreated: Notificación de creación de nuevo producto.
- ●onProductQcStatusChanged: Notificación cuando existe un cambio en los puntos de contenido.
- ●onProductUpdated: Notificación cuando existe un cambio en el estado de un producto.
Configuración
Los webhooks pueden configurarse de dos formas diferentes:
Configuración vía Portal:
1. Ve a sellercenter.falabella.com
2. Haz clic en 'Mi Cuenta'
3. Ve a 'Integraciones'
4. Haz clic en la pestaña 'Webhooks', luego 'Agregar Webhooks'
5. Agrega la URL para recibir mensajes y elige los eventos
Configuración vía API:
Usa el endpoint API CreateWebhook para crear webhooks programáticamente, y DeleteWebhook para eliminarlos.
Respuestas de Webhook
Puedes ver todos los tipos de respuestas que el webhook entregará en la sección de Payloads de Webhook en los Endpoints de Webhooks.
Reintentos de Callback
Seller Center reintentará los callbacks del webhook si tu sistema no está disponible. Los reintentos comienzan en 1 segundo y aumentan progresivamente hasta intervalos de 1 hora, continuando por 30 días antes de ser removidos.
Programa de Reintentos
| Retry | Delay (min) | Delay (hh:mm:ss) | Cumulative |
|---|---|---|---|
| Retry 1 | 1 | 00:00:01 | 00:00:01 |
| Retry 2 | 5 | 00:00:05 | 00:00:06 |
| Retry 3 | 10 | 00:00:10 | 00:00:16 |
| Retry 4 | 30 | 00:00:30 | 00:00:46 |
| Retry 5 | 60 | 00:01:00 | 00:01:46 |
| Retry 6 | 120 | 00:02:00 | 00:03:46 |
| Retry 7 | 300 | 00:05:00 | 00:08:46 |
| Retry 8 | 600 | 00:10:00 | 00:18:46 |
| Retry 9 | 1440 | 01:00:00 | 01:18:46 |
| Retry 10 | 1440 | 01:00:00 | 02:18:46 |
| Retry 11 | 1440 | 01:00:00 | 03:18:46 |
| Retry N | 1440 | 01:00:00 | Previous + 1 hr |