Cómo funciona la integración con Miravia

Esta página explica las piezas que intervienen y qué ocurre en cada una. Lee primero Piezas y después el recorrido que te interese.

Piezas

Miravia: el marketplace. Tiene los pedidos, los productos y el estado de los envíos.
El módulo de Miravia: lee de Miravia, guarda una copia local de cada pedido y producto, y envía a Miravia las escrituras permitidas.
La plataforma común de marketplaces: decide si una escritura está permitida (modo global), guarda las colas de trabajo y evita duplicados.
Beply (tu ERP): aquí están los pedidos de cliente, las facturas, el almacén y los productos.
BeplyImport: aporta el fichero de stock de tu ERP. Si lo usas, también recibe las etiquetas de envío por FTP.
Shopify (opcional): si reenvías pedidos a Shopify, la tienda puede servirlos en su propia app de preparación. Ver la guía de Shopify.

Concepto clave: copia local y pedido de cliente

Un pedido de Miravia tiene dos representaciones:

Copia local. Al descargarlo, el módulo guarda el pedido tal como lo envía Miravia: estado, líneas, comprador y paquetes. La copia no es un pedido de cliente.
Pedido de cliente. La copia se convierte en pedido de cliente de Beply cuando su estado está en Estados que crean pedido (por defecto, ready_to_ship, ready_to_ship_pending, packed y shipped). Esa conversión puede ser automática o manual.

Recorrido de un pedido

Miravia (Pendiente)
   │  descarga: cada 10 min (automática) o manual con un rango
   ▼
Copia local del pedido
   │  las líneas sin producto vinculado entran como líneas libres
   │
   │  aceptación automática (solo con "Aceptar pedidos automáticamente",
   │  escritura habilitada, cron activo y pedido aún no convertido)
   │     stock insuficiente conocido ──► retenido
   │     sin dato de stock y "Retener pedidos sin dato de stock" activa ──► retenido
   │     en otro caso ──► Listo para enviar en Miravia (Miravia crea paquete y tracking)
   ▼
Conversión a pedido de cliente de Beply
   │  automática con "Crear pedidos automáticamente", o a mano con "Convertir a pedido"
   ▼
Etiqueta (si está activada la solicitud automática) ──► FTP de BeplyImport o guardada en el pedido
   ▼
Tracking enviado a Miravia (o recibido de Shopify, si lo usas)

El historial de la ficha muestra estados del proveedor, no todas las decisiones del módulo. Algunas alertas sí aparecen en la ficha, como la de reenvío fallido a Shopify. Ver Recibir y procesar pedidos de Miravia para lo que sí se ve.

Recorrido de productos

Descargas los productos de Miravia (Importar productos, manual o automática).
Cada producto tiene un campo Referencia de la variante de Facturascripts. Es el vínculo con tu catálogo. Lo rellenas en la ficha del producto o lo confirmas con la conciliación de anuncios existentes.
El cruce de stock del fichero de tu ERP se hace por el SKU del vendedor, así que un producto sin vínculo a una variante también puede recibir stock. Para que la aceptación compruebe el stock, el producto debe estar vinculado. Sin vínculo, el pedido se acepta sin comprobar stock, salvo que actives Retener pedidos sin dato de stock.

Recorrido de stock y precio

El stock sale del fichero de stock de tu ERP, que lee BeplyImport, y llega a Miravia por la cola de la plataforma común con la subida de stock activada y escritura habilitada.
La reconciliación de stock compara cada 5 minutos el stock del fichero de tu ERP con Miravia y corrige diferencias. El precio se compara solo en el barrido completo. Sus ajustes no son visibles en la ficha de la cuenta.
Cambiar el stock dentro de Beply no envía el cambio a Miravia. Miravia recibe el stock del fichero del ERP.

Qué significa escritura permitida

Una escritura hacia Miravia solo sale si se cumplen las tres condiciones de Primeros pasos: modo global en Escritura habilitada, la casilla de la función activa y la cuenta activa. Si falta una, el módulo lee o simula, pero no escribe.

Versiones

Esta guía toma como referencia las funciones de la versión 18.0. La referencia no acredita publicación ni aprobación como estable. Confirma la versión instalada y sus opciones antes de seguir un procedimiento. Una versión publicada no prueba que esté instalada en tu cuenta.

Desde la versión 16.8: alertas y recuperación del empaquetado.
Desde la versión 16.9: destino Solo guardar en el pedido y envío a Shopify por variante exacta, sin email del comprador.
Desde la versión 17.0: enlace de la etiqueta en el pedido de Shopify.
Desde la versión 17.1: solicitud automática de preparación y ubicación del almacén en Shopify.
Desde la versión 17.2: alerta de reenvío fallido, Reenviar a Shopify y límite de solicitudes automáticas de etiqueta.
Desde la versión 17.3: el enlace sigue el paquete actual y se revoca cuando deja de esperar la recogida; límites separados para rechazos y peticiones totales.
Desde la versión 17.4: aviso para volver a imprimir una etiqueta que ya se había descargado y cierre de la alerta solo tras un reenvío correcto.

En la versión 16.7, el envío a Shopify usaba líneas libres y llevaba el email del comprador. Ese comportamiento anterior no describe las versiones desde la 16.9. Los requisitos y las limitaciones de cada versión para catálogo y seguimiento están en sus guías.