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

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. 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.
5. Once you have the brand, categories, and respective attributes, use ProductCreate to create the product.
6. After you get the product creation response, you must upload images using Image.
7. 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).

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