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.
  • 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. Una vez tengas marca, categorías y los atributos respectivos utiliza ProductCreate para la creación del producto.
  5. Luego de que tengas la respuesta de creación producto, deberás hacer la carga de imágenes con Image.
  6. 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, eliminación, y actualización de stock con 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.
  • Estamos trabajando en un API para obtener el detalle de puntaje de contenido de los productos, mientras tanto en caso de que el feed de como resultado falta de puntaje de contenido, el detalle se puede observar en fallabella seller center (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.
  • Entre más atributos completes de tu producto, menos posibilidades de rechazo por puntaje de contenido y mayor probabilidad de venta.

Flujo de creación de Producto

Haz clic en la imagen para poder agrandarla.