Cómo completar el formulario de Integración API con 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.