Logística

Aprende sobre el proceso de integración de los estados de las órdenes, modos logísticos y generación de etiquetas vía API.

Modalidades y operadores logísticos de los despachos

Conoce las modalidades y operadores logísticos de los despachos que puedes gestionar a través de Multivende.

Modalidades logísticas

Podrás conseguir la información de las modalidades logísticas de tus despachos en los endpoints:

Get checkouts light: Permite realizar el sondeo de las órdenes desde Multivende hacia tu integración.
Get checkout: Ente endpoint te permite consultar el detalle de una orden.
Get delivery order: Este Endpoint te permite consultar el detalle de un despacho asociado a una orden.

Delivery Order

En el detalle del DeliveryOrders:

"shippingMode": Informa el modo de envío según lo que indica el canal de venta.
"courierName": Informa el nombre del courier que realizará el despacho según lo que indica el canal de venta.

Checkout

En el detalle del Checkout:

"shippingMode": Informa el modo de envío según lo que indica el canal de venta. En los casos donde hay más de un DeliveryOrder con diferentes ShippingMode, el campo indicará "multiple".
"courierName": Informa el nombre del courier que realizará el despacho según lo que indica el canal de venta. En los casos donde hay más de un DeliveryOrder con diferentes courierName, el campo indicará "múltiple".
"isMultiwarehouse": Informa si el punto de retiro del pedido para el despacho es más de uno.

Shipping Mode

En el "shippingMode" encontrarás las opciones propias de cada canal de venta, según la información que nos proporcione el canal vía API. (me1, me2, fulfillment, Dropshipping).

Ejemplo:

 "shippingMode": "fulfillment",

courierName

En el “courierName” las opciones disponibles y denominación de los operadores logísticos podrán variar de acuerdo a la configuración propia del canal para identificar a cada uno (El courier Blue Express podrás encontrarlo con los valores: Blue Express, BLX, entre otros).

Ejemplo:

"courierName": "BLUEXPRESS",

Modalidades logísticas de los marketplaces

Mercadolibre

Mercado Envíos (drop_off)	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.
Mercado Envíos Places (xd_drop_off)	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado o en los puntos autorizados de Mercado Libre.
Mercado Envíos Colecta (cross_docking)	El vendedor prepara el pedido en su bodega, imprime la etiqueta y la flota propia de Mercado Libre lo retira y entrega al cliente final.
Mercado Envíos Full (fulfillment)	El vendedor envía stock a la bodega de Mercado Libre y el marketplace se encarga de almacenar los productos y realizar todo el proceso de preparación, generación de etiquetas y entrega al cliente final. No se genera etiqueta El seller debe generar la boleta para Colombia.
Mercado Envíos Flex (self_service):	El vendedor prepara el pedido en su bodega, imprime la etiqueta con código QR y despacha a través del courier de su preferencia o con su flota propia. *Las etiquetas deben ser escaneadas por el operador logístico con la app móvil de Mercado Envíos Flex para el control y seguimiento de los paquetes.
Acordar con el vendedor (custom)	El vendedor prepara el pedido en su bodega y despacha según lo acordado con el comprador. No imprime la etiqueta Debe actualizar el estado de envío a Mercado Libre.
ME1 (default)	El vendedor prepara el pedido en su bodega y despacha con su flota propia o a través del courier de su preferencia. No imprime la etiqueta. Debe actualizar el estado de envío, URL y número de tracking a Mercado Libre.
own logistic	Despacho por cuenta propia del vendedor

Linio

Dropshipping

El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.

Dafiti

Dropshipping	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.
Cross docking	El vendedor prepara el pedido en su bodega, imprime la etiqueta y la flota propia de Dafiti lo retira y entrega al cliente final.

Ripley

Dropshipping	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.
Cross docking	El vendedor prepara el pedido en su bodega, imprime la etiqueta y la flota propia de Ripley lo retira y entrega al cliente final.
Despacho propio	El vendedor prepara el pedido en su bodega y despacha a través de su flota propia.
Fulfillment	El vendedor envía stock a la bodega de Mercado Ripley y el marketplace se encarga de almacenar los productos y realizar todo el proceso de preparación, generación de etiquetas y entrega al cliente final.

Paris

Dropshipping (scheduled)	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.
Same Day	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha con su flota propia o a través del courier de su preferencia en el mismo día.
Fulfillment	El vendedor envía stock a la bodega de Paris y el marketplace se encarga de almacenar los productos y realizar todo el proceso de preparación, generación de etiquetas y entrega al cliente final. Los productos aún no son informados vía API. No se genera etiqueta y el seller debe generar la boleta.
Next Day	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha con su flota propia o a través del courier de su preferencia en el mismo día.

Fcom (falabella.com)

Dropshipping	El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.
Cross docking	El vendedor prepara el pedido en su bodega, imprime la etiqueta y la flota propia de falabella.com lo retira y entrega al cliente final.
Fulfillment	El vendedor envía stock a la bodega de Falabella y el marketplace se encarga de almacenar los productos y realizar todo el proceso de preparación y entrega al cliente final. Los productos aún no son informados vía API. No se genera etiqueta y el seller debe generar la boleta.

Amazon

MFN	Los vendedores son responsables de abastecer y almacenar su propio inventario, cumplir con sus propios pedidos, gestionar las devoluciones y trabajar directamente con el cliente.
Fulfillment	El vendedor envía el stock a la bodega de Amazon y el marketplace se encarga de almacenar los productos y realizar todo el proceso de preparación y entrega al cliente final.
Easy Ship ('pri-ez-mx' 'expd-ez-mx' 'expr-ez-mx' std-ez-mx')	Se encarga de la recolección, etiquetado y entrega de tus productos. Una vez que recibes un pedido, el sistema genera automáticamente la etiqueta de envío y coordina la recolección con el transportista. Además te ofrece seguimiento en tiempo real de todos tus envíos, proporcionando actualizaciones constantes tanto a ti como a tus clientes, mejorando la transparencia y la satisfacción del cliente.
MFN std	Logística MFN pero en modalidad standard

Walmart

Standard

El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.

Coppel

Standard

El vendedor prepara el pedido en su bodega, imprime la etiqueta y despacha a través del courier asignado por el marketplace.

Consideraciones para ventas con modalidad fulfillment

Las ventas de tipo fulfillment pueden ser registradas en Multivende y leerse mediante la integración a través del endpoint de Get checkout, no hay diferencia entre el formato de estas ventas y otras modalidades.

Los canales de venta que tienen disponible esta modalidad son: Mercado Libre, Paris, Falabella.com, Amazon y Ripley.

Para activar el registro de las órdenes con esta modalidad logística debes habilitar la opción en la configuración de la conexión del canal como lo indica el artículo según el canal.
Debido a que se crea una bodega especial para asociar las ventas fulfillment del marketplace, el stock de tus bodegas no se verá afectado.
Para este tipo de órdenes el shippingMode trae el valor “fulfillment”, de esta manera se pueden identificar.
Para Mercado Libre en Argentina, Colombia y México, el vendedor puede generar la factura.
Para Mercado Libre Brasil y Chile, la factura es generada por Mercado Libre y el vendedor puede descargarla.

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

Más información

¿Cómo generar y consultar etiquetas de los Marketplace?

El proceso de generación/consultas de etiquetas, debe realizarse consultado por cada Marketplace.

¿Cómo generar / consultar etiquetas de los Marketplace?

Te dejamos el paso a paso para que puedas obtener los documentos de despachos vía API:

1. Consultar las conexiones de los Marketplaces

Primero se debe consultar las conexiones de los Marketplaces que tiene habilitadas el Merchant por el endpoint Get Marketplace connections . El cual retorna un array con todas las conexiones, en el campo "_name" se indica el Marketplace al cual pertenece la conexión, los cuales pueden ser los siguientes:

Marketplace / Tienda online	Estado para poder generar etiquetas
Mercadolibre	Disponible
Linio	Disponible
Dafiti	Disponible
Ripley	Disponible
Paris	Disponible
Falabella (FCOM)	Disponible
Amazon	Disponible
Walmart	Disponible sólo Chile
Coppel	Disponible
Totalplay	Disponible
Liverpool	Disponible
Vtex	No disponible
Magento	No disponible
Shopify	No disponible
Prestashop	No disponible
Woocommerce	No disponible

Nota: Se deben descartar las conexiones de los Marketplace / Tiendas online que no están disponibles.

2. Consultar las órdenes disponibles para generar etiquetas

Con el "_Id" obtenido del respuesta anterior (Get Marketplace connections), se debe consultar por cada uno al Endpoint Get delivery orders with available labels. Enviando de forma predeterminada los siguientes parámetros:

_delivery_statuses = "completed".
_delivery_statuses = "pending".
_shipping_label_print_statuses = "not_printed"
_shipping_label_status = "ready"
_include_only_delivery_order_with_traking_number = true

El response es un array paginado de 50 órdenes por página. Se debe iterar por cuantas paginas contenga.

CONSIDERACIONES ESPECIALES:

Para generar las etiquetas de Linio y Dafiti es necesario cambiar el estado de la orden a "Listo para envío" previo a consultar las órdenes disponibles para generar etiquetas; por el endpoint Update delivery order status.
- Para el caso de Falabella se puede generar la etiqueta sin previamente cambiar el estado a Listo para envío, pero se debe informar este estado al canal de venta para indicar que el despacho está listo.
Para generar las etiquetas de Ripley debes realizar previamente la configuración indicada en el articulo Generación de etiquetas para Mercado Ripley hasta el paso 2, ya que los siguientes pasos son automatizados.
Para generar las etiquetas de Walmart es necesario cambiar el estado de la orden a "En Manejo" previo a consultar las órdenes disponibles para generar etiquetas; por el endpoint Update delivery order status.
Para generar las etiquetas de Liverpool es necesario cambiar el estado de la orden a "En Manejo" previo a consultar las órdenes disponibles para generar etiquetas; por el endpoint Update delivery order status.

Solo podrás generar etiquetas de las órdenes que no están despachadas ni canceladas. Para modalidad Fullfilment no se genera documento de despacho ya que la logística es administrada por los marketplaces que admiten esta modalidad.

3. Crear solicitud de generación de etiquetas

Con los _Id del response anterior (Get delivery orders with available labels), los cuales se pueden agrupar en un array de máximo 50 para consultar al endpoint PUT Generate delivery order tikets..

El cual crea una tarea asíncrona para procesar la solicitud de generar etiquetas.

Para verificar que la tarea esté procesada, consultar periódicamente al siguiente Endpoint Get bulk action task hasta que el campo "processStatus" sea igual a:

"completed",
"completed_with_warnings"
"failed".

En caso que sea "completed_with_warnings" o "failed" se debe volver a procesar la solicitud.

Adicionalmente, se debe validar el valor del campo “output” en el se indica el estado de las órdenes a las que se le solicitó generar las etiquetas.

"ordersWithAvailableDeliveryOrderTickets" es un array que contiene los id de las ordenes a las que se les puede generar etiqueta en la solicitud. Los campos que retorna son:
- "deliveryOrderId"
- "deliveryOrderCode"
- "checkoutId"
- "checkoutCode"
- "checkoutExternalId"
- "deliveryOrderLinkId"
- "deliveryOrderLinkExternalId"
"ordersWithUnavailableDeliveryOrderTickets" es un array que contiene los id de las ordenes a las que no se les puede generar etiqueta en la solicitud.
"failedDeliveryOrders" es un array que contiene los id de las ordenes a las que falló la generación de etiquetas en la solicitud.
"successfulDeliveryOrderDocuments" es un array que contiene los id de las ordenes a las que se les generó etiqueta en la solicitud. Los campos que retorna son:
- "deliveryOrder": {
  "deliveryOrderId",
  "deliveryOrderCode",
  "checkoutId",
  "checkoutCode",
  "checkoutExternalId",
  "deliveryOrderLinkId",
  "deliveryOrderLinkExternalId",
  }
- "deliveryOrderDocumentId"
"totalOrderProcessed" total de ordenes a las que se generó etiquetas en la solicitud.

Consideraciones

Si hay órdenes que están en ""failedDeliveryOrders" o ""ordersWithUnavailableDeliveryOrderTickets" se deben volver a reprocesar.
Si el valor de "totalOrderProcessed" no coincide con la cantidad de órdenes enviadas en la solicitud se debe a que hay ids de órdenes que no existen en Multivende enviadas para generar etiquetas.
En caso de que alguna venta quede con error, se debe revisar con el Marketplace.
Se recomienda generar las etiquetas al apenas la integración validar que existe el stock y almacenar el PDF para su impresión, así disminuirán los tiempos en el proceso de packing.
Por cada etiqueta los marketplace demorar aprox 1 min en poderla liberar.
Para Amazon desde el momento en que se genere la url de los documentos de despacho desde el Get bulk action task, tienes 15 minutos para realizar la descarga y almacenarlo, la url caducará pasado el tiempo mencionado.
En caso de que necesites descargar tus documentos de despacho de Amazon, si lo haces desde Get delivery order consultando la url desde el deliveryOrderDocuments, esta url también tiene un tiempo de 15 minutos, pasado este tiempo la url caducará y deberás hacer nuevamente el llamado del endpoint para habilitar una nueva url.
El proceso de generación masiva de etiquetas ha sido optimizado y estandarizado con el fin de controlar mayor cantidad de errores a la hora de generar etiquetas de despacho para los canales que utilizan esta función, el primer canal que ha implementado este funcionalidad estándar es Mercadolibre y próximamente lo hará Dafiti:

1. La implementación de esta optimización no significa ni debiera significar cambio alguno en el proceso normal de generación de etiquetas para los canales, es decir no debiera haber diferencia en cómo el usuario veía antes las etiquetas y cómo las ve ahora. No obstante sí debiera notar un cambio a la hora de generar etiquetas que habían sido previamente generadas puesto que en el antiguo proceso no generábamos estas etiquetas.
2. Actualmente cuando recibimos la solicitud para generar etiquetas previamente generadas (para el caso de Mercadolibre) lo que hacemos es tomarlas directamente desde el storage de Multivende (puesto que ya existen) generar el archivo consolidado y luego comprimirlas. Dichas etiquetas estarán disponibles con los mismos nombres de archivo pero, con la palabra “_old” al final de estos, esto con el fin de señalar que corresponden a etiquetas antiguas.
3. Las etiquetas denominadas “_old” no contaran con archivos de control puesto que Multivende no genera este recurso por ser un recurso propio de Mercadolibre y por ser etiquetas antiguas el archivo de control ya estará asociado a otra generación masiva de etiquetas realizada previamente.
4. Para este último caso el usuario podrá encontrar el archivo de control asociado a cada despacho individualmente.

El .zip contiene los siguientes archivos, según el formato que estableció el Marketplace:

etiquetas para la impresora Zebra (SOLO MERCADO LIBRE - PARIS y FCOM*)
manifiesto (SOLO MERCADO LIBRE, 1 manifiesto por solicitud)
etiquetas en PDF
Packing (agrupa los ítems por orden, formato Excel)
Picking (agrupa todos los ítems de las órdenes, formato Excel)

*La activación del ZPL de FCOM se solicita directamente al canal de venta.

Documentos según canal de venta:

Canales	Órdenes	"externalOrderNumber"	"PackageId" ("externalContent)	"shipping"."id" ("externalContent")
Mercado Libre	1 PDF por solicitud. 1 ZPL por cada orden de la solicitud.	"Venta"	No disponible	"Envío"
Paris	1 PDF por cada orden de la solicitud. 1 ZPL por cada orden de la solicitud. 1 PDF con todas las órdenes cada orden separada en 1 página. El formato es compatible con impresora zebra.	"Referencia"	No disponible	No disponible
Ripley	1 PDF por cada orden de la solicitud. 1 PDF con todas las órdenes cada orden separada en 1 página. El formato es compatible con impresora zebra.	"Número de Orden"	No disponible	No disponible
Falabella	1 PDF por cada orden de la solicitud. O de lo contrario: 1 ZPL por cada orden de solicitud. Esto se modifica desde el canal, si desean recibir PDF no llegará el archivo ZPL y al contrario, si desean recibir el ZPL no llegará el PDF dentro del .ZIP	No disponible	"REF"	No disponible
Linio	1 PDF por cada orden de la solicitud. El formato es compatible con impresora zebra.	No disponible	"REF"	No disponible
Dafiti	1 PDF por cada orden de la solicitud. El formato es compatible con impresora zebra.	"Referencia"	No disponible	No disponible

NOTA: si el Marketplace es Mercado Libre, automáticamente procesa la orden a lista, lo cual bloquea que se pueda cancelar por parte del cliente o Merchant.

No se registra que pueden pasar a buscar el pedido, esto se debe coordinar con el courier.

¿Cómo consultar las etiquetas de una orden?

A través del endpoint Get delivery order se puede consultar el detalle de entregas con despacho de una orden. El campo "DeliveryOrderDocuments" contiene un array con los documentos referentes a la entrega con despacho de la orden consultada.

Diagrama de Flujo

A continuación, se encuentra el diagrama de flujo para las consultas.

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

Más información

¿Cómo actualizar los estados de un despacho?

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:

"pending"	Pendiente de sincronizar
"requesting"	Empezando la ejecución
"changed"	Cambio de estado correcto
"not_requested"	El estado no genera sincronización al canal
"failed_fatal"	Fallo cambio de estado en el canal

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.

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

Más información

Estados de una orden según el tipo de entrega

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:

“_delivery_type_delivery” = Despacho (el producto se envía a una dirección dada por el comprador).
"_delivery_type_store_pickup" = Retiro (el producto lo retira el comprador en la dirección de la bodega asociada al stock del producto).
"_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

Estado en Multivende campo code	Descripción
_delivery_order_status_pending_	La orden ingresó en el sistema.
_delivery_order_status_handling_	Se está preparando la orden para el envío.
_delivery_order_status_ready_to_ship_	La orden está lista para el despacho.
_delivery_order_reschedule_	La orden se re agendó.
_delivery_order_status_shipped_	La orden se ha enviado.
_delivery_order_status_delivered_	La orden se ha entregado.
_delivery_order_status_not_delivered_	La orden no se entregó.
_delivery_order_status_cancelled_	La orden se ha cancelado.
_delivery_order_status_under_review_	La orden está en revisión.
_delivery_order_status_partial_cancelled_	Uno o algunos de los items de la orden fue cancelado

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

Multivende	Amazon
_delivery_order_status_pending_	unshipped
_delivery_order_status_handling_	partiallyShipped
_delivery_order_status_ready_to_ship_	closed_summary
_delivery_order_status_shipped_	shipped
_delivery_order_status_delivered_	delivered
_delivery_order_status_not_delivered_	not_delivered
_delivery_order_status_cancelled_	cancelled

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

Multivende	Linio, Dafiti, Falabella
_delivery_order_status_pending_	pending, processing
_delivery_order_status_handling_	return_waiting_for_approval, return_shipped_by_customer, return_rejected
_delivery_order_status_ready_to_ship_	ready_to_ship
_delivery_order_status_shipped_	shipped
_delivery_order_status_delivered_	delivered
_delivery_order_status_not_delivered_	returned
_delivery_order_status_cancelled_	failed, canceled

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

Multivende	Mercado Libre
_delivery_order_status_pending_	pending
_delivery_order_status_handling_	handling
delivery_order_status_ready_to_ship_	ready_to_ship
_delivery_order_status_shipped_	shipped
_delivery_order_status_delivered_	delivered
_delivery_order_status_not_delivered_	not_delivered
_delivery_order_status_cancelled_	cancelled

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	Paris
_delivery_order_status_pending_	null
_delivery_order_status_handling_	confirmed
_delivery_order_status_shipped_	in_transit
_delivery_order_status_delivered_	delivered
_delivery_order_status_not_delivered_	failure
_delivery_order_status_cancelled_	failure

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

Multivende	Ripley
_delivery_order_status_pending_	shipping
_delivery_order_status_shipped_	shipped
_delivery_order_status_delivered_	received
_delivery_order_status_cancelled_	cancelled

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

Multivende	Walmart Chile
_delivery_order_status_pending_	Created
_delivery_order_status_handling_	Acknowledged
_delivery_order_status_shipped_	Shipped
_delivery_order_status_delivered_	Delivered
_delivery_order_status_cancelled_	Cancelled

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

Multivende	Walmart México
_delivery_order_status_pending_	On Hold
_delivery_order_status_pending_	Created
_delivery_order_status_ready_to_ship_	Acknowledged
_delivery_order_status_shipped_	Shipped
_delivery_order_status_delivered_	Delivered
_delivery_order_status_cancelled_	Cancelled

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

Multivende	Magento
_delivery_order_status_pending_	pending, new, pending payment, pending payPal
_delivery_order_status_handling_	processing, on hold, payment review
_delivery_order_status_delivered_	invoiced
_delivery_order_status_cancelled_	closed, canceled

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

Multivende	Shopify
_delivery_order_status_pending_	null
delivery_order_status_ready_to_ship_	confirmed
_delivery_order_status_shipped_	in_transit
_delivery_order_status_delivered_	delivered
_delivery_order_status_not_delivered_	failure

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

Multivende	VTEX
_delivery_order_status_under_review_	window-to-cancel
_delivery_order_status_pending_	ready-for-handling
_delivery_order_status_handling_	handling
_delivery_order_status_shipped_	invoiced (Solo si esta el DTE cargado)
_delivery_order_status_cancelled_	cancelled

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.

Estado en Multivende campo code	Descripción
pick_up_order_status_pending	La orden ingresó en el sistema
pick_up_order_status_received_by_store	La orden ingresó a la tienda
pick_up_order_status_completed	La orden está lista para el despacho.
pick_up_order_status_cancelled	La orden fue cancelada

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

Más información

Identificar cancelaciones parciales de los despachos
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
Más información

Homologación de estados canales de venta versus 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

Estado en Multivende campo code	Descripción
_delivery_order_status_pending_	La orden ingresó en el sistema.
_delivery_order_status_handling_	Se está preparando la orden para el envío.
_delivery_order_status_ready_to_ship_	La orden está lista para el despacho.
_delivery_order_reschedule_	La orden se reagendó.
_delivery_order_status_shipped_	La orden se ha enviado.
_delivery_order_status_delivered_	La orden se ha entregado.
_delivery_order_status_not_delivered_	La orden no se entregó.
_delivery_order_status_cancelled_	La orden se ha cancelado.
_delivery_order_status_under_review_	La orden está en revisión.

Paris

Estado del canal	Estado Multivende
awaiting_fulfillment	_delivery_order_status_pending_
ready_to_ship	_delivery_order_status_pending_
printed_label	_delivery_order_status_ready_to_ship_
closed_summary	_delivery_order_status_ready_to_ship_
shipped	_delivery_order_status_shipped_
delivery_in_progress	_delivery_order_status_shipped_
delivered	_delivery_order_status_delivered_
not_delivered	_delivery_order_status_not_delivered_
lost	_delivery_order_status_not_delivered_
rejected_by_carrier	_delivery_order_status_not_delivered_
_delivery_order_status_under_review_	_delivery_order_status_under_review_
_delivery_order_reschedule_	_delivery_order_reschedule_
returned	_delivery_order_reschedule_
return_in_process	_delivery_order_reschedule_
seller_received	_delivery_order_reschedule_
returned_to_seller	_delivery_order_reschedule_
cancelled	_delivery_order_status_cancelled_
deleted	_delivery_order_status_cancelled_
unable_to_fulfill	_delivery_order_status_cancelled_

Shopify v2

Estado del canal	Estado Multivende
confirmed	_delivery_order_status_ready_to_ship_
in_transit	_delivery_order_status_shipped_
delivered	_delivery_order_status_delivered_
failure	_delivery_order_status_not_delivered_
null	_delivery_order_status_pending_
cancelled	_delivery_order_status_cancelled_

Mercadolibre

Estado del canal	Estado Multivende
pending	_delivery_order_status_pending_
handling	_delivery_order_status_handling_
ready_to_ship	_delivery_order_status_ready_to_ship_
shipped	_delivery_order_status_shipped_
delivered	_delivery_order_status_delivered_
not_delivered	_delivery_order_status_not_delivered_
cancelled	_delivery_order_status_cancelled_

Amazon

Estado del canal	Estado Multivende
unshipped	_delivery_order_status_pending_
partiallyShipped	_delivery_order_status_handling_
closed_summary	_delivery_order_status_ready_to_ship_
shipped	_delivery_order_status_shipped_
delivered	_delivery_order_status_delivered_
not_delivered	_delivery_order_status_not_delivered_
cancelled	_delivery_order_status_cancelled_

Vtex

Estado del canal	Estado Multivende
window-to-cancel	_delivery_order_status_under_review_
ready-for-handling	_delivery_order_status_pending_
handling	_delivery_order_status_handling_
canceled	_delivery_order_status_cancelled_
cancel	_delivery_order_status_cancelled_
cancellation-requested	_delivery_order_status_cancelled_
shipped	_delivery_order_status_shipped_
delivered	_delivery_order_status_delivered_

Magento

Estado del canal	Estado Multivende
pending	_delivery_order_status_pending_
new	_delivery_order_status_pending_
pending payment	_delivery_order_status_pending_
pending payPal	_delivery_order_status_pending_
processing	_delivery_order_status_handling_
on hold	_delivery_order_status_handling_
payment review	_delivery_order_status_handling_
closed	_delivery_order_status_cancelled_
canceled	_delivery_order_status_cancelled_
complete	_delivery_order_status_delivered_

Prestashop

Estado del canal	Estado Multivende
pending	_delivery_order_status_pending_
Mapeo personalizado de estados

Ripley

Estado del canal	Estado Multivende
delivered	_delivery_order_status_ready_to_ship_
pending	_delivery_order_status_pending_
shipped	_delivery_order_status_shipped_
received	_delivery_order_status_delivered_
canceled	_delivery_order_status_cancelled_
closed	_delivery_order_status_cancelled_

Fcom - Linio

Estado del canal	Estado Multivende
pending	_delivery_order_status_pending_
processing	_delivery_order_status_pending_
ready_to_ship	_delivery_order_status_ready_to_ship_
return_waiting_for_approval	_delivery_order_status_handling_
return_shipped_by_customer	_delivery_order_status_handling_
return_rejected	_delivery_order_status_handling_
shipped	_delivery_order_status_shipped_
delivered	_delivery_order_status_delivered_
returned	_delivery_order_status_not_delivered_
canceled	_delivery_order_status_cancelled_
failed	_delivery_order_status_cancelled_
ReadyToShip	_delivery_order_status_ready_to_ship_
PackadByMarketplace	_delivery_order_status_handling_
Shipped	_delivery_order_status_shipped_
Cancelled	_delivery_order_status_cancelled_

Jumpseller

Estado del canal	Estado Multivende
requested	_delivery_order_status_handling_
failed	_delivery_order_status_cancelled_
pickup_available	_delivery_order_status_delivered_
delivered	_delivery_order_status_delivered_
procesado	_delivery_order_status_delivered_

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

Más información

Cómo automatizar la configuración de pedidos de Amazon Easy Ship a través de la API de Multivende
En este artículo, aprenderás cómo automatizar la configuración de tus pedidos de Amazon Easy Ship utilizando la API de Multivende. Si necesitas información sobre el funcionamiento de Amazon Easy Ship, consulta el artículo: Cómo gestionar tus pedidos de Amazon Easy Ship en Multivende.

1. Identificar Órdenes de Amazon Easy Ship

Para gestionar los pedidos de Amazon Easy Ship, primero debes identificar el deliveryOrderId y el ID de la conexión con el marketplace correspondiente. Asegúrate de que la orden pertenezca a la modalidad de Easy Ship verificando el campo shippingMode con los siguientes valores:
- "pri-ez-mx"
- "expd-ez-mx"
- "expr-ez-mx"
- "std-ez-mx"
Puedes verificar esto utilizando cualquiera de los siguientes endpoints:
- Get checkout light: Si la venta tiene más de un deliveryOrder con diferentes modalidades logísticas, el valor indicado será "múltiple". Caso contrario el shippingMode traerá los valores asociados a Easy ship de Amazon.
- Get checkout: se valida el shippingMode dentro de cada deliveryOrder.
- Get deliveryOrder: se valida directamente el valor del shippingMode.
2. Consultar las Dimensiones del Paquete

Para obtener las dimensiones del paquete, utiliza el endpoint Get dimensions of item packages. Esta información es esencial para la consulta de horarios de recolección. La API responderá con un formato similar al siguiente:
```
[
  {
    "packageDimensionsAndWeight": {
      "asin": "XXXXXXXXXX",
      "packageDimensions": {
        "length": 12,
        "width": 12,
        "height": 12,
        "unit": "Cm"
      },
      "packageWeight": {
        "value": 12,
        "unit": "G"
      }
    }
  }
]
```
3. Consultar Horarios de Recolección

Para obtener los horarios de recolección disponibles, usa el endpoint Post available time slots. Envía los parámetros de dimensiones del paquete obtenidos en el paso anterior o establece tus propias medidas:
```
{
  "packageDimensionsAndWeight": {
    "packageDimensions": {
      "length": 0,
      "width": 0,
      "height": 0,
      "unit": "Cm"
    },
    "packageWeight": {
      "value": 0,
      "unit": "G"
    }
  }
}
```
La respuesta incluirá bloques de horarios disponibles para la recolección. Toma nota de los parámetros slotId, startTime y endTime del bloque que mejor se ajuste a tus necesidades:
```
{
  "packageDimensionsAndWeight": {
    "packageDimensions": {
      "length": 12,
      "width": 12,
      "height": 22,
      "unit": "Cm"
    },
    "packageWeight": {
      "value": 23,
      "unit": "G"
    }
  },
  "listHandoverSlots": [
    {
      "handoverMethod": "PICKUP",
      "slotId": "xxxxxxxxxxxxxxxxxxxx",
      "startTime": "2024-08-02T13:00:00-06:00",
      "endTime": "2024-08-02T18:00:00-06:00"
    },
    {
      "handoverMethod": "PICKUP",
      "slotId": "xxxxxxxxxxxxxxxxxxxx",
      "startTime": "2024-08-05T13:00:00-06:00",
      "endTime": "2024-08-05T18:00:00-06:00"
    }
  ]
}
```
4. Programar la Recolección

Para programar la recolección de tu pedido, utiliza el endpoint Post create scheduled packages. Envía los parámetros obtenidos del paso anterior para fijar el horario de recolección:
```
{
  "deliveryOrderId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "amazonOrderIdsAndPackageTimeSlots": [
    {
      "slotId": "xxxxxxxxxxxxxxxxx",
      "startTime": "2024-08-02T13:00:00-06:00",
      "endTime": "2024-08-02T18:00:00-06:00"
    }
  ]
}
```
5. Impresión de Etiquetas

La impresión de etiquetas para Amazon Easy Ship se realiza a través del flujo estándar de generación de etiquetas. Consulta el artículo: ¿Cómo generar y consultar etiquetas de los Marketplace? para obtener instrucciones detalladas.

Ten en cuenta que una vez generada la URL de los documentos de despacho, dispones de 15 minutos para descargarla. La URL caducará después de este tiempo. Si necesitas descargar los documentos nuevamente, realiza un nuevo llamado al endpoint Get delivery order y busca la URL en deliveryOrderDocuments.

Consideraciones Adicionales:

Para verificar el rango de fechas de recolección de una orden ya programada o validar si ya la orden tiene programado un envío, consulta los siguientes campos, si tienen información es que ya el despacho se encuentra programado:
- "pickUpDeliveryDateTo"
- "pickUpDeliveryDateFrom"
Esto lo puedes hacer a través de los endpoints Get delivery order o Get checkout

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
Más información
Configuraciones de Mercadolibre ME1 vía API Multivende
En este artículo te mostramos las configuraciones que debes considerar para las automatizaciones relacionadas con la modalidad de ME1.

Desde la API de Multivende podrás automatizar la carga o consulta de la información del despacho asociada a la operación de las ventas con esta modalidad. A continuación te indicamos el paso a paso para configurar esta información.

Clases de envío

Las clases de envío nos permiten asignar costos de envío diferentes en función de las características del producto como su tamaño, peso, fragilidad, etc. Esta opción resulta enormemente útil porque permite agrupar productos similares por envío y así optimizar los gastos de envíos. Puedes obtener más información desde nuestro centro de ayuda en el siguiente artículo: Crear, editar y eliminar clases de envío.

Puedes administrar las configuraciones de las clases de envío de tus despachos mediante la API con las siguientes acciones:
Zonas de envío

Una zona de envío consiste en un área geográfica para la cual puedes disponer del envío de tus productos, estableciendo métodos, tarifas y tiempos estimados de entrega. Para obtener más información sobre esta funcionalidad puedes visitar este artículo de nuestro Help Center.

Puedes administrar desde la integración vía API la información asociada a las zonas de envíos mediante las siguientes acciones disponibles.
Métodos de envío

Para tener más información sobre los métodos de envío te recomendamos visitar este artículo de nuestro Help Center.

Puedes administrar los métodos de envío relacionados a tus zonas de envío, los métodos de envío tienen asociados los parámetros:
- Moneda: puedes consultar desde la integración vía API la información asociada a las monedas para un merchant mediante el siguiente endpoint Obtener monedas
- Courier: puedes administrar desde la integración vía API la información asociada a los couriers para un merchant mediante las siguientes acciones disponibles:
- Los costos de cada clase de envío
- Tiempo límite en días
- Peso mínimo y máximo
- Valor por kilogramo de excedente.
Puedes operar desde la API esta información mediante las siguientes acciones disponibles:
- Obtener métodos de envío
- Obtener tipos de de método de envío
- Crear método de envío: para crear un método de envío lo debes hacer mediante el endpoint POST shipping zones methods, teniendo en cuenta que el campo status debe tener el valor “pending-to-create”.
- Actualizar método de envío: para actualizar un método de envío lo debes hacer mediante el endpoint POST shipping zones methods, teniendo en cuenta que en el campo status debe tener el valor “pending-to-update”.
Operar sobre las ventas con ME1

Requiere que el vendedor envíe el número de seguimiento y tracking url (ambos campos son requeridos) y también las actualizaciones de estado de las órdenes de despacho, lo cual puedes hacer mediante nuestro servicio de integraciones Multivende.

Para identificar las ventas con esta modalidad, el campo shippingMode trae el valor “default”.
- El número de seguimiento y tracking url deben ser enviados antes de la modificación del estado de la orden, se actualiza mediante el endpoint Update delivery order.
- Los cambios de estados disponibles para actualizar son:
Multivende Mercado Libre

_delivery_order_status_shipped_ shipped

_delivery_order_status_delivered_ delivered

_delivery_order_status_cancelled_ not_delivered

Estos estados se van actualizando de acuerdo a la operación de la logística del vendedor. Para la actualización del estado de las órdenes dispones de el endpoint Update delivery order status.

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
Más información
Endpoints para cargar documentos de despacho a órdenes en Multivende vía API
Si tu integración genera la etiqueta de despacho o manifiesto, puedes hacer la carga de este documento a las ordenes mediante la API, Multivende puede funcionar como repositorio de estos documentos para su uso en la operación logística del merchant.
- Cargar etiqueta/manifiesto a partir de un archivo local
Realizas la carga mediante el endpoint POST Load document by file , con la opción de subir la etiqueta y el manifiesto.

Request:
```
curl --location -g '{{base_url}}/api/delivery-order-load-label-and-manifest/file/{{delivery_order_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'file_label=@"/path/to/file"' \
--form 'file_manifest=@"/path/to/file"'
```
La API responderá con un 201 created.
- Cargar etiqueta/manifiesto a partir de un archivo base 64
La carga se realiza mediante el endpoint POST Load document by base64

Request:
```
curl --location -g '{{base_url}}/api/delivery-order-load-label-and-manifest/base64/{{delivery_order_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'base64_label=""' \
--form 'base64_manifest=""'
```
La API responderá con un 201 created.
- Cargar etiqueta/manifiesto a partir de una url
La carga se realiza mediante el endpoint POST Load document by url

Request:
```
curl --location -g '{{base_url}}/api/delivery-order-load-label-and-manifest/url/{{delivery_order_id}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{access_token}}' \
--form 'url_label=""' \
--form 'url_manifest=""'
```
La API responderá con un 201 created.

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
Más información

Multivende	Mercado Libre
_delivery_order_status_shipped_	shipped
_delivery_order_status_delivered_	delivered
_delivery_order_status_cancelled_	not_delivered

Logística

Conoce las modalidades y operadores logísticos de los despachos que puedes gestionar a través de Multivende.

Modalidades logísticas

Delivery Order

Checkout

Shipping Mode

courierName

Modalidades logísticas de los marketplaces

Mercadolibre

Linio

Dafiti

Ripley

Paris

Fcom (falabella.com)

Amazon

Walmart

Coppel

Consideraciones para ventas con modalidad fulfillment

El proceso de generación/consultas de etiquetas, debe realizarse consultado por cada Marketplace.

¿Cómo generar / consultar etiquetas de los Marketplace?

1. Consultar las conexiones de los Marketplaces

2. Consultar las órdenes disponibles para generar etiquetas

3. Crear solicitud de generación de etiquetas

Consideraciones

¿Cómo consultar las etiquetas de una orden?

Diagrama de Flujo

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.

Despachos

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

Entregas con despacho

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

Cancelaciones parciales para el canal Paris:

Entrega con retiro en tienda

Multivende

Paris

Shopify v2

Mercadolibre

Amazon

Vtex

Magento

Prestashop

Ripley

Fcom - Linio

Jumpseller

1. Identificar Órdenes de Amazon Easy Ship

2. Consultar las Dimensiones del Paquete

3. Consultar Horarios de Recolección

4. Programar la Recolección

5. Impresión de Etiquetas

Cargar etiqueta/manifiesto a partir de un archivo local

Cargar etiqueta/manifiesto a partir de un archivo base 64

Cargar etiqueta/manifiesto a partir de una url

¿No encontraste lo que buscabas?