🚧

Important

This documentation section only applies to international sellers operating under the cross-border sales model.

Differences Between Endpoints

With the eventual shutdown of Linio's Seller API, it will be necessary to integrate your systems with Falabella's Seller API to ensure optimal functionality. In the product catalog management, this change involves key adjustments in data structure and the management of products, attributes, and prices.

Below are the main differences to consider for adapting your integration:

1️⃣ Variations and Product Organization (ProductCreate, GetProducts, UpdateProducts)

• Now, apparel, accessories, and footwear must be handled as products with variations, grouped by color and size.
• Color and Size are no longer part of ProductData; instead, they must be reported at the Product level if the product has variations. Otherwise, they should be included within ProductData.
• The ColorBasico field is now required for products with variations and is located at the Product level.

2️⃣ Category Structure ( productcreate, GetProducts, UpdateProducts )

• Removal of the Categories field: In Linio, a product could belong to multiple categories. In Falabella, only PrimaryCategory is used.

3️⃣ New Stock and Pricing Structure (productcreate, GetProducts, UpdateProducts)

• Quantity is now called Stock.

• A new BusinessUnits object has been introduced, which manages:

  • Price: Regular and discounted price (including validity dates).
  • Stock: Available inventory levels.
  • Country of operation: Inventory location and commercialization.
  • Product status within the business unit.

• Stock and Price were previously at the product level; now, they are within BusinessUnits.

• Stock no longer has Available, only Stock.

4️⃣ Changes in Special Price Handling (productcreate, GetProducts, UpdateProducts)

• Discounted prices (SalePrice, SaleStartDate, SaleEndDate) were previously within ProductData.
• Include name changes
• They are now structured within BusinessUnits, using SpecialPrice, SpecialFromDate, and SpecialToDate.
• ⚠️ Important: If a discounted price is applied, the SpecialFromDate and SpecialToDate fields must be included within BusinessUnits.
• Date format change:
  • Previous format: DD/MM/YYYY
  • New format: YYYY-MM-DD HH:MM:SS

5️⃣ New Additions in the Attributes and Products API ( GetCategoryAttributes, GetProducts )

New attributes in GetCategoryAttributes

New fields have been added to enhance attribute classification and management:

• GroupName: Groups attributes under a specific category (e.g., "Warranty and Shipping").
• FeedName: Uniquely identifies the attribute.
• IsGlobalAttribute: Indicates whether the attribute is global or specific.
• ProductType: Classifies the attribute (config, etc.).
• InputType: Defines how the data is entered (dropdown, textfield, etc.).
• MaxLength: Defines the maximum allowed length.
• Support for attribute names in other languages (NameCn, NameEn).

New attributes in GetProducts

New fields have been added to evaluate product content quality:

• ContentScore: Indicates the product’s content quality score.
• QCStatus: Represents the product’s quality control status (e.g., approved, rejected, under review).

New endpoint to evaluate content score

Additionally, we have introduced a new endpoint that allows querying which attributes contribute to content scoring and what rules apply.

📍 For more details, check the section:
🔗 Get Content Score

🚧

Important for International Model

For sellers operating under the international model, it is mandatory to include the local language name (NameEn = USA, NameCN = China) in product creation, in addition to the listing name (Name), due to customs import regulations.

Product Catalog Differences Table (Migration Linio → Falabella)