API ReferenceSDK & PluginsFAQsContact Us
API Reference
Start typing to search…

Creating Products

post
https://sellercenter-api.falabella.com/?Action=ProductCreate

ProductCreate Allows the creation of one or more products; this API is asynchronous and generates the creation of a Feed.

⚠️

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.

FieldTypeDescriptionRequiredSection
SellerSkuStringUnique identifier for the product within the system.YesProduct
NameStringProduct name displayed to the customer.YesProduct
PrimaryCategoryIntegerID of the main category. Obtained from the GetCategoryTree endpoint, where it is called CategoryId.YesProduct
DescriptionStringProduct HTML description. Between 6 and 25,000 characters.YesProduct
BrandStringProduct brand.YesProduct
ProductIdNumberfieldHarmonized code (EAN, UPC, ISBN).NoProduct
BusinessUnitsSubsectionSection containing stock, prices, and associated operator.YesProduct
OperatorCodeStringOperator code. Example: facl, fape, faco.YesBusinessUnits.BusinessUnit
PriceDecimalProduct price.YesBusinessUnits.BusinessUnit
SpecialPriceDecimalDiscounted price. Mandatory if offer dates are provided.NoBusinessUnits.BusinessUnit
SpecialFromDateDateTimeOffer start date. Format: YYYY-MM-DD HH:MM:SS. Mandatory if SpecialPrice is provided.Conditional, only if SpecialPrice is sentBusinessUnits.BusinessUnit
SpecialToDateDateTimeOffer end date. Format: YYYY-MM-DD HH:MM:SS. Mandatory if SpecialPrice is provided.Conditional, only if SpecialPrice is sentBusinessUnits.BusinessUnit
StockIntegerAvailable stock quantity.YesBusinessUnits.BusinessUnit
StatusStringProduct status per operator: active or inactive.YesBusinessUnits.BusinessUnit
ProductDataSubsectionContains extended product attributes defined by category.YesProduct
ConditionTypeStringProduct condition; value depends on category, e.g., New.YesProductData
PackageHeightIntegerPackage height (in cm).YesProductData
PackageWidthIntegerPackage width (in cm).YesProductData
PackageLengthIntegerPackage length (in cm).YesProductData
PackageWeightDecimalPackage weight (in kg).YesProductData
TaxPercentageStringProduct 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 CodeMessage
1000Could not save product: %s (No se pudo guardar el producto)
1000Format 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>
Language