Módulo Velleman Dropshipping Componentes Eletrónicos PrestaShop — Catálogo FTP 6 000 Referências (Módulos, Kits, Áudio…)

Módulo PrestaShop de dropshipping VELLEMAN

Está a lançar uma loja de componentes eletrónicos, um site especializado em Arduino / Raspberry / makers DIY, um e-commerce de iluminação cénica ou de áudio profissional? Trabalha com a Velleman Group (grossista belga histórico fundado em 1976, referência europeia em componentes, módulos, kits educativos, sonorização, luz cénica, ferramentas de medição) e passa os dias a copiar 6 000 fichas de produto, a carregar manualmente 25 fotografias por produto, a recriar cada categoria em 10 níveis hierárquicos, a analisar à mão as caraterísticas técnicas detalhadas (Físicas / Elétricas / Técnicas / Instalação), a gerir 10 escalões de preço degressivos consoante os seus volumes de compra?

Com o Módulo Velleman dropshipping componentes eletrónicos módulos kits FTP, tudo se torna automático. Indica os seus acessos FTP Velleman (host, port, user, pass, caminho do seu ficheiro personalizado), clica em "Iniciar a importação" e o módulo descarrega o seu CSV de 64 colunas em Windows-1252, converte-o para UTF-8 célula a célula, descarrega o 2.º CSV de mapeamento de imagens a partir do CDN Velleman (URL fixo no código, invisível para o cliente) e cria os seus ~6 000 produtos PrestaShop numa estrutura em árvore com 10 níveis gerada de forma dinâmica, cada um com a sua ficha PREMIUM em 10 secções (faixa de identidade da marca + EAN + estado, introdução curta, pontos-chave, cards de caraterísticas técnicas, dimensões, embalamento, origem, ecocontribuição, conformidade GPSR UE 2024, CTA do fornecedor), até 25 imagens por produto, e conformidade europeia GPSR alimentada pelo seu formulário dedicado.

⚡ Antes vs Depois do Módulo Velleman

👤 A quem se destina este módulo?

🎯 Funcionalidades completas do Módulo Velleman

🌐 Ligação FTP individual por revendedor

Particularidade Velleman. Cada revendedor parceiro recebe um ficheiro CSV personalizado no servidor FTP Velleman, com as suas próprias condições tarifárias (escalões degressivos específicos da sua conta). O ficheiro tem um nome único (ex.: OSeuFicheiro.csv). Os acessos FTP (host, port, user, pass) nunca são partilhados e mantêm-se estritamente individuais.

Solução adotada pelo módulo: 5 campos FTP nos Parâmetros, nunca codificados de forma fixa, palavra-passe oculta na BD e nas respostas JSON. Botão "Testar a ligação FTP" que valida em direto a autenticação, o modo passivo e a acessibilidade do ficheiro.

5 campos FTP:
- Host       : ftp.velleman.eu (ou variante regional)
- Port       : 21 (predefinido, alterável)
- User       : o seu identificador Velleman B2B
- Password   : oculta na base, nunca apresentada em claro
- Path       : /OSeuFicheiro.csv

• Autenticação + modo passivo via ftp_connect + ftp_login + ftp_pasv (compatível com a quase totalidade das firewalls)
• Verificação do tamanho do ficheiro (ftp_size) antes da descarga para rejeitar ficheiros vazios/corrompidos
• Descarga via curl com URL ftp://user:pass@host:port/path — robusta e com bom desempenho
• Palavra-passe segura: armazenada cifrada, oculta na resposta JSON (• repetidos), nunca registada em log

📊 CSV de 64 colunas Windows-1252 — Análise robusta

O CSV Velleman tem 64 colunas sem cabeçalho (primeiro registo = dados, não cabeçalhos), codificado em Windows-1252 (legado europeu) com separador ponto e vírgula. O módulo trata destas particularidades herdadas:

• Mapeamento simbólico em 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. Sem magic numbers, código legível e fácil de manter.
• Conversão Windows-1252 → UTF-8 célula a célula via mb_convert_encoding() com deteção prévia se já é UTF-8 válido
• Análise decimal europeia: vírgula → ponto automático em preços, pesos, dimensões
• Fix leading dot: ".354" → "0.354" automático (caso contrário o cast float faz disparates)
• Streaming por ficheiros JSON: 1 linha CSV → 1 ficheiro uploads/state/full_import_rows/<idx>.json para permitir a retoma exata após interrupção

📸 Multi-imagens até 25 por produto via CDN Velleman

Inovação própria do módulo Velleman: um 2.º CSV de mapeamento de imagens é descarregado automaticamente do CDN Velleman público (URL fixa no código, nunca visível para o cliente) que associa cada SKU a uma lista de URLs de imagens do produto (até 25 vistas). O módulo divide, valida cada URL e importa todas as imagens pela ordem.

• 1.º URL = capa automaticamente
• Validação HEAD HTTP (curl NOBODY) antes da descarga: URLs partidos rejeitados sem fazer cair a importação
• Cache de 24h: o mapeamento é recarregado automaticamente apenas se tiver mais de 24h, poupando largura de banda
• Geração automática de todos os tamanhos PS (small, medium, large, home_default…)
• Fix BO PrestaShop 9 incluído: cópia 1:1 do ficheiro original <id>.jpg além das variantes (caso contrário, imagem partida na página de edição de produto do BO)

🏆 Descrição PREMIUM gerada automaticamente — 10 secções ativáveis

O módulo compõe automaticamente uma ficha de produto visualmente rica, estruturada em 10 secções ativáveis de forma independente através de switches no separador Opções. Cada secção tem o seu design, as suas cores, os seus ícones, o seu objetivo SEO/conversão:

Todas as secções podem ser ativadas/desativadas individualmente no separador Opções. Pode ativar tudo para fichas muito ricas, ou desligar tudo exceto a identidade + o CTA para um aspeto mais sóbrio.

✅ Conformidade GPSR UE 2024 — Formulário dedicado

O regulamento GPSR (General Product Safety Regulation) da União Europeia, em vigor desde 13 de dezembro de 2024, obriga todos os e-commerciantes da zona a apresentar em cada ficha de produto os contactos do fabricante (e do representante UE caso o fabricante esteja fora da UE). Incumprimento = coima.

Solução adotada pelo módulo: um painel dedicado no separador Parâmetros com 5 campos todos opcionais que preenche apenas uma vez. Os contactos são apresentados automaticamente em todas as fichas de produto Velleman.

• Nome do fabricante (ex.: "Velleman Group NV")
• Morada postal completa (rua, código postal, cidade, país)
• E-mail de contacto (apresentado clicável via mailto:)
• Telefone (apresentado clicável via tel:)
• Representante UE (apenas se o fabricante estiver fora da UE — deixar vazio para a Velleman Bélgica)

Apresentação condicional inteligente: a secção GPSR só é apresentada nas fichas de produto se pelo menos um campo estiver preenchido. Pode arrancar sem GPSR, o módulo não falha. Formato visual em vermelho-claro para realçar o seu caráter regulamentar.

💰 10 escalões de preço degressivos Velleman

A Velleman oferece até 10 escalões de preço degressivos consoante as quantidades de compra (tipicamente: 1, 5, 10, 25, 50, 100, 250, 500, 1000, 5000+). Cada escalão tem o seu próprio preço sem IVA negociado no seu contrato B2B Velleman.

Solução adotada pelo módulo: um seletor nos Parâmetros para escolher o escalão que corresponde ao seu volume de compra médio real. O módulo utiliza esse escalão como preço de custo único para calcular o preço de venda final consoante o seu modo (margins / fixed / wholesale).

• Seletor de escalão: 1 / 5 / 25 / 100 / 500 (predefinição: 5, o mais comum para PME)
• Modo margins: 6 escalões de margem configuráveis por faixa de preço sem IVA
• Modo fixed: 1 markup em % aplicado uniformemente (ex. 50%)
• Modo wholesale: preço de compra sem IVA inalterado (venda B2B a escolas, makers spaces, etc.)

🌳 Hierarquia de categorias com 10 níveis

O CSV Velleman fornece até 10 colunas "Título de categoria 1..10" formando uma hierarquia linear profunda (raiz → filha → neta → bisneta…). Cada produto pertence a uma folha no fim de uma cadeia de categorias.

Solução adotada pelo módulo: criação dinâmica das categorias em falta sob a sua raiz PrestaShop configurada. Lookup antes da criação (anti-duplicação) com query SQL otimizada.

Exemplo:
"Componentes Eletrónicos e Acessórios"
  → "Componentes eletrónicos"
    → "Condensadores"
      → "Tântalo"
        → "Altura baixa"
          → ...

• Criação multilingue sob a sua raiz PS (todas as línguas ativas recebem o mesmo nome + slug)
• Lookup antes do create: SELECT por nome + parent → se encontrada, reutiliza-se o ID existente
• Ligação de produto completa: id_category_default = folha mais profunda, category_product preenchido com toda a cadeia (filtros facetedsearch funcionam em todos os níveis)
• Slug automático via VlCompat::slug() (URL-safe, acentos normalizados)

⚡ Arquitetura de importação em tempo real + CRON 24/7

⏰ CRON 24/7 — 4 ações automatizadas

• Chave secreta de 32 carateres hexa gerada na instalação — os seus URLs CRON não podem ser adivinhados
• Regeneração com 1 clique da chave em caso de fuga
• Relançamento automático assíncrono via curl loopback: re-chamada em segundo plano se o time-budget for atingido (60s por predefinição), sobrevivência via @ignore_user_abort(true)
• Retoma exata: retoma exatamente na linha onde parou
• Lock anti-concorrência via flock: sem execuções paralelas
• Botão Stop no BO para parar de forma limpa um CRON em curso (flag file)
• Limite de produtos por execução configurável (10-100 para validar em modo de teste, 0 = ilimitado em produção)
• Flash "tarefa lançada em segundo plano" imediato ao clicar em Teste no BO — fica a saber logo que o servidor está a trabalhar

🏷️ O catálogo Velleman em números

Universo de produtos do catálogo Velleman (excerto por grandes famílias):

Marcas internas Velleman: Velleman Kit (kits de soldadura), Velleman Modules, Vellight (iluminação), HQ Power (áudio profissional), Vonyx, Skytec, Showtec, BoomTone DJ, PERFECT (segurança), Toolland (ferramentas), Velleman EDU (educação).

🛠️ Manutenção — Eliminação seletiva

• ☐ Produtos importados: deteção em 2 fontes (tabela meta + id_supplier), compatível com PS9 multi-shop com fallback wipe SQL caso Product::delete() devolva false
• ☐ Categorias vazias: varrimento por profundidade descendente via nleft/nright, eliminação apenas se não houver produtos associados nem subcategorias (preserva as raízes PS_HOME, PS_ROOT)
• ☐ Marca Velleman: elimina o manufacturer apenas se já não tiver nenhum produto associado (dupla confirmação obrigatória)
• ☐ Registos internos: truncate das tabelas history e import_errors

Confirmação simples ou dupla consoante o âmbito, com separador dedicado Ferramentas → Eliminação seletiva. A árvore de categorias é preservada se tiver produtos noutros locais (não-Velleman) que ainda as utilizem.

⭐ 12 razões para escolher o Módulo Velleman

1. 🌐 Ligação FTP individual por revendedor (5 campos) — cada cliente tem o seu ficheiro numerado, os seus escalões pessoais
2. 📸 Multi-imagens até 25 vistas/produto via 2.º CSV CDN (URL fixa invisível para o cliente) — inovação própria Velleman
3. 🏆 Descrição PREMIUM com 10 secções ativáveis individualmente (faixa, introdução, pontos-chave, cards técnicos, dimensões, embalamento, origem, eco, GPSR, CTA)
4. ✅ Conformidade GPSR UE 2024 via formulário dedicado (5 campos opcionais) — apresentação automática em todas as fichas
5. 🌳 10 níveis de categorias hierárquicas criadas de forma dinâmica — gestão de árvores profundas específicas de componentes
6. 💰 10 escalões de preço degressivos Velleman + seletor de preço de compra nos Parâmetros
7. 🔬 Análise inteligente das caraterísticas detalhadas (col 63): 1 secção = 1 card visual (Físicas / Elétricas / Técnicas / Instalação)
8. 🌍 Codificação Windows-1252 convertida automaticamente para UTF-8 célula a célula (preserva "Métré", "Réservé", carateres técnicos europeus)
9. 🔢 Decimais com vírgula + prefixos com ponto autocorrigidos (ex.: .354 → 0.354 — caso contrário o cast float falha)
10. ⚡ Importação em tempo real produto a produto: barra em direto, registo de consola, botão Parar, retoma exata
11. ⏰ CRON 24/7 seguro com time-budget, relançamento assíncrono automático, retry, lock, modo de teste, limitador de produtos
12. 💎 Sem AdminController, sem Tab BO, sem override: não polui o seu menu, não estraga os seus outros módulos

🎬 Como funciona em 5 passos

🔧 Compatibilidade técnica

❓ Perguntas frequentes

📦 Módulo desenvolvido pela WebPoint · webpoint.fr · Atualizações regulares · Código limpo e comentado