Preguntas Frecuentes

En este artículo, te compartimos algunas recomendaciones para realizar tu integración vía API con Multivende.

Si debes crear una integración porque formas parte de nuestro Developers Partners Program o si ya te encuentras trabajando en una integración para un merchant de Multivende, debes seguir las siguientes recomendaciones para que puedas brindar la mejor experiencia de trabajo al merchant y para que tus procesos también sean más optimizados.

Desarrollo de integraciones como Partner de Multivende

Si eres miembro de nuestro Developers Partners Program como desarrollador de integraciones con Multivende, debes tomar en cuenta las siguientes recomendaciones:

Consideraciones como desarrollador:

• Debes asegurarte de que tu equipo de desarrollo asista al onboarding de TI, ya que en este se dejará configurada la cuenta test del merchant para las pruebas en ambiente QA de la integración.

• Como integrador debes asistir a las reuniones semanales pautadas durante el proyecto de integración.

• Te pedimos que seas muy claro en las funcionalidades que cubre tu integración, las cuáles debes notificarnos en el Go Live y dejar definido si es factible realizar algún desarrollo customizado que el merchant requiera.

Consideraciones de parte de Multivende:

• Nuestro equipo de API hará seguimiento para confirmar la finalización del proyecto, es importante que des respuesta a nuestros emails y realizar una reunión para validar que la integración finalizó con éxito.

• Recuerda que ante cualquier duda o inconveniente en la conexión con nuestro servicio de integraciones, puedes consultarnos a través del correo electrónico api@multivende.com.

Desarrollo de integraciones para clientes

Si ya te encuentras desarrollado una integración específica para un merchant de Multivende, debes tomar en cuenta las siguientes recomendaciones

Consideraciones como desarrollador:

• Una vez cerrado tu acuerdo comercial, mantén en todo momento la comunicación, es importante que vayas dando estatus de los avances de la integración y asistir a todas a las reuniones pautadas.
  Recuerda que si requieres apoyo del equipo de API de Multivende puedes avisarnos y sumarnos a la comunicación.
• Debes ser claro en las funcionalidades que cubre tu integración y deja definido si es factible realizar algún desarrollo customizado que el merchant requiera.
• Debes llenar el formulario de integraciones en conjunto con el merchant cuando el equipo de Onboarding lo solicite para definir el alcance de la integración previo al kickoff.

• Como integrador, debes asistir a las reuniones semanales pautadas durante el proyecto de integración.

• Debes solicitar al merchant directamente los accesos a sus cuentas productivas en Multivende y gestionar las pruebas y recursos necesarios para validar la integración.

• Debes asegurarte de que tu equipo de desarrollo asista al onboarding de TI donde se deja configurada la cuenta test de merchant para las pruebas en ambiente QA de la integración. 

• Como integrador, debes garantizar que la integración cumpla con las necesidades del merchant.

Consideraciones de parte de Multivende:

• Multivende es responsable de realizar el kickoff inicial del proyecto para un merchant en conjunto. Como integrador, debes asistir a esta reunión con los miembros de tu equipo de TI que realizará la integración, ya que en el kickoff se debe dejar claro el alcance del proyecto.

• Nuestro equipo de API hará seguimiento para confirmar la finalización del proyecto, es importante que des respuesta a nuestros emails y realizar una reunión para validar que la integración finalizó con éxito.

• Recuerda que ante cualquier duda o inconveniente en la conexión con nuestro servicio de integraciones puedes consultarnos a través del correo electrónico api@multivende.com.

¡Manténte atento a las comunicaciones API!

Te aconsejamos estar atento a las comunicaciones de nuestro equipo de desarrollo ante cualquier comunicación que enviemos referente a la actualización en nuestra API, esto con el fin de garantizar que tu desarrollo no se vea afectado ante algún cambio.

Equipo Integraciones API Multivende

Necesitas el Client ID y Secret para obtener un token y acceder a los servicios de nuestra API.

Debes ingresar en tu cuenta previamente creada realizando login a través de:

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

Tanto el Client ID como el Client Secret los puedes encontrar ingresando a tu lista de aplicaciones.

Haz click en el botón de acciones como se muestra en la siguiente imagen:

Al darle click al botón de acciones podrás editar los datos de tu aplicación, además, en la parte superior del formulario encontrarás el Client ID y el Client Secret resaltado en color azul.

Equipo Integraciones API Multivende

El Merchant ID es clave para consultas en la API. Aquí aprenderás a ubicarlo en la interfaz.

• Para consultar tu ID de comerciante, debes seguir los pasos a continuación:

1.- Debes hacer clic en el ícono del lápiz que aparece al lado del nombre de la cuenta. Este enlace te llevará a visualizar/editar los datos de la cuenta.

2.- Toma de la URL el ID, este es el identificador de la cuenta (Merchant_id).

¡Listo! Ya obtuviste tu Merchant ID.

Equipo Integraciones API Multivende

Aprende a consultar los ID de recursos en la interfaz de la plataforma Multivende.

Para facilitar la visibilidad entre los ID entregados vía API y la plataforma, en la URL de Multivende puedes verificar el ID del ítem seleccionado.

Por ejemplo, al seleccionar "editar" una bodega la URL será:

https://app.multivende.com/stores-and-warehouses/XXXXXXXX-3639-4c28-9e1c-XXXXXXXXXXXX/edit

Donde el ID correspondiente a la bodega es: XXXXXXXX-3639-4c28-9e1c-XXXXXXXXXXXX.

Equipo Integraciones API Multivende

Este campo es el identificador único de una conexión con un canal de venta de la cuenta de un merchant.

Puedes consultar la información de este Id para las conexiones de las cuentas de un merchant mediante el endpoint Get Marketplace connections  , la api retornará un array con todas las conexiones disponibles en la cuenta del merchant:

{
  "entries": [
    {
      "_name": "Mercadolibre",
      "_id": "a58xxxe-1fb6-4bd2-80xx-1b795xxxa39a",
      "name": null,
      "country": "cl",
      "pictureUrl": "https://s3.amazonaws.com/im-shared/mercadolibre.png",
      "provider": "mercadolibre",
      "allowPickUpInStore": null
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 50,
    "total_pages": 1,
    "current_page": 1,
    "next_page": 0,
    "previous_page": 0,
    "total_items": 1
  }
}

En el request de la solicitud se debe identificar el canal de venta al que estamos consultando las conexiones.

Marketplace

• mercadolibre
• linio
• dafiti
• ripley
• paris
• fcom
• amazon
• walmart
• coppel

Online Store:

• vtex
• magento
• shopify
• prestashop
• wocommerce
• jumpseller
• bigcommerce

Equipo Integraciones API Multivende

Si tienes problemas con Webhooks, revisa varios factores que pueden afectar su funcionamiento.

A continuación, se detallan algunas posibles causas y soluciones para que puedas realizar las validaciones necesarias.

1. Enviar CallbackURL para realizar validaciones internas

• Una de las primeras acciones que debes tomar es asegurarte de que la URL de devolución (CallbackURL) esté correctamente configurada. Esta URL es crucial para que el servidor receptor pueda validar las solicitudes de Webhook. Asegúrate de que la CallbackURL esté configurada correctamente en tu aplicación y que esté preparada para recibir y procesar los Webhooks de manera adecuada.

2. El problema puede ser porque no está permitiendo la IP de Multivende

• Otro posible motivo por el que no recibes los Webhooks es que tu servidor no esté permitiendo la IP de Multivende (o el servidor que está enviando los Webhooks).
• Si tu firewall o configuración de red bloquea estas direcciones IP, los Webhooks no podrán llegar correctamente.
• Verifica que las direcciones IP de origen estén permitidas en tu servidor para asegurarte de que el tráfico de los Webhooks no sea bloqueado.

3. CallbackURL sin certificado SSL válido

• Una de las razones más comunes por las cuales los Webhooks no se reciben es un problema con el certificado SSL de la CallbackURL. Si la URL de destino no tiene un certificado SSL válido o si no está configurada para aceptar conexiones seguras (https), los Webhooks pueden ser rechazados por motivos de seguridad.
• Asegúrate de que tu servidor tenga un certificado SSL válido y que la URL de Callback sea accesible a través de HTTPS.

4. Tiempo de procesamiento de la solicitud muy alto (> 2 segundos)

• El tiempo de procesamiento de la solicitud también puede ser un factor importante. Si el procesamiento de la solicitud que recibes en el Webhook demora más de 2 segundos, es posible que el sistema de Webhooks no lo registre correctamente o que el Webhook se agote por tiempo de espera.
• Revisa el rendimiento de tu servidor y asegúrate de que las solicitudes se procesen de manera eficiente y en tiempos adecuados para evitar problemas.

Conclusión

Si estás experimentando problemas con la recepción de Webhooks, asegúrate de validar cada uno de los puntos mencionados anteriormente. Revisar la configuración de la CallbackURL, permitir las IPs correctas, contar con un certificado SSL válido y optimizar el tiempo de procesamiento de las solicitudes te ayudará a resolver los inconvenientes y mejorar el flujo de trabajo con Webhooks.

Si después de verificar estos puntos el problema persiste, puede ser útil realizar pruebas adicionales y revisar los logs de tu servidor para obtener más información sobre el origen del problema.

1. Fechas de actualización y fechas de venta en el canal de ventas (updatedAt y soldAt): Asegúrate de que las fechas enviadas en las consultas estén correctamente alineadas con los valores de las propiedades updatedAt y soldAt de las órdenes.

   • updatedAt: Esta fecha indica la última vez que una orden fue modificada. Si envías una fecha anterior a la última actualización de una orden, es probable que no obtengas los resultados más recientes.

   • soldAt: Esta fecha refleja el momento en que la venta fue registrada en el canal de ventas. Si estás buscando órdenes con fechas soldAt anteriores a la fecha real en la que la orden fue registrada, podrías estar excluyendo órdenes válidas.

   Consejo: Al hacer la búsqueda, asegúrate de enviar las fechas correctas según estos parámetros. Si usas fechas incorrectas, podrías obtener resultados incompletos o incorrectos.

¿Cómo solucionar estos problemas?

• Verifica las fechas: Revisa cuidadosamente las fechas de updatedAt y soldAt al realizar las consultas. Asegúrate de que estás utilizando el formato correcto y que las fechas sean relevantes para las órdenes que buscas.

¿Puedo configurar un intervalo de tiempo específico para el polling?

Sí, puedes configurar un intervalo de tiempo específico que se adapte a tus necesidades, de manera que solo se busquen órdenes dentro de un rango de fechas determinado. Sin embargo, recuerda siempre ajustar las fechas de updatedAt y soldAt según sea necesario para obtener los resultados más precisos.

Equipo Integraciones API Multivende

Actúan como un mecanismo complementario a los webhooks para mitigar la potencial pérdida de notificaciones o eventos.

• Polling de ventas

Se debe consultar las ventas de un rango de fechas cada M (Frecuencia de ejecución) horas, estableciendo lo siguiente:

• from = fecha y hora de la última vez que se ejecutó correctamente el polling (si no se ha ejecutado, desde que fecha y hora se deben consultar las ventas).
• to = la fecha y la hora actual.
• M = frecuencia de ejecución (recomendamos usar M = 1 -2 horas).

Debes utilizar el endpoint Get checkouts light whit scroll para realizar el sondeo de las órdenes desde Multivende.

En cada solicitud, se debe enviar el MerchantId. De manera opcional, puedes filtrar por MarketplaceConnectionId y obtener las ventas utilizando los campos de fecha:

• UpdatedAt: fecha de última actualización de la orden.
• SoldAt: fecha de venta en el canal de venta.

También debes definir el límite (limit) de resultados a consultar (valor permitido entre 50 y 1000). Este endpoint permite obtener las ventas del merchant paginadas mediante scroll.

Más información en el artículo Registro de ventas desde Multivende: Instrucciones para integrarlas en tu sistema

• Polling de productos

Mediante el endpoint de Get products with scroll puedes traer un listado de productos nuevos o actualizados en una cuenta de merchant en un rango de tiempo determinado.

En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 5000.

El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.

El endpoint permite filtrar por fecha de creación (createdAt) o por fecha de actualización (updatedAt), devolviendo los items en el rango de fecha consultado (de from a to).

Podemos incluir las imágenes y los atributos customizados en la respuesta enviando estos filtros con el valor true.

La respuesta del endpoint nos dará un array con todos los productos incluidos en la consulta, donde podremos identificar además la información del producto padre y de las versiones.

• Polling de stock

Permite consultar el stock de productos por bodega que se haya registrado o actualizado en una rango de tiempo determinado.

En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 30000.

El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.

El endpoint Get stocks with scroll permite filtrar por fecha de creación (createdAt) o por fecha de actualización (updatedAt), devolviendo los ítems en el rango de fecha consultado (de from a to).

La variable amount de cada registro devuelto en la solicitud nos dará el monto de stock disponible para el producto.

• Polling de precios

Puedes obtener los precios nuevos o actualizados en un rango de tiempo determinado por lista de precios mediante el endpoint de Get prices with scroll.

En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 30000.

El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.

Por cada registro podemos validar los precios asociados a los product versions mediante los campos:
- net (precio neto)
- gross (precio de venta)
- tax (impuesto)
- pricewithdescount (precio con descuento)

• Polling de product links

Consultas los estados de sincronización de los productos que fueron vinculados hacia el canal de venta (sólo para administración de integraciones que son de tipo canal de venta) por fecha de creación o actualización.

Con Get product links with scroll obtienes un array de los registros devueltos en la solicitud, donde puedes validar el synchronizationStatus del producto hacia el canal y de acuerdo a este realizar las acciones necesarias para la vinculación.

En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 1000.

El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.

• Polling de clientes

Puedes obtener el registro de clientes nuevos o actualizados en un rango de tiempo determinado mediante el endpoint de Get clients with scroll.

En la solicitud vamos a indicar el límite ({{limit}}) de items que queremos consultar, el rango permitido de items a traer va entre 50 y 30000.

El parámetro _scroll_id nos permite avanzar a la siguiente página, si llega en null indica que todos los items llegaron en la actual consulta realizada.

Equipo Integraciones API Multivende

Guía para formar el Ubigeo de Perú desde Ripley y MELI con datos normalizados por Multivende.

📌 ¿Qué es el Ubigeo?

El Ubigeo es un código numérico de seis cifras que identifica de manera única cada división político-administrativa del Perú: dse compone de tres elementos principales:

• Departamento (Ciudad)
• Provincia
• Distrito

Canal: Ripley

¿Cómo llega la información desde Ripley?

Ripley proporciona los datos de ubicación en los siguientes campos:

• "City" → Ciudad
• "State" → Provincia
• "Street_2" → Distrito

🔄 ¿Cómo lo normaliza Multivende?

Multivende transforma esta información y la expone de forma estándar en el Checkout, en la ruta:

DeliveryOrderInCheckouts → DeliveryOrder → ShippingAddress

Con los siguientes campos:

• "city" → Ciudad
• "state" → Provincia
• "address_2" → Distrito

Canal: MercadoLibre (MELI)

¿Cómo llega la información desde MercadoLibre?

MercadoLibre informa los datos de la dirección en:

• Shipping.receiver_address.state → Departamento
• Shipping.receiver_address.city → Provincia
• Shipping.receiver_address.neighborhood → Distrito

🔄 ¿Cómo lo normaliza Multivende?

En el Checkout, dentro de:

DeliveryOrderInCheckouts → DeliveryOrder → ShippingAddress

Los datos se exponen como:

• "city" → Ciudad
• "state" → Provincia
• "neighborhood" → Distrito

Canal: Falabella

¿Cómo llega la información desde Falabella?

Falabella proporciona los datos de ubicación directamente en un campo denominado PostCode

• "PostCode": 150140 

🔄 ¿Cómo lo normaliza Multivende?

Multivende transforma esta información y la expone de forma estándar en el Checkout, en la ruta:

Checkout → Client → BillingAddresses → zipCode

Con los siguientes campos:

• "zipCode":150140

   

✅ Resumen por canal

Notas adicionales

• La información se encuentra siempre dentro del Checkout, por lo que recomendamos a los integradores acceder a los campos mencionados a través del objeto DeliveryOrderInCheckouts.
• Multivende se encarga de normalizar los datos geográficos para Perú, lo que facilita la implementación multicanal.
• Si otros canales llegaran a incluir datos similares, Multivende los procesará del mismo modo.
• El campo zipCode puede ser utilizado para asignación de zonas de envío, validación de direcciones, cálculo de impuestos, entre otros fines logísticos.
• No se requiere ninguna transformación adicional desde el lado del integrador: Multivende se encarga de mapear y normalizar automáticamente los datos.

Si alguno de los servicios de la API de Multivende retorna error al hacer una consulta, lo ideal es seguir un proceso ordenado para identificar la causa y resolverlo.

Puede acontecer durante tu implementación que la api no retorne información o retorne algún error no esperado, por ejemplo al consultar el stock, las ventas o los productos.. A continuación te presentamos una lista de posibles causas que puedes validar:

 1. Lee el código de estado (status code)

El código HTTP te dice mucho sobre el tipo de error:

• 400 → Solicitud mal formulada (Bad Request)
• 401 / 403 → Error de autenticación o permisos
• 404 → Recurso no encontrado
• 405 → Método no permitido (por ejemplo, usaste GET en vez de POST)
• 500 / 502 / 503 / 504 → Error del servidor o servicio caído

2. Revisa el cuerpo del error (response body)

La mayoría de APIs devuelven un mensaje explicativo. Ejemplo:

{
 "error": "Missing parameter 'productId'"
}

Esto te indica directamente qué parámetro falta o está mal.

3. Verifica tu solicitud (request)

Comprueba que:

• La URL del endpoint esté correcta.
• El método HTTP coincida con lo que la API espera (GET, POST, PUT, DELETE).
• Los headers sean los adecuados (Content-Type, Authorization, etc.).
• El body tenga el formato correcto (por ejemplo, JSON válido).

👉 Puedes probar la solicitud en Postman o cURL para ver la respuesta directamente.

4. Revisa autenticación y permisos

Errores comunes:

• Token vencido.
• Token sin permisos para ese endpoint.

💡 Para OAuth2, revisa si el grant type y los scopes son los correctos.

 5. Valida los parámetros

Asegúrate de enviar:

• Todos los parámetros requeridos.
• En el formato correcto (por ejemplo, número vs string).
• Sin valores nulos o vacíos si no están permitidos.

Ejemplo:

{
 "user_id": 123,
 "email": "user@example.com"
}

 6. Consulta la documentación

Busca el endpoint específico en la documentación de la API y revisa:

• Qué campos son obligatorios.
• Qué valores acepta.
• Ejemplos de solicitudes exitosas.

7. Activa logs o consola de depuración

Si estás desarrollando:

• Usa herramientas como console.log() o logs del servidor.
• Captura tanto el request como el response para ver qué se está enviando y recibiendo.

 8. Contacta al soporte de la API

Si todo está correcto y el error persiste, puede ser:

• Un problema temporal del servidor.
• Un bug en la API.

Proporciona al soporte:

• URL del endpoint
• Método HTTP
• Cuerpo de la solicitud
• Respuesta completa (código + mensaje)

Envía esta información con el detalle de tu caso mediante nuestro formulario de soporte API Multivende

Equipo de API Multivende

Este artículo explica paso a paso cómo completar el Formulario de Integración API con Multivende.

El objetivo del formulario es recopilar toda la información necesaria para planificar, desarrollar y dar seguimiento a una integración técnica entre Multivende y uno o más sistemas externos (por ejemplo ERP, WMS, OMS, operador logístico, etc.).

Completar correctamente todos los campos es fundamental para evitar retrasos, reprocesos o solicitudes de información adicional por parte del equipo técnico.

Con esta información Multivende puede:

• Registrar el proyecto de integración.
• Definir el alcance funcional y técnico.
• Identificar responsables y contactos del equipo que desarrollará.
• Planificar la implementación por etapas (Versiones 1, 2 y 3).
• Acompañar el proceso de forma ordenada.

¿Quién debe completarlo?

Debe ser completado por:

• Jefe de Proyecto (coordinación y seguimiento)
• Líder de TI / Desarrollo (definición técnica del alcance)

Si la integración será desarrollada por un equipo externo (partner o proveedor), se recomienda completar el formulario en conjunto con ellos, para asegurar que las funcionalidades seleccionadas correspondan a las acordadas u ofertadas y que la planificación por versiones sea correcta.
 

Consideraciones generales antes de completar el formulario

• Todos los campos marcados con (*) son obligatorios.

• La información debe ser clara, precisa y actualizada.

• Si deseas integrar más de un sistema, debes completar un formulario por cada sistema.

• Las fechas ingresadas deben ser coherentes con la planificación real del proyecto.

• Las funcionalidades seleccionadas deben corresponder a lo que efectivamente se desarrollará vía API.

• Te recomendamos leer:
  • Todo lo que debes saber sobre Integraciones API
    
    • https://help.multivende.com/hc/es-419/articles/13698322328461-Todo-lo-que-debes-saber-sobre-Integraciones-API
• Y para elegir funcionalidades según tu tipo de sistema:
  • Guía de acciones según tu tipo de integración
    • https://help.multivende.com/hc/es-419/sections/13698226753037-Gu%C3%ADa-de-acciones-seg%C3%BAn-tu-tipo-de-integraci%C3%B3n

Importante (Onboarding y catálogo)

• La carga inicial del catálogo principal se realiza durante el onboarding vía Excel (cargas masivas) o importación desde canales.
• La carga/sincronización de catálogo e imágenes vía API puede ejecutarse en paralelo, pero no reemplaza la carga inicial del onboarding.

Enlace al formulario 

Descripción de los campos del formulario

• Datos generales del merchant

Razón social *

Ingresa la razón social legal de la empresa que realizará la integración.

Ejemplo:
Empresa Ejemplo SpA

Nombre Fantasía *

Ingresa el nombre comercial con el que la empresa es conocida.

Ejemplo:
EjemploTech

• Responsables del proyecto

Nombre de Jefe de proyecto *

Corresponde a la persona del área TI (o similar) de la empresa que será responsable de supervisar y facilitar la integración.

Importante:
Debe ser un contacto válido y activo durante todo el proyecto.

Correo Jefe de proyecto *

Ingresa el correo electrónico del Jefe de proyecto indicado anteriormente.

Este correo será utilizado para:

• Coordinación del proyecto

• Comunicaciones técnicas

• Seguimiento de avances

Nombre y correo del líder de desarrollo *

Corresponde a la persona del área TI encargada de ejecutar la integración técnica.

• Si el desarrollo lo realiza un proveedor externo, debes indicar:

  • El líder TI del proveedor

  • Su correo electrónico

Nombres, correos y cargo del equipo de desarrollo

Ingresa los datos del equipo técnico que participará en la integración.

Ejemplo:

• Juan Pérez – Desarrollador Backend – juan.perez@empresa.com

• María López – Arquitecta TI – maria.lopez@empresa.com

Este campo ayuda a facilitar la comunicación técnica durante el proyecto.

• Sistema a integrar

Nombre de sistema a integrar *

Indica el nombre del sistema que se comunicará con Multivende a través de la API, incluyendo su versión si corresponde.

Ejemplo:
SAP Business One
SAP S/4HANA
Oracle Netsuite

⚠️ Importante:
Si deseas integrar más de un sistema, debes completar un formulario por cada sistema.

Tipo de sistema *

Selecciona el tipo de sistema que deseas integrar. Las opciones disponibles son:

• ERP:

  • Sistema central de gestión del negocio: suele ser “la fuente” de productos, precios, stock, compras, ventas, contabilidad y/o facturación.
    ✅ Ideal si necesitas sincronizar productos, precios, stock, ventas y documentos.

• OMS:

  • Gestiona el ciclo completo de pedidos: creación, preparación, cambios de estado, cancelaciones, despacho y postventa.
    ✅ Ideal si buscas automatizar ventas y estados de órdenes.

• WMS:

  • Gestiona la bodega: inventario físico, ubicación, picking/packing y despacho.
    ✅ Ideal para automatizar stock y estados logísticos.

• Operador Logístico:

  • Proveedor externo que almacena y despacha pedidos. Normalmente gestiona tracking, entregas y confirmaciones.
    ✅ Ideal para automatizar estados de despacho/retiro y documentación logística.

• POS:

  • Sistema de punto de venta en tienda física. Afecta ventas presenciales y, muchas veces, stock.
    ✅ Ideal si necesitas sincronizar stock y/o ventas de tienda física.

• DTE:

  • Sistema de facturación electrónica que emite boletas/facturas/notas de crédito.
    ✅ Ideal si necesitas automatizar carga/lectura de documentos tributarios asociados a órdenes.

• RMS:

  • Sistema de gestión retail: operación comercial, tiendas, pricing, promociones, etc.
    ✅ Ideal para automatizar precios, stock, catálogo (según alcance del RMS).

• PIM:

  • Centraliza datos de productos: fichas, atributos, descripciones, multimedia e información enriquecida.
    ✅ Ideal para automatizar sincronización de productos/catálogo.

• Otro:

  • Solución propia o sistema especializado que no encaja en las categorías anteriores.
    ✅ En este caso se recomienda detallar el objetivo en “Observaciones”.

Selecciona la opción que mejor represente la función principal del sistema.

• Fechas del proyecto

Fecha de inicio del proyecto de integración *

Selecciona la fecha en que comenzará el proyecto de integración.

Debe corresponder al inicio real de las actividades técnicas o de coordinación.

Fecha estimada de fin del proyecto *

Selecciona la fecha estimada para tener en producción la Versión 1.

📌 Estas fechas ayudan a planificar acompañamiento, validaciones y hitos del proyecto.

• Selección de funcionalidades a automatizar

En este apartado debes seleccionar las funcionalidades que se automatizarán vía API.

Para cada funcionalidad seleccionada, deberás indicar la versión de integración en la que será desarrollada.

Las versiones representan las fases o etapas en las que las funcionalidades saldrán a producción:

• Versión 1 - primera etapa en producción (mínimo viable / prioritario)

• Versión 2 - segunda etapa

• Versión 3 - etapa final o mejoras posteriores

📌 Recomendación: asigna V1 a lo que sea crítico para operar (por ejemplo: stock o ventas), y deja V2/V3 para optimizaciones.

Funcionalidades disponibles

• Sincronizar ventas

  • Permite integrar y centralizar en tu sistema las ventas procesadas en Multivende, optimizando finanzas y operación: emisión de documentos, acciones internas y reportes.

• Actualizar estado de las órdenes

  • Automatiza cambios de estado de órdenes para reflejar el avance real del pedido (trazabilidad). Reduce gestión manual y mejora precisión operativa.

• Generación de etiquetas de envío de los marketplaces

  • Permite automatizar la obtención/sincronización de documentos logísticos (etiquetas) para impresión y operación. Mejora flujo en bodega y evita manejo manual en plataforma.

• Leer documentos tributarios de las órdenes

  • Automatiza la descarga de boletas/facturas ya adjuntas a una orden. Multivende actúa como repositorio para que otros sistemas consuman esos documentos.

• Cargar documentos tributarios de las órdenes

  • Automatiza subir la boleta o factura a la orden para que esté disponible para el comprador en el canal. Esto puede ser requisito en algunos marketplaces.

Funcionalidades para productos / catálogo

• Leer stock

  • Permite consultar stock vía API para mantener sistemas sincronizados, reduciendo trabajo manual y mejorando confiabilidad para la experiencia de compra.

• Cargar stock

  • Envía stock desde tu sistema hacia Multivende para evitar quiebres o sobreventa, manteniendo inventario actualizado en canales.

• Leer precios

  • Permite consultar precios vía API y mantener consistencia entre sistemas.

• Cargar precios

  • Envía precios desde tu sistema hacia Multivende, asegurando actualizaciones rápidas y precisas en los canales conectados.

• Sincronización de productos (recomendado para PIM o canales de venta)

  • Automatiza la gestión del catálogo: envío/actualización de información básica, atributos estándar y personalizados.
    • 📌 No es obligatorio automatizar la carga completa de productos desde tu sistema a Multivende debido a su complejidad; se recomienda hacerlo si cuentas con los atributos básicos requeridos y un PIM/estructura sólida.

🔎 Recomendación:
Selecciona únicamente las funcionalidades que realmente se desarrollarán y asigna correctamente la versión según la planificación del proyecto.

• Observaciones

En este campo puedes ingresar cualquier comentario adicional relevante, por ejemplo:

• Aclaraciones técnicas

• Restricciones del sistema

• Dependencias externas

• Consideraciones especiales del proyecto

Este campo es opcional, pero muy útil para entregar contexto adicional.

• Envío del formulario

Una vez completados todos los campos:

1. Revisa cuidadosamente la información ingresada.

2. Asegúrate de que los correos y nombres estén correctos.

3. Haz clic en Enviar.

Al enviar el formulario:

• Multivende registra el proyecto de integración.

• Se valida el alcance definido.

• Se continúa con el proceso de integración y acompañamiento técnico.