Flujos de Productos

Para poder operar con nuestras APIS es crucial que entiendas el flujo de un producto.

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.

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?

Actualmente trabajamos con dos tipos de variaciones, tanto por color y tallas, es decir para un mismo modelo de un producto, se pueden crear múltiples variaciones asociadas las diferentes tallas y colores, estos productos estarán asociados a través de un SKU padre (ParentSKU) el cual puede ser entregado o en su defecto se tomará el SKU padre de la primera variación.

Es importante recordar que el ParentSKU, debe ser equivalente al SellerSku del producto que se designa cómo padre.

Para más detalle puedes ver el apartado de Creación de Productos (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.

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

  1. Trae todas las marcas disponibles utilizando GetBrands.
  2. Luego obtiene todas las categorías disponibles utilizando GetCategoryTree
  3. Para la categoría seleccionada utilizada GetCategoryAttributes para obtener los atributos respectivos filtrando por el campo PrimaryCategory.
  4. 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.
  5. Una vez tengas marca, categorías y los atributos respectivos utiliza ProductCreate para la creación del producto.
  6. Luego de que tengas la respuesta de creación producto, deberás hacer la carga de imágenes con Image.
  7. 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

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.