Sincronización de Información de Productos a Canales de Venta.

Encuentra aquí el proceso necesario para sincronizar información de productos hacia canales de venta.

El objetivo es facilitar que los merchants puedan gestionar y relacionar toda la información de sus productos de manera eficiente.

• Proceso de Sincronización y Publicación

Para lograr la publicación exitosa de un producto en un canal de venta, se requiere seguir los siguientes pasos de configuración de información, los cuales deben ser implementados del lado del canal de venta.

Mapeo general: Configuración de los datos de las credenciales para establecer la conexión entre Multivende y el canal de venta. Permite al comerciante vincular ambos sistemas.

Mapeo de categorías : Establecer la relación entre las categorías de productos en Multivende y las categorías correspondientes en el canal de venta. Las categorías de la cuenta del merchant en Multivende pueden ser obtenidas mediante el endpoint: Get product categories.

Mapeo de atributos: Relacionar los atributos personalizados creados en Multivende con los atributos equivalentes disponibles en el canal de venta. Los atributos deben estar asociados por categorías. El único atributo que debe quedar configurado por defecto es el SKU (code).
Para obtener un array con todos los atributos de los productos de Multivende para un Merchant usar el endpoint Get product attributes.

Mapeo de marcas:Relacionar cada una de las marcas creadas en Multivende con la marca correspondiente en el canal de venta.

Para consultar las marcas de una cuenta de merchant dentro de Multivende puedes hacerlo mediante el endpoint: Get brands.

Imágenes: las imágenes están clasificadas por álbum. Para obtener el listado de los álbumes usar el endpoint Get products picture set. (El Merchant debe poder seleccionar qué álbum de fotos que va a usar). En caso de usar el álbum por defecto de Multivende debes considerar que el _id de este álbum es el valor "null". 

Publicación de los productos en el canal:

Para consultar todo el detalle de la información de un producto lo haces por el id de Multivende del producto mediante el endpoint Get product by id.

La publicación de los productos en el canal de venta se puede realizar mediante dos modalidades:

• Publicar desde el canal

Esta vista debe listar los productos de la cuenta del merchant en Multivende y permitir la publicación masiva o individual de los  productos. La vista debe ser realizada de lado de la integración.

Para leer los productos desde Multivende hacia el canal de venta debes realizar la consulta mediante el polling de productos con el endpoint de Get products with scroll.

• Publicación mediante product links:

En Multivende, el merchant, puede activar los productos de forma individual o masiva, generando un `product link`. Este enlace contiene información del estado del producto entre el  canal de ventas y Multivende.

Los product links serán notificados vía webhook y también pueden ser consultados mediante la        api con el endpoint de Get product links with scroll para respaldar cualquier notificación que no          haya sido recibida.

Al consultar el detalle del product link mediante el endpoint de Get product link by id en la respuesta de la api,  se puede validar el estado de sincronización para el producto enviado.

Los estados de sincronización asociados a un product link son:

• “not-synchronized” : el producto fue enviado para ser sincronizado, este estado es recepcionado por el canal para iniciar la publicación del producto.
• “synchronized”: el producto fue publicado exitosamente en el canal de venta, este estado es notificado por el canal de venta hacia Multivende mediante una actualización del estado de sincronización.
• “synchronized_with_warnings”: el producto se sincronizó, sin embargo se requiere de cierta información, que si bien no afecta la publicación del producto, debe ser corregida o enviada para que la publicación quede cien por ciento sincronizada.
• “synchronizing”:  el producto se encuentra en sincronización con el canal de venta, este estado es usado por los canales que requieren una revisión del producto antes de ser publicado.
• “failed”: la sincronización del producto con el canal falló y no se logró la publicación. El canal debe enviar la descripción o detalle del error para que el merchant pueda realizar las correcciones pertinentes.

Realizar actualizaciones de estados de sincronización hacia Multivende.

Las actualizaciones de estados de los product links notifican hacia Multivende el resultado de la            vinculación del producto con el canal de venta. Esta comunicación de product links es bi-                      direccional entre Multivende y el canal de venta.

Las integraciones de canal de venta reciben la notificación via webhook o la lectura via polling de          las actualizaciones de los product links que se realicen desde Multivende y a partir de allí deben            informar hacia Multivende el estado en que se encuentra el producto en el canal.

El endpoint para enviar los de estados de sincronización hacia Multivende es: Post Upsert product link, se deben pasar los siguientes parámetros:

• 'ProductId': id de el producto padre en Multivende

• 'externalId': corresponde al identificador del producto en el canal

• 'externalContent': se informa la data nativa del canal (JSON)

• 'extraData': cualquier otra información relevante

• 'synchronizationStatus': permite los siguientes estados

           -> 'not-synchronized'

           -> 'synchronized'

           -> 'synchronized_with_warnings'

           -> 'synchronizing'

           -> 'Failed'

Los estados de sincronización de los productos entre Multivende y el canal de venta, los merchants los pueden ver en el panel de control del front de Multivende:

Y también en la conexión con la aplicación:

Despublicar el producto en el canal de venta

Si un usuario requiere remover productos en el canal, puede hacerlo desde Multivende, apagando el producto en la conexión, esta acción registra el estado de sincronización del producto como “to_unpublish”.

El canal de venta debe notificar a Multivende que la publicación del producto en el canal fue eliminada mediante el endpoint:  Deleted product link , el estado de sincronización del producto se actualiza a “to_unpublish” y es removido de la conexión, si el producto es nuevamente activado, el estado de sincronización llegará como “to_republish” y puede ser sincronizado nuevamente.

Si se desea remover el producto directamente desde el canal, sólo se debe enviar la solicitud del  Deleted product link. Este endpoint permite eliminar uno o varios productos directamente de la conexión.

Mapeo de precios

El merchant debe poder seleccionar la lista de precios mediante la cual el canal tomará la información de los valores de precios de los productos. Para consultar las listas de precios asociadas a un merchant usamos el endpoint Get price lists 

Posteriormente puedes consultar el precio de los productos mediante el endpoint Get prices with scroll, enviando el id de la lista de precios, límite de items a consultar (el rango del límite permitido es >=50 y <=30000), este endpoint permite obtener el precio de los productos paginados por scroll.

Puedes consultar el precio por un rango de fecha y hora, filtrando por el parámetro de fecha de creación (createdAt) o fecha de actualización (updatedAt).

Mapeo de inventario

En esta vista el merchant selecciona la bodega desde la cual se tomará el stock de los productos publicados en el canal. Para consultar las bodegas de la cuenta de un usuario en Multivende hacemos un llamado al endpoint Get stocks and warehouses.

Puedes consultar el stock de los productos mediante el endpoint Get stocks with scroll, enviando el id de la bodega, límite de items a consultar (el rango del límite permitido es >=50 y <=30000), este endpoint permite obtener el stock de los productos paginados por scroll.

 Puedes consultar el stock por un rango de fecha y hora, filtrando por el parámetro de fecha de creación (createdAt) o fecha de actualización (updatedAt).

Esperamos que este artículo te haya proporcionado una guía detallada para asegurar que la información de los productos se sincronice correctamente entre Multivende y los canales de venta, incluyendo los pasos necesarios y los endpoints de la API para realizar estas acciones.

Equipo Integraciones API Multivende