# Pedido Rápido B2B (Quick Order) — Guía completa
> 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…
- Página:
- Idioma: es
- Actualizado el: 2026-06-24
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfquickorder/index.md), [en](https://www.datafirefly.com/en/documentation/dfquickorder/index.md), [de](https://www.datafirefly.com/de/documentation/dfquickorder/index.md), [it](https://www.datafirefly.com/it/documentation/dfquickorder/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfquickorder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfquickorder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfquickorder/index.md)
- Índice:
## 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
1. En el back office, abra **Módulos > Gestor de módulos**.
2. Haga clic en **Subir un módulo** y seleccione el archivo `dfquickorder.zip`.
3. 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 `dfb2bquote` está 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).