Módulo Velleman Dropshipping Componentes Electrónicos para PrestaShop — Catálogo FTP 6 000 Referencias (Módulos, Kits, Audio)

Módulo PrestaShop de dropshipping VELLEMAN

¿Está lanzando una tienda de componentes electrónicos, un sitio especializado en Arduino / Raspberry / makers DIY, un e-commerce de iluminación escénica o de audio profesional? Trabaja con Velleman Group (mayorista belga histórico fundado en 1976, referente europeo en componentes, módulos, kits educativos, sonorización, luz escénica, herramientas de medida) y se pasa los días copiando manualmente 6 000 fichas de producto, subiendo manualmente 25 fotos por producto, recreando cada categoría sobre 10 niveles jerárquicos, parseando a mano las características técnicas detalladas (Físico / Eléctrico / Técnico / Instalación), gestionando 10 escalones de precios decrecientes según sus volúmenes de compra?

Con el Módulo Velleman dropshipping componentes electrónicos módulos kits FTP, todo se vuelve automático. Introduce sus accesos FTP Velleman (host, puerto, usuario, contraseña, ruta de su archivo personalizado), hace clic en "Iniciar importación", y el módulo descarga su CSV de 64 columnas en Windows-1252, lo convierte a UTF-8 celda por celda, descarga el 2.º CSV de mapeo de imágenes desde el CDN Velleman (URL embebida invisible al cliente), y crea sus ~6 000 productos PrestaShop en una arborescencia de 10 niveles generada al vuelo, cada uno con su ficha PREMIUM de 10 secciones (banner identidad marca + EAN + estado, intro corta, puntos clave, cards de características técnicas, dimensiones, embalaje, origen, eco-contribución, conformidad GPSR UE 2024, CTA proveedor), hasta 25 imágenes por producto, y conformidad europea GPSR alimentada por su formulario dedicado.

⚡ Antes vs Después del Módulo Velleman

👤 ¿A quién va dirigido este módulo?

🎯 Funcionalidades completas del Módulo Velleman

🌐 Conexión FTP individual por revendedor

Particularidad de Velleman. Cada revendedor partner recibe un archivo CSV personalizado en el servidor FTP Velleman, con sus propias condiciones tarifarias (escalones decrecientes específicos de su cuenta). El archivo lleva un nombre único (ej.: SuArchivo.csv). Los accesos FTP (host, puerto, usuario, contraseña) nunca se comparten y permanecen estrictamente individuales.

Solución adoptada por el módulo: 5 campos FTP en Ajustes, nunca embebidos, contraseña enmascarada en la BD y en las respuestas JSON. Botón "Probar conexión FTP" que valida en directo la autenticación, el modo pasivo y la accesibilidad del archivo.

5 campos FTP:
- Host       : ftp.velleman.eu (o variante regional)
- Puerto     : 21 (por defecto, modificable)
- Usuario    : su identificador Velleman B2B
- Contraseña : enmascarada en la base, nunca mostrada en claro
- Ruta       : /SuArchivo.csv

• Autenticación + modo pasivo vía ftp_connect + ftp_login + ftp_pasv (compatible con casi todos los firewalls)
• Verificación tamaño archivo (ftp_size) antes de descargar para rechazar archivos vacíos/corruptos
• Descarga curl vía URL ftp://user:pass@host:port/path — robusto y eficiente
• Contraseña segura: almacenada cifrada, enmascarada en la respuesta JSON (• repetidos), nunca registrada

📊 CSV 64 columnas Windows-1252 — Parseo robusto

El CSV Velleman tiene 64 columnas sin cabecera (primer registro = datos, no encabezados), codificado en Windows-1252 (legacy europeo) con separador punto y coma. El módulo gestiona estas particularidades heredadas:

• Mapeo simbólico en constantes PHP: COL_SKU=0, COL_NAME=1, COL_INTRO=2, COL_RECYCLE_NAME=23, …, COL_CAT_FROM=37, COL_CAT_TO=46, COL_PACKAGING=53, COL_STOCK=58, COL_BULLETS=61, COL_TECH_DETAILS=62. Sin más magic numbers, código legible y mantenible.
• Conversión Windows-1252 → UTF-8 celda por celda vía mb_convert_encoding() con detección previa si ya es UTF-8 válido
• Parseo decimal europeo: coma → punto automático en precios, peso, dimensiones
• Fix leading dot: ".354" → "0.354" automático (de lo contrario el cast float hace cualquier cosa)
• Streaming por archivos JSON: 1 línea CSV → 1 archivo uploads/state/full_import_rows/<idx>.json para permitir la reanudación precisa tras interrupción

📸 Multi-imágenes hasta 25 por producto vía CDN Velleman

Innovación propia del módulo Velleman: un 2.º CSV de mapeo de imágenes se descarga automáticamente desde el CDN Velleman público (URL embebida en el código, nunca visible para el cliente) que asocia cada SKU a una lista de URLs de imágenes del producto (hasta 25 vistas). El módulo divide, valida cada URL e importa todas las imágenes en orden.

• 1.ª URL = portada automáticamente
• Validación HEAD HTTP (curl NOBODY) antes de descargar: URLs rotas se rechazan sin colapsar la importación
• Caché 24h: el mapeo se recarga automáticamente solo si tiene más de 24h, ahorra ancho de banda
• Generación auto de todos los tamaños PS (small, medium, large, home_default…)
• Fix BO PrestaShop 9 incluido: copia 1:1 del archivo original <id>.jpg además de las variantes (de lo contrario imagen rota en la página de edición de producto BO)

🏆 Descripción PREMIUM autogenerada — 10 secciones activables

El módulo compone automáticamente una ficha de producto visualmente rica, estructurada en 10 secciones activables independientemente mediante interruptores en la pestaña Opciones. Cada sección tiene su diseño, sus colores, sus iconos, su objetivo SEO/conversión:

Todas las secciones son activables/desactivables individualmente en la pestaña Opciones. Puede activar todo para fichas muy ricas, o desactivar todo excepto identidad + CTA para un acabado depurado.

✅ Conformidad GPSR UE 2024 — Formulario dedicado

El reglamento GPSR (General Product Safety Regulation) de la Unión Europea, en vigor desde el 13 de diciembre de 2024, obliga a todos los e-commerciantes de la zona a mostrar en cada ficha de producto los datos del fabricante (y del representante UE si el fabricante está fuera de la UE). Incumplimiento = multa.

Solución adoptada por el módulo: un panel dedicado en la pestaña Ajustes con 5 campos todos opcionales que rellena una sola vez. Los datos se muestran automáticamente en todas las fichas de producto Velleman.

• Nombre del fabricante (ej.: "Velleman Group NV")
• Dirección postal completa (calle, código postal, ciudad, país)
• Email de contacto (renderizado clicable vía mailto:)
• Teléfono (renderizado clicable vía tel:)
• Representante UE (solo si fabricante fuera de UE — dejar vacío para Velleman Bélgica)

Visualización condicional inteligente: la sección GPSR solo aparece en las fichas de producto si al menos un campo está rellenado. Puede empezar sin GPSR, el módulo no falla. Formato visual rojo claro para recordar su carácter regulatorio.

💰 10 escalones de precios decrecientes Velleman

Velleman ofrece hasta 10 escalones de precios decrecientes según las cantidades de compra (típicamente: 1, 5, 10, 25, 50, 100, 250, 500, 1000, 5000+). Cada escalón tiene su propio precio sin IVA negociado en su contrato B2B Velleman.

Solución adoptada por el módulo: un selector en Ajustes para elegir el escalón que corresponde a su volumen medio de compra real. El módulo usa este escalón como precio de coste único para calcular el precio de venta final según su modo (margins / fixed / wholesale).

• Selector de escalón: 1 / 5 / 25 / 100 / 500 (por defecto 5, el más habitual para PYME)
• Modo margins: 6 escalones de margen configurables por tramo de precio sin IVA
• Modo fixed: 1 markup en % aplicado uniformemente (ej. 50%)
• Modo wholesale: precio de compra sin IVA inalterado (venta B2B a escuelas, makers space, etc.)

🌳 Jerarquía de categorías en 10 niveles

El CSV Velleman aporta hasta 10 columnas "Título categoría 1..10" formando una jerarquía lineal profunda (root → hijo → nieto → biznieto…). Cada producto pertenece a una hoja al final de una cadena de categorías.

Solución adoptada por el módulo: creación al vuelo de las categorías que falten bajo su raíz PrestaShop configurada. Lookup antes de crear (anti-duplicados) con consulta SQL optimizada.

Ejemplo:
"Componentes Electrónicos y Accesorios"
  → "Componentes electrónicos"
    → "Condensadores"
      → "Tántalo"
        → "Altura baja"
          → ...

• Creación multilingüe bajo su raíz PS (todos los idiomas activos reciben el mismo nombre + slug)
• Lookup antes de crear: SELECT por nombre + padre → si se encuentra, se reutiliza el ID existente
• Vinculación producto completa: id_category_default = hoja más profunda, category_product rellenado con toda la cadena (filtros facetedsearch funcionan en todos los niveles)
• Slug automático vía VlCompat::slug() (URL-safe, acentos normalizados)

⚡ Arquitectura importación tiempo real + CRON 24/7

⏰ CRON 24/7 — 4 acciones automatizadas

• Clave secreta 32 caracteres hex generada en la instalación — sus URLs CRON no se pueden adivinar
• Regeneración con 1 clic de la clave en caso de fuga
• Auto-relanzamiento asíncrono vía curl loopback: auto-llamada en segundo plano si se alcanza el time-budget (60s por defecto), supervivencia mediante @ignore_user_abort(true)
• Reanudación precisa: reanuda exactamente en la línea donde se detuvo
• Lock anti-concurrencia vía flock: sin ejecuciones paralelas
• Botón Stop en BO para detener limpiamente un CRON en curso (flag file)
• Límite productos por ejecución configurable (10-100 para validar en modo test, 0 = ilimitado en producción)
• Flash "tarea lanzada en segundo plano" inmediato al hacer clic en Test BO — sabe enseguida que el servidor trabaja

🏷️ El catálogo Velleman en cifras

Universo de productos del catálogo Velleman (extracto por grandes familias):

Marcas internas Velleman: Velleman Kit (kits de soldadura), Velleman Modules, Vellight (iluminación), HQ Power (audio pro), Vonyx, Skytec, Showtec, BoomTone DJ, Perfect (seguridad), Toolland (herramientas), Velleman EDU (educación).

🛠️ Mantenimiento — Eliminación selectiva

• ☐ Productos importados: detección por 2 fuentes (tabla meta + id_supplier), compatible PS9 multi-tienda con fallback wipe SQL si Product::delete() devuelve false
• ☐ Categorías vacías: barrido por profundidad descendente vía nleft/nright, eliminación solo si cero productos vinculados + cero subcategorías (preserva las raíces PS_HOME, PS_ROOT)
• ☐ Marca Velleman: elimina el manufacturer únicamente si ya no tiene ningún producto vinculado (doble confirmación requerida)
• ☐ Registros internos: truncate de las tablas history e import_errors

Confirmación simple o doble según el alcance, con pestaña dedicada Herramientas → Eliminación selectiva. La arborescencia de categorías se preserva si tiene productos en otra parte (no-Velleman) que aún las usan.

⭐ 12 razones para elegir el Módulo Velleman

1. 🌐 Conexión FTP individual por revendedor (5 campos) — cada cliente tiene su archivo numerado, sus escalones personales
2. 📸 Multi-imágenes hasta 25 vistas/producto vía 2.º CSV CDN (URL embebida invisible al cliente) — innovación propia Velleman
3. 🏆 Descripción PREMIUM 10 secciones activables individualmente (banner, intro, puntos clave, cards técnicas, dimensiones, embalaje, origen, eco, GPSR, CTA)
4. ✅ Conformidad GPSR UE 2024 mediante formulario dedicado (5 campos opcionales) — visualización automática en todas las fichas
5. 🌳 10 niveles de categorías jerárquicas creadas al vuelo — gestión de arborescencias profundas específicas de componentes
6. 💰 10 escalones de precios decrecientes Velleman + selector precio de compra en Ajustes
7. 🔬 Parseo inteligente de características detalladas (col 63): 1 sección = 1 card visual (Físico / Eléctrico / Técnico / Instalación)
8. 🌍 Codificación Windows-1252 auto-convertida a UTF-8 celda por celda (preserva "Métré", "Réservé", caracteres técnicos europeos)
9. 🔢 Decimales con coma + prefijos punteados auto-corregidos (ej.: .354 → 0.354 — de lo contrario el cast float falla)
10. ⚡ Importación tiempo real producto-a-producto: barra en vivo, registro consola, botón Detener, reanudación precisa
11. ⏰ CRON 24/7 seguro con time-budget, auto-relanzamiento asíncrono, retry, lock, modo test, limitador de productos
12. 💎 Sin AdminController, sin Tab BO, sin override: no contamina su menú, no rompe sus otros módulos

🎬 Cómo funciona en 5 pasos

🔧 Compatibilidad técnica

❓ Preguntas frecuentes

📦 Módulo desarrollado por WebPoint · webpoint.fr · Actualizaciones regulares · Código limpio y comentado