Módulo PrestaShop de dropshipping BTSWHOLESALER
💄 ✨ 🧴
Módulo BTSWholesaler Dropshipping
O módulo que automatiza de A a Z o seu dropshipping de cosméticos, perfumes e parafarmácia em PrestaShop
PrestaShop 1.7 → 9.x · 5 idiomas · CRON 24/7 · Marcas premium
Vende cosméticos, perfumes ou parafarmácia em dropshipping? Passa os dias a importar manualmente produtos Vichy, La Roche-Posay, Nuxe, a copiar as fichas INCI, a gerir as variantes por capacidade (75ml, 100ml, 200ml), a transferir cada encomenda para o portal BTS, a verificar trackings, a enviar emails de envio aos seus clientes?
Com o Módulo BTSWholesaler dropshipping, tudo se torna automático. Configura uma vez, esquece. O módulo trabalha 24/7 em segundo plano.
⚡ Antes vs Depois do Módulo BTSWholesaler
| Tarefa |
❌ Sem o módulo |
✅ Com o módulo |
| Importação de 1 000 produtos perfumes + cosméticos |
10h+ manual, copiar-colar |
1 clique, ~45 min em segundo plano |
| Variantes por capacidade |
Criação manual ml/g um a um |
Agrupamento automático 75ml/100ml/200ml |
| Atualização de stocks e preços |
Verificação diária no portal BTS |
Sincronização delta CRON a cada 2h |
| Processamento de uma encomenda |
Reintrodução no portal BTS, escolha de transportadora |
Reenvio automático com transportadora mapeada |
| Email de tracking ao cliente |
Copiar-colar o número |
Enviado automaticamente pelo PS |
| Multilingue (5 idiomas UE) |
Tradução manual / DeepL pago |
Textos nativos BTS obtidos em paralelo |
| Margens e preços de venda |
Cálculo Excel produto a produto |
10 escalões % automáticos por intervalo |
| SEO e meta-descrições |
Redação manual |
Modelos com variáveis automáticas |
👤 A quem se destina este módulo?
💄
Parafarmácia online
Vende produtos de cuidado (Vichy, La Roche-Posay, Avène, Bioderma) e quer multiplicar o seu catálogo sem gerir stock físico.
🌸
Perfumaria e-commerce
Quer referenciar Dior, Chanel, Calvin Klein, Hugo Boss, YSL com as suas variantes EDT/EDP 50ml/100ml em poucos cliques.
📈
E-commerciante em escala
Gere mais de 5 000 referências de cosméticos manualmente e perde tempo no operacional em vez do marketing.
🎯 Funcionalidades completas do Módulo BTSWholesaler
📦 Importação do catálogo BTS — Em massa, sem timeout
- Autenticação JWT Bearer na API BTS v2.1 (segurança bancária)
- Importação unitária por EAN ou ID BTS para teste ou recuperação
- Importação em massa: 50, 100, 500, 1 000 produtos ou todo o catálogo
- Filtros avançados: por marca, por categoria BTS, modo limitado ou completo
- Modo leve (light update): se um produto já está importado, mexemos APENAS no preço/stock/disponibilidade. Sem reescrever descrições, categorias ou tags.
- Recuperação em caso de erro: relançamento assíncrono automático em caso de timeout
- Adaptado a alojamento modesto: time-budget 60s, retry em 429 rate-limit
🧴 Agrupamento inteligente por capacidade
BTSWholesaler lista frequentemente o mesmo perfume em vários SKUs distintos para cada capacidade. O módulo deteta automaticamente os grupos e cria 1 produto PrestaShop com as suas variantes:
| SKU BTS |
Nome BTS |
Resultado no PrestaShop |
3349668010615 |
Dior Sauvage EDT 60ml |
1 produto "Dior Sauvage EDT"
com 3 variantes:
· 60ml · 100ml · 200ml |
3349668010622 |
Dior Sauvage EDT 100ml |
3349668010639 |
Dior Sauvage EDT 200ml |
- Deteção automática das capacidades: ml, g, oz, cl, l, kg, gr
- Switch on/off nas configurações: se preferir 1 produto PS por SKU, o modo é desativável
- Stock individual por variante
- Referência PS única por combinação (o EAN BTS é conservado)
🌐 Multilingue 5 idiomas — Mercados europeus
| ?? Francês |
?? Espanhol |
?? Inglês |
?? Italiano |
?? Alemão |
- Chamadas paralelas via cURL multi: 1 round-trip para obter todos os idiomas de uma página
- Deteção automática dos idiomas PS ativos que tenham equivalente BTS
- Geração automática de descrições formatadas em HTML quando a API não fornece para um idioma
- Reformatação inteligente da descrição: cada frase torna-se um <p> para legibilidade e SEO
- Mini-descrição automática por idioma (description_short PS)
- Slug limpo (link_rewrite) sem acentos nem caracteres especiais
🚚 Mapeamento transportadoras PS ↔ BTS — Precisão máxima
Para cada transportadora da sua loja PrestaShop, associa o carrier_code BTSWholesaler correspondente através de uma tabela de mapeamento dedicada:
| Transportadora PS |
Código BTS associado |
País |
| Colissimo Domicílio |
colissimo_fr |
?? França |
| Mondial Relay |
mondial_relay_fr |
?? França |
| Chronopost |
chronopost_fr |
?? França |
| DHL Express |
dhl_express |
?? Europa |
| DPD |
dpd_fr |
?? França |
- Obtenção automática dos preços via
getShippingPrices() consoante o país de envio
- Fallback gracioso: se uma transportadora não está mapeada, o módulo utiliza a transportadora predefinida configurada
- Retry em 429 rate-limit no reenvio de encomenda
💰 Margens configuráveis — 10 escalões por defeito
| Modo |
Descrição |
Para quem? |
| Escalões |
% diferente conforme o intervalo de preço de compra (ex.: +100% abaixo de 10€, +50% acima de 100€) |
⭐ Recomendado — maximiza a margem nos preços baixos |
| Markup fixo |
Uma só % aplicada a todos os produtos |
Estratégia simples, margem constante |
| Trabalhador independente |
Modo de imposto simplificado (IVA não aplicável) |
Independentes em isenção de IVA |
🔍 SEO e Modelos personalizáveis
- Meta title / meta description com variáveis:
{name}, {brand}, {ean}, {capacity}
- Geração automática de meta_keywords a partir do título, marca, capacidade
- Filtro de stop-words FR/EN integrado (le, la, les, the, of...)
- Tags PS automáticas: marca, género (Mulher/Homem/Misto), capacidade
- Imagem inserida na descrição longa (no início ou no fim) — boost de SEO on-page
- Desativação automática em rutura de stock ou opção "manter visível para o SEO"
✏️ Substituições de texto — Personalize à sua marca
Regras de substituição aplicadas aos nomes e descrições importados. Vários âmbitos:
| Texto fonte |
Texto destino |
Campo |
Envío rápido |
Envio rápido |
Descrição |
BTSWholesaler |
A Minha Loja |
Todos |
en stock |
envio em 24h |
Descrição |
🛒 Pipeline de encomendas 100% automático
O cenário que muda tudo:
- 👤 Um cliente encomenda um perfume na sua loja PrestaShop
- 💳 Ele paga → a encomenda passa ao estado "Pagamento aceite"
- ⚡ O módulo reenvia automaticamente a encomenda para a BTS (com transportadora mapeada conforme o país)
- 📨 A BTS prepara e envia a encomenda diretamente ao seu cliente (em marca branca)
- 🚚 O CRON do módulo recolhe o número de tracking quando estiver disponível
- 📧 PrestaShop envia automaticamente o email de envio ao cliente com o seu tracking
→ Não tocou em NADA. A encomenda é processada de ponta a ponta.
- Hook PS nativo
actionOrderStatusUpdate — disparo instantâneo na mudança de estado
- 3 modos de pagamento BTS suportados: transferência bancária, PayPal, cartão bancário
- Endereço do cliente convertido para o formato BTS (firstname, lastname, address, postcode, city, country, phone)
- Idempotente: não refaz o reenvio de uma encomenda já transmitida
- Painel de controlo: veja todas as suas encomendas PS e o respetivo estado BTS num relance
- Cancelamento propagado (opcional): se cancelar a encomenda PS, o módulo invoca
setCancelOrder do lado da BTS
⏰ CRON 24/7 — 4 ações automatizadas
| Ação CRON |
Função |
Frequência aconselhada |
full_import |
Importação completa do catálogo (criação ou atualização) |
1×/dia |
delta_sync |
Sincronização incremental (apenas os produtos modificados) |
a cada 2h |
stock_check |
Atualização de stock + disponibilidade dos produtos já importados |
de hora a hora |
tracking |
Recolhe trackings + email de envio ao cliente |
de hora a hora |
- Chave segura de 32 caracteres 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 assíncrono automático: o módulo invoca-se a si próprio em segundo plano se o time-budget for atingido (60s) — sem timeout Apache
- Retoma precisa: retoma exatamente na página onde parou
- Retry automático em rate-limit / erro 429 / timeout de rede
- Estado em tempo real no BO: página atual, criados, atualizados, erros
- Botão stop: para corretamente o CRON em curso
- Limite de produtos configurável: importar apenas N produtos por "job"
📊 Separador Analytics — Pilotagem do seu dropshipping
- Histórico de importações: quem, quando, quantos, sucessos/falhas
- Registo de erros detalhado: erros de descarga de imagem, variantes recusadas, timeout API…
- Lista de produtos importados com filtros (por marca, por categoria, por estado)
- Exportação CSV da lista de produtos BTS importados (para análise externa)
- Paginação: 20, 50, 100, 500 produtos por página
- Pesquisa por EAN, nome, marca
🏷️️ O catálogo BTSWholesaler — Marcas premium acessíveis
BTS Wholesaler é um dos maiores grossistas B2B europeus (sediado em Espanha) especializado em cosméticos de grandes marcas, perfumes de nicho e marcas de luxo, parafarmácia e higiene e beleza. Visão não exaustiva das marcas disponíveis:
Vichy La Roche-Posay Avène Bioderma Nuxe Caudalie Eucerin L'Oréal Dior Chanel Calvin Klein Hugo Boss YSL Versace Dolce & Gabbana Garnier Nivea Sanex Yves Rocher + centenas de outras
Categorias cobertas: perfumaria homem/mulher, cuidado do rosto, cuidado do corpo, maquilhagem, capilar, solar, higiene, parafarmácia, suplementos alimentares, bebé e criança.
⭐ 10 razões para escolher o Módulo BTSWholesaler
- 🚀 Instalação em 5 minutos: cole o seu token JWT, teste a ligação, pronto
- 🤖 100% AJAX, zero reload: interface fluida, moderna, agradável
- 📚 Documentação integrada com 12 secções: nenhuma ligação à internet necessária para a consultar
- 🛡️️ Compatível PS 1.7 → 9.x: camada de compatibilidade
BtsCompat que gere todas as versões
- ⚡ Otimizado para alojamento modesto: importação por chunks, throttle, time-budget 60s
- 🔐 Segurança máxima: token JWT Bearer, hash_equals na chave CRON, validação do lado do servidor
- 🎨 Design personalizado: cabeçalho com gradiente azul, separadores estilizados, paleta coerente
- 🧹 Manutenção fácil: eliminação seletiva com opções, limpeza de órfãos
- 💎 Nenhum AdminController, nenhum separador Tab: não polui o seu menu BO, configuração apenas na ficha do módulo
- 🌟 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 através do BO. Criação automática de 10 tabelas, 1 fornecedor, 4 URLs CRON seguros.
2
Ligue a sua conta
Cole o seu token JWT BTSWholesaler, escolha o seu idioma principal, teste a ligação (1 clique).
3
Configure as suas margens
10 escalões por defeito. Modelos SEO, mapeamento de transportadoras, multi-imagens, multilingue: tudo é parametrizável.
4
Lance a importação
Filtre por marcas + categorias, escolha a quantidade, clique em "Iniciar". O CRON assume o resto 24/7.
🔧 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+ |
| Multi-shop |
Compatível (utiliza a loja atual) |
| Hooks utilizados |
actionOrderStatusUpdate |
| Override de classe |
Nenhum (preserva os seus outros módulos) |
| AdminController |
Nenhum |
| Separador na sidebar BO |
Nenhum (não polui o seu menu) |
| Conta BTSWholesaler |
Conta B2B necessária (em btswholesaler.com) |
| Token JWT API |
Solicitar ao seu comercial BTS |
❓ Perguntas frequentes
P: O módulo BTSWholesaler dropshipping funciona no PrestaShop 9?
R: Sim, totalmente compatível com PS 9.x. A camada de compatibilidade interna BtsCompat gere também as versões 1.7 e 8 sem modificação do código.
P: Quantos produtos posso importar?
R: Sem limite do lado do módulo. O catálogo BTSWholesaler completo contém dezenas de milhares de referências. Pode importar tudo ou direcionar por marcas (Vichy, La Roche-Posay…) ou categorias (perfumaria, cuidado do rosto…).
P: O meu alojamento partilhado a 9 €/mês vai aguentar?
R: Sim, o módulo está especialmente otimizado para alojamentos modestos. CRON por chunks, time-budget 60s, relançamento assíncrono automático. Sem risco de timeout Apache 5xx.
P: Como funciona o modo de variantes por capacidade?
R: O módulo deteta os SKUs que partilham o mesmo nome de base e agrupa as capacidades como variantes de um único produto PS. Switch on/off nas configurações se preferir 1 produto por SKU.
P: As encomendas são pagas automaticamente na BTS?
R: O módulo suporta 3 modos de pagamento (banktransfer, paypal, cartão). Conforme o seu acordo com a BTS, o pagamento pode ser automático (conta pré-paga) ou exigir a sua validação a partir do seu portal. O módulo recolhe depois o tracking + email do cliente automaticamente.
P: O que acontece se uma imagem BTS estiver corrompida?
R: O módulo valida cada imagem com getimagesize() antes da importação. Os ficheiros corrompidos (TIFF disfarçado de JPEG, etc.) são rejeitados corretamente. O produto é criado sem imagem em vez de fazer falhar a importação.
P: O que acontece se a BTS estiver temporariamente indisponível?
R: O módulo deteta os erros de rede e HTTP 429 (rate-limit), faz retry automaticamente com backoff e retoma onde tinha parado na próxima execução do CRON.
P: Posso desinstalar corretamente?
R: Sim, mas a desinstalação preserva voluntariamente os seus produtos importados (perda irreversível evitada). Uma zona "Eliminação seletiva" no separador Manutenção permite uma limpeza granular com confirmação.
🎯 Pronto para automatizar o seu dropshipping?
O Módulo BTSWholesaler dropshipping é a ferramenta mais completa para vender as marcas premium de cosméticos, perfumes e parafarmácia em PrestaShop. Configurado uma só vez, trabalha por si 24/7.
⚡ INSTALAÇÃO 5 MIN · 📚 DOCUMENTAÇÃO INTEGRADA · 🛡️ COMPATÍVEL PS 1.7 → 9 · 🇫🇷 SUPORTE EM FRANCÊS
📋 Detalhes técnicos para programadores
Tabelas BD criadas (10): wp_btswholesaler_margins, wp_btswholesaler_history, wp_btswholesaler_category_mapping, wp_btswholesaler_product_meta, wp_btswholesaler_combination_meta, wp_btswholesaler_text_replacements, wp_btswholesaler_seo_templates, wp_btswholesaler_import_errors, wp_btswholesaler_carrier_mapping, wp_btswholesaler_orders
Configurações PS: WPBTS_SETTINGS (JSON), WPBTS_CRON_KEY, WPBTS_SUPPLIER_ID, WPBTS_DESCRIPTIONS, WPBTS_IMPORT_PROGRESS, WPBTS_DELTA_PROGRESS
APIs BTS utilizadas: getListProducts, getListProductsMultilang (cURL multi paralelo), getCategoriesList, getProductCategories, getDictionnary, getCarriers, getShippingPrices, setOrder, setCancelOrder, getOrders, getOrder, getOrderTracking
Arquitetura: 4 classes PHP limpas (BtsCompat, BtsApiClient, BtsCategoryMapper, BtsProductImporter) + módulo principal. Sem override de classe core PrestaShop. Código comentado em francês.
Segurança: autenticação JWT Bearer, hash_equals() na chave CRON, pSQL() em todo o lado, token CSRF nativo PS em AJAX, throttle anti DoS, validação de formato de imagens.
📦 Módulo desenvolvido por WebPoint · webpoint.fr · Atualizações regulares · Código limpo e comentado
