Módulo PrestaShop de dropshipping SDE MAISON
🛏️ 🍽️ 🪟
Módulo SDE Dropshipping Têxteis para o Lar
O módulo que automatiza de A a Z o seu dropshipping têxtil francês com Maison Vivaraise no PrestaShop
PrestaShop 1.7 → 9.x · 7 idiomas · CRON 24/7 · Made in France
Vende têxteis para o lar, decoração ou artigos de mesa em dropshipping? Trabalha com SDE / Maison Vivaraise e passa os dias a copiar fichas Winkler, Sel & Poivre, a reformatar descrições multilingues, a fazer upload de fotos da fototeca deles, a recalcular os seus preços de venda com a sua margem, a criar manualmente centenas de categorias em árvore?
Com o Módulo SDE dropshipping têxteis para o lar, tudo se torna automático. Indica o URL do CSV Maison Vivaraise, clica em "Iniciar importação", e o módulo cria os seus produtos PrestaShop multilingues em 7 idiomas diante dos seus olhos, em tempo real, numa árvore de categorias pronta a usar.
⚡ Antes vs Depois do Módulo SDE
| Tarefa |
❌ Sem o módulo |
✅ Com o módulo |
| Importar 1 000 referências de têxteis lar | 15h+ manual, copiando do portal SDE | 1 clique, ~40 min em segundo plano |
| Multilingue 7 idiomas | DeepL pago ou redação manual | Textos nativos FR/EN/DE/ES/IT/NL/PT do CSV |
| Árvore de categorias | Criação manual de dezenas de categorias | 7 cats + 38 subcats criadas na instalação |
| Variantes tamanho + cor | Criação manual SKU por SKU | Agrupamento auto via campo "parent" em combinações PS |
| Multi-imagens (até 10/produto) | Download manual da fototeca | Auto do CDN, redimensionada para PS |
| Etiquetas sustentáveis (Oeko-Tex, Bio, Made in France etc.) | Redação manual na descrição | Features PS filtráveis no front |
| Margens e preços de venda | Cálculo Excel produto a produto | 5 escalões % automáticos por faixa |
| Codificação Latin-1 (ISO-8859-1) | Bug de acentos: "40�C" em vez de "40°C" | Conversão auto célula a célula em UTF-8 |
👤 A quem se destina este módulo?
🛏️
Loja online de têxteis para o lar
Vende conjuntos de cama, lençóis, edredões, fronhas e quer aumentar o seu catálogo sem gerir stock físico na SDE / Maison Vivaraise.
🇫🇷
E-commerce Made in France
Destaca produtos franceses certificados Oeko-Tex, linho europeu, Made in France. O módulo cria Features filtráveis que valorizam estas etiquetas.
📈
Dropshipper em crescimento
Gere mais de 1 000 referências têxteis manualmente e perde tempo no operacional. O módulo devolve-lhe horas por semana.
🎯 Funcionalidades completas do Módulo SDE
🌳 Árvore de categorias pronta a usar
Na instalação, o módulo cria automaticamente 7 categorias principais + 38 subcategorias sob a sua categoria raiz PrestaShop, já traduzidas em 7 idiomas:
| Cat. principal |
Subcategorias |
| 🛏️ Cama | Capas de edredão · Fronhas · Lençóis ajustáveis e planos · Colchas e edredons · Máscaras de dormir |
| 🛁 Banho | Toalhas de banho · Toalhas de praia · Manoplas · Tapetes de banho · Ponchos · Necessaires |
| 🛋️ Decoração | Mantas e plaids · Almofadas · Almofadas outdoor · Almofadas de cadeira · Cortinas e cortinados · Pufes · Bancos |
| 👜 Acessórios | Sacos · Bolsas · Acessórios de escritório · Sacos de água quente · Lenços |
| 👨🍳 Cozinha | Aventais · Luvas de forno · Pegas · Panos de loiça · Chapéus de chef · Cozinha infantil |
| 🍽️ Mesa | Toalhas de mesa · Guardanapos · Caminhos de mesa · Individuais · Acessórios de mesa |
| 🪟 Tapetes | Tapetes decorativos · Tapetes de corredor · Tapetes de cozinha · Tapetes outdoor |
- Multilingue 7 idiomas na instalação (FR/EN/DE/ES/IT/NL/PT): "Cuisine" torna-se "Kitchen", "Küche", "Cocina", "Cucina", "Keuken", "Cozinha"
- Rede de segurança: se eliminar manualmente uma categoria do BO PS, é automaticamente recriada na próxima abertura do módulo (idempotente, multi-idioma, dedup automática)
- Raiz personalizável: Home por padrão, ou qualquer categoria da sua árvore
🧠 Mapeamento inteligente CSV → categoria
Para cada linha CSV, o módulo resolve a categoria em 4 passos inteligentes:
1
Mapeamento em BD
Se a mesma CSV-cat já foi resolvida → reutiliza-se a associação.
2
Mapeamento estático
Tabela interna ~100 entradas: "Tabliers", "tablier", "Tablier" → Cozinha › Aventais.
3
Fuzzy ≥75%
Similaridade similar_text com as subcats predefinidas. Match se a melhor ≥75%.
4
Fallback "Outros"
Subcat "Outros › Por classificar": nunca um erro. Re-mapeável manualmente do separador dedicado.
Separador Mapeamentos de categorias no BO: tabela auto-carregada na abertura do módulo, listando todos os mapeamentos resolvidos. Cada linha oferece um seletor das 38 subcats com um botão Re-mapear que move todos os produtos afetados para o novo destino.
🧵 Variantes por parent (tamanho + cor)
O CSV SDE contém uma coluna parent que agrupa vários SKU partilhando o mesmo produto base. No modo "agrupamento ativado" (por padrão), o módulo cria 1 produto PrestaShop com as suas declinações tamanho + cor:
| SKU SDE | parent | size_fr | color_fr | Resultado em PrestaShop |
|---|
2246035000 | SEL & POIVRE | 80x85 | ROUGE | 1 produto "Avental Sel & Poivre"
3 combinações:
· 80x85 / Vermelho
· 100x100 / Vermelho
· 80x85 / Azul |
2246035001 | SEL & POIVRE | 100x100 | ROUGE |
2246035002 | SEL & POIVRE | 80x85 | BLEU |
- Switch on/off em Definições: ative "1 produto por SKU bruto" se preferir não agrupar
- Stock por declinação gerido automaticamente
- SKU CSV = reference PS por combinação
- EAN por combinação se fornecido no CSV
🌐 Multilingue 7 idiomas — Mercados europeus
| 🇫🇷 Francês |
🇬🇧 Inglês |
🇩🇪 Alemão |
🇪🇸 Espanhol |
🇮🇹 Italiano |
🇳🇱 Neerlandês |
🇵🇹 Português |
- 35 colunas multilingues no CSV: name, color, size, category, matter, care, description × 7 idiomas
- Conversão de codificação automática: o CSV está em Latin-1 (ISO-8859-1), o módulo converte célula a célula em UTF-8
- Deteção automática dos idiomas PS ativos com equivalente no CSV
- Mini-descrição inteligente: extraída das 2 primeiras frases se o CSV a fornecer, autogerada caso contrário (nunca sobrescrita)
- Slug limpo (link_rewrite) sem acentos por idioma
🌱 Features PS — Etiquetas sustentáveis filtráveis
O módulo cria automaticamente Features PrestaShop (filtráveis no front via pesquisa facetada) a partir do CSV:
🇫🇷 Made in France
🌾 European Flax
🛡️ Oeko-Tex Standard 100
💚 Oeko-Tex Made in Green
🌿 Bio (Orgânico)
♻️ Reciclado
♺ Upcycled
🇫🇷 Imprimé en France
🧵 Composição (matter)
🎨 Coleção (theme)
🌍 País de origem
Os seus clientes podem filtrar a navegação por "Made in France", "Bio", "Oeko-Tex"… Forte argumento comercial para públicos eco-conscientes / RSE.
📸 Multi-imagens até 10 por produto
- 10 colunas no CSV:
image-url-1 a image-url-10 (URLs absolutos para o CDN Maison Vivaraise)
- Download curl com User-Agent personalizado, seguimento de redireções
- Validação de formato via
getimagesize(): JPEG/PNG/GIF/WebP, ficheiros corrompidos rejeitados
- 1ª imagem = capa automaticamente
- Geração auto de todos os tamanhos PS (small, medium, large, home_default etc.) via
ImageManager::resize()
- Legenda multilingue que retoma o nome do produto em cada idioma
- Opção "imagem na descrição": injeção da 1ª imagem diretamente na descrição longa (boost SEO on-page), posição inicial ou final à escolha
⚡ Arquitetura de importação em tempo real
O cenário que muda tudo:
- 📥 Preparação: o módulo descarrega o CSV do URL SDE e coloca as linhas em cache JSON
- 🚀 Importação "1 produto = 1 chamada AJAX": sem freeze de 30 minutos, vê cada produto criado um a um
- 📊 Barra de progresso dourada: percentagem ao vivo + contador X/Y
- 📋 Log ao vivo estilo consola: badge colorido (Criado / Atualizado / Ignorado / Erro) + SKU + nome + ID PS#
- ⏸️ Botão Parar a qualquer momento, retoma possível
- 📈 Estatísticas ao vivo: Criados · Combinações · Atualizados · Ignorados · Erros
→ Sem mais página a bloquear. Sem mais 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 (criação + light updates) | 1×/dia |
light_sync | Atualização preços + stock + disponibilidade dos produtos já importados (modo leve) | 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 padrão, configurável) — sem timeout Apache 5xx
- Retoma precisa: retoma exatamente na linha onde parou
- Lock anti-concorrência via flock: sem execuções paralelas
- Retry de download CSV 3× com backoff 2s/4s/6s
- Botão Parar no BO para parar limpamente um CRON em curso (guarda o estado para retoma)
- Modo de teste com limite de produtos configurável, URLs auto-atualizados ao vivo
- Estado em tempo real no BO: página atual, criados, atualizados, erros
💰 Margens e SEO configuráveis
4 modos de cálculo de preço
| Modo | Descrição |
|---|
| RRP | Preço recomendado pelo fornecedor (recommended-retail-price) tal qual — o mais simples |
| Escalões ⭐ | % diferente conforme a faixa de preço de compra (5 escalões por padrão, configuráveis) |
| Markup fixo | Uma única % aplicada a todos os produtos |
| Wholesale | Preço de compra tal qual (venda B2B) |
Templates SEO personalizáveis
- Meta title / meta description com variáveis:
{name}, {brand}
- PS Tags multilingues auto-gerados a partir de brand + category + color + theme + matter (por idioma)
- Mini-descrição inteligente: extraída das 2 primeiras frases CSV se fornecida, autogerada caso contrário
- Auto-desativação rotura de stock (opção) ou "manter visível para o SEO"
🛠️ Manutenção — Eliminação seletiva 5 caixas
- ☐ Produtos importados: deteção a partir de 4 fontes (meta, supplier, product_supplier, mapeamento de categorias), compatível com o quirk multi-shop do PS9 com fallback wipe SQL em 25 tabelas relacionadas
- ☐ Atributos órfãos (Tamanho / Cor): elimina valores + grupos se nenhuma combinação os usar mais
- ☐ Marcas órfãs: elimina os manufacturers sem produto
- ☐ Fornecedor SDE - Maison Vivaraise: elimina o supplier apenas se já não tiver produtos associados
- ☐ Logs internos: truncate das tabelas history e import_errors
Tripla confirmação (caixa de diálogo + escrever ELIMINAR + botão). A árvore de categorias é gerida pelo módulo e não pode ser quebrada pelo utilizador.
🏷️ O catálogo Maison Vivaraise / SDE
Maison Vivaraise (sde.fr) é um ator francês do B2B de têxteis para o lar. Catálogo representado por marcas e coleções:
Winkler
Sel & Poivre
Maison Vivaraise
+ coleções sazonais
Categorias cobertas: roupa de cama, roupa de banho, artes de mesa, decoração têxtil, cozinha, tapetes, acessórios. Muitos produtos certificados Made in France, Oeko-Tex, European Flax, Bio.
⭐ 12 razões para escolher o Módulo SDE
- 🚀 Instalação em 3 minutos: URL CSV + árvore criada + iniciar a importação
- 🌳 Árvore pronta a usar: 7 cats + 38 subcats criadas na instalação (multilingue 7 idiomas)
- 🧠 Mapeamento inteligente de 4 níveis: estático → fuzzy → fallback → re-mapeável manualmente
- 🌐 Multilingue nativo 7 idiomas sem DeepL nem tradução manual
- 🧵 Variantes por parent: agrupamento de SKU em combinações tamanho + cor
- 📸 Multi-imagens até 10/produto com validação de formato
- 🌱 Features PS filtráveis: 8 etiquetas sustentáveis (Made in France, Oeko-Tex, Bio etc.) + composição + coleção + origem
- ⚡ 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
- 🛡️ Compatível PS 1.7 → 9.x: camada de compatibilidade
SdCompat que gere todas as versões, incluindo a migração meta_keywords → ps_tag do PS9
- 💎 Sem AdminController, sem separador BO, sem override: não polui o seu menu, não quebra 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 de 4 tabelas, do fornecedor SDE - Maison Vivaraise, da chave CRON, da árvore 7 + 38 categorias multilingues.
2
Indique o URL do CSV
Vá a Definições, cole o URL do ficheiro CSV fornecido por SDE / Maison Vivaraise, configure as variantes por parent, as Features, a imagem na descrição.
3
Configure as suas margens
5 escalões por padrão, ou escolha RRP / Markup fixo / Wholesale. Templates SEO personalizáveis com {name}/{brand}.
4
Inicie a importação
Clique "Iniciar importação". A barra de progresso e o log ao vivo iniciam. Vê cada produto criado diante dos seus olhos na sua subcategoria correta.
🔧 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 (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 SDE / Maison Vivaraise | Conta B2B necessária |
| URL CSV | A solicitar ao seu comercial SDE |
❓ Perguntas frequentes
P: O Módulo SDE dropshipping têxteis lar funciona no PrestaShop 9?
R: Sim, totalmente compatível com PS 9.x. A camada de compatibilidade interna SdCompat também gere 1.7 e 8 sem modificação de código. O módulo gere mesmo a migração específica do PS9 onde meta_keywords foi removido de ps_product_lang: muda automaticamente para o sistema ps_tag.
P: Quantos produtos posso importar?
R: Sem limite do lado do módulo. O catálogo Maison Vivaraise contém milhares de referências. Pode importar tudo ou usar o "Limite de produtos" para começar suavemente.
P: O meu alojamento partilhado de 9€/mês vai aguentar?
R: Sim, o módulo está especificamente 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 importação "all-in-one".
P: Como funciona a árvore predefinida?
R: Na instalação, o módulo cria 7 categorias principais (Cama, Banho, Decoração, Acessórios, Cozinha, Mesa, Tapetes) com as suas 38 subcategorias, multilingues em 7 idiomas. Se eliminar uma cat manualmente do BO, é recriada na próxima abertura do módulo (rede de segurança idempotente).
P: O que acontece aos produtos já importados numa nova importação?
R: Modo "light update" automático: o módulo deteta o SKU existente e atualiza APENAS o preço e o stock. NUNCA reescreve as suas descrições, categorias, Features ou tags — mantém as suas personalizações.
P: O que acontece se uma CSV-cat não corresponder a nenhuma subcategoria?
R: O produto é colocado em "Outros › Por classificar" (nunca um erro). Vai ao separador Mapeamentos de categorias, seleciona o destino correto e clica em Re-mapear: todos os produtos afetados são automaticamente movidos.
P: O CSV da SDE está em Latin-1, é problema?
R: Não, o módulo gere isso automaticamente. Conversão célula a célula em UTF-8 via mb_convert_encoding/iconv. Sem mais "40�C" em vez de "40°C", os acentos são preservados nos 7 idiomas.
P: E se 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.
P: Posso desinstalar limpamente?
R: Sim, mas a desinstalação mantém voluntariamente os seus produtos importados (perda irreversível evitada). A zona "Eliminação seletiva" permite uma limpeza granular com tripla confirmação: produtos / atributos / marcas / fornecedor / logs, independentes.
🛏️ Pronto a automatizar o seu dropshipping de têxteis para o lar?
O Módulo SDE dropshipping têxteis para o lar é a ferramenta mais completa para vender os produtos SDE / Maison Vivaraise (Winkler, Sel & Poivre etc.) no PrestaShop. Configurado uma vez, importa o catálogo ao seu ritmo numa árvore de categorias pronta a usar.
⚡ INSTALAÇÃO 3 MIN · 📚 IMPORTAÇÃO TEMPO REAL · 🛡️ COMPATÍVEL PS 1.7 → 9 · 🇫🇷 SUPORTE EM FRANCÊS
📋 Detalhes técnicos para programadores
Tabelas BD criadas (5): wp_sde_history, wp_sde_import_errors, wp_sde_product_meta (sku unique), wp_sde_combination_meta (sku unique), wp_sde_category_mapping (csv_path unique)
Configurações PS: WPSD_SETTINGS (JSON), WPSD_SUPPLIER_ID, WPSD_CRON_KEY, WPSD_LAST_IMPORT_AT, WPSD_LAST_IMPORT_COUNT, WPSD_CRON_LAST_*
CSV SDE (81 colunas multilingues): sku, ean, parent, name_xx, color_xx, size_xx, category+category_xx, matter_xx, care_xx, description_xx, image-url-1..10, price, recommended-retail-price, qty, weight, volume, country-code, customs-nomenclature, made-in-france, oeko-tex-*, organic, recycled, upcycled, european-flax, printed-in-france, theme, ecoparticipation-ttc
Arquitetura: 5 classes PHP limpas (SdCompat, SdCategoryTaxonomy, SdCategoryMapper, SdFeatureMapper, SdCsvImporter) + módulo principal + router AJAX + CRON. Sem override de classes core PrestaShop. Código comentado em francês.
Importação em tempo real: 2 endpoints AJAX (import_csv_prepare descarrega + parseia + cacheia, import_csv_row processa 1 produto). Estado persistido em JSON em uploads/state/ com index.php de proteção.
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() na chave CRON.
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 devolve false em multi-shop (verificação SQL post-delete + fallback wipe direto em 25 tabelas relacionadas), ProductAttribute renomeado a partir de Attribute.
Mapeamento de categorias: 4 níveis (DB cache → static map ~100 entradas → fuzzy similar_text ≥75% → fallback "Outros"). Cross-idioma (corresponde a qualquer tradução). Auto-dedup em cada abertura do módulo BO.
📦 Módulo desenvolvido por WebPoint · webpoint.fr · Atualizações regulares · Código limpo e comentado
