Creating Products

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 body of the request must be XML. Any fields submitted with empty values will be ignored and not processed. To optimize feed usage, it is recommended to submit products in batches. The suggested size is up to 500 products per request, although this number can be adjusted depending on the volume and complexity of the data included.

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:



What is a multi-variation category?

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 considered the parent.

There are two ways to define the ParentSku:

  1. You can explicitly specify theParentSku when creating each variation. This applies whether the parent product already exists or is included in the same request with the variations.

  2. If you do not provide aParentSku, the system will automatically assign the SellerSku of the first variation as the parent product.

XML example for product creation with multiple variations

<?xml version="1.0" encoding="UTF-8"?>
<Request>
  <Product>
    <SellerSku>SKU-TEST-999999</SellerSku>
    <ParentSku>SKU-TEST-999999</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>
    <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>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>SKU-TEST-88888888</SellerSku>
    <ParentSku>SKU-TEST-999999</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>
    <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>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

ℹ️

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>

XML Tag Definitions

Field

Type

Description

Required

Section

SellerSku

String

Unique identifier for the product within the system.

Yes

Product

ParentSku

String

Identifier of the parent product for variations. If not provided, the SellerSku of the first product will be used as the parent.

No

Product

Name

String

Product name displayed to the customer. Minimum 2 characters, maximum 255.

Yes

Product

Variation

String

Indicates the product's variation (e.g., size, color). Only used when the category does not support multivariation. Can be filled with "..." if needed.

Conditional

Product

Color

String

Main color of the product. Required if the product supports multivariation. Attributes that generate variation may vary by category.

Conditional

Product

ColorBasico

String

Basic color of the product. Required if the product supports multivariation. Attributes that generate variation may vary by category.

Conditional

Product

Talla

String

Product size (especially for clothing and footwear). Required if the product supports multivariation. Attributes may vary by category.

Conditional

Product

PrimaryCategory

Integer

Main category ID. Obtainable via the GetCategoryTree endpoint.

Yes

Product

Description

String

HTML description of the product. 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

Contains stock, pricing, and operator details.

Yes

Product

OperatorCode

String

It is associated with the country of operation: *Chile: facl *Peru: fape *Colombia: faco

Yes

BusinessUnits

Price

Decimal

Regular product price.

Yes

BusinessUnits

SpecialPrice

Decimal

Discounted price. Required if discount dates are provided.

Conditional

BusinessUnits

SpecialFromDate

DateTime

Discount start date. Format: YYYY-MM-DD HH:MM:SS. Required if SpecialPrice is included.

Conditional

BusinessUnits

SpecialToDate

DateTime

Discount end date. Format: YYYY-MM-DD HH:MM:SS. Required if SpecialPrice is included.

Conditional

BusinessUnits

Stock

Integer

Available stock quantity.

Yes

BusinessUnits

Status

String

Product status by operator: active or inactive.

Yes

BusinessUnits

ProductData

Subsection

Contains extended product attributes defined per category.

Yes

Product

ConditionType

String

Product condition. Value depends on category (e.g., Nuevo).

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

DisciplinaZapatillas

String

Sports discipline (e.g., Tennis, Running). Example of a category-specific attribute.

No

ProductData

Genero

String

Target gender for the product (e.g., Male, Female, Unisex). Example of a category-specific attribute.

No

ProductData


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