Integraciones API

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)

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

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

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.

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.

Equipo Integraciones API Multivende

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

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: (Utilizar la siguiente nomenclatura "nombreEmpresa_test")
   • 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.
   • 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:

• ¿Cómo crear un ticket para contactar al Equipo de Integraciones vía API?

Equipo Integraciones API Multivende

En caso de no contar con una interfaz gráfica para realizar la conexión de la aplicación con la cuenta del Merchant igualmente puede generar tu código de autorización, primero debes ingresar a tu cuenta de Desarrollador, dirigirte a "Aplicaciones", luego a "Listado de aplicaciones" y hacer clic en la acción del "Lápiz" (Editar).

Dentro de la configuración de la aplicación podrás visualizar la opción “Agregar cuentas de merchant”, la cual se encuentra debajo de “Visibilidad”.

Importante, esto solo se puede realizar una vez tengas tu aplicación autorizada.

Una vez dentro, debes insertar el MerchantId en el recuadro y hacer click sobre el botón guardar.

Ahora el Merchant podrá visualizar tu aplicación en el listado de aplicaciones de la vista de Merchants.

Para esto, el Merchant debe ingresar a la plataforma, dirigirse a "Aplicaciones" luego a "Listado de aplicaciones".

Aquí veremos un listado de aplicaciones certificadas de Multivende, se debe hacer scroll hasta el final de la página en donde dice "Listado de aplicaciones propias no certificadas", debes hacer clic en "Ver más" en la aplicación a la cual se desea generar el authorization code, donde el Mrechant podrá otorgar los permisos según lo requiera.

Seguido a esto se debe seleccionar la opción "Generar authorization code", aquí el Merchant podrá brindarle permiso (Scopes) a los datos seleccionados y establecer un nombre para la conexión con la aplicación.

Válida que la información esté correcta y listo, el código de autorización será generado y podrás continuar con el proceso de autenticación mediante Oauth2

Podrás ver el proceso en el siguiente video:

Para generar un nuevo código de autorización de una aplicación ya conectada a la cual se le expiró el refreshToken o algún problema similar; lo puedes realizar sin generar una nueva conexión de la aplicación en Multivende. Para ello debes seguir los siguientes pasos.

Primero, el Merchant debe ingresar a la plataforma de Multivende, seguido a esto hará clic a la opción "Aplicaciones" la cual desplegará "Listado de aplicaciones".

Aquí el Merchant podrá ver todas las aplicaciones que tenga conectadas en su cuenta.

• Se debe hacer click sobre la acción del lápiz en la aplicación en concreto.

• Luego "Generar código de autorización" 

• Y listo, se ha generado el código de autorización para continuar con tu flujo de autenticación.

Puedes ver los detalles en el siguiente vídeo:

Importante

• El código de autorización solo se genera al principio del flujo, luego debes renovar tu token con el refreshToken. Solo en los casos que el refreshToken expire u algún problema similar, se puede realizar este proceso.
• La obtención del código de autorización es un proceso manual que se realiza únicamente desde la cuenta del Merchant. Este proceso no puede ser automatizado debido a que requiere confirmación por parte del Merchant los permisos a otorgar a la aplicación.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

El proceso de autenticación mediante OAuth2 es un paso crucial para garantizar que las aplicaciones de terceros puedan interactuar de manera segura con una API, garantizando que solo los usuarios autorizados puedan acceder a ciertos recursos. Sin embargo, en este proceso, pueden surgir varios errores que impiden obtener o renovar el token de acceso. A continuación, te explicamos los pasos involucrados en este proceso, los posibles errores que podrías enfrentar y cómo solucionarlos.

Proceso de autenticación con OAuth2

Cuando un merchant entrega el código de autorización, se inicia el proceso de autenticación mediante OAuth2. El primer paso consiste en enviar los parámetros necesarios al Endpoint Authenticate OAuth2 utilizando una solicitud HTTP POST.

Ejemplo de solicitud:

curl --location -g '{{base_url}}/oauth/access-token' \
--header 'cache-control: no-cache' \
--header 'Content-Type: application/json' \
--data '{
  "client_id": 00000000000,
  "client_secret": "NMV6TupxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxpR3YNW",
  "grant_type": "authorization_code",
  "code": "ac-xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx"
}
'

En este punto, la API responderá con un objeto que contiene el token, refreshToken y la duración de su validez.

Respuesta exitosa:

{
  "_id": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "status": "created",
  "OauthClientId": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "MerchantId": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "CreatedById": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "UpdatedById": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "OwnerId": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "scopes": { ... },
  "expiresAt": "2021-03-03T01:45:34.958Z",
  "refreshToken": "rt-xxxxxxxx-162b-xxxx-xxxx-xxxxxxxxxxxx",
  "refreshTokenExpiresAt": "2021-03-04T19:45:34.958Z",
  "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

El token tiene una validez de 6 horas, mientras que el refreshToken tiene una validez de 48 horas y puede ser utilizado una única vez para renovar el acceso.

Renovación del Token mediante el Refresh Token

Cuando el token está cerca de expirar, se debe utilizar el Endpoint Refresh Token OAuth2 para obtener un nuevo token y un nuevo refreshToken. Esto debe realizarse antes de que el token original caduque, idealmente cuando queda aproximadamente 1 hora de vida.

Ejemplo de solicitud para renovar el token:

curl --location -g '{{base_url}}/oauth/access-token' \
--header 'cache-control: no-cache' \
--header 'Content-Type: application/json' \
--data '{
  "client_id": 00000000000,
  "client_secret": "NMV6TupxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxpR3YNW",
  "grant_type": "refresh_token",
  "refresh_token": "rt-xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx"
}
'

Respuesta exitosa:

{
  "_id": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "status": "created",
  "OauthClientId": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "MerchantId": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "CreatedById": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "UpdatedById": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "OwnerId": "xxxxxxxxx-3736-4f94-8xxx-xxxxxxxxxxxxxxx",
  "scopes": { ... },
  "expiresAt": "2021-03-03T01:45:34.958Z",
  "refreshToken": "rt-xxxxxxxx-xxxx-4fd9-xxxx-8d9a818bef2a",
  "refreshTokenExpiresAt": "2021-03-04T19:45:34.958Z",
  "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

Este proceso puede ser automatizado para que, cuando el token esté cerca de su expiración (por ejemplo, con 5 horas de antelación), se realice la renovación automática utilizando el refreshToken. De este modo, se garantiza la continuidad en el flujo de autenticación sin interrupciones.

Errores Comunes

1. Token Expirado o Invalidado: Si el token ha expirado y no se ha renovado a tiempo, el proceso debe reiniciarse desde el principio. Esto implica que el merchant deberá generar un nuevo código de autorización manualmente desde la configuración de la aplicación.

2. Refresh Token Expirado o No Utilizado: Si el refreshToken ha expirado o no ha sido utilizado dentro de su período de validez, el proceso también debe reiniciarse desde cero, lo que requerirá que el merchant obtenga un nuevo código de autorización manualmente.

3. Error en la Solicitud de Renovación: Si hay errores en la solicitud de renovación del token (por ejemplo, errores de red, parámetros incorrectos, etc.), asegúrate de validar los datos enviados, como el client_id, client_secret y el refresh_token.

4. Error en la Respuesta del Servidor: Si la API devuelve un error, revisa el código de estado HTTP y el mensaje de error para identificar la causa. Algunos errores comunes incluyen falta de permisos o problemas de autenticación.

Resumen

Para gestionar adecuadamente la autenticación OAuth2, es importante realizar lo siguiente:

• Obtener y gestionar el token y el refreshToken de manera eficiente.

• Automatizar la renovación del token antes de su expiración.

• Asegurarse de que el refreshToken se use dentro de su período de validez.

• Si el refreshToken expira o no es válido, reiniciar el proceso de autenticación obteniendo un nuevo código de autorización manualmente.

Este proceso garantiza que las interacciones con la API sean seguras y fluidas, manteniendo el acceso autorizado de manera continua y sin interrupciones.

Conoce el proceso para interactuar de forma correcta con la API de Multivende y aprovechar las herramientas disponibles para ERP's

Para realizar tu interacción de forma correcta con la plataforma y permitir que tu integración ERP pueda sacar el máximo provecho de las herramientas que brindamos, es necesario iniciar aprendiendo información básica sobre nuestra API, para eso te pedimos leer 5 artículos básicos sobre la integración:

Artículo 1 - Lo que debes saber sobre Integraciones API - (Requerido)

Detallamos cuáles son los pasos para que tu aplicación pueda conectarse a la cuenta del merchant y poder empezar a consultar sus datos.

Artículo 2 - API Mutivende - Postman(Requerido)

Conocerás más sobre nuestra API y su documentación en Postman.

Artículo 3 - ¿Cómo cargar stock vía API?(Requerido)

Encontrarás la información para realizar la sincronización de stock a Multivende. Para hacerlo, debes hacer uso de los endpoints de la sección “stock”, te recomendamos dejar un cron que sincronice los stocks por lo menos una vez al día. Además de una opción para que el usuario pueda ejecutar el proceso manualmente.

Artículo 4 - Actualización de Precios(Opcional)

Podrás obtener la información para realizar la sincronización de precios a Multivende. Para hacerlo, debes hacer uso de los endpoints de la sección “prices”.

Artículo 5 - ¿Cómo crear productos desde tu sistema a Multivende?(Opcional)

Con información básica (SKUs, Nombre, Variantes)(Recomendado): Te dejamos los endpoint disponibles:

• Get products with scroll: Enumera los productos asociados al Merchant.

• Get product by id: Muestra los detalles de un producto por la ID.

Artículo 6 - Registro de ventas desde Multivende: Instrucciones para integrarlas en tu sistema(Requerido)

Conocerás cómo obtener las ventas e iniciar el proceso de logística. Este es un flujo complementario a los webhooks para repasar las ventas en un rango de fechas y horas dadas, se recomienda:

• Registrar el _id de la venta.
• Registrar la fecha de la venta en el canal "soldAt".
• Registrar la fecha de última actualización de la venta en Multivende "updatedAt" para que puedas identificar si la venta ha sido modificada desde la última vez que la obtuviste.
• Luego de registrar la venta por primera vez se envía el stock actualizado de los productos en ella.

Artículo 7 - ¿Cómo enviar Documentos Tributarios a Multivende? (Requerido)

• Detallamos cómo realizar la carga de los documentos electrónicos a las ventas.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Conoce el proceso para interactuar de forma correcta con la API de Multivende y aprovechar las herramientas disponibles para tu integración OMS.

Para realizar tu interacción de forma correcta con la plataforma y permitir que tu integración OMS pueda sacar el máximo provecho de las herramientas que brindamos, es necesario iniciar aprendiendo información básica sobre nuestra API, para eso te pedimos leer 8 artículos básicos sobre la integración:

Artículo 1 - Todo lo que debes saber sobre Integraciones API(Requerido)

Detallamos cuáles son los pasos para que tu aplicación pueda conectarse a la cuenta del merchant y poder empezar a consultar sus datos.

Artículo 2 - API Mutivende - Postman(Requerido)

Conocerás más sobre nuestra API y su documentación en Postman.

Artículo 3 - Registro de ventas desde Multivende: Instrucciones para integrarlas en tu sistema(Requerido)

Conocerás cómo obtener las ventas e iniciar el proceso de logística. Este es un flujo complementario a los webhooks para repasar las ventas en un rango de fechas y horas dadas, se recomienda:

• Registrar el _id de la venta.
• Registrar la fecha de la venta en el canal "soldAt".
• Registrar la fecha de última actualización de la venta en Multivende "updatedAt" para que puedas identificar si la venta ha sido modificada desde la última vez que la obtuviste.
• Luego de registrar la venta por primera vez se envía el stock actualizado de los productos en ella.

Artículo 4 -Estados de una Orden Según el Tipo de Entrega(Requerido)

Encontrarás la información para poder notificar al canal el estado de manejo de una orden.

Artículo 5 - ¿Cómo generar y consultar etiquetas de los Marketplace?(Recomendado):

Conocerás cómo obtener las etiquetas de las ventas que son despachadas por el marketplace.

Artículo 6 - ¿Cómo cargar stock vía API?(Opcional)

Encontrarás la información para realizar la sincronización de stock a Multivende. Para hacerlo, debes hacer uso de los endpoints de la sección “stock”, te recomendamos dejar un cron que sincronice los stocks por lo menos una vez al día. Además de una opción para que el usuario pueda ejecutar el proceso manualmente.

Artículo 7 - Actualización de Precios(Opcional)

Podrás obtener la información para realizar la sincronización de precios a Multivende. Para hacerlo, debes hacer uso de los endpoints de la sección “prices”.

Artículo 8 - ¿Cómo enviar Documentos Tributarios a Multivende? (Opcional)

Detallamos cómo realizar la carga de los documentos electrónicos a las ventas.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Conoce el proceso para interactuar de forma correcta con la API de Multivende y aprovechar las herramientas disponibles para DTE's.

Para realizar tu interacción de forma correcta con la plataforma y permitir que tu integración DTE pueda sacar el máximo provecho de las herramientas que brindamos, es necesario iniciar aprendiendo información básica sobre nuestra API, para eso te pedimos leer 5 artículos básicos sobre la integración:

• Artículo 1 - Todo lo que debes saber sobre Integraciones API(Requerido)
  Detallamos cuáles son los pasos para que tu aplicación pueda conectarse a la cuenta del merchant y poder empezar a consultar sus datos.
  
  
• Artículo 2 - API Mutivende - Postman(Requerido)
  Conocerás más sobre nuestra API y su documentación en Postman.

• Artículo 3 - Registro de ventas desde Multivende: Instrucciones para integrarlas en tu sistema(Requerido)
  Conocerás cómo obtener las ventas e iniciar el proceso de logística. Este es un flujo complementario a los webhooks para repasar las ventas en un rango de fechas y horas dadas, se recomienda:
  • Registrar el _id de la venta.
  • Registrar la fecha de la venta en el canal "soldAt".
  • Registrar la fecha de última actualización de la venta en Multivende "updatedAt" para que puedas identificar si la venta ha sido modificada desde la última vez que la obtuviste.
  • Luego de registrar la venta por primera vez se envía el stock actualizado de los productos en ella.
    
    
• Artículo 4 - ¿Cómo enviar Documentos Tributarios a Multivende? (Requerido)
  Detallamos cómo realizar la carga de los documentos electrónicos a las ventas.

• Artículo 5 - Sincronizar stock vía API (Opcional)
  Encontrarás la información para realizar la sincronización de stock a Multivende. Para hacerlo, debes hacer uso de los endpoints de la sección “stock”, te recomendamos dejar un cron que sincronice los stocks por lo menos una vez al día. Además de una opción para que el usuario pueda ejecutar el proceso manualmente.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Conoce el proceso para interactuar de forma correcta con la API de Multivende y aprovechar las herramientas disponibles para tu integración Fulfillment/WMS/TMS

Para realizar tu interacción de forma correcta con la plataforma y permitir que tu integración pueda sacar el máximo provecho de las herramientas que brindamos, es necesario iniciar aprendiendo información básica sobre nuestra API, para eso te pedimos leer 6 artículos básicos sobre la integración:

• Artículo 1 - Todo lo que debes saber sobre Integraciones API(Requerido)
  Detallamos cuáles son los pasos para que tu aplicación pueda conectarse a la cuenta del merchant y poder empezar a consultar sus datos.
  
  
• Artículo 2 - API Mutivende -Postman(Requerido)
  Conocerás más sobre nuestra API y su documentación en Postman.
  •  
• Artículo 3 - ¿Cómo cargar stock vía API?(Requerido)
  Encontrarás la información para realizar la sincronización de stock a Multivende. Para hacerlo, debes hacer uso de los endpoints de la sección “stock”, te recomendamos dejar un cron que sincronice los stocks por lo menos una vez al día. Además de una opción para que el usuario pueda ejecutar el proceso manualmente.

• Artículo 4 - Registro de ventas desde Multivende: Instrucciones para integrarlas en tu sistema(Requerido)
  Conocerás cómo obtener las ventas e iniciar el proceso de logística. Este es un flujo complementario a los webhooks para repasar las ventas en un rango de fechas y horas dadas, se recomienda:
  • Registrar el _id de la venta.
  • Registrar la fecha de la venta en el canal "soldAt".
  • Registrar la fecha de última actualización de la venta en Multivende "updatedAt" para que puedas identificar si la venta ha sido modificada desde la última vez que la obtuviste.
  • Luego de registrar la venta por primera vez se envía el stock actualizado de los productos en ella.

Conoce las herramientas que tenemos disponibles en Multivende para que puedas registrar tus ventas desde la plataforma hacia tu sistema

Para registrar las ventas desde Multivende hacia un sistema tenemos a disposición dos herramientas:

1. Webhooks: Son notificaciones en tiempo real que se generan cuando ocurre un evento en Multivende y se envían a la aplicación por medio del Callback_URL.
2. Polling: Es un proceso de consulta de ventas que funciona como complemento del webhook. 

¿Cómo realizar esta implementación?

Consultar 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).

Deberas usar el endpoint Get checkouts light para realizar el sondeo de las órdenes desde Multivende.

Modos de consulta según funcionalidad a integrar

1. Sistemas que intervienen en la operación de la orden. Por ejemplo: generación de etiquetas, documentos tributarios, entre otros.
   
   1. _updated_at_from (buscar en fecha de última actualización en Multivende).
   2. _updated_at_to (buscar hasta la fecha de última actualización en Multivende).
   3. _marketplace_connection_id (opcional, filtra por Marketplace).
      
      
2. Sistemas que no intervienen en la operación de la orden. Por ejemplo: reportería, herramientas de BI. 
   
   1. _sold_at_from (buscar en Fecha de venta en el mercado).
   2. _sold_at_to (buscar hasta la fecha de venta en el Marketplace).
   3. _sold_at_order (opcional, ordenar ASC o DESC).
   4. _marketplace_connection_id (opcional, filtra por Marketplace).

Se pueden consultar las ventas cada M = 1 hora, por ejemplo, pasando en los parámetros a continuación:

_updated_at_from: from.
_updated_at_to: to.

Estos parámetros tienen el formato y la zona horaria en UTC, es decir: "YYYY-mm-dd hh:mm:ss".

Ejemplo:

Si la fecha actual es “2020-03-18 20:30”, el request sería de la siguiente manera:

curl --location --request GET

'http://app.multivende.com/api/m/b4bbbbbb-fff2-45b1-99989-0afc7xx32xxx/checkouts/light/p/1?_updated_at_from=2020-03-18 18: 30 & _updated_at_to = 2020-03-18 20:30 '\

--header' Autorización: Baerer eyJ0eXAiOiJKV1QiLCJhbGcixxxxxxxxxxxJ9.e ………… .. '

En donde este sería el Response:

{
"entries": [
{
   "_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
   "status": "created",
   "verifyStatus": "verificado",
   "paymentStatus": "completado",
   "soldAt" : "2019-10-10T16: 12: 59.000Z",
   "createdAt": "2019-10-10T16: 13: 01.000Z",
   "updatedAt": "2019-10-31T22: 01: 09.000Z",
   "BillingAddressId ": null,
   " DeliveryTypeId ": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
   " MerchantId ": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}, 
],
   " paginación ": {
        "desplazamiento": 0,
        "limit": 50,
        "total_pages": 1,
        "current_page": 1,
        "next_page": 0,
        "previous_page": 0,
        "total_items": 11
  }
}

Recomendamos registrar en su sistema los campos updatedAt (Fecha de última actualización en Multivende), soldAt (Fecha de la venta en el canal), y "_id" (identificador de la venta en Multivende), ya que con estos campos se puede comparar en sus registros y validar si es una nueva venta o se debe actualizar.

Consultar detalle de venta por "_id"

Una vez se tenga el "_id" de la venta (response anterior), se consulta su detalle con el endpoint Get Checkout.

Cuando el response tiene el campo:

• DeliveryOrdersInCheckouts: Se refiere a la venta con despachos, el cual es un arreglo que detalla toda la información de los despachos de la venta.
  • Cada despacho viene dentro de un objeto que se llama DeliverOrder. En el objeto se encuentra la dirección de despacho dentro del objeto ShippingAddress.

• PickUpOrders: Se refiere a la venta con retiro en tienda, el cual es un arreglo que detalla toda la información del retiro en tienda para la venta.

Importante: 

• Multivende mantiene la misma estructura, pero los datos pueden variar según el canal. Por ejemplo:

• Los campos DeliveryOrdersInCheckouts y PickUpOrders son arrays dado que una venta puede tener más de un despacho o retiro en tienda asociado.

• Una venta puede contener tanto “DeliveryOrdersInCheckouts” (Despachos) como “PickUpOrders” (Retiros en tienda) esto siempre y cuando el canal lo permita.
• Get delivery order types: Tipos de entrega  para una orden.
  
  

Ejemplos:

1. El campo country puede tener el valor CL o Chile.
2. El campo indication puede llegar el detalle de la calle y casa y en otra venta llegar separado en el campo calle y número.

• Entrega con despacho

Podemos consultar el detalle de la orden para tomar la data relevante para la operación logística mediante el endpoint  delivery order.

• Entrega con retiro en tienda

Podemos consultar el detalle de la orden para tomar la data relevante para la operación logística mediante el endpoint pickup order.

• Entrega Mixta

Se consultan ambos endpoints de acuerdo al tipo de entrega de cada producto.

Consideraciones importantes

• A través de los webhooks las apps resultan más eficientes, porque identifican cuando se produce un cambio en tiempo real y entonces, puede hacer las solicitudes periódicas en un rango de tiempo más amplio a la API para obtener el contenido actualizado.
• Los webhooks se deben complementar con un polling para disminuir la probabilidad de pérdida de datos. (Actualmente no estamos realizando re intentos que aseguren el delivery de la notificación).
• Si al consultar el detalle de la venta con el CheckoutId el response es con status 404, se debe a que se trata de una venta que presentó error en el registro de Multivende la cual no queda registrada.
• Deben validar siempre desde webhooks y polling que el id de la venta informado ya se encuentre registrado en tu sistema para ver si la creas o actualizas.
• Validar para actualizar si la fecha de updateAt es diferente a la que tienes registrada.

Ventas con errores:

Es posible consultar los ids de las ventas que no se registraron en Multivende por motivos de error durante el registro, esto puede funcionar como una auditoría. Para realizar la consulta de estos ids pueden realizar un request al endpoint Get checkouts with error

La respuesta de la api dará una descripción del error que causó el no registro correspondiente de la orden. Recordar que cuando la orden es corregida, se lleva a cabo el registro de la misma con un id diferente.

{
  "entries": [
{
  "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "externalId": "XXXXXXX",
  "externalContent": null,
  "error": "StatusCodeError: 404 - {\"cause\":\"\",\"message\":\"Order do not exists\",
            \"error\":\"order_not_found\",\"status\":404}\n at new StatusCodeError 
            (/app/node_modules/request-promise/lib/errors.js:32:15)\n at Request.RP$callback 
            [as _callback] (/app/node_modules/request-promise/lib/rp.js:77:29)\n at 
            Request.self.callback (/app/node_modules/request/request.js:185:22)\n 
            at Request.emit (node:events:513:28)\n at Request.emit (node:domain:489:12)\n 
            at Request.<anonymous> (/app/node_modules/request/request.js:1154:10)\n 
            at Request.emit (node:events:513:28)\n at Request.emit (node:domain:489:12)\n 
            at IncomingMessage.<anonymous> (/app/node_modules/request/request.js:1076:12)\n 
            at Object.onceWrapper (node:events:627:28)\n at IncomingMessage.emit 
            (node:events:525:35)\n at IncomingMessage.emit (node:domain:489:12)\n at 
            endReadableNT (node:internal/streams/readable:1358:12)\n at 
            processTicksAndRejections (node:internal/process/task_queues:83:21)",
  "archived": "disabled",
  "count": 0,
  "status": null,
  "eventStatus": "error",
  "type": null,
  "createdAt": "2021-05-22T04:29:46.000Z",
  "updatedAt": "2021-05-22T04:29:46.000Z",
  "MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "MarketplaceConnectionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
},
{
  "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "externalId": "XXXXXXX",
  "externalContent": null,
  "error": "StatusCodeError: 404 - {\"cause\":\"\",\"message\":\"Order do not exists\",
            \"error\":\"order_not_found\",\"status\":404}\n at new StatusCodeError 
            (/app/node_modules/request-promise/lib/errors.js:32:15)\n at Request.RP$callback 
            [as _callback] (/app/node_modules/request-promise/lib/rp.js:77:29)\n at 
            Request.self.callback (/app/node_modules/request/request.js:185:22)\n 
            at Request.emit (node:events:513:28)\n at Request.emit (node:domain:489:12)\n 
            at Request.<anonymous> (/app/node_modules/request/request.js:1154:10)\n 
            at Request.emit (node:events:513:28)\n at Request.emit (node:domain:489:12)\n 
            at IncomingMessage.<anonymous> (/app/node_modules/request/request.js:1076:12)\n 
            at Object.onceWrapper (node:events:627:28)\n at IncomingMessage.emit 
            (node:events:525:35)\n at IncomingMessage.emit (node:domain:489:12)\n at 
            endReadableNT (node:internal/streams/readable:1358:12)\n at 
            processTicksAndRejections (node:internal/process/task_queues:83:21)",
  "archived": "disabled",
  "count": 0,
  "status": null,
  "eventStatus": "error",
  "type": null,
  "createdAt": "2021-05-22T04:11:37.000Z",
  "updatedAt": "2021-05-22T04:11:37.000Z",
  "MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "MarketplaceConnectionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
}

Si se consultan los id's asociados a las ventas con error en la api de Get checkout esta dará un 404 debido a que las ventas con error no quedan guardadas en Multivende.

Flujo de la consulta

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

En este artículo detallamos la información de la facturación referente a una venta según el Canal.

Lo primero que debes realizar es consultar la orden enviando el ID mediante el Endpoint Get Checkout, los detalles para la información de facturación puedes obtenerla dentro de nuestros campos normalizados en Multivende, consultando dentro de "Client" donde podrás obtener todos los datos relacionados al cliente y dentro del campo "BillingAddresses" los detalles en relación a la dirección de facturación.

"Client": {
   "fullName": "",
   "_id": "a8e48e5c-XXXX-4dab-9ec3-XXXXXXXXXXXX",
   "name": "",
   "lastName": "",
   "activity": null,
   "contactName": null,
   "comune": null,
   "city": null,
   "documentType": null,
   "taxId": "XXXXXXXX-X",
   "birthday": null,
   "code": null,
   "email": null,
   "phoneNumber": null,
   "comment": null,
   "type": "person",
   "tags": null,
   "status": "created",
   "createdAt": "2020-11-04T19:32:04.000Z",
   "updatedAt": "2020-11-04T19:32:04.000Z",
   "CreatedById": "af718539-XXXX-4413-8c83-XXXXXXXXXXXX",
   "UpdatedById": "68a88914-XXXX-414e-9d3c-XXXXXXXXXXXX",
   "ClientId": "a8e48e5c-XXXX-4dab-9ec3-XXXXXXXXXXXX",
   "MerchantId": "be133293-XXXX-4f01-822a-XXXXXXXXXXXX"

   "BillingAddresses": [
       {
          "_id": "30feddc9-XXXX-4951-816b-XXXXXXXXXXXX",
          "name": "Full Name",
          "address_1": "Coquimbo - IV - Coquimbo, Chile",
          "address_2": "General Bartolome Blanche XXX",
          "description": null,
          "indications": null,
          "position": 0,
          "status": "created",
          "importance": "principal",
          "createdAt": "2023-03-10T13:02:10.000Z",
          "updatedAt": "2023-03-10T13:02:10.000Z",
          "CreatedById": "af718539-XXXX-4413-8c83-XXXXXXXXXXXX",
          "UpdatedById": "68a88914-XXXX-414e-9d3c-XXXXXXXXXXXX",
          "ClientId": "a8e48e5c-XXXX-4dab-9ec3-XXXXXXXXXXXX",
          "MerchantId": "be133293-XXXX-4f01-822a-XXXXXXXXXXXX"
      }
   ]
}

• Para identificar la información de facturación del cliente debes consultar el campo "CheckoutBillingClients"

"CheckoutBillingClients": [
 {
   "_id": "9f1839df-XXXX-4a05-XXXX-2e4024XXXXXX",
   "name": "Multivende",
   "taxName": null,
   "taxActivity": null,
   "taxId": "XXXXXXXXX",
   "documentType": "RUT",
   "legalRepresentative": null,
   "legalRepresentativeTaxId": null,
   "email": null,
   "phoneNumber": null,
   "type": "company",
   "status": "created",
   "createdAt": "2024-01-12T12:41:08.000Z",
   "updatedAt": "2024-01-12T12:41:08.000Z",
   "BillingAddressId": "02e22a7b-7850-4204-8728-78a888ae09c7",
   "CheckoutId": "0d85a156-9c81-XXXX-XXXX-7908e8XXXXXX",
   "CreatedById": null,
   "UpdatedById": null,
   "MerchantId": "4df759c7-XXXX-4cad-XXXX-a5e954XXXXXX"
 }
],

• Dafiti  y Falabella

Esta se informa dentro del campo "InvoiceRequired"

"InvoiceRequired": "false" (Boleta)

"InvoiceRequired": "true" (Factura)

• Mercadolibre:

Se informa dentro de "remote_order_extra_billing_information --> "billing_info" --> "additional_info"

Si la orden de compra en una boleta llegará de la siguiente manera:

{
"type": "INVOICE_TYPE",
"value": "Boleta"
},

Y en caso de ser factura:

{
"type": "INVOICE_TYPE",
"value": "Factura"
},

• Paris:

Se informa dentro del campo "originInvoiceType".

"originInvoiceType": "boleta"

"originInvoiceType": "factura"

• Ripley:

Se informa dentro del campo "has_invoice"

"has_invoice": false (Boleta)

"has_invoice": true (Factura)

• Shopify

Se informa dentro de los campos "CheckoutLink" --> "tags"

"tags":[
     "CS_AIOD",
     "CS_APPLIED_SHOPIFY_DISCOUNT",
     "EXTRACYBER",
     "FACTURA",
     "Packed at 16:14 on marzo 29 2023",
     "Packed at 16:15 on marzo 29 2023",
     "PLAZA"
],

• VTEX

Se informa dentro del campo "clientProfileData" --> "isCorporate"

"isCorporate": true (Factura)

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Se pueden adjuntar archivos tanto las ventas (Checkouts) como los despachos (DeliveryOrder) en formato PDF con un peso máximo de 1MB, para ello se requiere identificar los respectivos _ids de la venta o del despacho.

Subir documentos electrónicos a las ventas

Primero se tiene que crear un registro en Multivende del DTE usando el siguiente endpoint Create checkout electronic billing document, dentro del body estarás enviando la siguiente información: 

• Checkout_id (Identificador único de la venta en Multivende).
• ClientId (se obtiene desde el Client en el detalle de la venta consultando el Endpoint Get Checkout).
• id (Número de folio correspondiente al documento a ser cargado).
• Fecha de emisión.
• type (se detalla más adelante).
• provider (se detalla más adelante).
• ElectronicBillingDocumentEmitterId (se detalla más adelante).

Request:

curl --location -g '{{base_url}}/api/checkouts/{{checkout_id}}/electronic-billing-documents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
"ClientId": "{{client_id}}",
"id": "XXXXXXX",
"emissionDate":"2019-03-01",
"type":"electronic_billing_electronic_bill",
"provider":"test_provider_code",
"ElectronicBillingDocumentEmitterId":"{{electronic_billing_document_emitter_id}}"
}'

Response:

{
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"status": "created",
"ClientId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"id": "8877777",
"emissionDate": "2019-03-01T00:00:00.000Z",
"ElectronicBillingDocumentEmitterId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ElectronicBillingDocumentTypeId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ElectronicBillingDocumentProviderId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"CheckoutId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"updatedAt": "2019-08-29T15:26:33.000Z",
"createdAt": "2019-08-29T15:26:33.000Z"
}

Una vez se cree el registro del DTE, con el "_Id" del response, se adjuntan los archivos, tenemos dos endpoints que permiten realizar la carga de archivos en  pdf o base64:

• El endpoint Upload file to electronic billing document  permite la carga del archivo PDF desde local.
• El endpoint Upload file to electronic billing document base64  permite la carga del archivo Base64.

La carga de los DTE desde Multivende a los canales de venta se tiene habilitado para:

• Mercado Libre
• Paris
• Ripley
• Falabella
• Coppel
• Walmart (Habilitado sólo para México)
• VTEX

A continuación te detallamos algunas consideraciones a tener en cuenta en la carga de los documentos tributarios para los siguientes canales de ventas: 

Consideraciones para VTEX

• En el caso de VTEX se envía el documento tributario al canal, solo cuando esta cargado el PDF y luego se marca la orden como enviada.

Consideraciones para Falabella

• La creación del registro del DTE y posterior subida solo es permitida cuando la orden se encuentra en los siguientes estados:
  • "ready_to_ship",
  • "delivered",
  • "shipped".

De lo contrario el documento quedará con error de sincronización.

• A partir del 28 de febrero de 2025, Falabella solo admite la carga del documento tributario en formato PDF, por lo que para este canal debes realizar la subida del documento en este formato.

Consideraciones para Walmart México

• Deben esperar a que la orden tenga la información de facturación dentro del campo"billingClient" para poder realizar la generación del DTE, ya que, un cliente puede solicitar factura dentro de los 30 días próximos a la venta; es en ese entonces cuando deben realizar la generación del documento correspondiente.
• En el caso de Walmart debes realizar previamente la configuración de Apolo en Multivende, en este artículo encontrarás los pasos a seguir.

Subir documentos electrónicos a los despachos

Primero se tiene que crear el registro en Multivende del DTE usando el siguiente endpoint Create delivery order electronic billing document 

Para lo que se requiere conocer:

• Delivery_order_id (Id del despacho).
• ClientId (se obtiene del detalle de la venta).
• id (número de folio).
• Fecha de emisión.
• type (se detalla más adelante).
• provider (se detalla más adelante).
• ElectronicBillingDocumentEmitterId (se detalla más adelante).

curl --location -g '{{base_url}}/api/delivery-orders/{{delivery_order_id}}/electronic-billing-documents' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
"ClientId": "{{client_id}}",
"id": "XXXXXXX",
"emissionDate":"2019-03-01",
"type":"electronic_billing_electronic_bill",
"provider":"test_provider_code",
"ElectronicBillingDocumentEmitterId":"{{electronic_billing_document_emitter_id}}"
}'

Response:

{
"_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"status": "created",
"ClientId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"id": "8877777",
"emissionDate": "2019-03-01T00:00:00.000Z",
"ElectronicBillingDocumentEmitterId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"CreatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"UpdatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"MerchantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ElectronicBillingDocumentTypeId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ElectronicBillingDocumentProviderId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"DeliveryOrderId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"updatedAt": "2019-08-29T15:27:24.000Z",
"createdAt": "2019-08-29T15:27:24.000Z"
}

Una vez se cree el registro del DTE, con el _id del response, se adjunta como tal los archivos (.pdf, .zip, entre otros) por medio del endpoint Upload file to electronic billing document.

Códigos de tipos (type) permitidos para los DTEs

• electronic_billing_electronic_invoice (Factura Electrónica)
• electronic_billing_not_taxed_electronic_invoice (Factura Electrónica Exenta)
• electronic_billing_electronic_bill (Boleta Electrónica)
• electronic_billing_not_taxed_electronic_bill (Boleta Electrónica Exenta)
• electronic_billing_not_taxed_debit_note
• electronic_billing_not_taxed_credit_node

Para los Providers (proveedor)

Esta información se tiene que canalizar vía correo api@multivende.com solicitando un código de proveedor según el proveedor (generador de boletas) que estén usando. Enviando la siguiente información:

• Sistema DTE.
• Empresa desarrolladora de la integración.
• Merchant ID.

Multivende genera el código y lo informa de vuelta en el correo de la solitud.

Para los Emisores de documentos (ElectronicBillingDocumentEmitterId)

Puedes seguir los pasos del siguiente artículo ¿Cómo crear un emisor de documentos?.  En caso de cualquier duda comunicarse con onboarding@multivende.com , ellos lo asistirán en la generación de este identificador.

Si deseas realizar este proceso via API, puedes crear el emisor de documentos mediante el endpoint Create electronic billing document emitter enviando los siguientes campos:

{
  "name": "nombre asociado al emisor de documentos",
  "code":"código",
  "taxId":"RUT/NIT",
  "taxName":"razón social"
}

*Rellena el campo código con 01111

En la respuesta del endpoint puedes identificar el _id asociado al emisor del documento electrónico, este proceso se realiza sólo una vez y el emisor de documento electrónico queda asociado a la cuenta del merchant.

Response:

{
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"status": "created",
"name": "Test emitter",
"code": "01010",
"taxId": "76449667-3",
"taxName": "Test emitter SPA",
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"updatedAt": "2019-08-28T19:58:12.000Z",
"createdAt": "2019-08-28T19:58:12.000Z"
}

Puedes consultar el _id del emisor de documento asociado a la cuenta de un merchant mediante el endpoint: Get electronic billing document emitters

Consulta de documentos electrónicos

Para consultar los documentos electrónicos de una orden puedes consultar al siguiente endpoint Get electronic billing documents of a checkout

Consideraciones para tipos de envío Fulfillment

Si se trata de una orden de tipo Fulfillment, recuerda que para verificar el tipo de envío debes consultar el campo "shippingMode".

shippingMode: fulfillment

• Paris: 

  • El seller debe solicitar la configuración de Fulfillment a Paris, y el canal se encarga de emitir la boleta.

• Mercadolibre:
  • Argentina, Colombia y México, el vendedor puede generar la factura.
  • Brasil y Chile, Mercado Libre siempre genera la factura.
• Falabella
  • Falabella se encarga de la emisión de la boleta.
• Ripley
  • Para registrar tus ventas de Fulfillment by Ripley desde Multivende, es necesario que tengas una cuenta nueva creada en Ripley. Asegúrate de tener este requisito cumplido antes de solicitar la integración. La boleta es generada por el marketplace para estas ventas.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

En este artículo mostramos como obtener la información del pago realizado por el comprador en la venta.

Esta información la obtenemos mediante los siguiente Endpoint que tenemos disponible dentro de nuestro Servicios de Integración de Multivende.

Obtener la información del pago de una venta

• Get checkout: Adicional a obtener los detalles de una venta, tales como datos del cliente y facturación puedes encontrar los detalles del pago consultando el campo "CheckoutPayments" aquí podrás visualizar los métodos de pago utilizados en la venta.

Ejemplo Response:

"CheckoutPayments": [
      {
        "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "code": "xxxxxxxxxxx",
        "amount": 59600,
        "amountPaid": 59600,
        "change": 0,
        "paymentStatus": "completed",
        "authorizationCode": null,
        "detail": null,
        "status": "created",
        "verificationStatus": "verified",
        "cardNumber": null,
        "installments": 1,
        "datePaid": null,
        "dateVerificated": null,
        "createdAt": "2021-05-10T18:31:28.000Z",
        "updatedAt": "2021-05-10T18:51:23.000Z",
        "CreatedById": null,
        "UpdatedById": null,
        "CheckoutId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "PaymentMethodId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "CurrencyId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "PaymentMethod": {
          "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
          "tags": "{\n   \"requiresTransaction\": false\n }",
          "code": "_payment_methods_online_payment",
          "name": "PAYMENT_METHODS.Online_payment.Name",
          "description": "PAYMENT_METHODS.Online_payment.Description",
          "position": 12,
          "status": "created",
          "createdAt": null,
          "updatedAt": null,
          "codeTranslated": "Pago en línea"
        },
        "CheckoutPaymentLinks": [
          {
            "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
            "externalId": "xxxxxxxxxxx",
            "transactionId": "xxxxxxxxxxx",
            "externalContent": "",
            "synchronizationStatus": "synchronized",
            "status": "created",
            "createdAt": "2021-05-10T18:31:28.000Z",
            "updatedAt": "2021-05-10T18:31:28.000Z",
            "CreatedById": null,
            "UpdatedById": null,
            "MarketplaceConnectionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
            "MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
            "CheckoutPaymentId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
          }
        ]
      }
    ]

Métodos de Pago

• Get checkout payment methods: Se detallan los métodos de pago asociados a la cuenta del Merchant, enviando dentro del Request el MerchantId se listará el ID del método de pago, nombre, descripción, entre otros. Los cuales son estándar para todos los merchants de Multivende y puedes dejarlos preconfigurados al realizar la integración para homologarlos con los de la aplicación.

Ejemplo Response

[
  {
    "_id": "a4135228-a10c-11e6-bfdf-2c56dc130c0d",
    "tags": "{\n  \"requiresTransaction\": false\n}",
    "code": "_payment_methods_cash",
    "name": "PAYMENT_METHODS.Cash.Name",
    "description": "PAYMENT_METHODS.Cash.Description",
    "position": 0,
    "status": "created",
    "createdAt": null,
    "updatedAt": null
  },
  {
    "_id": "0f5b5e2f-a10d-11e6-bfdf-2c56dc130c0d",
    "tags": "{\n  \"requiresTransaction\": true\n}",
    "code": "_payment_methods_credit_card",
    "name": "PAYMENT_METHODS.Credit_card.Name",
    "description": "PAYMENT_METHODS.Credit_card.Description",
    "position": 1,
    "status": "created",
    "createdAt": null,
    "updatedAt": null
  },
  {
    "_id": "a41369d7-a10c-11e6-bfdf-2c56dc130c0d",
    "tags": "{\n  \"requiresTransaction\": true\n}",
    "code": "_payment_methods_debit_card",
    "name": "PAYMENT_METHODS.Debit_card.Name",
    "description": "PAYMENT_METHODS.Debit_card.Description",
    "position": 2,
    "status": "created",
    "createdAt": null,
    "updatedAt": null
  },
 ]

Actualizar información del pago de una venta

• Update checkout payment: Te permite actualizar los detalles de un pago, no es obligatorio enviar todos los campos del cuerpo. Solo se deben enviar aquellos que necesitan ser actualizados.

Los valores permitidos para enviar dentro del campo “verificationStatus” es "verified" o "pending"

Nota: esta funcionalidad sólo es permitida para las integraciones que son de tipo Canal de venta, las cuales pueden notificar los estados de los pagos hacia Multivende. 

Ejemplo Request:

curl --location -g --request PUT '{{base_url}}/api/checkout-payments/{{checkout_payment_id}}' \
--header 'Authorization: Bearer {{access_token}}' \
--data '{
    "verificationStatus": "pending",
    "authorizationCode": 12345,
    "detail": "detail",
    "cardNumber": 1234567,
    "installments": 12
}'

Ejemplo Response

{
  "_id": "d14833f3-f8c0-4287-a7ba-ee375fabfc2b",
  "code": "14514653588",
  "amount": 4990,
  "amountPaid": 4990,
  "change": 0,
  "paymentStatus": "completed",
  "authorizationCode": 12345,
  "detail": "detail",
  "status": "created",
  "verificationStatus": "pending",
  "cardNumber": 1234567,
  "installments": 12,
  "datePaid": null,
  "dateVerificated": null,
  "createdAt": "2021-04-19T16:44:58.000Z",
  "updatedAt": "2021-11-10T19:23:07.000Z",
  "CreatedById": null,
  "UpdatedById": "644e493e-b3fa-4639-946e-7b47b90ad6f6",
  "CheckoutId": "60a813c9-a16f-4215-949f-d64fda865f24",
  "PaymentMethodId": "7a2f09c3-f7a2-11e7-96a2-2c56dc130c0d",
  "PaymentGatewayId": null,
  "CurrencyId": "5e402b2b-bb2e-46fd-9bda-8dd9f62d3a31",
  "MerchantId": "156bd2c4-13b9-46c0-9e91-349ec8cfeab8"
}

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Luego de completar la configuración de la relación entre las plataformas y publicado los productos, se podrán registrar nuevas órdenes vía API si cuenta con los permisos necesarios para administrar las ventas de la conexión realizada.

{
"deliveryStatus": "cancelled",
"paymentStatus": "cancelled",
"verificationStatus": "verified"
}

• Grupos de atributos personalizados para las ventas:  A través de la API de Multivende puedes crear, editar o consultar estos grupos de atributos personalizados.

  • Consultar grupos de atributos: mediante el endpoint de Get Custom Attribute Sets puedes realizar la consulta de los grupos de atributos personalizados de ventas asociados a una cuenta de merchant.
  • Crear un grupo de atributos: puedes crear un grupo de atributos via API mediante el endpoint Post Custom Attribute Sets  
  • Editar un grupo de atributos: la actualización de un grupo de atributos se hace por medio del endpoint Put Custom Attribute Sets 

• Atributos personalizados para las ventas: los atributos se crean dentro un grupo. A través de la API de Multivende puedes crear, editar o consultar estos atributos personalizados.

  • Consultar atributos: mediante el endpoint de Get Checkouts Custom Attributes puedes realizar la consulta de atributos personalizados de una venta para que puedas registrarlos o leerlos mediante tu integración.
  • Crear un atributo: puedes crear un atributo dentro de un grupo de atributos via API mediante el endpoint Post Chekouts Custom Attributes   
  • Actualizar un atributo: puedes actualizar la información de un atributo personalizado de la venta a través del endpoint Put Checkout Custom Attributes

En este artículo, mostramos cómo realizar la creación de productos desde tu sistema hacia Multivende mediante nuestra API.

Para comenzar, te dejamos los Endpoints disponibles para una correcta creación de un producto desde nuestra API.

• Get products with scroll: Obtener todos los productos de un Merchant.
• Products: Obtener los registros de las marcas, tallas, colores u otros se debe consultar según sea el caso en la carpeta correspondiente.
• Create product: Crear productos asociado a un merchant.
• Update product: Permite actualizar la información del producto.
• Atributos custom: Atributos personalizados que pueden asignar al producto.
  • Te recomendar leer el siguiente artículo en donde abordamos esto con mayor detalle.

• Creación de un producto con información básica

A través de nuestra API podemos realizar la creación de un producto para ello disponemos del Endpoint Create product *, esto nos permite crear un producto a un Merchant.

Te dejamos un ejemplo para la creación de un producto enviando información básica dentro del cuerpo del mensaje, cabe destacar que debes ponerle un Nombre y configurar el SKU padre e hijo.

{
"name": "Nombre del producto",
"code": "SKU Padre",
"InventoryTypeId": "791a6654-c5f2-11e6-aad6-2c56dc130c0d",
"InternalCodeTypeId": null,
"ProductVersions": [
    {
        "status": "waiting-for-creation", (Status enviado por defecto)
        "code": "SKU Hijo",
        "isDefaultVersion": true,
        "InventoryTypeId": "791a6654-c5f2-11e6-aad6-2c56dc130c0d",
        "InternalCodeTypeId": null,
        "position": 0
    }
]
}

Tener en consideración utilizar siempre el campo “InventoryTypeId” seteado de la siguiente manera  = "791a6654-c5f2-11e6-aad6-2c56dc130c0d".

Una vez enviado el endpoint la API no retornará 201, indicando la creación de nuestro producto de forma exitosa, un ejemplo del response es el siguiente:

{
    "_id": "XXX33b34-XXXX-XXXX-85e2-5b55a0aXXXXXX",
    "status": "created",
    "name": "Nombre del producto",
    "InternalCodeTypeId": null,
    "code": "SKU Padre",
    "CreatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXXX",
    "UpdatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXX",
    "MerchantId": "bf03e4e6-53a0-4082-9476-XXXXXXXXXXX",
    "updatedAt": "2023-00-00T00:00:00.000Z", (Fecha y hora en formato UTC)
    "createdAt": "2023-00-00T00:00:00.000Z",
    "ProductTypeId": "0f381d1c-3408-11e7-8e63-XXXXXXXXXXXX",
    "ProductVersions": [
        {
            "_id": "d775b3d8-a19a-4069-8cdd-XXXXXXXXXXXX",
            "code": "SKU Hijo",
            "internalCode": null,
            "providerCode": null,
            "position": 0,
            "width": 0,
            "length": 0,
            "height": 0,
            "weight": 0,
            "status": "created",
            "createdAt": "2023-00-00T00:00:00.000Z",
            "updatedAt": "2023-00-00T00:00:00.000Z",
            "CodeTypeId": null,
            "InternalCodeTypeId": null,
            "ColorId": "4ecf5004-f721-46bf-a38a-75807491a4cb",
            "SizeId": "226a61dc-1eef-41cf-af5e-cc6aea7c75b4",
            "CreatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXXX",
            "UpdatedById": "d561f14f-0800-4091-8d3f-XXXXXXXXXXXX",
            "InventoryTypeId": "791a6654-c5f2-11e6-aad6-XXXXXXXXXXXX",
            "ProductId": "30433b34-294f-40a6-85e2-XXXXXXXXXXXX",
            "MerchantId": "bf03e4e6-53a0-4082-9476-XXXXXXXXXXXX"
        }
    ]
}

Tener en consideración la lectura de los siguientes artículos, dado que una vez creado este producto puedes realizar la carga del Stock y el Precio.

• ¿Cómo cargar stock vía API?: Mostramos cómo realizar las carga de stock de tus productos mediante la API de Multivende.
• Actualización de Precios: Te indicamos cómo realizar una actualización de precio para tus productos.

• Crear un producto con información completa.

Del mismo modo utilizando el Endpoint Create product * podemos crear un producto pero enviando información completa de este, ya sea color, talla, marca, etc.

Antes de comenzar a crear un producto al detalle lo primero que debes realizar es lo siguiente:

1.- Mapeo de los atributos de los productos como:

1. Categoría.
2. Color.
3. Talla.
4. Marca.
5. Temporada.
6. Clases de envío.
7. Descripción.
8. Atributos custom. 
9. 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.

2.- 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 deberá poder mapear los álbumes de la aplicación con los álbumes de Multivende).

• Configuración imágenes de producto: Contiene los Endpoint para realizar actualizaciones de posiciones de imágenes, subir imágenes por ID o URL, cargar imágenes hacia la versión del producto.
• Get products picture set: Obtendrás los álbumes de imágenes de los productos del Merchant.
  • Get products pictures: Lista las imágenes de un producto del Merchant.

    • Si el campo "ProductPictureSetId" es "null", es el álbum predeterminado.

  • Get product versions pictures: Obtiene las imágenes de las versiones de un producto del Merchant

Puedes encontrar más detalles en el artículo dedicado a la Gestión de imágenes.

*El Merchant deberá poder seleccionar cuales son los productos que cargará desde la aplicación a Multivende.

Configuración de atributos

Puedes encontrar el detalle de los Endpoint en la propia documentación de la API, no obstante te dejamos los que podrían ser los más relevantes:

• Marcas:

  • Get Brands: Podrás obtener las marcas asociadas al Merchant.
    • Get Brands by Id: Te permite buscar una marca especifica enviando el "_id" dentro del request.
  • Post Brands: Puedes crear una marca desde la integración la cual quedará asociada al Merchant.
  • Update Brands: Te permite actualizar el nombre o la descripción de la marca.

• Clases de envío:

  • Get shipping classes: Podrás obtener las clases de envío asociadas al Merchant.

    • Get shipping classes by Id: Te permite buscar una clase envío especifica enviando el "_id" dentro del request.

  • Post shipping classes: Puedes crear una clase de envío desde la integración la cual quedará asociada al Merchant.

• Colores:

  • Get Colors:  Podrás obtener los colores asociados al Merchant.  
    • Get Colors by Id: Te permite buscar un color especifico enviando el "_id" dentro del request.
  • Post Colors: Puedes crear un color el cual quedará asociado al Merchant.
  • Update Colors: Te permite actualizar el nombre del color.

• Tallas:

  • Get Sizes: Podrás buscar las tallas asociadas al Merchant. 
    • Get Size by Id: Te permite buscar una talla especifica enviando el "_id" dentro del request.
  • Post Sizes: Puedes crear un talla la cual quedará asociada al Merchant.
  • Update Sizes: Te permite actualizar el nombre y la descripción de la talla.

• Temporadas:

  • Get Seasons: Podrás obtener las temporadas asociadas al Merchant.  
    • Get Seasons by Id: Te permite buscar una temporada especifica enviando el "_id" dentro del request.
  • Post Seasons: Puedes crear una temporada la cual quedará asociada al Merchant.
  • Update Seasons: Te permite actualizar el nombre de la temporada.

• Categorías:

  • Get Product Categories: Podrás obtener las categorías de los productos asociadas al Merchant.

    • Get Product Categories by Id: Te permite buscar una categoría de un producto enviando el "_id" dentro del request.
  • Post Product Categories: Puedes crear una categoría la cual quedará asociada al Merchant.
  • Update Categories: Te permite actualizar el nombre y la descripción de la categoría.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

En este artículo, mostramos cómo actualizar un producto desde tu sistema hacia Multivende mediante nuestra API.

Para comenzar, te dejamos los Endpoints disponibles para una correcta actualización de un producto desde nuestra API.

• Get products with scroll: Obtener todos los productos de un Merchant.
• Products: Obtener los registros de las marcas, tallas, colores u otros se debe consultar según sea el caso en la carpeta correspondiente.
• Create product: Crear productos asociado a un merchant.
• Atributos custom: Atributos personalizados que pueden asignar al producto.

A través de nuestra API podemos realizar la actualización de un producto para ello disponemos del Endpoint Update Product.

Dentro del "Body" podrás enviar los parámetros que deseas modificar, como por ejemplo "name", "alias" o un "CustomAttributeValues".

Te dejamos un ejemplo para la actualización de un producto enviando información básica dentro del cuerpo del mensaje.

{
  "name":"TEST Guantes Nike Extreme Lightweight Fitness Para Hombre",
  "alias":"",
  "BrandId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "model":"",
  "SeasonId":null,
  "description":null,
  "ProductVersions":[
{
  "_id":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "code":"NLGC4937_L",
  "SizeId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "ColorId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "status":"created", 
  "internalCode":"",
  "CodeTypeId":null,
  "InternalCodeTypeId":null,
  "position":0,
  "width":0,
  "length":0,
  "height":0,
  "weight":0,
  "Size":{
  "_id":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "name":"L"
},
  "CodeType":{
  "_id":null,
  "name":null,
  "code":null,
  "description":null,
  "position":null,
  "tags":null,
  "status":null,
  "createdAt":null,
  "updatedAt":null
},
  "InternalCodeType":{
   "_id":null,
   "name":null,
   "code":null,
   "description":null,
   "position":null,
   "tags":null,
   "status":null,
   "createdAt":null,
   "updatedAt":null
},
 "Color":{
  "_id":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
  "name":"Negro"
},
  "InventoryType":{
   "_id":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
   "name":"INVENTORY_TYPES.Normal.Name",
   "code":"_normal_inventory_type",
   "description":"INVENTORY_TYPES.Normal.Description",
   "position":0,
   "tags":"NULL",
   "status":"created",
   "createdAt":null,
   "updatedAt":null
},
  "ProductVersionPictures":[
   null
],
 "CustomAttributeValues":{
   "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX":"L"
},
 "allImages":[

],
 "InventoryTypeId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
}
],
   "ProductCategoryId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
   "code":"NLGC4937",
   "internalCode":"",
   "CodeTypeId":null,
   "shortDescription":"",
   "htmlDescription":"",
   "htmlShortDescription":"",
   "tags":[

],
   "WarrantyId":null,
   "ShippingClassId":null,
   "CustomAttributeValues":{
   "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
   "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX":"negro",
   "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX":"xNLGC4937",
   "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
},
   "OfficialStoreId":null,
   "InventoryTypeId":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
   "InternalCodeTypeId":null
}

Importante:

• Recordar que siempre el campo “InventoryTypeId” debe ir establecido de la siguiente manera:

"InventoryTypeId": "791a6654-c5f2-11e6-aad6-2c56dc130c0d"

• Dentro del body puede enviar únicamente los parámetros que deseas actualizar, el resto, puedes omitirlos o no enviarlos en la solicitud.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

En este artículo te mostramos cómo consultar el stock de tus productos mediante la API de Multivende.

La consulta de stock se realiza a productos asociados a una bodega en Multivende. Para consultar las bodegas que se encuentran creadas en una cuenta de merchant, lo puedes hacer mediante el endpoint: Get stores and warehouses.

Request:

curl --location -g '{{base_url}}/api/m/{{merchant_id}}/stores-and-warehouses/p/{{page}}' \
--header 'Authorization: Bearer {{access_token}}'

Response:

{
"entries": [
{
"_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Mi Tienda (Personaliza el nombre)",
"code": null,
"address": null,
"description": null,
"type": "store",
"phoneAreaCode": null,
"phoneNumber": null,
"latitude": 0,
"longitude": 0,
"openHours": null,
"tags": null,
"position": 0,
"status": "created",
"createdAt": "2018-05-24T00:19:31.000Z",
"updatedAt": "2018-05-24T00:19:31.000Z",
"CreatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"UpdatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"LocationId": null,
"TimezoneId": null,
"MerchantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"SalesGroupId": null
},
{
"_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Bodega (Personaliza el nombre)",
"code": null,
"address": null,
"description": null,
"type": "warehouse",
"phoneAreaCode": null,
"phoneNumber": null,
"latitude": 0,
"longitude": 0,
"openHours": null,
"tags": null,
"position": 1,
"status": "created",
"createdAt": "2018-05-24T00:19:31.000Z",
"updatedAt": "2018-05-24T00:19:31.000Z",
"CreatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"UpdatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"LocationId": null,
"TimezoneId": null,
"MerchantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"SalesGroupId": null
}
],
"pagination": {
"offset": 0,
"limit": 50,
"total_pages": 1,
"current_page": 1,
"next_page": 0,
"previous_page": 0,
"total_items": 2
}
}

Consultar stock de productos

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).

Consultar el histórico de movimientos de stock de un producto en una bodega

El historial de stock en bodega, puede ser consultado a través del endpoint Get stock history
este retorna todo el movimiento de stock del producto.

Podrás visualizar la información que se ve en la vista Movimiento de inventario desde la plataforma de Multivende.

Ejemplo response:

{
"entries": [
{
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"date": "2019-03-07T18:14:15.000Z",
"amount": 76,
"unitCost": 0,
"type": "INCREASE",
"comment": null,
"status": "created",
"createdAt": "2019-03-07T18:14:15.000Z",
"updatedAt": "2019-03-07T18:14:15.000Z",
"CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"CostCurrencyId": null,
"OriginProviderId": null,
"ProductRelocationCategoryId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"OriginWarehouseId": null,
"DestinationWarehouseId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ProductVersionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ProductStockBatchId": null,
"ProductRelocationCategory": {
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"name": "PRODUCT_RELOCATION_CATEGORIES.Product_reception.Name",
"certaintyLevel": "known",
"type": "increase",
"code": "_product_reception",
"description": "PRODUCT_RELOCATION_CATEGORIES.Product_reception.Description",
"position": 0,
"tags": "{ \"use_type\": \"external\"}",
"status": "created",
"createdAt": null,
"updatedAt": null
},
"CreatedBy": {
"profile": {
"name": "developers",
"fullName": "developers"
},
"token": {
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
},
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"name": "developers",
"email": "developers-test@multivende.com"
},
"OriginWarehouse": null,
"DestinationWarehouse": {
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"name": "Bodega (Personaliza el nombre)",
"code": null,
"address": null,
"description": null,
"type": "warehouse",
"phoneAreaCode": null,
"phoneNumber": null,
"latitude": 0,
"longitude": 0,
"openHours": null,
"tags": null,
"position": 1,
"status": "created",
"createdAt": "2019-01-30T17:18:46.000Z",
"updatedAt": "2019-01-30T17:18:46.000Z",
"CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"LocationId": null,
"TimezoneId": null,
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"SalesGroupId": null
}
},
{
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"date": "2019-03-07T18:04:49.000Z",
"amount": 14,
"unitCost": 0,
"type": "INCREASE",
"comment": null,
"status": "created",
"createdAt": "2019-03-07T18:04:49.000Z",
"updatedAt": "2019-03-07T18:04:49.000Z",
"CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"CostCurrencyId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"OriginProviderId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ProductRelocationCategoryId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"OriginWarehouseId": null,
"DestinationWarehouseId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ProductVersionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"ProductStockBatchId": null,
"ProductRelocationCategory": {
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"name": "PRODUCT_RELOCATION_CATEGORIES.Product_reception.Name",
"certaintyLevel": "known",
"type": "increase",
"code": "_product_reception",
"description": "PRODUCT_RELOCATION_CATEGORIES.Product_reception.Description",
"position": 0,
"tags": "{ \"use_type\": \"external\"}",
"status": "created",
"createdAt": null,
"updatedAt": null
},
"CreatedBy": {
"profile": {
"name": "developers",
"fullName": "developers"
},
"token": {
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
},
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"name": "developers",
"email": "developers-test@multivende.com"
},
"OriginWarehouse": null,
"DestinationWarehouse": {
"_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"name": "Bodega (Personaliza el nombre)",
"code": null,
"address": null,
"description": null,
"type": "warehouse",
"phoneAreaCode": null,
"phoneNumber": null,
"latitude": 0,
"longitude": 0,
"openHours": null,
"tags": null,
"position": 1,
"status": "created",
"createdAt": "2019-01-30T17:18:46.000Z",
"updatedAt": "2019-01-30T17:18:46.000Z",
"CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"LocationId": null,
"TimezoneId": null,
"MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
"SalesGroupId": null
}
}
],
"pagination": {
"offset": 0,
"limit": 50,
"total_pages": 1,
"current_page": 1,
"next_page": 0,
"previous_page": 0,
"total_items": 2
}
}

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

En este artículo, te mostramos cómo realizar las carga de stock de tus productos mediante la API de Multivende.

En este artículo te mostramos cómo consultar el precio de tus productos mediante la API de Multivende.

La consulta de precios se realiza a productos asociados a una lista de precios en Multivende.

Consultar precios de productos.

Para obtener el id de una lista de precios consultamos al endpoint Get price lists.

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).

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Un producto puede estar relacionado a más de una lista de precios, por lo que la actualización del precio de un producto se realiza por cada una de las listas en la que se encuentre.

{
  "entries": [
 {
  "_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "Precios de lista",
  "isDefault": true,
  "code": null,
  "description": null,
  "position": 0,
  "status": "created",
  "createdAt": "2018-05-24T00:19:31.000Z", 
  "updatedAt": "2018-05-24T00:19:31.000Z",
  "CreatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "UpdatedById": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "CurrencyId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "MerchantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "Currency": {
  "_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "PlatformCurrency": {
  "_id": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "CURRENCIES.Chilean_peso.Name",
  "symbol": "$",
  "code": "CLP",
  "decimalPlaces": 0
  }
 }
}
],
"pagination": {
  "offset": 0,
  "limit": 50,
  "total_pages": 1,
  "current_page": 1,
  "next_page": 0,
  "previous_page": 0,
  "total_items": 1
 }
}

https://app.multivende.com/api/product-price-lists/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/product-versions/{{sku_child}}/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ' \
--header 'Cookie: route=XXXXXXXXXX.XXX.XX.XXXXXX|0bbbab1f8d05XXXXXXXXXXXXXXXXXXX' \
--data 
{ 
  "net": 119900, 
  "tax": 19, 
  "gross": 120000, 
  "priceWithDiscount": 150000 
}

{
  "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "net": 100840.336134454,
  "tax": 21,
  "gross": 120000,
  "priceWithDiscount": 150000,
  "status": "created",
  "createdAt": "2019-10-14T13:50:19.000Z",
  "updatedAt": "2019-10-24T20:01:25.000Z",
  "CreatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "UpdatedById": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "ProductPriceListId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "ProductVersionId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "CurrencyId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
  "MerchantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "Currency": {
    "_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
    "PlatformCurrency": {
    "_id": "a3e8e8ec-62d5-11e6-9651-70928b05753b",
    "name": "CURRENCIES.Chilean_peso.Name",
    "symbol": "$",
    "code": "CLP",
    "decimalPlaces": 0
   }
  }
}

Los cambios de estados lo puedes realizar mediante tu integración vía API, no obstante debes tener en consideración lo que te explicamos a continuación. 

Puedes obtener el campo _id del endpoint Get checkout dentro del arreglo de DeliveryOrder, el cual es necesario para actualizar el estado de la entrega.

La actualización del estado se debe realizar según el tipo de entrega.

Despachos

Los siguientes datos pueden actualizarse por el endpoint Update delivery order status:

• "DeliveryOrderStatusId” = actualizar el estado del despacho según el _id correspondiente del endpoint Get Delivery Order Status
• "comment" = un comentario al despacho
• Para actualizar el número y url de tracking debes usar el endpoint Update delivery order
  • Los canales que permiten actualizar el número de tracking son los siguientes:
    • Mercadolibre (Esto aplica para envíos ME1, custom y not_specified).
    • Vtex (Aplica tanto para ordenes tipo "despacho" como "retiro en tienda").
    • Dafiti (Aplica para la modalidad "Dropshipping").
    • Amazon (Aplica para ventas de tipo Fulfillment - Channel == 'MFN').
    • Liverpool.

Tener en consideración que al enviar el cambio de estado a "Listo para envío" verificar posteriormente que este se haya sincronizado de forma correcta, esto lo pueden hacer consultando el Endpoint Get Delivery Order, el campo "DeliveryOrderStatusLink" verificando dentro de  "synchronizationStatus" el cual puede contener los siguientes estados:

Consideraciones Importantes:

• Si al pasar 10 minutos y se visualiza que no se ha realizado el cambio de estado, por favor enviar nuevamente la actualización de estado.
• Cuando se crea una tarea de cambio de estado, los campos del "DeliveryOrderStatusLink" serán informados en "null", cuando este cambio comience a ser procesado desde Multivende, el estado del campo "synchronizationStatus" informará uno de los 4 estados detallados en la tabla de arriba.

Los estados de las órdenes dependen del tipo de entrega que haya seleccionado el cliente, por lo que puede variar según esta condición.

Tipos de entrega para una orden

Para obtener los diferentes tipos de entrega que puede tener una orden se debe consultar el Endpoint Get delivery types. Actualmente contamos con dos tipos de entrega posibles, las cuales, en el response de la solicitud se obtiene el campo code, que puede tener los siguientes valores:

1. “_delivery_type_delivery” = Despacho (el producto se envía a una dirección dada por el comprador).
2. "_delivery_type_store_pickup" = Retiro (el producto lo retira el comprador en la dirección de la bodega asociada al stock del producto).
3. "_delivery_type_mix" = Mixto (La orden está compuesta por varios productos de los cuales tiene retiro en tienda y despacho)

Entregas con despacho

En el endpoint Get Checkout entregamos información general del despacho, pero si necesitas información adicional como los documentos o logs de cambio de estado, consulta el endpoint Get delivery order.

Para realizar la integración con los sistemas, se debe hacer un mapeo de los estados de las órdenes en Multivende y el sistema con el que se va a integrar. Para ello, se consulta al endpoint Get Delivery Order Status el cual retorna un array con todos los estados posibles de una orden en Multivende. 

Del response se deben guardar los campos _id y code, que deben ser mapeados con los estados del sistema.

A continuación, se detallan los posibles estados de las ventas en Multivende y su relación con los estados de las ventas en los canales.

• Multivende

• Multivende - Amazon
  • Relación de estados entre Multivende y Amazon

• Multivende - Linio, Dafiti, Falabella
  • Relación de estados entre Multivende y Linio, Dafiti, Falabella

• Multivende - Mercado Libre
  • Relación de estados entre Multivende y Mercado Libre

El estado solo se cambia en Mercadolibre para los pedidos que no son ME2 excepto el estado cancelado.

• Multivende - Paris
  • Relación de estados entre Multivende y Paris

• Multivende - Ripley
  • Relación de estados entre Multivende y Ripley

• Multivende - Walmart Chile
  • Relación de estados entre Multivende y Walmart Chile

• Multivende - Walmart México
  • Relación de estados entre Multivende y Walmart México 

• Multivende - Magento
  • Relación de estados entre Multivende y Magento

• Multivende - Shopify
  • Relación de estados entre Multivende y Shopify

• Multivende - VTEX
  • Relación de estados entre Multivende y VTEX

Consideraciones especiales para la información logística por canal de venta:

Cancelaciones parciales para el canal Paris:

Identificar los items cancelados: Para determinar qué artículo o artículos han sido cancelados en una orden de despacho, les instamos a buscar en el campo:

"checkoutLink" -> "externalContent" -> "subOrders "-> items al consultar la venta con Get checkout.

Dentro items, por cada uno de los items, en el campo “status” encontrarán la información detallada sobre la cancelación parcial en caso de que el ítem haya sido cancelado.

• Ejemplo:

"status": {
"id": 31,
"name": "stock_shortage_refunded",
"description": "Reembolsado por falta de stock en la db",
"translate": "Problema con stock",
"cancelable": false
}

Estas indicaciones solo aplican para el caso del marketplace Paris. 

Entrega con retiro en tienda

En el endpoint Get Checkout entregamos información general del retiro en tienda, pero si necesitas información adicional como los logs de cambio de estado, consulta el endpoint Get pickup order.

Los estados de retiro en tienda se pueden consultar mediante el endpoint de: GET pick up order statuses.

Actualizar el estado de una orden con retiro en tienda

Para actualizar el estado de una orden con retiro en tienda, lo hacemos mediante el endpoint:

PUT Update pick up order status. Enviando en el body los siguientes parámetros:

"PickUpOrderStatusId": "{{pick_up_order_status_pending_id}}"
"comment": "test comment",
"pickUpClosingComment": "test Pick Up Closing Comment",
"estimatedPickUpDateFrom": "2019-09-08 16:19:06",
"estimatedPickUpDateTo": "2019-09-10 09:19:06",
"effectivePickUpClosingDate": "2019-09-11 16:19:06"

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

La integración con nuestra API permite a los integradores acceder a información detallada sobre ventas, incluidas aquellas con cancelaciones parciales, específicamente para los canales de venta Paris y Mercadolibre. A continuación te compartimos la información de como puedes identificar estas transacciones:

Cancelaciones parciales para el canal Paris:

Identificar los items cancelados: Para determinar qué artículo o artículos han sido cancelados en una orden de despacho, les instamos a buscar en el campo:

"checkoutLink" -> "externalContent" -> "subOrders "-> items al consultar la venta con Get checkout.

Dentro items, por cada uno de los items, en el campo “status” encontrarán la información detallada sobre la cancelación parcial en caso de que el ítem haya sido cancelado.

Ejemplo:
"status": {
"id": 31,
"name": "stock_shortage_refunded",
"description": "Reembolsado por falta de stock en la db",
"translate": "Problema con stock",
"cancelable": false
}

Cancelaciones parciales para Mercadolibre:

Para Mercadolibre, al consultar el Get delivery order puedes validar el code del estatus del despacho en el DeliveryOrderStatus, en el caso de una cancelación parcial registra:

"code": "_delivery_order_status_partial_cancelled_"

"DeliveryOrderStatus": 
{
   "_id": "9fddd14d-8eda-46d8-867f-26ae43b3491f",
   "name": "DELIVERY_ORDER_STATUSES.Partial_cancelled.Name",
   "description": "DELIVERY_ORDER_STATUSES.Partial_cancelled.Description",
   "code": "_delivery_order_status_partial_cancelled_",
   "position": 10,
   "tags": null,
   "status": "created",
   "createdAt": "2023-02-21T00:00:00.000Z",
   "updatedAt": "2023-02-21T00:00:00.000Z"
}

Para el resto de los marketplaces aún no se registra información de cancelaciones parciales.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Cada canal de venta maneja diversos estados para los tipos de entrega, no obstante en Multivende poseemos esados normalizados dentro de la plataforma; estos los obtienes consultando el endpoint Get Delivery Order Status el cual retorna un array con los estados normalizados en Multivende. 

Del response se deben guardar los campos _id y code, que deben ser mapeados con los estados del sistema.

A continuación, se detallan la homologación de estados de las ventas en Multivende y su relación con los estados de las ventas en los canales.

Multivende

Paris

Shopify v2

Mercadolibre

Amazon

Vtex

Magento

Prestashop

Ripley

Fcom - Linio

Jumpseller

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Certificación ISO 27001: Sistema de Gestión de Seguridad de la Información

Multivende ha obtenido la certificación ISO 27001, la norma internacional que garantiza las mejores prácticas en gestión de la seguridad de la información. Esta certificación reconoce nuestro compromiso con la protección de los datos y la gestión de la seguridad en todos nuestros procesos.

La ISO 27001 se centra en identificar y gestionar los riesgos relacionados con la información, estableciendo un marco robusto para proteger la confidencialidad, integridad y disponibilidad de los datos. Con esta certificación, aseguramos que nuestros sistemas y procedimientos cumplen con los más altos estándares de seguridad, brindando confianza tanto a nuestros clientes como a nuestros socios comerciales.

Nuestro equipo trabaja continuamente para mantener estos estándares, implementando políticas y controles que garantizan la seguridad en cada etapa de nuestro trabajo.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

Todas las interacciones con la API de Multivende deben realizarse usando https.

echo | openssl s_client -showcerts -servername app.multivende.com -connect 
app.multivende.com:443 2>/dev/null | openssl x509 -inform pem -noout –text

Se entrega información sobre los rangos de IPs utilizados por Multivende.

Encriptación de datos:

• Es necesario encriptar el token y el refresh token utilizando un algoritmo de clave simétrica antes de almacenarlos en la base de datos.

Ventajas del uso de una IP estática a nivel de seguridad:

• Identificación confiable: Una IP estática te permite identificar de manera consistente a tu contraparte porque siempre tendrá la misma dirección IP. Esto puede facilitar la implementación de controles de acceso basados en IP (por ejemplo, listas blancas).
• Mayor control sobre la seguridad de la red: Como puedes predecir de dónde vendrán las peticiones, es posible configurar firewalls y reglas específicas para esa IP, lo que añade una capa adicional de seguridad.
• Riesgo de exposición: Si alguien malintencionado descubre esa IP estática, podría intentar atacarla directamente. Sin embargo, si la comunicación está protegida por HTTPS, el cifrado de la conexión protegerá los datos en tránsito.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

El Client ID y Client Secret de la aplicación son necesarios para realizar cualquier consulta vía 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.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

A continuación aprenderás a consultar los diferentes ID de los recursos desde 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.

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

El MarketplaceConnectionId es el identificador único de una conexión con un marketplace o canal de venta de la cuenta de un merchant en Multivende.

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

Si tienes dudas o necesitas asistencia, puedes escalar un ticket a través de este enlace y nuestro equipo estará encantado de ayudarte.

Equipo Integraciones API Multivende

En caso de que necesites asistencia con la integración de nuestra API, nuestro equipo de Integraciones vía API está disponible para brindarte el soporte que necesitas. A continuación, te explicamos cómo crear un ticket de manera rápida y sencilla para que puedas ponerte en contacto con ellos.

Paso 1: Accede a la Plataforma de Soporte

Lo primero que debes hacer es ingresar a la plataforma de soporte o al sistema de tickets de Multivende. Este acceso se encuentra en la sección de Soporte o Ayuda de nuestro sitio web o dentro de la misma aplicación.

• Desde la web: Dirígete a la página de soporte, encontrarás la opción "Enviar una solicitud"

• Desde la aplicación: Si estás trabajando en nuestra plataforma, busca la opción "Crear ticket de ayuda" en el menú principal.

Paso 2: Selecciona la Categoría Correcta

Una vez que hayas ingresado al sistema de soporte, deberás elegir la categoría adecuada para tu solicitud. En este caso, selecciona "Necesito crear un ticket de soporte para integraciones API" que te llevará directamente al formulario de tickets relacionado con este tema.

Paso 3: Completa el Formulario de Ticket

El siguiente paso es completar el formulario con los detalles de tu solicitud. Asegúrate de proporcionar la mayor cantidad de información posible para que el equipo de Integraciones pueda ayudarte de manera eficiente.

Los campos más comunes en el formulario incluyen:

• Correo electrónico: Escribe el correo en donde te enviaremos la confirmación de la creación de tu solicitud y en donde podrás realizar el seguimiento.
• Nombre y Apellido: De la persona que está creando la solicitud.
• Asunto del ticket: Escribe un resumen breve y claro de tu solicitud o problema.
• Nombre de la empresa: Nombre de la empresa que realiza la integración más el nombre del equipo integrador.
• Sistema que estás integrando: Indicados el sistema, ya sea ERP, OMS, etc...
• Descripción detallada: Explica detalladamente el problema que estás enfrentando, la duda que tienes o el tipo de asistencia que necesitas. Incluye cualquier error o mensaje que hayas recibido, así como el contexto de tu integración (por ejemplo, versión de la API, pasos que seguiste, etc.).
• Información adicional: Podrás adjuntar archivos como capturas de pantalla, logs de errores, ejemplos de código, etc. Estos detalles ayudarán al equipo a entender mejor el problema.

Paso 4: Enviar el Ticket

Una vez que hayas completado el formulario y revisado toda la información, haz clic en el botón de Enviar para crear el ticket. Esto enviará tu solicitud directamente al equipo de Integraciones vía API.

Paso 5: Espera la Confirmación y Respuesta

Después de enviar el ticket, recibirás un correo de confirmación con el número de seguimiento del ticket. El equipo de Integraciones comenzará a trabajar en tu solicitud y se pondrá en contacto contigo para proporcionarte una solución o más detalles si fuera necesario.

• Tiempo de respuesta: El tiempo de respuesta puede variar dependiendo de la complejidad de la solicitud, pero el equipo de Integraciones se compromete a responder lo antes posible.

Paso 6: Cerrar el Ticket

Una vez que se haya resuelto tu solicitud y estés satisfecho con la solución, se procederá a cerrar el ticket. Si en algún momento tienes más preguntas o problemas adicionales, puedes abrir un nuevo ticket en cualquier momento.

Consejos para Crear un Ticket Eficaz

• Sé claro y preciso: Cuanto más detallada sea la información que proporciones, más fácil será para el equipo de Integraciones ayudarte.
• Incluye ejemplos y código: Si estás enfrentando un problema técnico, incluir fragmentos de código, logs o capturas de pantalla puede ayudar a que se resuelva más rápidamente.
• Prioriza la solicitud: Si el problema es urgente, asegúrate de marcarlo con la prioridad más alta para que el equipo pueda darle atención inmediata.

Equipo de integraciones API Multivende.