Pedido Rápido B2B (Quick Order) — Guía completa
Instalar, configurar y utilizar el pedido rápido B2B: cuadrícula SKU con autocompletado, importación CSV, pegado desde Excel, listas de recompra y repetición de pedido en un clic para PrestaShop 8 y 9.
Presentación
El módulo Pedido Rápido B2B (dfquickorder) añade una página de entrada rápida donde sus clientes profesionales componen un pedido directamente a partir de sus referencias (SKU), sin recorrer el catálogo. Pueden escribir las referencias una a una con autocompletado, pegar dos columnas desde Excel, importar un archivo CSV, recargar una lista de recompra guardada o repetir un pedido anterior, y luego añadirlo todo al carrito con un clic.
Pensado para el reabastecimiento B2B y los compradores con prisa: un mayorista que conoce sus referencias ahorra un tiempo considerable frente a la navegación producto por producto. La cuadrícula resuelve cada SKU en tiempo real (nombre, precio según el grupo, stock, cantidad mínima, combinación).
Compatibilidad
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Tienda única y multitienda
- 5 idiomas: FR, EN, ES, DE, IT
- Tema Classic y temas personalizados (cuadrícula en JavaScript nativo, sin dependencia de jQuery)
- Sin dependencias (ni Composer ni framework)
Instalación
- En el back office, abra Módulos > Gestor de módulos.
- Haga clic en Subir un módulo y seleccione el archivo
dfquickorder.zip. - Una vez instalado, haga clic en Configurar.
Durante la instalación, el módulo crea su tabla de listas de recompra, registra sus hooks (displayCustomerAccount, displayNav2 y el hook personalizado displayQuickOrderBlock) e inicializa sus ajustes por defecto. Un enlace Pedido rápido aparece entonces en el área de cliente.
Configuración
Acceso y restricción
- Grupos de clientes autorizados: deje vacío para abrir el pedido rápido a todos, o seleccione uno o varios grupos para reservarlo a sus clientes B2B. Los visitantes no autorizados son redirigidos a su cuenta.
Entrada e importación
- Separador CSV: punto y coma, coma, tabulación o barra vertical, según el formato que exporten sus clientes.
- Número de filas por defecto: número de filas vacías mostradas al abrir la cuadrícula.
- Líneas máximas por CSV / pegado: protección contra importaciones demasiado grandes; las líneas que superan el límite se ignoran con un aviso.
Visualización y funciones
- Mostrar precio y subtotal: muestra el precio unitario, el total por línea y el total estimado, calculados según el método fiscal del grupo (sin o con IVA).
- Pegar desde Excel: activa la pestaña para pegar dos columnas (referencia y cantidad).
- Listas de recompra: activa el guardado y la recarga de listas con nombre por cliente.
- Repetición de pedido en un clic: activa la recarga de un pedido anterior en la cuadrícula.
- Botón «Convertir en presupuesto»: se muestra solo si el módulo
dfb2bquoteestá instalado y activo (puente con la gama de presupuestos B2B).
Uso
La cuadrícula de entrada de SKU
El cliente escribe una referencia: un menú de autocompletado sugiere los productos y combinaciones correspondientes (por referencia o por nombre). Al validar, la línea se resuelve en tiempo real y muestra el nombre del producto, la etiqueta de la combinación, el precio unitario según su grupo, el total de línea y un distintivo de estado. Se añade automáticamente una nueva fila vacía a medida que se avanza.
Los estados de línea
- Verde: referencia válida, stock suficiente.
- Naranja: cantidad ajustada (stock parcial disponible o cantidad mínima de venta alcanzada).
- Rojo: referencia desconocida, producto no disponible o sin stock.
La resolución gestiona las combinaciones: una referencia de combinación devuelve el id_product_attribute correcto y su etiqueta de atributos. La búsqueda se realiza por la referencia y, como respaldo, por el código de barras EAN13, respetando la tienda actual y los productos activos.
Pegar desde Excel
En la pestaña Pegar desde Excel, el cliente pega dos columnas (referencia y cantidad) directamente desde su hoja de cálculo. Cada línea se analiza y se resuelve, y luego se inyecta en la cuadrícula con su estado. Una posible fila de encabezado («sku», «referencia»…) se detecta y se ignora.
Importación CSV
En la pestaña Importación CSV, el cliente sube un archivo de dos columnas. El archivo se lee en el navegador y luego se envía para su resolución. Se proporciona una plantilla CSV descargable para guiar el formato esperado. Se aplica el separador configurado en el back office, con respaldo automático a los separadores habituales.
Listas de recompra
Un cliente conectado puede guardar la cuadrícula actual como una lista con nombre (por ejemplo «Reabastecimiento mensual») y recargarla en cualquier momento desde la pestaña Mis listas. Cada lista pertenece al cliente y a la tienda; puede cargarse en la cuadrícula o eliminarse.
Repetir un pedido anterior
La pestaña Repetir pedido enumera los últimos pedidos válidos del cliente. Un clic recarga todas las referencias y cantidades del pedido en la cuadrícula, listas para ajustarse y añadirse al carrito.
Añadir al carrito y convertir en presupuesto
El botón Añadir todo al carrito añade de una vez todas las líneas válidas al carrito, respetando las cantidades. Si el módulo dfb2bquote está activo, el botón Convertir en presupuesto añade las líneas al carrito y luego pasa al recorrido de presupuesto.
Acceso al pedido rápido
El enlace Pedido rápido está disponible en el área de cliente. También puede mostrarlo en la navegación superior y, mediante el hook personalizado displayQuickOrderBlock, insertar un bloque de llamada a la acción donde desee en su tienda.
Preguntas frecuentes y resolución de problemas
La cuadrícula muestra un error «JSON no válido» o no resuelve las referencias
Vacíe la caché de PrestaShop (Parámetros avanzados > Rendimiento) y, durante las pruebas, desactive la combinación/compresión de archivos (CCC). Las respuestas de la cuadrícula son JSON estricto: el módulo descarta cualquier salida parásita antes de responder, lo que evita que un mensaje PHP corrompa la respuesta.
¿Cómo reservo el pedido rápido a mis clientes profesionales?
En la configuración, seleccione el grupo o grupos autorizados en Grupos de clientes autorizados. Todos los demás visitantes no podrán acceder a la página.
¿Se gestionan las combinaciones?
Sí. Una referencia de combinación se resuelve a la combinación correcta, con su propia etiqueta de atributos, precio y stock. El código de barras EAN13 también se acepta como referencia.
¿Qué ocurre si una cantidad supera el stock?
Según el ajuste de gestión de roturas de stock del producto, la cantidad se ajusta al stock disponible (estado naranja) o la línea se marca como agotada (estado rojo). Las referencias no encontradas se señalan sin bloquear el resto de la cuadrícula.
¿Las listas y la repetición de pedido requieren una cuenta?
Sí: guardar listas y repetir pedidos anteriores requieren que el cliente haya iniciado sesión. La entrada de SKU, el pegado y la importación CSV también funcionan para los visitantes autorizados.
¿Es compatible con PrestaShop 9?
Sí. El módulo es compatible con PrestaShop 8 y 9, en multitienda y multilingüe (FR, EN, ES, DE, IT).