Módulo Óptica PrestaShop: instalación y configuración

Presentación

El módulo dfopticlens permite vender gafas graduadas en PrestaShop 8 y 9. En la ficha de una montura, el cliente elige un tipo de lente, introduce su receta, elige una lente entre los índices propuestos, añade tratamientos y confirma un resumen. El servidor controla cada valor, calcula el precio y comprueba que la graduación se puede montar en la montura. El precio de las lentes se suma a la línea de la montura mediante la personalización nativa de PrestaShop, y la receta acompaña al pedido hasta la factura.

Instalación

1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y envíe dfopticlens-1.1.0.zip.
2. La instalación crea el menú Vender > Óptica con cuatro páginas: Recetas, Monturas, Lentes e índices, Tratamientos.
3. Se crean cinco lentes (1.50, 1.59 policarbonato, 1.60, 1.67, 1.74) y siete tratamientos con precios de ejemplo. Ajústelos antes de la puesta en marcha.
4. Se crea la carpeta upload/dfopticlens/, protegida por un archivo .htaccess: los archivos de recetas nunca son accesibles desde la web.

Actualización desde la 1.0.0: suba el ZIP 1.1.0 encima. El script de actualización añade los nuevos ajustes y hooks sin perder datos.

Configuración del módulo

La página de configuración (botón Configurar del módulo) agrupa los ajustes en tres bloques.

Introducción de la receta

• Convención de cilindro enviada al laboratorio: cilindro negativo, positivo o tal como se escribió. El cliente siempre introduce los valores de su receta; la transposición se hace al guardar.
• Envío del archivo de la receta: desactivado, opcional u obligatorio, con un tamaño máximo en MB. Formatos aceptados: PDF, JPG, PNG, comprobados por su contenido.
• Avisar cuando la receta tenga más de X años (0 desactiva).
• Eliminar las recetas de carritos abandonados tras X días.
• Envío del archivo desde la cuenta tras el pedido: añade la página Mis recetas a la cuenta del cliente.
• Opción No conozco mi distancia pupilar y distancia pupilar media utilizada (63 mm por defecto). El pedido se marca entonces como por revisar.

Reglas de viabilidad

• Bloquear las lentes que no se pueden fabricar: activado por defecto. Desactivado, el pedido se acepta con un aviso.
• Margen de biselado y margen del diámetro efectivo cuando se desconoce el ED de la montura (ED estimado = A + margen).
• Altura mínima para progresivas (28 mm) y pasillo corto por debajo de (32 mm).
• Umbrales de aviso: diferencia entre ojos, descentramiento por ojo, potencia positiva en monturas ranuradas.
• Grosor objetivo de la lente recomendada, grosor central de las lentes negativas y de borde de las positivas (al aire o no).

Precios

• Precios introducidos con IVA o sin IVA. Se aplica a las lentes la regla de impuestos del producto montura.
• Suplementos por alta potencia y cilindro alto: umbral en dioptrías e importe (0 desactiva).

Lentes e índices

En Vender > Óptica > Lentes e índices, cada lente tiene:

• un nombre y una descripción corta visibles para el cliente, en cada idioma;
• el índice de refracción, usado para estimar el grosor, y el material para la hoja de taller;
• los tipos de lente en los que se ofrece y un precio por par para cada uno: monofocal, progresiva, sin graduación;
• la esfera mínima y máxima y el cilindro máximo (valor absoluto, leídos en cilindro negativo como los rangos de los fabricantes);
• el mayor diámetro de lente en bruto disponible (0 desactiva el control) y si se puede taladrar para monturas al aire.

Tratamientos

En Tratamientos, cada tratamiento tiene un precio por par (0 lo muestra como incluido). El grupo exclusivo impide combinar dos tratamientos: los que llevan el mismo código, por ejemplo tint para fotocromático, tinte solar y polarizado, se excluyen entre sí. También puede limitar un tratamiento a ciertas lentes, por ejemplo el polarizado a los índices 1.50 y 1.60.

Monturas

Una montura vincula un producto, o una de sus combinaciones, con sus medidas. El bloque de lentes solo aparece en los productos con una montura activada.

Crear una montura

1. En Monturas, haga clic en Añadir una montura, o desde la ficha del producto, pestaña Módulos, en Añadir las medidas de la montura.
2. Busque el producto por nombre, referencia o ID y elija Todas las combinaciones o una combinación concreta. Una montura definida para una combinación tiene prioridad.
3. Indique el tipo (completa, ranurada, al aire), el ancho de la lente A, el puente DBL y la altura de la lente B, obligatorios. Son los números impresos en la varilla: 52□18 da A = 52 y DBL = 18.
4. Opcional: el diámetro efectivo ED (si no, se estima) y la potencia máxima que admite la montura.
5. Marque los tipos de lente ofrecidos y, si hace falta, Vender solo con lentes.

Con Vender solo con lentes, el botón nativo del carrito abre la elección de lentes. Si una llamada directa al carrito añade igualmente la montura sola, el módulo la retira del carrito.

Importación y exportación CSV

El botón Exportar CSV genera un archivo con el formato correcto. La importación acepta punto y coma o coma y estas columnas:

product;combination;frame_type;lens_width;lens_height;bridge;ed;max_power;vision_types;lens_required;active

• product: ID o referencia del producto; combination: ID o referencia de la combinación, vacío o 0 para todas.
• frame_type: full, semi o rimless; vision_types: single|progressive|plano.
• Una montura existente (mismo producto y combinación) se actualiza. Las líneas rechazadas se listan con su número.

El botón Resincronizar productos reconstruye los campos de personalización de los productos, útil si un empleado sin permisos sobre el módulo modificó productos.

Recorrido del cliente

1. Tipo: monofocal, progresiva o sin graduación, según lo que ofrezca la montura. Sin graduación, se salta el paso de la receta.
2. Receta: tabla OD / OI, distancia pupilar en uno o dos valores, fecha, archivo y nota para el óptico. Un cliente conectado puede reutilizar la receta de un pedido anterior.
3. Lente: tarjetas con precio por par, corte a escala, grosor estimado y lente recomendada. Las lentes imposibles aparecen en gris con el motivo.
4. Tratamientos: los no disponibles para la lente elegida aparecen en gris.
5. Resumen: estado de viabilidad, notas, detalle del precio y total de montura y lentes.

Los datos se conservan si el cliente recarga la página y se borran tras añadir al carrito.

Reglas de viabilidad

Los cálculos se hacen sobre la forma en cilindro negativo. El grosor se estima con la fórmula de la sagita: sirve para comparar índices, no es el cálculo del laboratorio.

Precios, descuentos y factura

El precio de las lentes se guarda sin IVA en la personalización de la línea del carrito. PrestaShop lo suma al precio de la montura y aplica el IVA del producto. Si la montura tiene una reducción en porcentaje (precio específico o grupo de clientes), PrestaShop la aplica también a las lentes: el panel muestra el precio tachado y una línea Promoción de la montura aplicada también a las lentes, para que el total anunciado coincida con el carrito.

Pedidos y hoja de taller

• La página del pedido en el back-office muestra un bloque por receta: valores transpuestos, lente, tratamientos, medidas de la montura, descentramiento y lente en bruto mínima por ojo, notas de viabilidad y detalle del precio.
• Imprimir la hoja de taller abre una página A4 lista para imprimir.
• Descargar el archivo de la receta recupera el escaneo enviado por el cliente.
• Vender > Óptica > Recetas lista todas las recetas con su estado: OK, por revisar, no viable.

Cuenta del cliente: Mis recetas

Un cliente que ha pedido lentes ve el enlace Mis recetas en su cuenta. La página muestra cada receta con el pedido vinculado. Si el envío del archivo es opcional y el cliente no lo adjuntó, puede enviarlo desde esta página; el óptico lo encuentra después en el pedido.

Datos de salud y RGPD

• Los archivos de recetas se guardan fuera de la carpeta pública y solo se descargan desde el back-office.
• Las recetas de carritos nunca pedidos se eliminan tras el plazo configurado, junto con la línea de carrito correspondiente.
• Con el módulo oficial psgdpr, la exportación y eliminación de los datos de un cliente incluyen sus recetas.

Solución de problemas

El bloque de lentes no aparece en la ficha del producto

Compruebe que el producto tiene una montura activada y que el tema muestra el hook displayProductAdditionalInfo. Vacíe la caché de PrestaShop.

El botón nativo del carrito no abre el panel en una montura con lentes obligatorias

El módulo intercepta los botones con data-button-action="add-to-cart". Si su tema usa otro atributo, el bloqueo en el servidor sigue activo: la montura sola se retira del carrito.

El total del panel difiere del carrito

Una reducción de importe fijo solo se aplica a la montura y una regla de carrito (cupón) se aplica a todo el carrito: no aparecen en el panel de lentes.