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
:
-
You can explicitly specify the
ParentSku
when creating each variation. This applies whether the parent product already exists or is included in the same request with the variations. -
If you do not provide a
ParentSku
, the system will automatically assign theSellerSku
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: | Conditional | BusinessUnits |
SpecialToDate | DateTime | Discount end date. Format: | Conditional | BusinessUnits |
Stock | Integer | Available stock quantity. | Yes | BusinessUnits |
Status | String | Product status by operator: | Yes | BusinessUnits |
ProductData | Subsection | Contains extended product attributes defined per category. | Yes | Product |
ConditionType | String | Product condition. Value depends on category (e.g., | 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 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>