post https://sellercenter-api.falabella.com/?Action=ProductCreate
Create one or multiple new products.
The body transmitted by the POST is an XML structure. Tags that do not enclose a value are ignored; so, In the example below, ParentSku will be ignored by the endpoint, even though it was supplied.
You can create multiple products by specifying multiple Product tags.
This call creates a feed, which is then processed by system in the background.
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 meaning:
| Tag | Type | Description |
|---|---|---|
| SellerSku | String | A unique identifier for the product within the Seller Center instance that is to be added to the system. This identifier is usually freely assigned. Harmonized identifiers, such as UPC or EAN can be set via ProductId. Mandatory |
| ParentSku | String | The unique identifier of a product with which this product should be associated. [Free nomenclature ParentSku feature enabled] If ParentSku is provided than it will pick the defined ParentSku otherwise it will use SellerSku of the first variation. Optional |
| Status | String | One of the following values: 'active', 'inactive' or 'deleted'. Optional, defaults to 'active'. |
| Name | String | The name of the product as shown to the end-user. Mandatory. Must be between 2 to 255 characters. |
| Variation | String | If a product is available in multiple variations (e.g., colors or size), this is the value of the variation. E.g., if the product is a jacket that comes in different sizes, this would be the size of the jacket's variation that is added with the call (e.g., 'Extra Small'). |
| Color | String | Indicates the main color of the product. *Exclusive for fashion/footwear categories |
| ColorBasico | String | Indicates the main color of the product. If you don't have one, select the multicolor option. *Exclusive for fashion/footwear categories |
| Talla | String | Indicate the size of the product *Exclusive for fashion/footwear categories |
| PrimaryCategory | Integer | The ID of the primary category for his product. To get the ID for each of the system's categories call GetCategoryTree. Mandatory |
| Categories | String | A comma-separated list of one to thee sub-categories to which the product belongs. Each of the given sub-categories 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 description of the product, as shown to the end-user. 6 to 25000 characters. Embedding certain HTML tags is allowed, but must be escaped as character data (see below). Mandatory |
| Brand | String | The brand name of the product. Mandatory |
| BusinessUnits | Subsection | Product Operator code and status, pricing, stock details, with each BusinessUnit and its details declared separately. |
| OperatorCode | String | Operator code for the product, for example: FACL: Chile, FAPE: Peru, FACO: Colombia. It will always be FA followed by country code. |
| Status | String | Status of the product in that operator. One of the following values: 'active', 'inactive' or 'deleted'. Optional, defaults to 'active'. |
| Price | Decimal | The product's price. Not really a Double, but a Decimal. Mandatory |
| SpecialPrice | Decimal | The price for the product while it is on sale neeeds to be lower then the Price. If SpecialPrice is specified, either SpecialFromDate or SpecialToDate must be given; vice versa, if at least one of SpecialFromDate or SpecialToDate is specified, SalePrice is mandatory. |
| SpecialFromDate | DateTime | Time and date for when the product goes on sale. If passed in, SpecialPrice becomes mandatory. |
| SpecialToDate | DateTime | Time and date for when the product goes on sale. If passed in, SpecialPrice becomes mandatory. |
| TaxClass | String | The taxation class the product belongs to. The available tax classes are dependent on the specific installation the call is executed against. Optional |
| ShipmentType | String | Indicates whether the product is shipped direcly upon receipt ('crossdocking') or is drop shipped ('dropshipping'). Which shipment types are permissible depends on what is set up for a specific seller. Optional |
| ProductId | String | A harmonized code for the product, such as Universal Product Code (UPC), International Article Number (EAN), Global Trade Item Number (GTIN) or International Standard Book Number (ISBN). Optional |
| Condition | String | Indicates whether the product is new or used. One of 'Nuevo', or 'Reacondicionado'. Optional |
| ProductData | Subsection | Additional product attributes, depends on the primary category. Optional |
| Stock | Integer | The current level of inventory for 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 of the Feed via another API call FeedStatus . Check out the details of the response via FeedList. Please be aware while doing the ProductCreate call we just do a basic validation. A full validation will be done while processing the feed, so it can be possible to push 100 products but only 90 of them get 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 |
| 1000 | Format Error Detected |
Markup in the Description
The product description can be plain text like so:
<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 so:
<Description><![CDATA[<div>la descripción <b>negrita</b></div>]]></Description>
Create Multiple Variations
To be able to create multiple variation of one product, you need to fill the ParentSku to associate the product together. If a ParentSku is passed, a new variation to an existing product is created.
[Free nomenclature ParentSku feature enabled] If no ParentSku is given, a new product will be created based on the SellerSKU. If ParentSku is given and is different than an existing ParentSku than a new product will be created.
You can also use the ParentSku of a product which is generated with the same API request, see the example below.
<?xml version="1.0" encoding="UTF-8"?>
<Request>
<Product>
<SellerSku>SKU-TEST-999999</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>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>
<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>
<ParentSku>SKU-TEST-999999</ParentSku>
<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>