Recibir y procesar pedidos de Miravia

Los pedidos de Miravia se descargan a una copia local, se convierten en pedidos de cliente de Beply cuando cumplen las reglas, y pueden aceptarse en Miravia para prepararlos. Esta guía explica cada paso, las decisiones que el módulo toma por ti y qué mirar cuando un pedido se queda parado.

Antes de empezar

La cuenta debe estar en CONECTADO (ver Primeros pasos).
Decide si quieres Crear pedidos automáticamente o convertir a mano.
Antes de activar la aceptación automática, comprueba los productos vinculados (ver Descargar y vincular productos de Miravia).

Descargar pedidos

Hay dos formas:

Automática. Con la cuenta activa y el cron de pedidos activado, Miravia se consulta cada 10 minutos por defecto (el campo Periodo del cron lo cambia). Cada descarga mira los últimos días del Rango de fechas (por defecto, 3 días).
Manual. En la lista de pedidos de Miravia, pulsa Integrar desde proveedor, elige la cuenta y un rango frecuente (Hoy, Últimas 24 horas, Últimos 3 días, Último mes, Último año), o unas fechas. No puedes usar a la vez fechas y rango frecuente. La fecha de inicio no puede ser posterior a la de fin.

Una descarga actualiza la copia local, con sus líneas y su estado. Si Miravia cambia el estado después, la siguiente descarga lo actualiza.

Atención al corte. El campo Importar pedidos creados desde solo filtra la descarga automática. La descarga manual y la conversión a pedido de cliente no lo aplican. Un rango manual largo puede traer pedidos antiguos.

Estados del pedido

La lista muestra el estado tal como lo envía Miravia, sin traducir. Los valores habituales son pending (pendiente), ready_to_ship (listo para enviar), packed, shipped y los de espera o cancelación.

Qué estados crean pedido de cliente

Estados que crean pedido indica qué estados pueden convertirse en pedido de cliente. Por defecto son ready_to_ship, ready_to_ship_pending, packed y shipped. Puedes añadir pending o delivered si lo necesitas.

La ayuda de la configuración indica que pending está siempre bloqueado, pero el código permite añadirlo de forma explícita a esta lista.

La configuración bloquea estos estados: waiting_acceptance, waiting_debit, waiting_debit_payment, canceled y cancelled, returned, shipped_back y shipped_back_success.

Convertir a pedido de cliente

Un pedido se convierte en pedido de Beply de tres formas:

Automática. Con Crear pedidos automáticamente activo, la conversión ocurre después de la descarga, siempre que el estado esté permitido.
Un pedido. En la ficha del pedido, pulsa Convertir a pedido.
Varios pedidos. En la lista, pulsa Convertir a pedido y elige todos los pedidos no convertidos o los seleccionados. Si no seleccionas ninguno, aparece No hay pedidos seleccionados y no se crea nada.

Las líneas sin producto vinculado no bloquean el pedido: entran como líneas libres.

El Almacén de la cuenta es el almacén del pedido generado.

Serie por canal

Series por canal es un JSON que asigna una serie a cada canal. Ejemplo: {"default":"MIR","aliexpress":"ALI"}. La serie de cada canal debe existir en Beply.

Cliente del pedido

Con Un cliente por comprador activo, cada comprador tiene su ficha de cliente. Solo afecta a los pedidos importados a partir de entonces.
Si está desactivado, los pedidos van al cliente de Miravia.

Aceptar pedidos en Miravia

Aceptar pedidos automáticamente hace que el módulo pase a Listo para enviar en Miravia los pedidos pendientes que todavía no están convertidos. Esto hace que Miravia genere el paquete, el tracking y la etiqueta. Solo ocurre con la escritura habilitada y el cron de la cuenta activo.

Antes de aceptar, el módulo comprueba el stock de Beply de la variante vinculada a cada línea:

Stock insuficiente: el pedido queda retenido siempre.
Línea sin variante vinculada o sin fila de stock: el pedido queda retenido solo si Retener pedidos sin dato de stock está activa. Está apagada por defecto.

El fichero del ERP no influye en la aceptación. Para el rechazo automático de líneas sin stock, el fichero debe tener menos de tres horas.

Rechazar automáticamente en el portal las líneas sin stock solo funciona con Aceptar pedidos automáticamente activo y con evidencia de stock reciente del ERP (menos de tres horas). Si solo algunas líneas están sin stock decide si se rechazan solo esas líneas o el pedido entero.

No hay botón para rechazar un pedido a mano en Beply. Tampoco hay botón para cancelarlo.

Empaquetado

Desde la versión 16.8.

Al pasar a Listo para enviar, Miravia crea el paquete. Pueden pasar tres cosas:

Correcto. El pedido queda con paquete, tracking y etiqueta.
Miravia responde éxito sin paquete. El módulo hace una lectura de Miravia antes de reintentar. Solo vuelve a empaquetar si Miravia demuestra que no hay efecto. Los reintentos se hacen a los 15 minutos, 1 hora, 3 horas y 6 horas, con un máximo de cuatro.
Agotada la secuencia. El pedido pasa a Pack en cuarentena. No se reintenta solo, y no hay botón para forzar el empaquetado desde Beply. Revisa el pedido en Miravia.

La columna Estado pack/RTS muestra si el pedido tiene una retención de empaquetado:

Pack/RTS retenido: requiere lectura del proveedor. Una llamada de empaquetado ha quedado incierta. El módulo no la repite a ciegas. Se recupera sola entre 15 minutos y 12 horas después.
Pack en cuarentena. Miravia no creó el paquete tras los reintentos.
Pack contradicho por el proveedor. Miravia responde algo que contradice el estado local. Revisa el pedido antes de tocarlo.

La recuperación automática se puede contener desde la configuración de la cuenta con Contener recuperación del pack. Esa contención es global: afecta a todas las cuentas. Exige un motivo de al menos 10 caracteres y una duración de entre 1 y 168 horas. Reactivar recuperación del pack la quita antes de tiempo.

Alerta de empaquetado

Desde la versión 16.8.

Un pedido pagado que sigue Pendiente sin paquete, pasadas las horas de Alerta de empaquetado tras (horas) (de 1 a 72; por defecto 2), se marca como ERROR: empaquetado fallido. Aparece en la columna Alerta empaquetado y en la cabecera de la lista.

Solo se activa en cuentas con Aceptar pedidos automáticamente.
Se envía un correo resumen al usuario indicado en el campo Usuario de la cuenta. Ese usuario tiene que tener correo. El correo no incluye datos del comprador.
Cada pedido genera una sola alerta. La alerta se retira sola cuando el pedido sale del problema.

Falta de stock sin resolver

Un pedido retenido por falta de stock se vuelve a evaluar en cada pasada. Tras tres intentos separados en el tiempo, el módulo registra un aviso interno. Hoy ninguna pantalla muestra ese aviso.

Reenvío a Shopify (opcional)

¿Se pueden reenviar los pedidos de Miravia a una tienda Shopify? Sí, con Subir pedidos a Shopify, una Cuenta Shopify elegida y escritura habilitada. En la tienda hacen falta Crear pedidos en Shopify, el perfil de permisos en blanco y permiso de escritura de pedidos. El envío automático sale cuando Beply convierte el pedido automáticamente; Convertir a pedido no inicia ese envío. El pedido conserva su origen Miravia: en Shopify es un espejo y no se convierte ni se factura como venta de Shopify.

Desde la versión 16.9, cada línea llega como la variante exacta de Shopify y requiere envío. Para ello, la plataforma común debe admitir variantes en las líneas (desde su versión 16.2) y el catálogo de Shopify debe estar importado con un enlace único para cada SKU en la cuenta Shopify elegida. No se envía ningún pedido si alguna variante falta, es ambigua, pertenece a otra cuenta o la plataforma instalada no admite variantes. No se envía el email del comprador de Miravia.

En la versión 16.7, las líneas iban libres, con título, cantidad, precio y SKU, y el pedido incluía el email del comprador. Ese comportamiento es anterior a la versión 16.9.

Reenviar un pedido a Shopify

Desde la versión 17.2, Reenviar a Shopify permite solicitarlo manualmente desde la ficha, una vez corregida la causa. Requiere permiso para modificar, cuenta activa, Subir pedidos a Shopify y escritura habilitada. Si el pedido ya está vinculado en Shopify, no se reenvía ni se duplica.

Revisa el aviso de la ficha. Comprueba la cuenta Shopify y los enlaces de las variantes; si la causa no está clara, pide a soporte que revise el pedido.
Corrige el motivo antes de pulsar Reenviar a Shopify.
Pedido puesto en cola para reenviarlo a Shopify confirma la solicitud. Ponerlo en cola no confirma que haya llegado a Shopify: comprueba que existe el pedido en la tienda.

La alerta permanece abierta hasta que el reenvío termina con éxito. Si vuelve a fallar, la ficha vuelve a avisar. El usuario responsable de la cuenta puede recibir un correo resumen, sin datos del comprador. Ese aviso depende de que tenga email y de que el correo saliente permita enviarlo; un correo no recibido no prueba que el pedido haya llegado al almacén. El historial de estados del proveedor no muestra todos los diagnósticos internos. Ante una respuesta incierta, pide a soporte que reconcilie el estado en la tienda antes de solicitar otro envío.

Para el enlace de la etiqueta y la solicitud automática de preparación, consulta Etiquetas de envío y seguimiento en Miravia. Con Recibir tracking de Shopify, el seguimiento vuelve a Beply; consulta recibir seguimiento de Shopify. Para la tienda, consulta la guía de Shopify.

Ficha del pedido

Información del pedido: código, fecha, estado, última actualización, estado fiscal, estado de importación, último error de importación, pedido generado y cuenta.
Facturación y Envío: país, dirección, código postal y teléfono.
Totales y las líneas: código SKU, ID de línea, nombre, cantidad, precio, precio sin descuento y descuento.

Estado de importación: muestra si el pedido ya es pedido de cliente. Tras cinco intentos fallidos, el pedido pasa a cuarentena. El último error aparece en Último error de importación.

Estado fiscal: empieza en bloqueado. El bloqueo fiscal impide facturar el pedido, no impide convertirlo.

Comprueba el resultado

El pedido aparece en la lista con su estado y, si ya es pedido de cliente, con su Pedido generado.
Si el pedido está listo para enviar, tiene paquete y tracking en Miravia.
Si algo queda retenido, la columna de estado de empaquetado lo indica.