Primeros Pasos

  • Todo lo que debes saber sobre Integraciones API

    Conéctate vía API a una o más cuentas de Merchant y automatiza operaciones con nuestra API Rest.

     

    Flujo global de integraciones

    Multivende actúa como el centro de gestión para el catálogo de productos de un usuario, como observamos en el diagrama más abajo. (Diagrama flujo global de integraciones)

    Dentro de Multivende, los usuarios pueden realizar todas las configuraciones necesarias, como la carga de productos, gestión de stock, administración de bodegas y establecimiento de listas de precios. Con esta información, Multivende publica los productos o SKUs en los diversos marketplaces y tiendas online con los que está integrado de manera nativa.

    Todo el proceso entre Multivende, los marketplaces y las tiendas online está gestionado por nuestro equipo de desarrollo. Nosotros enviamos información relevante como stock, precios, productos, estado de órdenes y documentos a los marketplaces y tiendas online.

    A su vez, recibimos en Multivende los datos de ventas y los cambios de estado, como actualizaciones de órdenes y detalles sobre despachos o retiros en tienda.

    Además, ofrecemos la opción de descargar etiquetas de despacho y estamos integrados de manera nativa con operadores logísticos como Chilexpress, Envíame, entre otros.

    Multivende sigue un enfoque API First, lo que significa que nuestra API está disponible para que los integradores conecten sus sistemas externos. Durante el proceso de implementación, gestionamos todas las interacciones entre Multivende y la integración. (Diagrama flujo global de integraciones -  Aplicaciones)

    La API permite actualizar stock, precios y productos, y también acceder a esta información desde Multivende. Asimismo, disponemos de Webhooks para proporcionar actualizaciones en tiempo real sobre cualquier cambio en los recursos habilitados en la aplicación.

    Flujo_API.webp

    Diagrama flujo global de integraciones 

    Funcionalidades para automatizar

    Toda integración de un sistema con Multivende se debe realizar con el método de autenticación Oauth2. Puedes automatizar diferentes funcionalidades con esta integración las cuales son:

    • Ordenes
      Multivende te permite administrar dentro de una misma cuenta de Merchant diferentes conexiones a un mismo canal, podrás realizar: 
      • Leer órdenes por polling: Consultar las ventas nuevas/actualizadas en un rango de fechas de forma periódica para todas tus conexiones o por conexión .
      • Actualizar estados de las órdenes de despacho: Enviar a Multivende los cambios de estados que ocurren fuera del canal de venta, actualizaciones que a su vez, Multivende enviará al canal. Por ejemplo cambios de status del pedidos, como "El pedido ha sido enviado".
      • Actualizar estados de los retiros en tienda: Enviar a Multivende los cambios de estados que ocurren fuera del canal de venta, actualizaciones que a su vez, Multivende enviará al canal. Por ejemplo cambios de status del pedidos, como "El pedido está listo para ser retirado".
    • Etiquetas
    • Documentos tributarios:
      • Leer documentos tributarios de las órdenes: Obtener los DTE (documentos tributarios electrónicos, también denominados boletas o facturas) que cargan en Multivende otras integraciones en las órdenes.
      • Cargar documentos tributarios a las órdenes: Enviar a Multivende los DTE (documentos tributarios electrónicos, también denominados boletas o facturas) para almacenarlas como un repositorio centralizado de información de la orden. A su vez, Multivende envía a los canales que tienen habilitada la carga de DTE.
    • Productos:
    • Stock:
      • Leer stock: Obtener el stock disponible de los productos según la bodega.
      • Cargar stock: Enviar el stock disponible de los productos según la bodega.
    • Precios: 

     

    Conexión de nuevos canales

    Aplica para conectar marketplace o e-commerce que no están actualmente dentro de los canales con los que ya contamos con la integración, permitimos la conexión de nuevos canales de ventas a través de nuestra central de aplicaciones los cuales podrán realizar adicional a las funcionalidades anteriores:

    • Crear órdenes: Enviar a Multivende nuevas órdenes de compra con el detalle de precio, productos, cliente, modalidad de entrega y pagos. Las cuales al ser registradas, Multivende realiza el descuento del stock.
    • Administrar product links: Obtener desde Multivende los productos que serán publicados en el canal.
    • Cargar etiquetas de envío: Enviar a Multivende las etiquetas de envío para los paquetes de las órdenes que son despachadas por el seller en coordinación con un courier del canal.

    Para conocer qué funcionalidades debes realizar en tu integración te invitamos a validar según tu tipo de sistemas las dimensiones a cubrir Dimensiones de integración.

     

    Permisos

    El Merchant podrá seleccionar el nivel de permisos que se le asignará a cada aplicación por medio de los scopes definidos.

    Por Ejemplo: Asignar a un canal de venta el acceso a una lista de precios específica.

    Manejamos múltiples bodegas y listas de precios las cuales pueden mapear según los permisos otorgados a la aplicación para la sincronización del stock y precios.

    Notificaciones

    Disponemos de Webhooks encargados de enviar notificaciones a la aplicación para que pueda consultar las actualizaciones de los recursos, por lo que necesitarás un desarrollo que esté escuchando nuestras notificaciones.

     

    ℹ️ Información: Las integraciones hacia Multivende como son desarrolladas por parte de ustedes, deben estar soportadas con mantenimiento dado que los Canales de Venta y Multivende agregan o modifican los recursos para mejorar u optimizar dicha integración.
     

    El siguiente paso que debes realizar es integrar una aplicación. Para saber cómo hacerlo, consulta el siguiente artículo.

     

    Equipo Integraciones API Multivende

     
    Más información
  • Pasos esenciales para Integrar tu Aplicación

    En este artículo te presentamos los pasos que debes seguir para integrar una aplicación.

     

    Para poder integrar una aplicación deberás:

    1. Crear tu cuenta de desarrollador, si no cuentas con una debe ser creada con un correo que no esté registrado en Multivende.
    2. Crear tu aplicación en nuestra plataforma.
       
      Vídeo del proceso
       
    3. Desarrollar la conexión entre Multivende y la aplicación y la interfaz por la cual el Merchant realizará la configuración de la comunicación, esta comunicación se realizará por medio de Oauth2.
    4. Si la aplicación es un Marketplace, lee las siguientes consideraciones.
    5. Obtener detalles de la conexión entre tu APP y la cuenta del Merchant Get app information.
    6. ¡Listo! Puedes empezar a consultar nuestra API y realizar la integración con Multivende.

    Consideraciones Generales:

    1. La aplicación debe cumplir con los estándares de seguridad definidos en el siguiente artículo.

    2. Nuestras fechas están en formato UTC, se debe realizar la conversión según la zona horaria.
    3. Los datos enviados a la aplicación deben ser almacenados en su base de datos y por medio de los webhooks se notificarán los cambios para que puedan ser actualizados, por lo que no se debe realizar consultas constantes para obtener la información de algún recurso.
    4. El desarrollo debe considerar reintentos en caso de error.
    5. Una aplicación se puede relacionar a más de un Merchant.
    6. Un Merchant puede tener múltiples conexiones a la misma aplicación.
    7. No puedes tener la sesión de la cuenta desarrollador y merchant en el mismo navegador.

    Consideraciones Partners:

    1. La integración debe ser estándar para que los Merchant puedan configurar rápidamente la relación entre los sistemas.
    2. Se debe generar un manual de integración que será publicado en nuestro Help Center. El cual debe contener:
      1. ¿Cómo contactarse con el área comercial para contratar el servicio?.
      2. ¿Cómo contactarse con soporte en caso de tener algún inconveniente?.
      3. Condiciones del servicio.
      4. Funcionalidades que realiza la integración.
      5. Flujo que debe realizar para habilitar la integración, con capturas de pantalla que respalden la acción indicada.
    3. Más información en el siguiente artículo recomendaciones para partners.

     

    Equipo Integraciones API Multivende

     
    Más información
  • Empezando con tu cuenta de Desarrollador: Guía Rápida

    Para usar la API de Multivende, gestiona tus aplicaciones desde la cuenta de desarrollador.

     

    Para crear tu cuenta de desarrollador, debes seguir los siguientes pasos:

    1. Tienes que crear una cuenta a través de https://app.multivende.com/developers/signup , donde deberás ingresar los datos solicitados en el formulario:

      • Nombre de usuario.
      • Correo electrónico: Email destinado al administrador de la cuenta (se recomienda que sea el correo del equipo de TI y es posible usar un correo previamente registrado como en la cuenta de un merchant).
      • Contraseña la cual cumpla con los estándares definidos:
        • Mínimo 12 caracteres.
        • Mínimo 1 letra mayúscula y 1 letra minúscula.
        • Mínimo 1 número.
        • Mínimo 1 símbolo.

    Dale click a "Continuar" y listo! Tu cuenta ha sido creada con éxito.

     

    2.Si ya posees cuenta como desarrollador creada deben realizar login a través de:

    https://app.multivende.com/developers/login 

     

    ℹ️ Información:
    Recuerda siempre validar la URL a la cual estás apuntando para acceder correctamente al ambiente de Desarrollo.

     

    Equipo Integraciones API Multivende

     
    Más información
  • Instrucciones para crear y configurar tu Aplicación

    Debes registrar la app en tu cuenta de desarrollador para integrarla vía API con otro sistema.

     

    A continuación, te mostramos los pasos para crear la aplicación en Multivende:

    1. Ingresa al menú de aplicaciones, donde se mostrarán todas tus aplicaciones creadas en Multivende y presiona el botón Crear.

    Crear_aplicacio_n_-_2.png

    2. Ingresa los datos de tu aplicación.

    • Nombre: Nombre de tu aplicación para reconocerla en tu listado de aplicaciones.
    • Código: Código para asociar la aplicación. Debe ser único en todo el sistema, por lo que debes seguir la nomenclatura “empresa_nombredelsistema_pais_version”.
    • Nombre público: Nombre que se muestra a los merchants en su listado de aplicaciones. Debe ser único en todo el sistema, por lo que debes seguir la nomenclatura “Empresa + nombre del sistema + país + versión”.
    • Visibilidad: 
      • Público: Se listará tu aplicación para que los merchants puedan seleccionar tu app y asociarla a su cuenta.
      • Privado: No se listará en el pull de aplicaciones disponibles para integrar.
    • URL de destino: Página a la que enviaremos a los merchant para que se realicen el OAuth2.
    • URL de marketing: Página donde se mostrará tu publicidad.
    • Descripción.
    • Descripción pública: Debes detallar las funcionalidades que tiene tu integración, quedará disponible para que el merchant pueda visualizarla.
    • Scopes: Permisos que debe otorgar el merchant para que la aplicación funcione correctamente. Puedes encontrar más detalles en el artículo dedicado a los scopes.
    • Redirect URL: URL a la que redireccionaremos luego de que el merchant otorgue los permisos necesarios.
    • Webhooks: Notificaciones a las que debe estar suscrita la aplicación para que funcione correctamente. Puedes encontrar más detalles en el artículo de webhooks.
    • Callback URL: URL a la que enviaremos el POST de la notificación.

    3. Carga el logo de tu aplicación. Recuerda que esta debe cumplir con el formato de 45x45 px.

    4. ¡Listo! Tu aplicación se ha creado con éxito.

    ℹ️ Información:
    Para solicitar la aprobación, debes levantar un ticket al equipo de API solicitando la autorización de esta misma, envíanos el "ClientId" (en formato texto) que puedes encontrar en el listado de aplicaciones.
    Tu solicitud pasará por un proceso de validación. Te informaremos por el ticket
    cuando la aprobación sea confirmada y tu aplicación esté lista para usar los
    servicios.

     

    Crear aplicación - 1

     

     

    Equipo Integraciones API Multivende

    Más información
  • API Mutivende (Postman)

    Conoce más sobre nuestra API y accede a su documentación disponible en Postman en este artículo.

     

    Multivende Integration Services (MIS) permite a los clientes o aplicaciones de terceros interactuar con la información del usuario de forma estándar, así como diferentes aspectos de la cuenta de los usuarios.

    Puedes comenzar a probar la integración usando una cuenta con {{base_url}} que apunte a la siguiente URL.

    https://app.multivende.com

    Recuerda que nuestra comunicación utiliza HTTPS solo con TLS>= 1.2

     

    En el siguiente enlace, podrás consultar el detalle de nuestra API, la cual se encuentra documentada en Postman para que puedas descargar la colección y realizar pruebas a través de la herramienta..

     

    Equipo Integraciones API Multivende

    Más información
  • Cómo crear una cuenta de pruebas en Multivende

    Prueba Multivende creando una cuenta gratuita y conoce sus funciones antes de usarla en tu negocio.

    Paso 1: Accede al Sitio Web de Multivende

    1. Visita el sitio web oficial de Multivende: www.multivende.com.
    2. En la página principal, busca la opción que dice "Crear Cuenta". Podrás encontrar esta opción en la parte inferior de la página.

    Paso 2: Completa el Formulario de Registro

    1. Rellena tus datos personales: Para crear una cuenta de prueba, deberás proporcionar algunos datos básicos, tales como:

      • Nombre de usuario: 
      • Dirección de correo electrónico (asegúrate de usar una válida)
      • Contraseña segura.
        • Requisitos para la contraseña:
          • Mínimo 12 caracteres.
          • Mínimo 1 letra mayúscula y 1 letra minúscula.
          • Mínimo 1 número.
          • Mínimo 1 símbolo.
          • No puede contener el nombre de usuario.
      • Nombre de la empresa. (Utilizar la siguiente nomenclatura "nombreEmpresa_test")
      • Selecciona tu actividad principal. (Retail, venta mayorista, etc...)
      • Selecciona tu país.
      • Número de telefono. (No olvides incluir el código de area)

    2. Completa el reCAPTCHA.

    3. Enviar el formulario: Haz clic en el botón "Crear Cuenta".

    Paso 3: Inicia Sesión en tu Cuenta

    1. Una vez verificada tu cuenta, regresa al sitio de Multivende.
    2. En la parte superior derecha, haz clic en "Acceder".
    3. Ingresa tu correo electrónico y la contraseña que usaste durante el registro.

    Paso 4: Explora las Funcionalidades

    Con tu cuenta de prueba ya activa, podrás explorar todas las características que Multivende ofrece, como:

    • Crear productos.
    • Crear bodegas.
    • Cargar stock.
    • Cargar precios.
    • Crear ventas.
    • Administrar inventarios.
    • Probar opciones de pago y envío.
    • Entre otras...

     

    ¿Te gustaría aprender más sobre cómo sacar el máximo provecho a tu cuenta de prueba?
    Te invitamos a visualizar nuestro Workshop del Funcionamiento de la plataforma, donde te explicaremos detalladamente cómo utilizar cada funcionalidad y resolveremos todas tus dudas.

     

    Paso 5: Contacta Soporte si tienes preguntas

    Si tienes algún problema durante el registro o necesitas asistencia adicional, puedes contactar con el equipo de soporte de Multivende a través de las opciones de ayuda en línea o contacto que se encuentran en el sitio.

    Si necesitas más detalles de como contactar al equipo de Integraciones API, puedes ver más detalles en el siguiente artículo:

     

    Equipo Integraciones API Multivende

     

     

    Más información