Continuous Improvement

It is crucial to always have webhooks in your integration, so you can be almost instantly informed about various changes in your product and/or orders.

Events

Establish a Server-to-Server connection in which falabella.com will proactively notify a series of predefined events previously set by the merchant. Unlike APIs, it is the webhook that notifies the merchant as soon as an event occurs, without the merchant requesting it, not the other way around.

The events we can encounter are as follows:

Events related to Feed

onFeedCompleted: Notification of executed Feed, can be with or without rejections.
onFeedCreated: Notification of Feed creation.

Events related to Orders

onOrderCreated: Notification of the generation of a new Order.
onOrderItemsStatusChanged: Notification when there is a change in item status.

In the case of orders, in the event of feed failures, it will not send an error event, so it is advisable to use FeedStatus additionally to track the feed.

Events related to Products

onProductCreated: Notification of the creation of a new product.
onProductQcStatusChanged: Notification when there is a change in content points.
onProductUpdated: Notification when there is a change in the status of a product.

Configuration

Webhooks can be configured in two different ways, through the Falabella Seller center portal and via API.

Configuration via Portal

Go to https://sellercenter.falabella.com/.
Once inside, click on "My Account".
Unfold the menu, go to "Integrations".
Once inside, click on the "Webhooks" tab, then click on Add Webhooks.
Add the URL to receive messages and choose the events.

Configuration via API

For the creation of APIs, follow the creation instructions in the section on Webhook Creation in Webhooks Endpoints (Here), using our createwebhook API, as well as the deletion of them using DeleteWebhook (Here).

Webhook Responses

You can see all types of responses that the webhook will deliver in the Webhook Payloads section in Webhooks Endpoints (Here)

Callback Retry Attempts

Falabella Seller Center will make retry attempts for the webhook callback event if the seller-based system is not available for any reason. Additionally, a delay in the subsequent execution of the callback will be scheduled to allow for the recovery of the seller's system. This process will continue for 30 days.

After this period, the callback will be removed from the Falabella Seller Center system, regardless of whether it was successful or not. No more callback retry attempts will be made after this point.

For more details on possible delays in executing callbacks after a failed response, refer to the following table:

Attempts	Minutes	Additional Delay in Minutes	Additional Delay in Minutes
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 + 1hrs