Módulo BGS technic de dropshipping - Importação XML para PrestaShop

Módulo PrestaShop de dropshipping BGS TECHNIC

É mecânico, distribuidor de ferramentas, ou está a lançar uma loja online dedicada a ferramentas automóveis e industriais? Trabalha com a BGS technic, o grossista alemão de referência (~9500 produtos: jogos de chaves de caixa, chaves dinamométricas, ferramentas pneumáticas, ferramentas elétricas portáteis, equipamento de oficina…) e passa os dias a importar manualmente cada referência do site deles, a copiar características técnicas, a classificar cada artigo na categoria certa, a carregar fotos uma a uma a partir do CDN deles?

Com o Módulo BGS technic importação ferramentas auto PrestaShop, tudo se torna automático. Indica o URL XML BGS no seu idioma (16 disponíveis), clica em "Iniciar importação", e o módulo cria os seus 9500 produtos PrestaShop com as 290 categorias, imagens, características técnicas, margens, IVA, em streaming em tempo real perante os seus olhos. Tudo, numa só noite.

⚡ Antes vs Depois do Módulo BGS technic

Tarefa	❌ Sem o módulo	✅ Com o módulo
Importar 9500 ferramentas BGS	120h+ manual, copiando do portal B2B BGS	1 clique, 1 noite em segundo plano
Criação de 290 categorias em 4-5 níveis	Criação manual no BO PrestaShop	Auto em tempo real a partir de "Produtos|A|B|C|D"
Imagem personalizada por categoria	Categorias vazias ou imagens Google por defeito	345 imagens JPG incluídas no módulo
Multi-imagens por produto (até 10)	URL desconhecido, é preciso adivinhar /1/, /2/, /3/...	URL pattern auto-construído (1001.webp → /1/, _01 → /2/...)
Características técnicas (Diâmetro, Material...)	Inserção manual em cada ficha de produto	Extração auto a partir de Technische-Daten
Código aduaneiro (HS) + País de origem	Pesquisa manual para cada exportação	Auto como Features filtráveis (Made in CN, D, IT...)
Atualização de preços (BGS muda mensalmente)	Re-importação completa de todo o catálogo	CRON light_sync: apenas preços, 10× mais rápido
Adicionar novos produtos BGS	Re-scan completo ou monitorização manual	Botão "Criar produtos em falta" (pré-filtro SKU)
Margens e preços de venda	Cálculo Excel por escalão	6 escalões % automáticos (200% em preços baixos → 50% em altos)
IVA s/IVA / c/IVA	Cálculo manual produto a produto	Seletor TaxRulesGroup nativo PrestaShop
Servir 16 mercados (idiomas)	Tradução manual de 9500 fichas	16 ficheiros XML BGS (1 por idioma), troca em 30s
Filtrar "Promoções" / "Novidades" temporárias	Estas secções poluem a sua árvore	Filtro auto multilingue (16 idiomas)
Hosting modesto (partilhado)	Erros de servidor frequentes em grandes catálogos	Importação otimizada compatível com qualquer hosting

👤 A quem se destina este módulo?

🎯 Funcionalidades completas do Módulo BGS technic

📥 Importação inteligente e progressiva

• Importação otimizada: compatível com todos os tipos de hosting, mesmo partilhado
• Progresso em tempo real: vê cada produto a aparecer à medida que avança, com barra de progresso e estado de cada linha
• Retoma após interrupção: se fechar a página, a importação pode ser retomada onde parou
• Botão "Iniciar importação" com popup inteligente que o avisa se já existem produtos
• Botão "Criar produtos em falta" (amarelo): pré-filtro inteligente que importa apenas as novidades — ideal para atualizações diárias ultrarrápidas
• Modo "Teste 10 produtos": valide a configuração numa amostra antes da importação completa
• Logs em tempo real: estado de cada produto (criado / atualizado / ignorado / erro)

🗂️ Categorias em árvore com imagens

• 290 categorias em 4-5 níveis criadas automaticamente em tempo real a partir do caminho XML "Produtos|A|B|C|D"
• 345 imagens JPG incluídas no módulo (300×300 px, design unificado) — uma imagem por categoria a TODOS os níveis, não apenas folhas
• Manifest integrado que mapeia cada caminho XML ao seu ficheiro de imagem local
• Fallback CDN BGS: se uma imagem estiver em falta no manifest, o módulo passa automaticamente para o ícone BGS oficial
• Filtros "Promoções" e "Novidades": estas categorias temporárias são automaticamente ignoradas nos 16 idiomas (Promotionen, Akce, Tarjous, Nyheter, Novità, Nieuw, Nyhed, Reduceri, Sales…)
• Categoria raiz configurável: escolha onde criar a árvore na sua loja (sob Início por defeito, ou sob uma categoria à sua escolha)

📸 Multi-imagens de produto com URL pattern inteligente

• Imagem principal (Hauptbild) sempre importada automaticamente como cover
• Switch independente para até 9 imagens adicionais (Zusatzbild1 a Zusatzbild9)
• URL auto-construído segundo o padrão BGS: 1001.webp → /1/1001.webp, 1001_01.webp → /2/1001_01.webp, 1001_09.webp → /10/1001_09.webp. Não tem de configurar nada.
• Resize automático em todos os ImageType do PrestaShop (home_default, large_default, medium_default, small_default, cart_default, thickbox_default…)
• Inserção de imagem na descrição opcional (topo OU fundo, escolha radio) para temas que não mostram a cover em grande

🔧 Características técnicas auto (Features PrestaShop)

• Parser Technische-Daten: "Diâmetro: 60 - 115 mm$Largura: 85 mm$Material: Aço crómio-vanádio..." → Features PS separadas
• Todas as características BGS: Diâmetro, Largura, Material, Cor, Perfil de acionamento, Abertura de chave, Perfil de impressão, Tratamento de superfície, Tamanho de perfil...
• País de origem como feature (CN, D, IT, TW, IND, NL, PL, TUR, VN, DK, E, CZ) para permitir filtros "Made in"
• Código aduaneiro (Zolltarifnr) como feature, indispensável para exportações fora da UE
• Embalagem (VE) como feature (informação de catálogo, não stock — o cliente pode encomendar qualquer quantidade)
• Link YouTube automaticamente inserido no fim da descrição se a BGS fornecer um URL de vídeo
• Faceted search: todas estas features tornam-se filtráveis no front através do módulo oficial PrestaShop facetedsearch

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

Ação	Descrição	Frequência recomendada
full_import	Importação completa: criações + atualizações de todo o catálogo. Longa mas exaustiva.	1× por dia (3:00)
light_sync	Apenas atualização de preços, sem mexer nas imagens. 10× mais rápido do que full_import.	A cada 6h
cleanup_logs	Limpeza de históricos e erros > N dias (retenção configurável, defeito 30 dias)	1× por semana

🔐 Segurança: cada URL CRON contém uma chave secreta de 32 caracteres regenerável a partir do BO. Em caso de fuga, regenera e os URLs antigos são instantaneamente invalidados.

🧪 Modo de teste a partir do BO: um botão "▶" ao lado de cada ação executa a ação real em segundo plano e devolve o resultado JSON no BO. Já não precisa de copiar/colar no curl.

📏 Limitador integrado: um campo "Limite de produtos por execução CRON" (defeito 0 = ilimitado). Se colocar 200, o módulo adiciona automaticamente &max_rows=200 aos URLs e o CRON relança-se sozinho para processar os lotes seguintes. Ideal para hosting partilhado com timeout curto.

💰 Margens e IVA — Mantém o controlo

3 modos de cálculo do preço de venda

• Margens por escalão (recomendado): percentagens diferentes consoante o preço líquido bruto. O módulo é fornecido com 6 escalões comerciais pré-preenchidos:
  • 0–10 € s/IVA → +200% (vende a 30 € o que custa 10 €)
  • 10–30 € s/IVA → +150%
  • 30–80 € s/IVA → +120%
  • 80–200 € s/IVA → +90%
  • 200–500 € s/IVA → +70%
  • 500 €+ s/IVA → +50% (vende a 750 € o que custa 500 €)
  Pode adicionar/remover/modificar cada escalão livremente.
• Margem fixa: uma única percentagem para todo o catálogo. Mais simples, mas menos otimizado comercialmente.
• Preço líquido bruto: nenhuma margem aplicada (venda a preço de custo). Útil para fazer um teste ou para revenda B2B sem margem.

IVA via TaxRulesGroup nativo PrestaShop

O módulo não gere o IVA hardcoded: oferece um seletor das regras fiscais que configurou em Internacional → Impostos → Regras fiscais. Isto permite-lhe:

• Aplicar o IVA português (23% normal, 13% intermédio, 6% reduzido)
• Gerir o IVA europeu por país (um TaxRulesGroup configurado abrange os 27 países da UE com as respetivas taxas)
• Gerir isenções de IVA (regime simplificado)
• Distinguir profissional/particular através dos grupos de clientes PrestaShop

O módulo introduz o preço líquido calculado, e o PrestaShop mostra o ilíquido em tempo real conforme a regra escolhida para cada cliente.

🎚️ 11 switches para personalizar a sua importação

🛠️ Manutenção — Ferramentas integradas

📜 Separador Histórico e Erros

• Histórico dos últimos 50 eventos: downloads XML, inícios/fins de importações, eliminações, regenerações de chave CRON
• Últimos 100 erros com: tipo, índice XML, SKU afetado, mensagem completa
• Filtráveis visualmente, exportáveis manualmente

🗑️ Separador Ferramentas — Eliminação seletiva

• Eliminar todos os produtos importados pela BGS: com segurança (Product::delete via PrestaShop + sqlWipe em backup se Cascade falhar)
• Eliminar as categorias vazias provenientes do XML BGS: sobe das folhas para a raiz, apenas toca nas categorias sem produtos E sem subcategorias
• Eliminar o fornecedor "BGS technic" (apenas se já não houver produtos ligados)
• Esvaziar o histórico e os erros (TRUNCATE direcionado nas tabelas do módulo)

⚠️ Segurança: estas ações NUNCA tocam noutros produtos/categorias/fornecedores da sua loja. O módulo identifica apenas os seus próprios dados importados e preserva todo o resto.

🏷️ O catálogo BGS technic em números

🛠️ Famílias de produtos cobertas pela BGS technic

• Caixas de chaves de caixa e aperto (sortidos, chaves de caixa especiais, extratores)
• Chaves de roquete e extensões (chaves dinamométricas, multiplicadores de binário)
• Ferramentas especiais para veículos motorizados (motor, acessórios, distribuição)
• Ferramentas especiais moto / bicicleta / veículos comerciais e camiões
• Equipamento de oficinas (drenagem de óleo, elevadores, carrinhos de ferramentas)
• Acessórios auto (arrancadores, talhas, guinchos, cintas, atrelados)
• Ferramentas manuais (martelos, alicates, chaves de fendas, chaves combinadas)
• Ferramentas pneumáticas (aparafusadoras, esmeriladoras, berbequins pneumáticos)
• Ferramentas elétricas e a bateria (aparafusadoras, esmeriladoras sem fios)
• Ferramentas de alta tensão e isoladas (intervenção elétrica)
• Segurança no trabalho (EPI, capacetes, luvas, proteção auditiva)
• Casa, jardim, marketing

⭐ 14 razões para escolher o Módulo BGS technic

1. Compatível com PrestaShop 9.x (testado em produção), 8.x e 1.7.x
2. 9500 produtos importados em 1 noite (vs 6 meses manualmente)
3. 290 categorias auto-criadas com a sua imagem personalizada
4. 345 imagens JPG de alta qualidade incluídas no módulo (300×300, design unificado)
5. Multi-imagens inteligente: URL pattern auto-construído de acordo com as convenções BGS
6. 16 idiomas disponíveis do lado do fornecedor (você escolhe)
7. Margens por escalões pré-preenchidas comercialmente (200% em preços baixos → 50% em altos)
8. IVA via TaxRulesGroup nativo PrestaShop (s/IVA calculado, c/IVA gerido pelo PS)
9. Botão "Criar em falta": pré-filtro SKU inteligente para atualizações rápidas
10. CRON 24/7 seguro com modo de teste BO + limitador integrado
11. Filtros "Promoções"/"Novidades" auto multilingue (16 idiomas)
12. Importação otimizada: compatível mesmo com hosting modesto
13. Documentação integrada no painel do módulo (10 secções completas)
14. Ferramentas de manutenção: eliminação seletiva sem mexer noutros produtos

🎬 Como funciona em 5 passos

🔧 Compatibilidade técnica

PrestaShop	1.7.0 → 9.x (testado em produção em 9.0.x, 8.1.x e 1.7.8)
PHP	7.4 / 8.0 / 8.1 / 8.2 / 8.3
MySQL / MariaDB	MySQL 5.7+ / 8.x · MariaDB 10.x
Extensões PHP necessárias	xml, curl, gd ou imagick, mbstring, iconv, json
Espaço em disco	~2 GB livres (9500 produtos × 6 variantes de imagens)
Memória PHP mínima	128 MB (o módulo está otimizado para limitar o consumo)
Multi-shop	✅ Nativo (o supplier está associado a todas as lojas ativas)
Multi-idioma	⚠️ O módulo gere 1 idioma de cada vez (o conteúdo do produto é escrito em todos os idiomas PS com o mesmo valor)
Hosting	Compatível com partilhado (OVH, o2switch, Hostinger), VPS, dedicado, cloud (AWS, Hetzner)

❓ Perguntas frequentes

Como obter o URL XML BGS technic?

Contacte o seu comercial BGS technic ou o seu serviço de parceria. O acesso ao feed XML está reservado às contas parceiras BGS — receberá o URL adaptado ao seu mercado (16 idiomas disponíveis do lado do fornecedor).

O módulo funciona em PrestaShop 9?

Sim, é mesmo o seu terreno principal. Testado em produção em PrestaShop 9.0.x. Também compatível com 8.x e 1.7.x.

Quanto tempo demora a importação completa?

Com imagens adicionais: 8h-15h para 9500 produtos (~30s/produto, principalmente o download de imagens do CDN BGS). Sem imagens adicionais (apenas a cover): ~30 minutos. Dica: deixe correr via CRON noturno, é o ideal.

O que acontece se a BGS adicionar um produto ou mudar um preço?

No próximo CRON full_import: o novo produto é criado automaticamente, os preços existentes são atualizados de acordo com os seus escalões. Mantém as suas descrições modificadas se as fez a partir do BO PrestaShop.

O XML BGS contém o stock disponível?

Não. A BGS não fornece o stock no XML (é voluntário da parte deles). O módulo aplica um stock por defeito configurável (999 = ilimitado, recomendado em modo catálogo/dropshipping). Se quiser stock em tempo real, é preciso subscrever a sua API B2B (não coberta por este módulo).

O que significa o campo VE no XML?

VE = Verkaufseinheit (unidade de venda / embalagem). Indica quantas unidades estão embaladas por pacote (ex: VE=20 = vendido por pacote de 20). NÃO é o stock disponível. É apenas info de catálogo. Pode mostrá-lo como característica "Embalagem" através de um switch nas Opções.

O módulo suporta um site multilingue?

O módulo importa em 1 idioma de cada vez (o do ficheiro XML escolhido). Para uma loja multilingue, o conteúdo do produto é escrito em todos os idiomas PS com o mesmo valor. Para realmente traduzir em vários idiomas, é preciso fazer 1 importação por idioma (clone o módulo com outro nome).

Posso desativar o módulo sem perder os meus produtos?

Sim. A desinstalação preserva todos os dados (produtos, categorias, imagens, marcas, fornecedor, logs). Para apagar estes dados: utilize o separador Ferramentas → Eliminação seletiva antes de desinstalar.

Existe um ficheiro de mapping para as imagens de categorias?

Sim! O módulo contém 345 imagens JPG personalizadas (1 por categoria a todos os níveis), automaticamente atribuídas na criação da árvore. Se uma categoria não tiver imagem dedicada, o módulo recupera automaticamente o ícone oficial BGS como backup.

O módulo funciona com um ficheiro XML local (não em HTTPS)?

Sim. Pode colocar um caminho local do servidor no campo "URL XML" (ex: /var/www/imports/bgs.xml) e o módulo usá-lo-á diretamente, sem download curl. Muito útil para testes ou se obtiver o XML por FTP/SFTP.

Quanto espaço em disco consome o módulo?

~2 GB para os 9500 produtos com as suas imagens (1 cover + 6 variantes PrestaShop cada). O módulo em si tem ~5 MB (com as 345 imagens de categorias). Preveja amplo se ativar imagens adicionais (até 10 por produto = ~10 GB).

Existe suporte técnico?

Sim, suporte técnico pela WebPoint via akimania.com/contact — resposta em 48h úteis. O módulo é mantido com atualizações regulares (compatibilidade com PS futuros, adições de funcionalidades).

📦 Módulo desenvolvido pela WebPoint · webpoint.fr · Atualizações regulares · Código limpo e comentado · Compatível PS 1.7 → 9.x