Warehouse Revolution: configuración y ayuda

Haz una copia de seguridad de la base de datos de la tienda y de los datos de stock. Sube e instala mprwarehouserevolution y haz clic en Configurar para abrir Almacén > Configuración > Configuración.

Abre Almacén > Configuración > Almacenes y crea o selecciona un almacén activo. Elige el almacén predeterminado de forma deliberada. Puedes usar MAIN como referencia, pero la instalación no crea un almacén MAIN por ti. ID del almacén predeterminado tiene inicialmente el valor 0.

Usa un solo material y producto para la primera prueba de principio a fin. Configura stock, vínculos de productos, cron y reservas antes de confiar en el módulo para preparar pedidos reales.

El back office está organizado de la siguiente manera:

Warehouse
- Dashboard

Settings
- Warehouses
- Configuration
- Data Management
- Layout Editor
- Zones
- Code Schemas
- Holidays
- System Check
- License
- Support
- Update

Catalog
- Materials
- Recipes
- Product Links
- Bill of Materials
- Import Data

Inventory
- Stock Levels
- Reservations
- Corrections
- Stock Positions
- Stock Taking
- Internal Docs (PW/RW)

Procurement
- Suppliers
- Purchase Orders
- Suggest Reorder
- Receiving
- Stock Planning

Fulfillment
- Shipments
- Returns (RMA)
- Carriers
- Order Fulfillment
- Returns

Reports

Usa Configuración > Editor de diseño, Zonas y Esquemas de código cuando necesites ubicaciones físicas y numeración de documentos. Las zonas pueden describir ubicaciones de recepción, embalaje, envío, devoluciones y almacenamiento. Una configuración con un único almacén no requiere un plano detallado al principio.

En Catálogo > Materiales, crea cada artículo de stock interno. Crea las Recetas y sus componentes si un producto consume varios materiales o subrecetas. En Enlaces de producto, vincula el producto o la combinación de PrestaShop al material o la receta y establece la cantidad consumida. Consulta Lista de materiales para revisar las necesidades de componentes resultantes.

Introduce el stock inicial de materiales en Inventario > Niveles de stock o mediante el importador. Comprueba las unidades y las referencias de almacén antes de sincronizar las cantidades nativas de los productos. El módulo calcula las cantidades vendibles a partir del stock vinculado y las necesidades de componentes; un vínculo a una receta sin stock de sus componentes no constituye una configuración completa.

Abre Almacén > Configuración > Configuración. Guarda en el contexto de tienda previsto.

• Activar varios almacenes. Permite gestionar stock en más de un almacén; valor predeterminado: 0.
• ID del almacén predeterminado. Selecciona el almacén usado de forma predeterminada para envíos y cálculos de stock; valor predeterminado: 0.
• Sincronizar stock con PrestaShop. Actualiza las cantidades nativas de productos PrestaShop a partir del stock de almacenes/materiales; valor predeterminado: 1.
• Activar alertas de stock. Activa la lógica de alertas de stock bajo; valor predeterminado: 1.
• Umbral predeterminado de stock bajo. Establece el umbral de cantidad de respaldo para el stock bajo; valor predeterminado: 10.
• Activar lista de materiales. Activa las recetas de materiales y el stock de productos basado en componentes; valor predeterminado: 1.
• Deducir componentes automáticamente al despachar. Deduce los materiales de los componentes cuando se despacha un envío; valor predeterminado: 1.
• Factor de seguridad predeterminado. Establece el multiplicador de seguridad de la planificación de stock, donde 1 significa que no hay margen adicional; valor predeterminado: 1.
• Plazo de aprovisionamiento predeterminado. Establece el plazo de aprovisionamiento de respaldo del proveedor/material en días para la planificación de stock; valor predeterminado: 120.

Mantén activada la sincronización nativa de stock solo cuando el stock del almacén deba ser la fuente de los productos vinculados. Revisa también las opciones de sincronización por producto en Enlaces de producto. Elige el umbral de stock bajo, el plazo de aprovisionamiento y el factor de seguridad según tu flujo real de reposición.

Debajo del formulario estándar, Almacén principal por país permite elegir el almacén principal para los países de entrega. Los países sin asignar usan el almacén predeterminado. Comprueba Se resuelve en y haz clic en Guardar almacenes principales para guardar este panel de asignación independiente. Es un mapa de países configurado, no un cálculo del almacén más cercano.

• Crear envíos automáticamente al realizar un pedido. Crea registros de envío automáticamente con los valores none, dropship_only o all; valor predeterminado: none.
• Selección de almacén para envíos automáticos. Elige el almacén para la creación automática de envíos mediante default, first_available o most_stock; valor predeterminado: default.
• Establecer automáticamente el estado del pedido al enviar. Muestra y preselecciona un estado de pedido al crear envíos; valor predeterminado: 1.
• Estado del pedido - enviado por completo. Establece el estado de pedido sugerido cuando se han enviado todos los artículos del pedido; valor predeterminado: 4.
• Estado del pedido - enviado parcialmente. Establece el estado de pedido sugerido cuando quedan artículos sin enviar, donde 0 significa no cambiar; valor predeterminado: 0.
• Notificar al cliente - envío completo. Establece la selección predeterminada de la casilla de notificación al cliente para envíos completos; valor predeterminado: 1.
• Notificar al cliente - envío parcial. Establece la selección predeterminada de la casilla de notificación al cliente para envíos parciales; valor predeterminado: 0.
• Bloquear correo de falta de stock. Bloquea el correo nativo de PrestaShop de falta de stock cuando el módulo gestiona el flujo de envío; valor predeterminado: 1.
• Periodo de gracia tras el despacho. Establece cuántos minutos se esperan antes de confirmar la deducción de stock tras el despacho; valor predeterminado: 5.
• Hora límite de envío. Establece la hora límite en formato de 24 horas usada para las estimaciones predeterminadas de envío en el mismo día; valor predeterminado: 15.
• Días de tránsito predeterminados. Establece el plazo de transporte de respaldo en días laborables cuando el transportista no tiene un valor de tránsito; valor predeterminado: 3.
• Divisas de costes. Establece las divisas de costes separadas por comas, con la primera como predeterminada; valor predeterminado: GBP,EUR,PLN.
• Motivos de corrección. Establece un motivo de corrección por línea para la ventana modal de corrección del envío; valor predeterminado: Shipped wrong item; Damaged in transit; Customer return; Quantity error; Quality issue; Missing from package; Other.
• Activar seguimiento de envíos. Muestra el seguimiento de envíos en la cuenta del cliente y las páginas de detalles del pedido; valor predeterminado: 1.
• Activar avisos de envío por correo. Envía los correos de envío del módulo cuando el seguimiento está activado; valor predeterminado: 1.
• Activar imágenes de envíos. Permite al personal subir fotos de paquetes y documentos a los envíos; valor predeterminado: 1.
• Tamaño máximo de imagen. Establece el tamaño máximo de subida de imágenes de envío en MB; valor predeterminado: 5.
• Imágenes visibles para clientes por defecto. Hace que las imágenes de envío subidas sean visibles para los clientes de forma predeterminada, en lugar de solo para administradores; valor predeterminado: 0.

Usa Crear envíos automáticamente al realizar un pedido = none para una primera prueba manual. Si activas la creación automática, elige dropship_only o all y verifica la estrategia de selección de almacén con pedidos representativos. Las estrategias disponibles son almacén predeterminado, primer stock disponible y mayor stock.

Comprueba que los ID de estado de pedido configurados coincidan con los estados de tu tienda. Los interruptores de notificación de envío completo/parcial establecen la elección inicial de notificación. Revisa la elección efectiva al procesar un envío. Bloquear correo de falta de stock está activado de forma predeterminada para evitar el correo nativo de falta de stock en el flujo del módulo.

Usa Periodo de gracia tras el despacho para definir la demora antes del registro definitivo del stock de un envío despachado. El valor predeterminado es de 5 minutos. Un planificador debe procesar los envíos pendientes después de esa demora. Prueba el flujo de deshacer/corregir antes de usarlo para despachos reales.

Motivos de sustitución de artículos añade los motivos usados para las sustituciones. Sus valores predeterminados son Fuera de stock, Dañado en el almacén, Descatalogado, Solicitud del cliente, Más adecuado para el pedido, Problema de calidad y Otro. Mantén cada motivo en una línea independiente, igual que en Motivos de corrección.

El estado de preparación almacenado tiene como valor predeterminado 3 y el minuto de la hora límite de envío 0. No son campos visibles independientes llamados Estado del pedido - preparación o Minuto de la hora límite de envío en el formulario Configuración actual.

En el grupo Stock:

• Activar reservas de materiales. Activa las reservas temporales de materiales desde la fase seleccionada en Inicio de las reservas de stock. Valor predeterminado: 1. Una configuración nueva empieza al acceder a la página del carrito o al proceso de pago, no cada vez que se añade al carrito.

• Duración de la reserva. Establece la duración de la reserva tras un cambio aceptado del carrito. Valor predeterminado: 30 minutos. Está limitada por Periodo máximo de protección; las actualizaciones y los guardados duplicados no la renuevan.

• Inicio de las reservas de stock. Valor predeterminado: cart_page. Reserva al acceder a la página del carrito o al proceso de pago. Puedes elegir en su lugar añadir al carrito o acceder al proceso de pago. El acceso al carrito/proceso de pago requiere JavaScript y una sesión de cliente válida. Un cambio posterior aceptado del carrito puede reservar stock; simplemente verlo o actualizarlo no reinicia una reserva.

• Integración de stock del carrito. Haz clic en Preparar integración de stock del carrito para comprobar la versión instalada de PrestaShop y preparar sus adaptadores nativos. Resuelve los conflictos indicados y recarga la página.

• Reducir el stock disponible por las reservas del carrito. Valor predeterminado: desactivado. Actívalo solo cuando la integración nativa y el worker rápido de stock estén preparados. Una reserva de un componente reduce la disponibilidad de todos los productos vinculados que lo usan; el stock físico del componente no cambia.

• Periodo máximo de protección. Valor predeterminado: 120 minutos. Limita la protección continua de un propietario.

• Pausa entre periodos de protección. Valor predeterminado: 30 minutos. Exige una pausa antes de que ese propietario obtenga nueva protección.

• Carritos protegidos por propietario. Valor predeterminado: 3.

• Unidades de venta protegidas por propietario. Valor predeterminado: 100.

• Cambios por periodo de protección. Valor predeterminado: 60 cambios aceptados de cantidad/receta.

• Carritos protegidos por grupo de stock. Valor predeterminado: 1000 carritos temporales en competencia.

• Máximo de líneas distintas del carrito. Valor predeterminado: 256. Auméntalo solo después de medir carritos más grandes.

• Máximo de grupos de stock por carrito. Valor predeterminado: 128. Un pool representa un material o una receta ensamblada en un almacén.

Revisa estos límites conjuntamente. Los carritos sin reserva temporal pueden seguir sometiéndose a comprobaciones de stock al pagar. Actualizar la página no prolonga la protección. Examina Inventario > Reservas con carritos de prueba y una cantidad de stock controlada.

reservation_use_session_tracking = 1 y reservation_cron_enabled = 0 siguen siendo valores predeterminados almacenados por compatibilidad. No son campos Usar seguimiento de sesión o Activar limpieza por cron independientes en el formulario actual. La tarea de limpieza registrada actualmente se ejecuta mediante el planificador compartido. No dependas del tráfico de visitantes para ejecutar tareas de stock en segundo plano.

Visualización

• Mostrar disponibilidad de stock. Muestra la disponibilidad de stock del almacén en las páginas de producto; valor predeterminado: 1.
• Mostrar detalles del stock. Muestra información detallada de stock cuando la disponibilidad de stock del producto está activada; valor predeterminado: 1.
• Ocultar barra de stock. Oculta la barra de stock del módulo y mantiene utilizable la ventana modal de comprobación mediante los elementos .stock_checker del tema; valor predeterminado: 0.
• Texto de entrega con stock. Establece el texto de la etiqueta de entrega cuando hay stock local disponible; valor predeterminado: Next day delivery.
• Texto de entrega sin stock local. Establece el texto de la etiqueta de entrega cuando solo hay stock del almacén secundario disponible; valor predeterminado: Secondary warehouse · 3-5 business days.

Usa los textos de entrega como mensajes configurados por ti. Estos mensajes se introducen manualmente en lugar de calcularse a partir de datos del transportista. Si tu tema tiene su propio botón de stock, activa Ocultar barra de stock y conserva un elemento .stock_checker con los ID del producto y la combinación para que pueda abrir la ventana modal de comprobación.

El módulo registra stock-availability, my-shipments y my-returns. La página stock-availability también requiere la preferencia almacenada stock_checker_page, cuyo valor predeterminado es 0. No es un campo Configuración normal. Usa la comprobación de stock del producto como primera prueba pública.

Devoluciones (RMA)

• Activar devoluciones (RMA). Permite a los clientes solicitar devoluciones desde su cuenta; valor predeterminado: 1.
• RMA requiere aprobación. Exige aprobación del personal antes de que el cliente envíe una devolución; valor predeterminado: 1.
• Reembolsar automáticamente devoluciones de grado A. Este ajuste no activa reembolsos automáticos. Procesa los reembolsos mediante tu flujo de PrestaShop/pago; valor predeterminado: 0.

Los clientes pueden solicitar devoluciones y ver el seguimiento de envíos en las áreas de cuenta/pedido registradas cuando están activadas. Verifica esos enlaces iniciando sesión como cliente con un pedido de prueba real. El personal aprueba, recibe, inspecciona y resuelve la devolución en Preparación de pedidos > Devoluciones (RMA). Los campos de reembolso registran decisiones; verifica cualquier reembolso real mediante tu flujo de PrestaShop/pago. No consideres Reembolsar automáticamente devoluciones de grado A una prueba de que se ha movido dinero.

Ejecuta el runner cron MPR compartido desde el planificador del servidor. Usa el token cron MPR compartido existente que proporciona la API getCronToken() del módulo o tu administración cron MPR. No es un campo Token cron editable en Almacén > Configuración. El punto de entrada CLI admite:

* * * * * php /var/www/html/modules/mprwarehouserevolution/cron.php --token=YOUR_SHARED_TOKEN --max-tasks=20 --max-seconds=55 --context=cron

Sustituye la ruta de la tienda y el token. Las tareas programadas liberan las reservas caducadas y los compromisos de stock de pedidos finalizados cada 300 segundos, confirman los despachos pendientes cada 60 segundos, procesan el stock de productos en cola mediante CLI cada minuto, recuperan las publicaciones pendientes cada minuto y solicitan una conciliación completa a diario.

El endpoint cron HTTP no puede ejecutar las tareas de stock exclusivas de CLI. Mantén una programación CLI para procesar el stock. El punto de entrada raíz también admite --stock-only para ejecutar su subconjunto de tareas CLI relacionadas con el stock. Comprueba los resultados de las tareas antes de crear programaciones adicionales que se solapen.

Si activas Reducir el stock disponible por las reservas del carrito, supervisa también este breve proceso CLI para que vuelva a ejecutarse a intervalos aproximados de un segundo:

php /var/www/html/modules/mprwarehouserevolution/bin/cart-stock-worker.php --seconds=3 --max-products=20

El worker admite --seconds=1..20, --max-products=1..100 y --quiet. Ejecútalo con el usuario habitual de los procesos de la tienda. Examina su resultado de salud JSON y su código de salida antes de silenciar la salida. Preparar la integración por sí solo no ejecuta el worker.

Abre Almacén > Catálogo > Importar datos. Usa CSV UTF-8 y las plantillas del tipo de entidad seleccionado. El importador acepta punto y coma o coma como delimitadores y ofrece vista previa/preparación, selección de filas y procesamiento por lotes. El límite de su controlador es de 500 MB, sujeto a límites inferiores de PHP/servidor.

Importa en orden de dependencia: almacenes y zonas; proveedores y materiales; recetas y componentes de recetas; vínculos de productos y productos de proveedores; stock; pedidos de compra y sus líneas. Las referencias deben coincidir exactamente con los registros existentes.

Añade una URL de seguimiento personalizada del transportista en Almacén -> Preparación de pedidos -> Transportistas. El módulo sustituye {tracking} o {tracking_number} por el número de seguimiento del envío, y las URL de tipo DHL también pueden usar {locale}.

Code: custom_local
Name: Local Courier
Tracking URL Pattern: https://carrier.example/track?id={tracking}
Transit Time: 2
Active: yes

DHL pattern:
https://www.dhl.com/{locale}/home/tracking.html?tracking-id={tracking}&submit=1

Importa vínculos de productos con archivos CSV UTF-8 separados por punto y coma en Almacén -> Catálogo -> Importar datos.

product_reference;product_attribute_id;item_type;item_reference;quantity;sync_stock
TRAY-1200;0;recipe;SHOWER-TRAY-KIT;1;1
DRAIN-90;0;material;DRAIN-90;1;1

Importa el stock inicial de materiales por referencia de almacén.

material_reference;warehouse_reference;quantity
PANEL-1200;MAIN;25
DRAIN-90;MAIN;40

Crea una receta y sus componentes.

reference;name_en;description_en;assembly_time;assembly_cost;auto_deduct
SHOWER-TRAY-KIT;Shower tray kit;Panel and drain kit;30;5.00;1

recipe_reference;component_type;component_reference;quantity;is_optional
SHOWER-TRAY-KIT;material;PANEL-1200;1;0
SHOWER-TRAY-KIT;material;DRAIN-90;1;0

Usa el botón de stock de tu tema y deja que el módulo abra la ventana modal de comprobación de stock. Funciona con Ocultar barra de stock activado.

<button type="button"
        class="btn btn-secondary stock_checker"
        data-id-product="{$product.id_product|intval}"
        data-id-product-attribute="{$product.id_product_attribute|default:0|intval}">
    Check live stock
</button>

Da estilo a los elementos de stock del front office mediante las clases del módulo.

.mprw-stock-bar {
  border: 1px solid #d9e2ec;
  padding: 12px;
}

.mprw-bar-in-stock {
  color: #127a3a;
}

.mprw-bar-secondary-stock {
  color: #8a5a00;
}

.stock_checker.mprw-price-stock-summary {
  white-space: nowrap;
}

Las plantillas de correo de envío y RMA admiten estos marcadores de posición.

Shipment email:
{firstname}
{lastname}
{email_heading}
{order_reference}
{shipments_text}
{pending_items_text}
{history_url}
{shop_name}
{shop_url}

RMA customer update:
{firstname}
{lastname}
{rma_reference}
{order_reference}
{return_type}
{status_label}
{date_updated}
{message}
{rma_url}
{shop_name}

Usa los ejemplos CSS y de correo solo para las plantillas/clases correspondientes de tu versión instalada. Comprueba un mensaje saliente de envío y otro de RMA después de cambiar las plantillas.

Crea un pedido de prueba con un producto vinculado. Revisa el panel del almacén en la página del pedido del back office, incluidos componentes, artículos del envío, materiales personalizados, incidencias, correcciones, devoluciones, registro de correos e historial de preparación.

Crea el envío, verifica su almacén y cantidades y hazlo avanzar por los pasos aplicables de preparación de artículos, embalaje y despacho. Tras el periodo de gracia, verifica el movimiento y el stock disponible. Usa una corrección explícita cuando se haya registrado un artículo o una cantidad incorrectos. No edites manualmente las tablas de stock.

Para la reposición, crea un proveedor y un pedido de compra y usa Recepción cuando llegue la mercancía. Comprueba por separado las cantidades entrantes y las recibidas. Usa Sugerir reabastecimiento, Planificación de stock y Informes solo cuando los vínculos de materiales, plazos de aprovisionamiento y stock sean correctos.

Para las devoluciones, verifica la recepción y clasifica cada artículo antes de reponerlo en stock o resolver la RMA. Los patrones de URL de seguimiento sustituyen {tracking} o {tracking_number}, y los patrones aplicables también admiten {locale}. Estos enlaces no contratan etiquetas del transportista.

Los estados de envío son:

1 = Pending
2 = Picking
3 = Picked
4 = Packed
5 = Shipped
6 = Delivered
7 = Cancelled

Los estados RMA son:

1 = Requested
2 = Approved
3 = Awaiting return
4 = In transit back
5 = Received
6 = Inspected
7 = Resolved
8 = Rejected
9 = Cancelled

Los grados de calidad de las devoluciones son:

A = Like new - full stock credit
B = Slight damage - refurbished stock
C = Damaged - heavy discount
F = Unsellable - write-off

Los estados de los pedidos de compra son:

1 = Draft
2 = Sent
3 = Confirmed
4 = Partial
5 = Received
6 = Cancelled

Las etiquetas de grado A/B/C/F corresponden a las constantes numéricas internas 1/2/3/4. Usa las opciones de grado del back office en lugar de escribir estos códigos en la base de datos.

Ejecuta Almacén > Configuración > Verificación del sistema. Comprueba el almacén predeterminado, las tablas, los hooks y el estado de la integración instalada. Con un producto de prueba, verifica stock inicial, una reserva de carrito, compromiso de stock del pedido, envío parcial/completo, finalización del periodo de gracia, cancelación/corrección, recepción y reposición mediante RMA. Compara la cantidad nativa del producto con los registros de stock y movimientos del módulo.

Si las cantidades se actualizan con retraso, comprueba el cron CLI, la salud del worker, los interruptores de sincronización y los vínculos de productos antes de introducir correcciones manuales. Si un carrito no reserva inmediatamente, comprueba Inicio de las reservas de stock y los límites de protección. Si falta la barra pública de stock, comprueba los ajustes de Visualización y los hooks del tema. Para enlaces de cuenta ausentes, comprueba ajustes de seguimiento/RMA, inicio de sesión y propietario del pedido. Para fallos de importación, comprueba columnas obligatorias, registros referenciados, codificación y límites de subida del servidor.

Usa los permisos de empleados del back office para las acciones correspondientes de ver/añadir/editar/eliminar. Las escrituras de asignación por país requieren acceso de edición. No concedas un acceso amplio a la base de datos al personal del almacén como sustituto de los permisos del módulo.

Primero haz una copia de seguridad de todos los datos de almacenes, materiales, recetas, vínculos de productos, stock, aprovisionamiento, envíos, devoluciones y movimientos. Desactiva Reducir el stock disponible por las reservas del carrito y mantén el worker de stock en ejecución hasta que haya restaurado la disponibilidad. El módulo bloquea la desactivación/desinstalación mientras sigan activos reservas públicas, restauración o un ticket de transición.

Una vez terminada la restauración, desactiva o desinstala desde el back office. La desinstalación elimina tareas registradas, menús, preferencias de columnas y datos SQL del módulo. Elimina tus propias entradas de supervisión del worker y del planificador cuando dejen de ser necesarias. Vuelve a comprobar las cantidades nativas de stock y el flujo de gestión de stock de sustitución antes de aceptar pedidos.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.