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