Etiquetas de envío y seguimiento en Miravia

Cuando un pedido de Miravia está listo para enviar, Miravia genera la etiqueta del paquete. Esta guía explica cuándo se pide, dónde queda, cómo se envía el tracking y qué hacer cuando una etiqueta no aparece.

Antes de empezar

El pedido debe estar aceptado en Miravia como Listo para enviar y convertido a pedido de cliente de Beply.
La etiqueta solo se pide si la casilla Solicitar etiquetas automáticamente está activa. La casilla Solicitar etiquetas a Miravia por sí sola no pide ninguna etiqueta.
El modo global de escritura debe estar en Escritura habilitada.

Cuándo se pide una etiqueta

El módulo solo pide la etiqueta si se cumplen todas estas condiciones:

El pedido es un pedido de cliente de Beply ya creado.
El canal es Miravia.
El pedido tiene 60 días como máximo.
Todas las líneas del pedido están en Listo para enviar.

La solicitud automática revisa los pedidos en cada pasada. Con varios paquetes, la ficha del pedido ofrece un PDF que agrupa las etiquetas de todos los paquetes.

Destino de las etiquetas

En la configuración de la cuenta, Destino de las etiquetas de envío admite dos valores:

FTP del ERP (BeplyImport). Es el valor por defecto. La etiqueta se entrega a BeplyImport. Si la entrega falla, el pedido pasa a retención manual; no se reintenta cada 5 minutos.
Solo guardar en el pedido (desde la versión 16.9). La etiqueta se descarga de Miravia y se guarda en el pedido, sin FTP. Pensado para cuentas sin ERP externo que recoja etiquetas.

Con Solo guardar en el pedido:

Solo se admiten pedidos de un paquete. Con varios paquetes no se pide la etiqueta.
No hay regeneración explícita de la etiqueta.
Una etiqueta ya guardada para el mismo paquete no se vuelve a pedir. Si Miravia cambia el paquete, la etiqueta y su enlace deben seguir el paquete actual.
Desde la versión 17.2, las solicitudes automáticas tienen un máximo de 6 intentos, con esperas de 15 minutos, 1 hora, 3 horas, 6 horas y 12 horas entre ellos. Después, el módulo deja de pedirla automáticamente. Una etiqueta guardada reinicia el contador. Los intentos de descarga son distintos de los de recuperación del pack: pedir un PDF no es volver a empaquetar el pedido. No se aplica a una petición manual o por API; eso no añade un botón de regeneración a la ficha.

Un valor de destino desconocido no descarga nada. Al guardar la cuenta, un valor no válido vuelve al valor por defecto.

Campos de entrega FTP

Los campos Host FTP de etiquetas, Puerto FTP de etiquetas, Usuario FTP de etiquetas, Contraseña FTP de etiquetas, Carpeta FTP de etiquetas, FTP pasivo y Usar FTPS son heredados y de solo lectura. La conexión de entrega la gestiona BeplyImport. La casilla FTP legacy del proveedor (retirado) no se usa.

Ver la etiqueta

En la ficha del pedido, la etiqueta aparece con su Descargar etiqueta cuando existe. Si todavía no hay etiqueta, la ficha lo indica. Las etiquetas que no se pueden previsualizar (por ejemplo, ZPL) se descargan con el botón.

Enlace de la etiqueta en el pedido de Shopify

Desde la versión 17.0.

Si reenvías pedidos a Shopify, puedes activar Enlace de la etiqueta en el pedido de Shopify. Requisitos:

Escritura habilitada.
Destino Solo guardar en el pedido.
Pedido de Shopify ya creado y etiqueta PDF guardada.
Pedido en Listo para enviar, con 60 días como máximo.

Cuando se cumplen, el pedido de Shopify recibe una línea en la nota y un atributo Etiqueta Miravia con un enlace de descarga en PDF.

El enlace es público y no requiere sesión. Caduca a los 14 días.
Puedes revocarlo desde el pedido con Revocar enlace de la etiqueta. Desde la versión 17.3, el enlace también se revoca cuando el pedido ya no tiene estados previos a recogida: enviado, entregado, cancelado por completo o un estado desconocido. Una cancelación parcial no lo revoca; un pedido sin estados responde 404 y conserva el enlace.
Actualizar el pedido de Shopify no avisa al comprador.
Cualquier petición rechazada (enlace desconocido, caducado, revocado o pedido no listo para enviar) recibe una respuesta 404 sin detalles del motivo. Desde la versión 17.3, el límite por dirección distingue 30 rechazos de 600 peticiones totales en 10 minutos; las peticiones posteriores al límite responden 429.

Volver a imprimir una etiqueta actualizada

Desde la versión 17.3, el mismo enlace sirve la etiqueta nueva cuando Miravia cambia el paquete y la nueva etiqueta está guardada. Mientras falta la etiqueta actual, devuelve 404 y no sirve la etiqueta antigua. La caducidad de 14 días vuelve a contar al guardar la nueva etiqueta.

Desde la versión 17.4, si la etiqueta anterior ya se había descargado, la nota del pedido de Shopify muestra Etiqueta Miravia actualizada. Debes descargarla e imprimirla otra vez desde el mismo enlace; no uses el PDF anterior. Ese aviso actualiza la nota del pedido y no notifica al comprador.

Solicitud de preparación en Shopify

Desde la versión 17.1, Solicitud de preparación automática en Shopify envía una petición al servicio de preparación del almacén. Está desactivada por defecto. No equivale a crear el pedido, recibir tracking ni avisar al comprador.

Configura Ubicación de Shopify del almacén con el número de la ubicación o gid://shopify/Location/N. No es el almacén de Beply.
Comprueba que ya existen el pedido de Shopify, un enlace propio de la etiqueta vigente y publicado en ese pedido, y un paquete pendiente de recogida. El pedido debe seguir siendo elegible para la etiqueta.
Todas las órdenes de preparación abiertas del pedido deben estar asignadas a esa ubicación. Si alguna está en otra, no se envía ninguna solicitud parcial.
La cuenta Shopify debe disponer de read_orders, read_locations, read_third_party_fulfillment_orders y write_third_party_fulfillment_orders. Mantén escritura habilitada y las opciones necesarias para publicar el enlace de la etiqueta.
Activa Solicitud de preparación automática en Shopify solo cuando esa tienda y ese almacén deban gestionar la preparación.

La solicitud lleva el enlace de la etiqueta y no avisa al comprador. Una solicitud enviada no significa que el pedido esté preparado ni que la preparación esté completada: comprueba la solicitud y su estado en Shopify. Una solicitud ya enviada o aceptada se reconoce leyendo su estado y no se envía otra vez. Una respuesta incierta se resuelve con una nueva lectura antes de repetir; los errores recuperables se revisan como mucho cada 30 minutos. Una solicitud rechazada o cuya cancelación ya fue aceptada por el almacén no se reenvía: revísala en Shopify.

Tracking: enviar a Miravia

Enviar tracking a Miravia habilita la opción de envío del número de seguimiento. La versión 17.5 bloqueaba el transporte de ese seguimiento. Si tienes instalada la versión 17.6, se corrige ese bloqueo; siguen siendo necesarias la cuenta y el pedido correctos, Enviar tracking a Miravia activo y Escritura habilitada.
Si la casilla ya estaba activa, al instalar la versión 17.6 el módulo puede empezar a enviar seguimiento con las opciones existentes. Comprueba la cuenta y la configuración antes de actualizar.
La casilla, la cola y una respuesta aceptada no demuestran recepción: comprueba el seguimiento en Miravia.
El número sale del tracking de Shopify o del tracking del ERP.
Si un envío no tiene número de seguimiento, queda en cuarentena: no se envía nada hasta que exista el número.

Actualizar no reactiva automáticamente los envíos rechazados ni los que están en cuarentena. Los ya confirmados tampoco se envían otra vez. Una respuesta incierta requiere reconciliar su estado antes de repetir: pide a soporte que revise el envío y comprueba el resultado en Miravia. El módulo también lee el tracking de cada paquete desde Miravia y lo guarda en el pedido.

Tracking: recibir de Shopify

Recibir tracking de Shopify importa el seguimiento desde Shopify. Funciona incluso en modo de solo lectura. Para enviarlo después a Miravia hace falta escritura habilitada y Enviar tracking a Miravia activo.

Comprueba el resultado

La ficha del pedido muestra la etiqueta, o el enlace de Shopify si lo usas.
El pedido tiene número de seguimiento cuando Miravia lo ha generado.

Problemas frecuentes

No aparece la etiqueta: falta Solicitar etiquetas automáticamente, el pedido no está en Listo para enviar, el modo global no permite escribir o el pedido supera los 60 días.
Varios paquetes con destino solo pedido: la etiqueta no se pide. Cambia a FTP del ERP (BeplyImport) o gestiona la etiqueta en Miravia.
El tracking no llega a Miravia: revisa la versión, la casilla, el modo global y que el envío tenga número de seguimiento. Comprueba también si quedó rechazado antes de actualizar: no se reactiva automáticamente.