Webhooks

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

1. Go to https://sellercenter.falabella.com/.
2. Once inside, click on "My Account".
3. Unfold the menu, go to "Integrations".
4. Once inside, click on the "Webhooks" tab, then click on Add Webhooks.
5. 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: