Find below all the payload definition for all entities.
HTTP Response
A callback will be successful, if the response http code, given by the seller system, is 200. The response content doesn't matter.
Retries of callbacks
Falabella Seller Center will retry the callback of the webhook event in case the seller based system was not reachable for any reason.
It will delay the next execution of the callback by some minutes to give the seller system time to recover.
Seller Center will continue to execute the callback until 30 days have passed.
Afterwards the callback is deleted from the Falabella Seller Center system even when it never succeeded and will not be retried afterwards.
The following table gives an overview about the delays of the execution of callbacks in case of a failure response.
Retry | 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 12 | 1440 | 01:00:00 | 04:18:46 |
Retry 13 | 1440 | 01:00:00 | 05:18:46 |
Retry 14 | 1440 | 01:00:00 | 06:18:46 |
Retry 15 | 1440 | 01:00:00 | 07:18:46 |
Retry 16 | 1440 | ... | ... |
1. Feed
Find bellow all the events sent for Feed entity and its payload definitions.
The Feed Created and Feed Completed events are only triggered for the following types:
- Product create
- Product update
- Product remove
- Image
Feed Created
{
"event": "onFeedCreated",
"payload": {
"Feed": "829a8d2a-d370-4fa6-8613-8554f43d5fed"
}
}
Field | Type | Description |
---|---|---|
Feed | String | A feed identifier to be used to get more details using the API. |
Feed Completed
{
"event": "onFeedCompleted",
"payload": {
"Feed": "829a8d2a-d370-4fa6-8613-8554f43d5fed"
}
}
Field | Type | Description |
---|---|---|
Feed | String | A feed identifier to be used to get more details using the API. |
How to handle onFeedCompleted
- After receiving this event, please call FeedStatus API action to get details.
- The event will only be triggered for a "Finished" feed, which will happen for most cases. If you do not receive a callback for long time, please call FeedStatus API action to discover if the Feed got status "Canceled" or "Error"
2. Product
Find bellow all the events sent for Product entity and its payload definitions.
Product Created
{
"event": "onProductCreated",
"payload": {
"SellerSkus": [
"NI006ELAAGWDNAFAMZ-43340"
]
}
}
Field | Type | Description |
---|---|---|
SellerSkus | String[] | List of seller skus to be used to get more details using the API. |
Product Updated
{
"event": "onProductUpdated",
"payload": {
"SellerSkus": [
"NI006ELAAGWDNAFAMZ-43340",
"NI006ELAAGWDNAFAMZ-43341",
"NI006ELAAGWDNAFAMZ-43342",
"NI006ELAAGWDNAFAMZ-43343"
]
}
}
Field | Type | Description |
---|---|---|
SellerSkus | String[] | List of seller skus to be used to get more details using the API. |
Product QC Status Changed
{
"event": "onProductQcStatusChanged",
"payload": {
"SellerSkus": [
"NI006ELAAGWDNAFAMZ-43341",
"NI006ELAAGWDNAFAMZ-43342"
]
}
}
Field | Type | Possible Other Values |
---|---|---|
SellerSkus | String[] | List of seller skus to be used to get more details using the API. |
3. Order
Find bellow all the events sent for Order entity and its payload definitions.
Order Created
{
"event": "onOrderCreated",
"payload": {
"OrderId": 190
}
}
Field | Type | Description |
---|---|---|
Order | Int | Order identifier to be used to get more details using the API. |
Order Items Status Changed
{
"event": "onOrderItemsStatusChanged",
"payload": {
"OrderId": 190,
"OrderItemIds": [2, 3],
"NewStatus": "ready_to_ship"
}
}
Valid values for "NewStatus":
{
"Statuses":[
"shipped",
"returned",
"return_waiting_for_approval",
"return_shipped_by_customer",
"return_rejected",
"ready_to_ship",
"processing",
"pending",
"failed",
"delivered",
"canceled"
]
}
Field | Type | Description |
---|---|---|
OrderId | Int | Order identifier to be used to get more details using the API. |
OrderItemIds | Int[] | Order Item identifiers to be used to get more details using the API. |
NewStatus | String | New item status |
Find bellow all the events sent for Metrics entity and its payload definitions.
5. Statistics
Find bellow all the events sent for Statistics entity and its payload definitions.
Statistics Updated
{
"event": "onStatisticsUpdated",
"payload": {}
}