Módulo PrestaShop de dropshipping DEBRANET
🌐 Catálogo fonte disponível em: 
✅ Loja multilingue automática. Numa só importação, o módulo preenche cada ficha de produto em todos os idiomas ativos da sua loja. Sem tradução manual, sem ferramentas externas.
🇭🇺 🇬🇧 🌍
Módulo Debranet Dropshipping Produtos para Adultos
O módulo que automatiza de A a Z o seu dropshipping adulto internacional com a Debranet no PrestaShop
PrestaShop 1.7 → 9.x · 7.688 referências · ~78 categorias · EN + HU · CRON 24/7
Está a lançar ou a operar uma loja online de produtos para adultos no mercado europeu? Trabalha com a Debranet (grossista B2B sediada na Hungria) e passa os dias a copiar manualmente as fichas de produto do portal XML, a recriar a hierarquia de categorias no PrestaShop, a fazer upload das fotos uma a uma, a recalcular os seus preços de venda com a sua margem e a repetir a operação a cada atualização do catálogo?
Com o Módulo Debranet dropshipping produtos para adultos, tudo se torna automático. Instala o módulo, clica em "Iniciar importação", e o módulo descarrega os feeds XML da Debranet (categorias, marcas, produtos), reconstrói a hierarquia idêntica no PrestaShop, cria os seus ~7.688 produtos multilingues EN + HU diante dos seus olhos, em tempo real, em lotes auto-paginados de 100.
⚡ Antes vs Depois do Módulo Debranet
| Tarefa |
❌ Sem o módulo |
✅ Com o módulo |
| Importar 7.688 referências para adultos | 100h+ manual, cópia do portal Debranet | 1 clique, ~5h em segundo plano auto-paginado |
| Hierarquia de ~78 categorias | Criação manual Cat → Sub → Sub-Sub | Hierarquia Debranet preservada idêntica em 1 chamada atómica |
| Multilingue EN + HU | DeepL pago ou redação manual em húngaro | Textos nativos em inglês e húngaro do feed XML |
| Paginação API codekey | Gestão manual dos parâmetros from/to=1000 | Auto-paginação 100×100, codekey ofuscado integrado |
| Multi-imagens CDN Debranet | Download manual imagem por imagem | Auto a partir do CDN, validadas e redimensionadas para PS |
| Marcas (manufacturers) | Criação manual e depois associação | Fase 1 dedicada: feed XML brand → manufacturer PS |
| Margens e preços de venda | Cálculo Excel produto a produto | 5 escalões % automáticos por intervalo |
| Imagem original BO PrestaShop 9 | Imagem partida no BO PS9 (bug oficial) | Fix BO PS9 incluído: cópia 1:1 do ficheiro original |
👤 Para quem é este módulo?
🇪🇺
Loja para adultos no mercado europeu
Tem como alvo a Europa Central, o Reino Unido, a Irlanda ou os mercados germanófonos e nórdicos com um grossista húngaro competitivo em preços e prazos de envio europeus.
🇬🇧
E-commerce anglófono
Vende em inglês (UK, Irlanda, mercados internacionais) e precisa de fichas nativas em inglês sem ter de as redigir ou traduzir — a Debranet entrega diretamente EN + HU.
📈
Dropshipper que escala na Europa
Gere mais de 1.000 referências para adultos manualmente. O módulo devolve-lhe horas por semana e permite-lhe escalar para novos mercados europeus.
🎯 Funcionalidades completas do Módulo Debranet
🔄 Arquitetura de 3 fases — Importação Single-click
Onde a concorrência o obriga a manipular 3 ficheiros e 5 botões, o módulo Debranet realiza toda a importação com um único comando "Iniciar importação" que orquestra 3 fases atómicas:
1
Fase 1 — Marcas
Download do feed brand.php Debranet → criação dos Manufacturer PS, mapping persistido em BD. 1 chamada atómica.
2
Fase 2 — Categorias
Download do feed category.php → ~78 categorias criadas em cascata por parent_id, multilingue EN + HU. Hierarquia Debranet preservada.
3
Fase 3 — Produtos
Download do feed product.php auto-paginado (100×100), criação de produtos PS com categorias atribuídas, manufacturer ligado, multi-imagens, EAN, preços.
🔐 API XML Debranet protegida por codekey
A Debranet expõe 3 endpoints XML protegidos por uma chave de autenticação (codekey):
| Endpoint |
Conteúdo |
Paginação |
brand.php | Feed de marcas (Manufacturer) | 1 chamada |
category.php | Hierarquia de categorias EN + HU (~78 entradas) | 1 chamada |
product.php | Catálogo de produtos + fotos + características | 100×100 auto |
- Codekey hardcoded ofuscado: a chave de autenticação está incorporada no módulo, recodificada XOR + base64, chave XOR fragmentada em 3 helpers — impossível fazer
grep no código fonte
- URL do feed ofuscado: a mesma técnica para o URL base dos endpoints
- Sem configuração do utilizador: o módulo funciona out-of-the-box, não tem de pedir a chave à Debranet (está integrada pelo seu revendedor do módulo)
- Auto-paginação de produtos: o módulo encadeia automaticamente as chamadas
?from=0&to=100, ?from=100&to=200… até esgotar o catálogo
- Download curl robusto: timeout 600s, retry 3× com backoff, seguimento de redirecionamentos, User-Agent personalizado
🌳 Hierarquia de categorias Debranet preservada idêntica
Ao contrário de outros módulos de importação que impõem uma árvore predefinida fixa, o módulo Debranet preserva a hierarquia nativa do fornecedor: as ~78 categorias do feed XML são reproduzidas sob a sua categoria raiz PrestaShop com as suas relações pai/filho intactas.
- Sub-raiz personalizável: por defeito PS_HOME_CATEGORY, ou qualquer categoria da sua árvore
- Multilingue EN + HU na instalação: cada categoria tem o seu nome inglês E húngaro
- Mapping persistido em BD: a tabela
wp_debranet_category_mapping mantém a correspondência Debranet ID → PS ID (reutilizável, idempotente)
- Separador Mappings de categorias no BO: tabela auto-carregada que lista todos os mappings resolvidos, com seletor das categorias PS e botão Re-mapear para mover os produtos se quiser fundir ou renomear uma categoria
- Rede de segurança: se eliminar manualmente uma categoria do BO PS, ela é recriada na próxima abertura do módulo
🌐 Multilingue EN + HU — Mercados europeus
Porquê EN + HU? A Debranet é uma grossista húngara B2B que entrega o seu catálogo em 2 línguas: inglês (para o mercado internacional) e húngaro (para o mercado local e a Europa Central).
O módulo deteta automaticamente as línguas ativas no seu PrestaShop e importa apenas as presentes no feed Debranet. Se o seu PS só tiver francês, os produtos serão criados mas as suas traduções EN/HU serão ignoradas (opção «Ignorar FR» por defeito).
| 🇬🇧 English |
🇭🇺 Magyar (Húngaro) |
🇫🇷 Français (ignorado) |
| Mercado UK / Irlanda / internacional |
Mercado Hungria / Europa Central |
Não fornecido pela Debranet |
- Deteção automática das línguas PS ativas com equivalente no feed Debranet
- Slug limpo (link_rewrite) sem acentos por língua
- Mini-descrição inteligente: extraída das 2 primeiras frases se a Debranet a fornecer, gerada automaticamente caso contrário (nunca sobrescrita)
- Tags PS multilingues auto-gerados a partir de brand + category (por língua)
📸 Multi-imagens a partir do CDN Debranet
- Multi-imagens por produto: o feed XML expõe vários URLs de imagens por produto (cover + fotos adicionais)
- Download curl com User-Agent personalizado, seguimento de redirecionamentos, timeout 30s
- Validação de formato via
getimagesize(): JPEG/PNG/GIF/WebP, ficheiros corrompidos rejeitados sem fazer crash do import
- 1ª imagem = cover automaticamente
- Geração auto de todos os tamanhos PS (small, medium, large, home_default…) via
ImageManager::resize()
- Fix BO PrestaShop 9 incluído: cópia 1:1 do ficheiro original
<id>.jpg além das variantes — sem este fix, a imagem não aparece na página de edição de produto do BO PS9 (bug PS9 conhecido)
- Legenda multilingue retomando o nome do produto em cada língua ativa
⚡ Arquitetura de import em tempo real auto-paginado
O cenário que muda tudo:
- 📥 Fase 1 + Fase 2: marcas + ~78 categorias criadas em 2 chamadas atómicas (10-30 seg)
- 🚀 Fase 3 — Paginação de produtos: o módulo lança chamadas sucessivas
from=0&to=100, from=100&to=200… auto-incrementadas
- 📊 Barra de progresso dourada: percentagem ao vivo + contador X/Y produtos (em ~7.688)
- 📋 Log ao vivo estilo consola: badge colorido (Criado / Atualizado / Ignorado / Erro) + ID Debranet + nome + ID PS#
- ⏸️ Botão Parar a qualquer momento, retoma possível na página exata de paragem
- 📈 Estatísticas ao vivo: Criados · Atualizados · Ignorados · Erros · Página atual
→ Acabou a página lenta. Acabaram as preocupações. Vê tudo o que se passa.
⏰ CRON 24/7 — 3 ações automatizadas
| Ação CRON |
Função |
Frequência recomendada |
full_import | Importação completa do catálogo (3 fases: brands + categories + products auto-paginados) | 1×/dia |
light_sync | Atualização preço + stock + disponibilidade dos produtos já importados (modo leve, sem recriação) | a cada 2-4h |
cleanup_logs | Limpeza logs > N dias (retenção configurável) | 1×/semana |
- Chave secreta de 32 caracteres hex gerada na instalação — os seus URLs CRON não podem ser adivinhados
- Regeneração com 1 clique da chave em caso de fuga
- Auto-relançamento assíncrono: o módulo chama-se a si próprio em segundo plano se o time-budget for atingido (60s por defeito, configurável) — sem timeout Apache 5xx
- Retoma precisa: retoma exatamente na página Debranet onde parou (cursor pagination)
- Lock anti-concorrência via flock: sem execuções paralelas
- Retry de download XML 3× com backoff 2s/4s/6s
- Botão Parar no lado BO para parar limpamente um CRON em curso (guarda o estado para retoma)
- Modo de teste com limite de produtos configurável (50 por defeito), ideal para validar antes da importação completa
💰 Margens e SEO configuráveis
4 modos de cálculo de preço
| Modo | Descrição |
|---|
| RRP | Preço aconselhado Debranet (recommended retail price) tal qual — o mais simples para começar |
| Escalões ⭐ | % diferente segundo o escalão de preço de compra sem IVA (5 escalões por defeito, configuráveis) |
| Markup fixo | Um único % aplicado a todos os produtos |
| Wholesale | Preço de compra sem IVA tal qual (venda B2B) |
Templates SEO personalizáveis
- Meta title / meta description com variáveis:
{name}, {brand}, {category}, {ean}
- Tags PS multilingues auto-gerados a partir de brand + category (por língua ativa)
- Mini-descrição inteligente: extraída se fornecida pela Debranet, gerada automaticamente caso contrário
- Auto-desativação rotura de stock (opção) ou "manter visível para o SEO"
- Opção "imagem na descrição": injeção da 1ª imagem diretamente na descrição longa (boost SEO on-page), posição início ou fim à escolha
🛠️ Manutenção — Eliminação seletiva
- ☐ Produtos importados: deteção em 4 fontes (meta, supplier, product_supplier, mapping de categorias), compatível com o quirk multi-shop PS9 com fallback wipe SQL em 25 tabelas associadas
- ☐ Marcas órfãs: elimina os manufacturers Debranet sem produto
- ☐ Categorias órfãs: elimina as categorias Debranet vazias (opção facultativa)
- ☐ Fornecedor Debranet: elimina o supplier apenas se não tiver mais nenhum produto associado
- ☐ Logs internos: truncate das tabelas history e import_errors
Tripla confirmação (caixa de diálogo + escrever ELIMINAR + botão). A árvore de categorias pode ser recriada automaticamente na próxima abertura do módulo se não marcar a opção "Categorias órfãs".
🏷️ O fornecedor Debranet em números
7.688
referências em catálogo
~78
categorias hierárquicas
EN + HU
2 línguas nativas
100×100
paginação XML auto
3
feeds XML (brand/cat/product)
Categorias cobertas pela Debranet (universo adulto): lingerie sexy, brinquedos sexuais vibratórios, dildos e plugs, masturbação, BDSM e bondage, lubrificantes, cuidado íntimo, afrodisíacos, jogos libertinos, acessórios eróticos. O catálogo cobre todos os segmentos do mercado adulto com preços grossistas competitivos no mercado europeu.
⭐ 12 razões para escolher o Módulo Debranet
- 🚀 Importação Single-click: 1 comando → 3 fases atómicas (marcas + categorias + produtos)
- 🔐 API protegida por codekey integrada: codekey hardcoded ofuscado, sem configuração de rede do lado do utilizador
- 📡 Auto-paginação 100×100: encadeia automaticamente as chamadas XML até esgotar o catálogo (~7.688 produtos)
- 🌳 Hierarquia Debranet preservada: ~78 categorias importadas tal qual com as suas relações pai/filho
- 🌐 Multilingue nativo EN + HU sem DeepL nem tradução manual para húngaro
- 📸 Multi-imagens com validação de formato + fix BO PS9 incluído
- 💰 4 modos de preço: RRP / Escalões (5 por defeito) / Markup fixo / Wholesale
- ⚡ Importação em tempo real produto a produto: barra ao vivo, log consola, botão Parar
- ⏰ CRON 24/7 com time-budget, auto-relançamento assíncrono, retry, lock, retoma precisa
- 🛡️ Compatível PS 1.7 → 9.x: camada de compatibilidade
DnCompat + fix bug imagem BO PS9 oficial
- 💎 Sem AdminController, sem Tab BO, sem override: não polui o seu menu, não parte os seus outros módulos
- 🇫🇷 Autor francês: suporte em francês, atualizações regulares, código limpo e comentado
🎬 Como funciona em 4 passos
1
Instale o módulo
Descarregue o ZIP, instale via BO. Auto-criação das 5 tabelas, do fornecedor Debranet, da chave CRON. O codekey API já está integrado (ofuscado).
2
Configure os parâmetros
Vá a Parâmetros: escolha a categoria raiz PS, o modo de preço (RRP / Escalões / Markup / Wholesale), a opção imagem na descrição, o modo teste (50 produtos) ou importação completa.
3
Lance a importação Single-click
Clique em "Iniciar importação". Fase 1 (marcas) + Fase 2 (~78 categorias EN + HU) + Fase 3 (~7.688 produtos auto-paginados) num único comando. Barra de progresso e log ao vivo.
4
Ative o CRON 24/7
Uma vez bem-sucedida a importação inicial, configure o CRON no seu cPanel/Plesk com os URLs fornecidos. Sincronização automática preço/stock a cada 2-4h, importação completa 1×/dia.
🔧 Compatibilidade técnica
| PrestaShop | 1.7.x → 9.x (testado em PS 9.0) |
| PHP | 7.4 mínimo, recomendado 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL | Ativado (download feed XML + imagens) |
| Multi-shop | Compatível (força CONTEXT_ALL para a eliminação) |
| Hooks utilizados | Nenhum (sem poluição da cadeia de eventos) |
| Override de classe | Nenhum (preserva os seus outros módulos) |
| AdminController | Nenhum |
| Separador sidebar BO | Nenhum (não polui o seu menu) |
| Conta Debranet B2B | Conta necessária (codekey pré-fornecido com a sua licença do módulo) |
| Configuração do utilizador | Nenhuma (URL e codekey integrados) |
❓ Perguntas frequentes
P: O Módulo Debranet funciona no PrestaShop 9?
R: Sim, totalmente compatível com PS 9.x. O módulo gere a migração específica de PS9 onde foi removido meta_keywords (mudança automática para ps_tag) bem como o bug PS9 onde a imagem original não aparece na página de edição de produto BO (fix por cópia 1:1 do ficheiro <id>.jpg além das variantes redimensionadas).
P: Quantos produtos posso importar?
R: Sem limite do lado do módulo. O catálogo Debranet contém atualmente ~7.688 produtos, mas a auto-paginação 100×100 suporta qualquer tamanho de catálogo futuro. Pode usar o modo teste (50 produtos) para começar suavemente.
P: O meu alojamento partilhado de 9 €/mês vai aguentar?
R: Sim, o módulo está especialmente otimizado. A arquitetura "1 produto = 1 chamada AJAX" garante que nenhuma chamada ultrapassa 2-3 segundos. Sem risco de timeout Apache 5xx, ao contrário dos módulos de import "tudo-em-um".
P: Tenho de pedir um codekey à Debranet?
R: Não, o codekey API já está integrado no módulo (ofuscado para impedir a extração). Não tem qualquer configuração de rede a fazer — instale e lance a importação. A conta Debranet B2B continua, no entanto, necessária para a faturação e entrega das suas encomendas.
P: O francês não está na Debranet, como vender em França?
R: O feed Debranet apenas fornece EN + HU. Se o seu PrestaShop tiver a língua francesa ativa, o módulo criará na mesma os produtos com os seus nomes ingleses como fallback FR. Pode depois traduzir manualmente as fichas via DeepL ou um módulo de tradução. Para vender diretamente em francês, o módulo Busyx Pro (catálogo francês adulto) é uma alternativa complementar.
P: Como funciona a árvore Debranet?
R: Ao contrário de outros módulos que impõem uma árvore fixa, o módulo Debranet preserva a hierarquia nativa do fornecedor (~78 categorias com as suas relações pai/filho). Na fase 2 da importação, o módulo cria todas as categorias em cascata por parent_id. Pode depois re-mapear individualmente a partir do separador Mappings de categorias para fundir ou mover se quiser personalizar.
P: O que acontece com os produtos já importados durante uma nova importação?
R: Modo "light update" automático: o módulo deteta o produto existente (por ID Debranet) e atualiza UNICAMENTE o preço e o stock. NUNCA reescreve as suas descrições, categorias ou tags — mantém as suas personalizações e o seu trabalho SEO.
P: E se eu quiser parar uma importação em curso?
R: Botão "Parar" disponível durante a importação (UI) e durante o CRON (flag file). Paragem limpa no fim do produto em curso, gravação do estado para retoma na página exata de paragem (cursor pagination).
P: O módulo funciona noutros países além da Hungria?
R: Sim, é todo o interesse! A Debranet expede em toda a Europa (e além mediante pedido). O módulo é concebido para sex shops anglófonos (UK, Irlanda, Austrália, Canadá anglófono, mercados internacionais EN), centro-europeus (Hungria, República Checa, Eslováquia…) ou qualquer país onde opere uma loja multilingue com EN ou HU como língua principal.
P: Posso desinstalar de forma limpa?
R: Sim, mas a desinstalação conserva voluntariamente os seus produtos importados (perda irreversível evitada). A zona "Eliminação seletiva" permite uma limpeza granular com tripla confirmação: produtos / marcas / categorias / fornecedor / logs, independentes.
🇪🇺 Pronto para automatizar o seu dropshipping adulto europeu?
O Módulo Debranet dropshipping produtos para adultos é a ferramenta mais completa para vender as ~7.688 referências Debranet no PrestaShop, nos mercados anglófonos e húngaros. Uma vez configurado, importa automaticamente o catálogo ao seu ritmo com a sua hierarquia nativa preservada.
⚡ INSTALAÇÃO 3 MIN · 📚 IMPORT EM TEMPO REAL · 🛡️ COMPATÍVEL PS 1.7 → 9 · 🇫🇷 SUPORTE EM FRANCÊS
📋 Detalhes técnicos para programadores
Tabelas BD criadas (4): wp_debranet_history, wp_debranet_import_errors, wp_debranet_product_meta (debranet_id unique), wp_debranet_category_mapping (debranet_cat_id unique)
Configurações PS: WPDN_SETTINGS (JSON), WPDN_SUPPLIER_ID, WPDN_CRON_KEY, WPDN_LAST_IMPORT_AT, WPDN_LAST_IMPORT_COUNT, WPDN_CRON_LAST_*
API Debranet (3 endpoints XML): brand.php?codekey=* (marcas), category.php?codekey=* (hierarquia EN+HU), product.php?codekey=*&from=N&to=M (catálogo auto-paginado). Codekey hardcoded ofuscado via base64 + XOR (chave fragmentada em 3 helpers xk1/xk2/xk3).
Arquitetura: 5 classes PHP limpas (DnCompat, DnCategoryMapper, DnBrandMapper, DnXmlParser, DnProductImporter) + módulo principal + router AJAX + CRON. Sem override de classe core PrestaShop. Código comentado em francês.
Import em tempo real: 3 endpoints AJAX (import_phase_brands, import_phase_categories, import_phase_products_chunk). Estado persistido em JSON em uploads/state/ com index.php de proteção. Cursor pagination (página atual + total) para retoma precisa.
Segurança: pSQL() em todo o lado, pasta uploads/ protegida, validação de formato de imagens (getimagesize), CSRF nativo PS em AJAX, escape HTML sistemático (htmlspecialchars), hash_equals() sobre chave CRON, codekey ofuscado não extraível por grep.
Compatibilidade PS9 específica: migração automática meta_keywords → ps_tag/ps_product_tag via Tag::addTags(), gestão do quirk Product::delete() que retorna false em multi-shop, fix BO PS9 imagem original (cópia 1:1 do ficheiro <id>.jpg antes das variantes ImageManager::resize).
Mapping de categorias: reconstrução direta da hierarquia XML Debranet (parent_id), sem necessidade de mapping difuso (sem categoria em texto livre, tudo é ID). Re-mapeável individualmente a partir do BO.
Multilingue: deteção automática das línguas PS ativas correspondentes à lista Debranet (['en', 'hu']). FR ignorado por defeito (opção configurável). Fallback FR ← EN se apenas o francês estiver ativo.
📦 Módulo desenvolvido por WebPoint · webpoint.fr · Atualizações regulares · Código limpo e comentado
