⚠️
Warning
Always check the feed details to confirm whether the product was successfully created or if it has any warnings or rejections.

🚧
Important for international model
For sellers operating under the international model, it is mandatory to include the local language name (NameEn = USA, NameCN = China) when creating products, in addition to the publication name (Name), due to customs requirements for product imports.

Request Data

The request body must be sent in XML format. Fields with empty values will be ignored and not processed. To optimize feed usage, it is recommended to group products into batches. The suggested size starts at 500 products per request, and can be adjusted based on data complexity and the seller’s expected response times, up to a maximum of 1,000 products per batch.

Each category includes a specific set of mandatory and optional attributes related to its type. However, there is a base set of attributes common to all categories in Falabella, which is detailed below.

Field	Type	Description	Required	Section
SellerSku	String	Unique identifier for the product within the system.	Yes	Product
Name	String	Product name displayed to the customer.	Yes	Product
PrimaryCategory	Integer	ID of the main category. Obtained from the GetCategoryTree endpoint, where it is called CategoryId.	Yes	Product
Description	String	Product HTML description. Between 6 and 25,000 characters.	Yes	Product
Brand	String	Product brand.	Yes	Product
ProductId	Numberfield	Harmonized code (EAN, UPC, ISBN).	No	Product
BusinessUnits	Subsection	Section containing stock, prices, and associated operator.	Yes	Product
OperatorCode	String	Operator code. Example: facl, fape, faco.	Yes	BusinessUnits.BusinessUnit
Price	Decimal	Product price.	Yes	BusinessUnits.BusinessUnit
SpecialPrice	Decimal	Discounted price. Mandatory if offer dates are provided.	No	BusinessUnits.BusinessUnit
SpecialFromDate	DateTime	Offer start date. Format: `YYYY-MM-DD HH:MM:SS`. Mandatory if SpecialPrice is provided.	Conditional, only if SpecialPrice is sent	BusinessUnits.BusinessUnit
SpecialToDate	DateTime	Offer end date. Format: `YYYY-MM-DD HH:MM:SS`. Mandatory if SpecialPrice is provided.	Conditional, only if SpecialPrice is sent	BusinessUnits.BusinessUnit
Stock	Integer	Available stock quantity.	Yes	BusinessUnits.BusinessUnit
Status	String	Product status per operator: `active` or `inactive`.	Yes	BusinessUnits.BusinessUnit
ProductData	Subsection	Contains extended product attributes defined by category.	Yes	Product
ConditionType	String	Product condition; value depends on category, e.g., `New`.	Yes	ProductData
PackageHeight	Integer	Package height (in cm).	Yes	ProductData
PackageWidth	Integer	Package width (in cm).	Yes	ProductData
PackageLength	Integer	Package length (in cm).	Yes	ProductData
PackageWeight	Decimal	Package weight (in kg).	Yes	ProductData
TaxPercentage	String	Product tax percentage.	Conditional (Mandatory only in Colombia)	ProductData

Remember that you can query the attributes associated with a category using the GetCategoryAttributes endpoint, and additionally check which attributes contribute to scoring through the GetContentScore endpoint.

What is a multi-variation category?

One of the most important considerations when creating products is to identify whether the category supports multi-variations. Categories that support multi-variation allow you to group similar products (e.g., by size or color) into a single listing on Falabella.com, as shown in the image below:

Some categories, such as clothing, footwear, or accessories, allow you to create products with multiple variations (e.g., color and size). These variations must be correctly structured at the product level for proper publication.

How to know if a category supports multi-variation?

You must use the GetCategoryAttributes API.

If the response includes an attribute with FeedName = "Variation", then the category does not support multi-variation.
If that attribute is not present, the category does support multi-variation.

How to identify attributes that generate variations?

Once you confirm that a category supports multi-variation, the attributes that trigger it must meet both of the following conditions:

IsGlobalAttribute = 0
GroupName = "Variation"

All such attributes must be declared at the Product level, not inside ProductData.

Example of an attribute that generates variation:

<Attribute>
  <Label>Color básico variant</Label>
  <Name>color_basico_variant</Name>
  <FeedName>ColorBasicoVariant</FeedName>
  <GlobalIdentifier>ATT000003974</GlobalIdentifier>
  <GroupName>Variation</GroupName>
  <isMandatory>1</isMandatory>
  <IsGlobalAttribute>0</IsGlobalAttribute>
  <Description>Basic color of the variant</Description>
  <ProductType>simple</ProductType>
  <InputType>dropdown</InputType>
  <AttributeType>option</AttributeType>
  <ExampleValue></ExampleValue>
  <MaxLength></MaxLength>
</Attribute>

How to structure multiple variations?

All variations must be linked to the same ParentSku, which corresponds to the SellerSku of the product designated as the parent.

You must specify the ParentSku when creating each variation. When creating a product group, you need to choose which SKU will be the parent product. All products in the group must share the same ParentSku.

XML example for product creation with multiple variations

<?xml version="1.0" encoding="UTF-8"?>
<Request>
  <Product>
    <SellerSku>SKU1</SellerSku>
    <ParentSku>SKU1</ParentSku>
    <Name>PRODUCT TEST - TEST - TEST</Name>
    <PrimaryCategory>811</PrimaryCategory>
    <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</Description>
    <Brand>EPATE</Brand>
    <ProductId>430450</ProductId>
    <Color>Blanco</Color>
    <ColorBasico>Blanco</ColorBasico>
    <Talla>39</Talla>
    <BusinessUnits>
      <BusinessUnit>
        <OperatorCode>facl</OperatorCode>
        <Price>59990</Price>
        <SpecialPrice>35990</SpecialPrice>
        <SpecialFromDate>2023-05-26 00:00:00</SpecialFromDate>
        <SpecialToDate>2023-10-31 23:59:59</SpecialToDate>
        <Stock>36</Stock>
        <Status>active</Status>
      </BusinessUnit>
    </BusinessUnits>
    <ProductData>
      <ConditionType>Nuevo</ConditionType>
      <PackageHeight>10</PackageHeight>
      <PackageWidth>10</PackageWidth>
      <PackageLength>10</PackageLength>
      <PackageWeight>1</PackageWeight>
      <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
      <Genero>Mujer</Genero>
    </ProductData>
  </Product>

  <Product>
    <SellerSku>SKU2</SellerSku>
    <ParentSku>SKU1</ParentSku>
    <Name>PRODUCT TEST - TEST - TEST</Name>
    <PrimaryCategory>811</PrimaryCategory>
    <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit...</Description>
    <Brand>EPATE</Brand>
    <ProductId>888888</ProductId>
    <Color>Blanco</Color>
    <ColorBasico>Blanco</ColorBasico>
    <Talla>39</Talla>
    <BusinessUnits>
      <BusinessUnit>
        <OperatorCode>facl</OperatorCode>
        <Price>59990</Price>
        <SpecialPrice>35990</SpecialPrice>
        <SpecialFromDate>2023-05-26 00:00:00</SpecialFromDate>
        <SpecialToDate>2023-10-31 23:59:59</SpecialToDate>
        <Stock>36</Stock>
        <Status>active</Status>
      </BusinessUnit>
    </BusinessUnits>
    <ProductData>
      <ConditionType>Nuevo</ConditionType>
      <PackageHeight>10</PackageHeight>
      <PackageWidth>10</PackageWidth>
      <PackageLength>10</PackageLength>
      <PackageWeight>1</PackageWeight>
      <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
      <Genero>Mujer</Genero>
    </ProductData>
  </Product>
</Request>

Example of Different Requests

⚠️
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.

ℹ️
Note:
These examples are for reference purposes only. You should always consider the required and optional fields according to the GetCategoryAttributes endpoint.
For more details, refer to the documentation: GetCategoryAttributes.

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Product>
        <SellerSku>SKU-TEST-12345</SellerSku>
        <ParentSku>SKU-TEST-12345</ParentSku>
                <Name>PRODUCT TEST - TEST - TEST</Name>
                <PrimaryCategory>811</PrimaryCategory>
                <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
                <Brand>EPATE</Brand>
                <ProductId>4066749430450</ProductId>
                <Color>Blanco</Color>
                <ColorBasico>Blanco</ColorBasico>
                <Talla>39</Talla>
                <BusinessUnits>
                    <BusinessUnit>
                        <OperatorCode>facl</OperatorCode>
                        <Price>59990</Price>
                        <SpecialPrice>35990</SpecialPrice>
                        <SpecialFromDate>2023-05-26 00:00:00</SpecialFromDate>
                        <SpecialToDate>2023-10-31 23:59:59</SpecialToDate>
                        <Stock>36</Stock>
                        <Status>active</Status>
                    </BusinessUnit>
                </BusinessUnits>
                <ProductData>
                    <ConditionType>Nuevo</ConditionType>
                    <PackageHeight>10</PackageHeight>
                    <PackageWidth>10</PackageWidth>
                    <PackageLength>10</PackageLength>
                    <PackageWeight>1</PackageWeight>
                    <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
                    <Genero>Mujer</Genero>
                </ProductData>
            </Product>
        </Request>

<Request>
    <Product>
        <SellerSku>9087978897</SellerSku>
        <Name>Test 1</Name>
        <Variation>...</Variation>
        <ParentSku />
        <ProductId>9087978897</ProductId>
        <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
        <Brand>2K GAMES</Brand>
        <PrimaryCategory>2723</PrimaryCategory>
        <BusinessUnits>
            <BusinessUnit>
                <OperatorCode>facl</OperatorCode>
                <Price>1600.00</Price>
                <SpecialPrice>1200.00</SpecialPrice>
                <SpecialFromDate>2025-06-20 00:00:00</SpecialFromDate>
                <SpecialToDate>2025-06-30 00:00:00</SpecialToDate>
                <Stock>50</Stock>
                <Status>active</Status>
            </BusinessUnit>
        </BusinessUnits>
        <ProductData>
            <PackageWidth>12</PackageWidth>
            <PackageLength>12</PackageLength>
            <PackageHeight>12</PackageHeight>
            <ConditionType>Nuevo</ConditionType>
            <PackageWeight>1</PackageWeight>

        </ProductData>
    </Product>
</Request>

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Product>
        <SellerSku>SKU-TEST-123456</SellerSku>
        <ParentSku>SKU-TEST-123456</ParentSku>
                <Name>PRODUCT TEST - TEST - TEST</Name>
                <PrimaryCategory>811</PrimaryCategory>
                <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
                <Brand>EPATE</Brand>
                <Variation>US 7</Variation>
                <Color>Blanco</Color>
                <ColorBasico>Blanco</ColorBasico>
                <Talla>39</Talla>
                <BusinessUnits>
                    <BusinessUnit>
                        <OperatorCode>facl</OperatorCode>
                        <Price>59990</Price>
                        <SpecialPrice>35990</SpecialPrice>
                        <SpecialFromDate>2025-05-26 00:00:00</SpecialFromDate>
                        <SpecialToDate>2025-10-31 23:59:59</SpecialToDate>
                        <Stock>36</Stock>
                        <Status>active</Status>
                    </BusinessUnit>
                </BusinessUnits>
                <ProductData>
                    <ConditionType>Nuevo</ConditionType>
                    <PackageHeight>10</PackageHeight>
                    <PackageWidth>10</PackageWidth>
                    <PackageLength>10</PackageLength>
                    <PackageWeight>1</PackageWeight>
                    <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
                    <Genero>Mujer</Genero>
                </ProductData>
            </Product>
            <Product>
                <SellerSku>SKU-TEST-78905</SellerSku>
                <ParentSku>SKU-TEST-123456</ParentSku>
                        <Name>PRODUCT TEST - TEST - TEST</Name>
                        <PrimaryCategory>811</PrimaryCategory>
                        <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
                        <Brand>EPATE</Brand>
                        <Variation>US 7</Variation>
                        <Color>Azul</Color>
                        <ColorBasico>Rojo</ColorBasico>
                        <Talla>38</Talla>
                        <BusinessUnits>
                            <BusinessUnit>
                                <OperatorCode>facl</OperatorCode>
                                <Price>59990</Price>
                                <SpecialPrice>35990</SpecialPrice>
                                <SpecialFromDate>2025-05-26 00:00:00</SpecialFromDate>
                                <SpecialToDate>2025-10-31 23:59:59</SpecialToDate>
                                <Stock>36</Stock>
                                <Status>active</Status>
                            </BusinessUnit>
                        </BusinessUnits>
                        <ProductData>
                            <ConditionType>Nuevo</ConditionType>
                            <PackageHeight>10</PackageHeight>
                            <PackageWidth>10</PackageWidth>
                            <PackageLength>10</PackageLength>
                            <PackageWeight>1</PackageWeight>
                            <DisciplinaZapatillas>Tenis</DisciplinaZapatillas>
                            <Genero>Mujer</Genero>
                        </ProductData>
                    </Product>
                </Request>

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
   <Product>
        <SellerSku>9087978897</SellerSku>
        <Name>Test 1</Name>
        <Variation>...</Variation>
        <ParentSku />
        <ProductId>9087978897</ProductId>
        <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
        <Brand>2K GAMES</Brand>
        <PrimaryCategory>2723</PrimaryCategory>
        <BusinessUnits>
            <BusinessUnit>
                <OperatorCode>facl</OperatorCode>
                <Price>1600.00</Price>
                <SpecialPrice>1200.00</SpecialPrice>
                <SpecialFromDate>2025-06-20 00:00:00</SpecialFromDate>
                <SpecialToDate>2025-06-30 00:00:00</SpecialToDate>
                <Stock>50</Stock>
                <Status>active</Status>
            </BusinessUnit>
        </BusinessUnits>
        <ProductData>
            <PackageWidth>12</PackageWidth>
            <PackageLength>12</PackageLength>
            <PackageHeight>12</PackageHeight>
            <ConditionType>Nuevo</ConditionType>
            <PackageWeight>1</PackageWeight>

        </ProductData>
    </Product>
       <Product>
        <SellerSku>9087978898</SellerSku>
        <Name>Test 1</Name>
        <Variation>...</Variation>
        <ParentSku />
        <ProductId>9087978898</ProductId>
        <Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.</Description>
        <Brand>2K GAMES</Brand>
        <PrimaryCategory>2723</PrimaryCategory>
        <BusinessUnits>
            <BusinessUnit>
                <OperatorCode>facl</OperatorCode>
                <Price>1600.00</Price>
                <SpecialPrice>1200.00</SpecialPrice>
                <SpecialFromDate>2025-06-20 00:00:00</SpecialFromDate>
                <SpecialToDate>2025-06-30 00:00:00</SpecialToDate>
                <Stock>50</Stock>
                <Status>active</Status>
            </BusinessUnit>
        </BusinessUnits>
        <ProductData>
            <PackageWidth>12</PackageWidth>
            <PackageLength>12</PackageLength>
            <PackageHeight>12</PackageHeight>
            <ConditionType>Nuevo</ConditionType>
            <PackageWeight>1</PackageWeight>

        </ProductData>
    </Product>
</Request>

Response Data

This API works asynchronously. Receiving a 200 OK response only confirms the request was accepted, not that the products were successfully created.

To check the final result:

Use the returned RequestId to query the status via the FeedStatus API.
Alternatively, configure a webhook to receive automatic notifications when the feed processing finishes.

For more details, refer to the FeedStatus endpoint documentation.

Success

<SuccessResponse>
    <Head>
        <RequestId>cb106552-87f3-450b-aa8b-412246a24b34</RequestId>
        <RequestAction>ProductCreate</RequestAction>
        <ResponseType/>
        <Timestamp>2016-06-22T04:40:14+0200</Timestamp>
    </Head>
    <Body/>
</SuccessResponse>

Errors

<?xml version="1.0" encoding="UTF-8"?>
<ErrorResponse>
    <Head>
        <RequestAction>ProductCreate</RequestAction>
        <ErrorType>Platform</ErrorType>
        <ErrorCode>1000</ErrorCode>
        <ErrorMessage>Could not save product: An exact match of the document is being processed, cb106552-87f3-450b-aa8b-412246a24b34</ErrorMessage>
    </Head>
    <Body/>
</ErrorResponse>

Error Code	Message
1000	Could not save product: %s (No se pudo guardar el producto)
1000	Format Error Detected (Error de formato detectado)

Description Formatting

The product description can be plain text like this:

<Description>product description</Description>

It can also include certain HTML tags, such as ul, li, and span. If HTML is embedded, it must be escaped as character data, like this:

<Description><![CDATA[<div>the description <b>bold</b></div>]]></Description>