APIS

Contamos con un extenso conjunto de APIS para poder gestionar tus productos y feeds, algunas son opcionales y pueden mejorar tu experiencia de integración

Fundamentales de Producto

GetBrands(Aquí): Trae todas las marcas disponibles*.
GetCategoryTree(Aquí): Trae todas las categorías de los productos.
GetCategoryAttributes(Aquí): Trae una lista de atributos para una categoría.
GetContentScore(Aquí): Consultar atributos que dan puntos de contenido para una categoría
ProductCreate(Aquí): Creación de producto
Image(Aquí): Carga de imágenes.
ProductUpdate(Aquí): Actualización de producto.
GetProducts(Aquí): Traer uno o más productos.
ProductRemove(Aquí): Eliminación de Producto.

APIS Complementarias

UpdateStock(Aquí) :Permite actualizar el stock de un producto en una bodega específica. Si no se poseen bodegas adicionales, el endpoint operará sobre tu bodega por defecto.
Para más información sobre el modelo multibodega, haz clic aquí.
GetStock(Aquí) :Permite consultar el stock de un producto en una bodega específica. Si no se poseen bodegas adicionales, el endpoint operará sobre tu bodega por defecto.
Para más información sobre el modelo multibodega, haz clic aquí.

Fundamentales de Feed

FeedList(Aquí): Trae todos los Feeds de los últimos 30 días.
FeedOffsetList(Aquí): Trae un subconjunto de los Feeds de los últimos 30 días, puedes realizar por ejemplo filtros por estado.
FeedStatus(Aquí): Trae el detalle de un Feed específico.
FeedCancel(Aquí):Cancela Feeds que se encuentren pendientes.

Adicionales

GetCategoryByAttributesSet (Aquí): Trae categorías proporcionando atributos
GetBrandMappedAttributes(Aquí): Trae atributos asociados a marcas
GetMappedAttributesOptions(Aquí): Trae Opciones de atributo mapeadas a otras opciones de atributo.
FeedCount(Aquí): Entrega estadísticas de Feeds
GetFeedRawInput(Aquí): Trae el XML original de requerimiento de uno o más Feeds

¿SE CUENTA CON VARIACIONES DE PRODUCTOS?

Desde este 2025, hemos comenzado a incorporar progresivamente productos con variaciones en categorías distintas a moda y calzado. Estos productos estarán vinculados mediante un SKU padre (ParentSKU), el cual puede ser proporcionado manualmente o, en su defecto, se tomará el SKU del primer producto de la variación como SKU padre.

Es importante tener en cuenta que el ParentSKU debe coincidir con el _SellerSku _del producto que se designa como padre.

Para saber cómo identificar si una categoría admite múltiples variaciones, puedes consultar el apartado “¿Cómo saber si una categoría admite múltiples variaciones?” en el siguiente enlace: (Aquí)

🚧
Error en la carga de productos.
Es importante validar siempre la existencia de un producto padre antes de crear nuevas variables.
En el caso que el producto padre se encuentre en el mismo request que los hijos, ten en consideración que si la carga del producto padre falla, automáticamente generará un rechazo en la carga de los productos asignados como variables.

⚠️
Tamaño de lote recomendado
Para un uso eficiente de los feeds, agrupa tus productos en lotes. Se recomienda enviar entre 500 y 1.000 productos por solicitud, dependiendo del tamaño y complejidad de los datos incluidos.

¿Cómo utilizar las APIS para generar la creación de un producto?

Trae todas las marcas disponibles utilizando GetBrands.
Luego obtiene todas las categorías disponibles utilizando GetCategoryTree
Para la categoría seleccionada utilizada GetCategoryAttributes para obtener los atributos respectivos filtrando por el campo PrimaryCategory.
Utilizar el API GetContentScore para obtener información adicional de los atributos que dan puntos de contenido, además de las respectivas reglas para lograr todo el puntaje.
Una vez tengas marca, categorías y los atributos respectivos utiliza ProductCreate para la creación del producto.
Luego de que tengas la respuesta de creación producto, deberás hacer la carga de imágenes con Image.
En los pasos 4 y 5 recuerda siempre estar pendiente al estado de los feeds, puedes apoyar el uso de webhooks con el uso del api GetProducts.

🚧
Marca no encontrada
Recuerda, en caso de que la marca que se quiera vender no esté disponible, puedes realizar la publicación bajo la categoría "Genérico", o bien solicitar la creación de una nueva marca en el siguiente enlace
FORMULARIO

¿Cómo actualizo o elimino un producto?

Debes usar ProductUpdate y ProductRemove, respectivamente, recuerda siempre estar monitoreando el estado del feed.

🚧
Consideración en actualizaciones
No se deben realizar acciones de inactivación y eliminación de productos que posean Fullfillment by Falabella, ya que estas acciones podrían inhabilitar el vender tus productos con stock asegurado.

Cuando el ShipmenType es Dropshipping las ordenes son Fulfilled by the seller por lo que deben consumir stock ya que se arman en bodegas propias;

Cuando el ShipmenType es Own Warehouse, estas órdenes son Fulfilled by Falabella y no deberían consumir stock porque este ya fue entregado a Falabella.com para que realice el fulfillment en nombre del seller.

¿Qué otras consideraciones se deben tener?

Recuerda que siempre puedes ver los detalles de tus productos con GetProducts.
Recuerda que los productos con menos de 30 puntos serán rechazados automáticamente, mientras que aquellos con entre 30 y 70 puntos pasarán por una validación manual. Los productos que superen 70 puntos serán aprobados automáticamente. Por esta razón, es fundamental utilizar el API GetContentScore para optimizar la calidad del contenido y asegurar su aprobación.
Recuerda que también puedes editar tus productos una vez estén creados y ver si se cumplieron o no con las reglas de puntaje (Productos>Administrador de Productos>editar detalles).

Producto con puntaje de contenido deficiente

Puedes utilizar FeedStatus para ver el detalle del error de un feed en particular.

Flujo de creación de Producto

Puedes hacer clic en la imagen para poder visualizarla o puedes descargar haciendo clic en el botón derecho de mouse y seleccionando guardar cómo, para tener la imagen en su resolución original.