API ReferenceSDK & PluginsFAQsContact Us
API Reference

Product Flows

To operate with our APIs, it is crucial that you understand the product flow.

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.
  • 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?

We currently support two types of variations, by both color and size. That means for the same product model, you can create multiple variations associated with different sizes and colors. These products will be linked through a parent SKU (ParentSKU), which can either be provided or will default to the ParentSKU of the first variation.

It is important to remember that the ParentSKU must be equivalent to the SellerSku of the product designated as the parent.

For more details, you can check the Product Creation section (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.

How to use the APIs to create a product?

  1. Retrieve all available brands using GetBrands.
  2. Then, retrieve all available categories using GetCategoryTree.
  3. For the selected category, use GetCategoryAttributes to obtain the respective attributes, filtering by the PrimaryCategory field.
  4. Once you have the brand, categories, and respective attributes, use ProductCreate to create the product.
  5. After you get the product creation response, you must upload images using Image.
  6. 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 perform actions like deactivation, deletion, or stock updates on 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.
  • We are working on an API to obtain the product content score details. Meanwhile, if the feed results indicate a lack of content score, you can view the details in Falabella Seller Center (Products>Product Manager>edit details).
Producto con puntaje de contenido deficiente

Producto con puntaje de contenido deficiente

  • You can use FeedStatus to view the error details of a particular feed.
  • The more attributes you complete for your product, the less likely it is to be rejected due to content score, and the higher the chance of selling.

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.