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.
Remember to always check the details of a feed to ensure that the product was created correctly or if there are observations regarding its rejection.
The body of the request is an XML; any fields sent with an empty value will not be processed and will be ignored, as shown in the following example, where ParentSku will be ignored even though it has been declared. It is possible to update one or more products.
Request Data
<?xml version="1.0" encoding="UTF-8" ?>
<Request>
<Product>
<SellerSku>SKU-TEST-12345</SellerSku>
<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>
<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>
<?xml version="1.0" encoding="UTF-8" ?>
<Request>
<Product>
<SellerSku>SKU-TEST-12345</SellerSku>
<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>
<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-78905</SellerSku>
<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>
<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>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>
The XML tags have the following meanings:
| Tag | Type | Description |
|---|---|---|
| SellerSku | String | A unique identifier for the product within the Seller Center instance that will be added to the system. This identifier is usually assigned freely. Harmonized identifiers, such as UPC or EAN, can be configured through ProductId. Mandatory. |
| ParentSku | String | This field defines the structure for managing products with variations, such as sizes or colors. It establishes a primary product as "parent" and links it with variants using its SellerSku as ParentSku. A specific ParentSku can be provided; otherwise, the SellerSku of the first variation is used automatically. It facilitates the organization and effective management of products with variations. |
| Status | String | One of the following values: 'active', 'inactive', or 'deleted'. Optional, defaults to 'active'. |
| Name | String | The name of the product as displayed to the end user. Mandatory. Must be between 2 and 255 characters. |
| Variation | String | If a product is available in multiple variations (e.g., colors or sizes), this is the variation value. For example, if the product is a jacket available in different sizes, this would be the size of the jacket variation being added (e.g., 'Extra Small'). |
| Color | String | Indicates the primary color of the product. |
| BasicColor | String | Indicates the primary color of the product. If there is none, select the multicolor option. |
| Size | String | Indicates the size of the garment of the product. |
| PrimaryCategory | Integer | The ID of the main category of your product. To get the ID of each category in the system, call GetCategoryTree. Mandatory. |
| Categories | String | A comma-separated list of one of the three subcategories to which the product belongs. Each given subcategory must descend from the category specified by the PrimaryCategory parameter. Optional. |
| BrowseNodes | String | A comma-separated list of one or two additional categories that are not necessarily related to the PrimaryCategory. Optional. |
| Description | String | The product description as shown to the end user. 6 to 25000 characters. Certain HTML tags are allowed but must be used as escape characters (see below). Mandatory. |
| Brand | String | The brand of the product. Mandatory. |
| BusinessUnits | Subsection | Product operator code and status, prices, stock details, with each BusinessUnit and its details declared separately. |
| OperatorCode | String | Operator code for the product; available options are: \nFACL: Chile \nFAPE: Peru \nFACO: Colombia \nIt will always be 'FA' followed by the country code. |
| Status | String | The status of the product in that operator. \nOne of the following values: 'active' (active), 'inactive' (inactive), 'deleted' (deleted). Default value is 'active'. |
| Price | Decimal | The price of the product. It is not really a Double value but a Decimal. Mandatory. |
| SpecialPrice | Decimal | The product price during a sale must be lower than the price. If SpecialPrice is specified, SpecialFromDate or SpecialToDate must also be specified; conversely, if at least one of SpecialFromDate or SpecialToDate is specified, SpecialPrice is mandatory. |
| SpecialFromDate | DateTime | Start date and time of the product's sale. If passed, SpecialPrice becomes mandatory. |
| SpecialToDate | DateTime | End date and time of the product's sale. If passed, SpecialPrice becomes mandatory. |
| TaxClass | String | The tax class to which the product belongs. Available tax classes depend on the specific installation against which the call is made. Optional. |
| ShipmentType | String | Indicates whether the product is shipped directly upon receipt ('crossdocking') or shipped directly ('dropshipping'). Allowed shipping types depend on what is configured for a specific seller. Optional. |
| ProductId | numberfield | A harmonized code for the product must be a number ranging from 1 to 18, such as the Universal Product Code (UPC), European Article Number (EAN), Global Trade Item Number (GTIN), or International Standard Book Number (ISBN). Although Should only be filled with numbers. Optional. |
| Condition | String | Indicates whether the product is new or used. One of "new", "used", or "refurbished". Optional. |
| ProductData | Subsection | Additional product attributes, depending on the main category. Optional. |
| Stock | Integer | The current inventory level of this product. Optional. |
| VolumetricWeight | Number DECIMAL(10,2) | |
| ProductGroup | String | The name of the group. |
Response Data
Use the generated response information to retrieve more details from the Feed through another API call to FeedStatus. Check the response details via FeedList. Note that while making the ProductCreate call, only a basic validation is performed. A full validation will occur while processing the feed, so it is possible that out of 100 products added, only 90 may be created.
Success
<?xml version="1.0" encoding="UTF-8"?>
<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) |
Markup in the Description
The product description can be plain text as follows:
<Description>la descripción</Description>
It can also contain certain HTML tags, including ul, li, and span. If HTML is embedded, it must be escaped as character data, like this:
<Description><![CDATA[<div>la descripción <b>negrita</b></div>]]></Description>
Creating Multiple Variations
All variations must be associated with a ParentSku, which is simply the _SellerSku_ of the product considered as the parent by the merchant when creating a variation:
- You can specify the ParentSku in the request, and the generated product will be considered a variation of this. This is valid for both already existing parent products and those that have not yet been created but are included in the same request along with the variations.
- If no ParentSku is provided, the SellerSku of the first variation will automatically be used as the ParentSku.
Product Upload Error
It is important to always validate the existence of a parent product before creating new variations.
If the parent product is included in the same request as the children, keep in mind that if the parent product upload fails, it will automatically cause a rejection in the upload of products assigned as variations.
Variations Only for Apparel and Footwear
Currently, variations of color and size can only be created for footwear and clothing categories. We are working to support variations in other categories soon.
Below is an example of an association to a ParentSku that has not yet been created and shares a request with variant products:
- First, the creation of the product SellerSku: SKU-TEST-999999 is requested.
- Then, the product SellerSku: SKU-TEST-88888888 is created and associated as ParentSku:SKU-TEST-999999
<?xml version="1.0" encoding="UTF-8"?>
<Request>
<Product>
<SellerSku>SKU-TEST-999999</SellerSku> <!-- creation of the SellerSku that will be the parent -->
<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>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> <!-- creation of the SellerSku that will be a variant -->
<ParentSku>SKU-TEST-999999</ParentSku> <!-- assignment of the ParentSku, associated with the SellerSku, which was created first -->
<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>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>