🚧

Importante

Esta sección de la documentación solo aplica para vendedores internacionales que realizan modelo de venta cross border.

Diferencias entre Endpoints

Con el eventual apagado de la Seller API de Linio, será necesario integrar sus sistemas con la Seller API de Falabella, para mantener un óptimo funcionamiento. En la gestión del catálogo de productos, este cambio implica ajustes clave en la estructura de datos y en la administración de productos, atributos y precios.

A continuación, se presentan las principales diferencias a considerar para adaptar la integración:

1️⃣ Variaciones y Organización de Productos (ProductCreate, GetProducts, UpdateProducts)

• Ahora, productos de vestuario, accesorios y calzado deben manejarse como productos con variaciones, agrupados por color y talla.
• Color y Talla ya no forman parte de ProductData, sino que deben informarse a nivel de Product, en el caso de que el producto posea variación, en caso contrario deberá estar dentro del ProductData,.
• Se incluye el campo ColorBasico, requerido para productos con variaciones, ubicado a la altura de Product, en el caso de productos con variación.

2️⃣ Estructura de Categorías (productcreate, GetProducts, UpdateProducts)

• Eliminación del campo Categories: En Linio, un producto podía pertenecer a múltiples categorías. En Falabella, solo se usa PrimaryCategory.

3️⃣ Nueva Estructura de Stock y Precios (productcreate, GetProducts, UpdateProducts)

• Quantity ahora es llamado Stock

• Se introduce un nuevo objetoBusinessUnits , el cual maneja:

  • Price: Precio normal y precio en oferta (incluyendo fechas de vigencia).
  • Stock: Nivel de inventario disponible.
  • País de operación: Ubicación del inventario y comercialización.
  • Estado del producto dentro de la unidad de negocio.

• Stock y Precio antes estaban a nivel de producto, ahora están dentro de BusinessUnits.

• Stock ya no tieneAvailable , solo Stock.

4️⃣ Cambios en el Manejo de Precios Especiales (productcreate, GetProducts, UpdateProducts)

• Los precios de oferta (SalePrice, SaleStartDate, SaleEndDate) antes estaban dentro de ProductData.
• Agregar los cambios de nombre
• Ahora se estructuran dentro de BusinessUnits, con los campos SpecialPrice, SpecialFromDate y SpecialToDate.
• ⚠️ Importante: En caso de precio oferta, las fechas SpecialFromDate y SpecialToDate deben incluirse dentro de BusinessUnits.
• Formato de fechas cambiado:
  • Antes: DD/MM/YYYY
  • Ahora: YYYY-MM-DD HH:MM:SS

5️⃣ Nuevos en la API de Atributos y Productos (GetCategoryAttributes, GetProducts)

Nuevos atributos enGetCategoryAttributes

Se agregaron nuevos campos para mejorar la clasificación y gestión de atributos:

• GroupName: Permite agrupar atributos bajo una categoría específica (ej. "Garantía y Envío").
• FeedName: Identifica el atributo de forma única.
• IsGlobalAttribute: Indica si el atributo es global o específico.
• ProductType: Clasifica el atributo (config, etc.).
• InputType: Define cómo se ingresa el dato (dropdown, textfield, etc.).
• MaxLength: Define la longitud máxima permitida.
• Soporte para nombres en otros idiomas (NameCn, NameEn).

Nuevos atributos enGetProducts

Se agregaron nuevos campos para evaluar la calidad del contenido de los productos:

• ContentScore: Indica la puntuación de calidad del contenido del producto.
• QCStatus: Representa el estado de control de calidad del producto (ej. aprobado, rechazado, en revisión).

Nuevo endpoint para evaluar el puntaje de contenido

Adicionalmente, contamos con un nuevo endpoint que permite consultar qué atributos otorgan puntaje de contenido y qué reglas aplican.

📍 Para más detalles, revisa el apartado:
🔗 Get Content Score

🚧

Importante para modelo internacional

Para los vendedores que operan bajo el modelo internacional, es obligatorio incluir en la creación de productos el nombre en el idioma local (NameEn = USA, NameCN = China) en complemento al nombre de publicación (Name), debido a razones aduaneras de importación de productos.

Tabla de Diferencias en Catálogo (Migración Linio → Falabella)

📌 Para más detalles sobre los flujos de APIs de productos, consulta:
🔗 Flujos de API de Producto