APIS

We offer an extensive set of APIs to manage your products and feeds; some are optional and can improve your integration experience.

Product Essentials

GetBrands(Here): Retrieves all available brands*.
GetCategoryTree(Here): Retrieves all product categories.
GetCategoryAttributes(Here): Retrieves a list of attributes for a category.
GetContentScore(Here): Retrieve attributes that contribute to content scoring for a category.
ProductCreate(Here): Product creation.
Image(Here): Image upload.
ProductUpdate(Here): Product update.
GetProducts(Here): Retrieves one or more products.
ProductRemove(Here): Product removal.

Feed Essentials

FeedList(Here): Retrieves all Feeds from the last 30 days.
FeedOffsetList(Here): Retrieves a subset of Feeds from the last 30 days, for example, you can filter by status.
FeedStatus(Here): Retrieves the details of a specific Feed.
FeedCancel(Here): Cancels pending Feeds.

Additional

GetCategoryByAttributesSet(Here): Retrieves categories by providing attributes.
GetBrandMappedAttributes(Here): Retrieves attributes associated with brands.
GetMappedAttributesOptions(Here): Retrieves attribute options mapped to other attribute options.
FeedCount(Here): Provides Feed statistics.
GetFeedRawInput(Here): Retrieves the original request XML for one or more Feeds.

DO WE SUPPORT PRODUCT VARIATIONS?

Starting in 2025, we have gradually begun to include products with variations in categories beyond fashion and footwear. These products will be linked through a Parent SKU (ParentSKU), which can be manually provided or, if not specified, will default to the SKU of the first variation.

It’s important to note that the ParentSKU must match the _SellerSku _of the product designated as the parent.

To learn how to identify whether a category supports multiple variations, please visit the section “How to know if a category supports multiple variations?” at the following link: (Here).

🚧
Product upload error.
It’s important to always validate the existence of a parent product before creating new variables.
If the parent product is in the same request as the child products, be aware that if the upload of the parent product fails, it will automatically cause the rejection of the child products as well.

⚠️
Recommended Batch Size
To optimize feed usage, group your products into batches. It is recommended to send between 500 and 1,000 products per request, depending on the size and complexity of the data included.

How to use the APIs to create a product?

Retrieve all available brands using GetBrands.
Then, retrieve all available categories using GetCategoryTree.
For the selected category, use GetCategoryAttributes to obtain the respective attributes, filtering by the PrimaryCategory field.
Use the GetContentScore API to retrieve additional information about the attributes that contribute to content scoring, along with the corresponding rules to achieve the maximum score.
Once you have the brand, categories, and respective attributes, use ProductCreate to create the product.
After you get the product creation response, you must upload images using Image.
In steps 4 and 5, always monitor the feed status, and you can use webhooks with the GetProducts API.

🚧
Brand not found
Remember, if the brand you want to sell is not available, you can publish it under the "Generic" category or request the creation of a new brand at the following link:
FORM

How do I update or delete a product?

You must use ProductUpdate and ProductRemove, respectively. Always remember to monitor the feed status.

🚧
Update considerations
Do not deactivate or delete products that have Fulfillment by Falabella, as these actions could disable the ability to sell your products with secured stock.

When the ShipmentType is Dropshipping, the orders are Fulfilled by the seller, so they must consume stock since they are assembled in the seller's warehouse.

When the ShipmentType is Own Warehouse, these orders are Fulfilled by Falabella and should not consume stock because it has already been delivered to Falabella.com to handle the fulfillment on behalf of the seller.

What other considerations should be taken into account?

Remember, you can always view your product details using GetProducts.
Remember that products with less than 30 points will be automatically rejected, while those scoring between 30 and 70 points will go through a manual review. Products that score above 70 points will be automatically approved. For this reason, it is essential to use the GetContentScore API to optimize content quality and ensure approval.
Remember that you can also edit your products once they are created and check whether the content score rules have been met. (Products>Product Manager>edit details).

Producto con puntaje de contenido deficiente

You can use FeedStatus to view the error details of a particular feed.

Product Creation Flow

You can click on the image to view it, or right-click and select "Save As" to download it and keep the image in its original resolution.