En este artículo, mostramos cómo realizar la creación de productos en tu canal mediante la API de Multivende.
Para lograr una conexión entre Multivende y el canal, se debe diseñar una interfaz en la que el merchant pueda:
-
Mapear los atributos de los productos como:
- Categoría.
- Color.
- Talla.
- Marca.
- Temporada.
- Clases de envío.
- Descripción.
- Atributos custom.
-
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 en endpoint Get product attributes.
Ejemplo de mapeo de atributos:
La documentación de los endpoint para los productos está disponible en Products.
- 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 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".
- Listas de precios: Si la app tiene permiso para leer todas las listas de precios debe listar todas las listas del endpoint Get price lists, sí no, debe listar solo a las que tiene permisos.
- Bodegas: Si la app tiene permiso para leer todas las bodegas debe listar todas las bodegas del endpoint Get stores and warehouses, si no, debe listar solo a las que tiene permisos.
- El Merchant deberá poder seleccionar que productos va a publicar en el canal a través del endpoint Get products with scroll podrás obtener el listado de productos con atributos filtrados, la aplicación deberá notificar a Multivende el estado del product link(Estado del producto en canal para la publicación). Te dejamos disponible nuestra documentación para administrar los product link mediante al endpoint Get product links with scroll. Ten en cuenta que con este endpoint tienes la posibilidad de filtrar por estado de sincronización (synchronization_statuses) enviando los estados separados por coma, si quieres filtrar por varios estados.
- El Merchant deberá poder eliminar productos del canal y la aplicación deberá notificar a Multivende a través del endpoint Deleted product link.
- Deben implementar los webhooks para: productos, stocks, precios y product link con los cuales deben buscar la información del producto para actualizarla, si al consultar por el _id del product link retornamos 404 significa que el merchant apago el producto para el canal. Como complemento de los webhooks deben usar los endpoints disponibles para consultas de stock, productos, product links y precios, consultando cada cierto la información para mantener la información sincronizada y evitar cualquier perdida de notificaciones.
A nivel de configuración de backend deben mapear internamente:
- Moneda: En el endpoint Get currencies podrás consultar las monedas disponibles en Multivende, este dato se debe enviar para crear las órdenes.
- Métodos de pago: En el endpoint Get checkout payment methods podrás consultar los métodos de pagos disponibles en Multivende, este dato se debe enviar para crear las órdenes.