Módulo PrestaShop de dropshipping MATTERHORN
🛍️ ✨ 📦
Módulo Matterhorn Dropshipping
O único módulo que automatiza de A a Z o seu dropshipping de moda e lingerie no PrestaShop
PrestaShop 1.7 → 9.x · 13 idiomas · CRON 24/7 · ~50 000 produtos
Vende moda ou lingerie em dropshipping? Passa horas a importar produtos um a um, a copiar e colar descrições, a baixar imagens, a traduzir para várias línguas, a transferir manualmente cada encomenda para o seu fornecedor, a verificar trackings, a enviar e-mails de expedição aos seus clientes?
Com o Módulo Matterhorn dropshipping, tudo se torna automático. Já não toca em nada — o módulo trabalha em segundo plano 24/7.
⚡ Antes vs Depois do Módulo Matterhorn
| Tarefa |
❌ Sem o módulo |
✅ Com o módulo |
| Importação de 1 000 produtos | ~ 8 a 12 horas manuais | 1 clique, ~30 minutos em segundo plano |
| Atualização de stock e preços | Verificação manual diária | CRON automático a cada 2h |
| Processamento de uma encomenda | Reintrodução no site do fornecedor | Envio automático após o pagamento |
| E-mail de tracking ao cliente | Copiar e colar o número | Enviado automaticamente pelo PS |
| Multilíngue (13 idiomas) | Tradução manual ou DeepL pago | Textos nativos Matterhorn obtidos diretamente |
| Margens e preços de venda | Cálculo em Excel produto a produto | Escalões % automáticos por gama |
| Carga do servidor | Risco de timeout em alojamento partilhado | Otimizado para alojamento de 9 €/mês |
👤 A quem se destina este módulo?
🚀
Empreendedor que está a começar
Está a lançar a sua loja de moda/lingerie e quer ter mais de 1 000 produtos online desde o primeiro dia, sem stock e sem investimento inicial.
📈
E-comerciante em escala
Gere mais de 5 000 produtos manualmente e perde tempo no operacional em vez de no seu marketing/SEA.
🌍
Vendedor multilíngue
Vende em França, Alemanha, Itália, Espanha… e precisa de descrições nativas sem tradutor pago.
🎯 Funcionalidades completas do Módulo Matterhorn
📦 Importação do catálogo Matterhorn — Em massa, em segundo plano, sem timeout
- Importação unitária por ID Matterhorn para testar ou recuperar um produto danificado
- Importação em massa: 50, 100, 500, 1 000 produtos ou todo o catálogo (~50 000 produtos)
- Filtros avançados: por marca (multi-seleção), por categoria (multi-seleção), novidades dos últimos 60 dias
- Tag picker visual: adicione marcas/categorias clicando — chips coloridos com cruz de remoção
- Seleção persistente: a sua filtragem é memorizada entre sessões
- Recuperação após erro: relançamento automático em segundo plano em caso de timeout
- Adaptado a alojamento modesto: 1 produto por chamada API em modo económico
📸 Multi-imagens automáticas — 3 a 5 fotos por produto
- Todas as imagens Matterhorn obtidas via endpoint DETAIL (modelo, costas, detalhe, packshot)
- Imagem principal automaticamente marcada como cover
- Galeria completa visível na ficha de produto do lado do cliente
- Limite configurável: 1, 3, 5, 10 ou ilimitado (consoante o seu espaço em disco)
- Inserção automática na descrição longa (em cima/em baixo — bom para o SEO)
- Resize de todas as variantes PS: home, cart, large, medium, small, default
- Validação de formato: JPEG, PNG, GIF, WEBP — ficheiros corrompidos rejeitados de forma limpa
📐 Variantes por tamanhos — Combinações PS nativas
- Criação automática do grupo de atributo "Tamanho" e de todos os seus valores
- Uma combinação PS por variante Matterhorn (EU 36, EU 38, EU 40…)
- Stock individual por tamanho (visível no front, gerível a partir do BO)
- EAN13 se disponível em Matterhorn
- variant_uid Matterhorn memorizado para as encomendas (cada tamanho tem o seu próprio ID do lado do fornecedor)
- Referência de produto legível:
MH-V-{variant_uid} por combinação
🌐 Multilíngue 13 idiomas — Textos nativos Matterhorn
A Matterhorn dispõe de 13 domínios distintos (um por idioma). O módulo chama automaticamente o domínio correto para cada idioma ativo da sua loja:
| 🇫🇷 Francês | 🇬🇧 Inglês | 🇩🇪 Alemão | 🇮🇹 Italiano | 🇪🇸 Neerlandês |
| 🇨🇿 Checo | 🇸🇰 Eslovaco | 🇸🇪 Sueco | 🇷🇴 Romeno | 🇭🇺 Húngaro |
| 🇬🇷 Grego | 🇱🇹 Lituano | 🇧🇬 Búlgaro | + FR fallback | + EN fallback |
- Deteção automática dos idiomas PS ativos que possuem um domínio Matterhorn correspondente
- Auto-geração de descrições formatadas em HTML quando a API não as fornece (SEO friendly)
- Reformatação inteligente: cada frase torna-se um <p> para uma leitura mais fácil
💰 Margens configuráveis — Maximize o seu lucro
Estão disponíveis três modos de cálculo do preço de venda:
| Modo | Descrição | Para quem? |
|---|
| Escalões | % diferente consoante a faixa de preço de compra (ex.: +200% abaixo de 5 €, +35% acima de 500 €) | ⭐ Recomendado — maximiza a margem nos preços baixos |
| Markup fixo | Um único % aplicado a todos os produtos | Estratégia simples, margem constante |
| Grossista | Mostra o preço Matterhorn bruto (sem markup) | Lojas B2B que revendem a outros profissionais |
🔍 SEO multilíngue — Modelos personalizáveis
- Meta title / meta description com variáveis:
{name}, {brand}, {category}, {color}
- Geração automática em todos os idiomas ativos
- Slug limpo (link_rewrite) sem acentos nem caracteres especiais
- Imagem na descrição longa (no início ou no fim) para reforçar o SEO on-page
- Auto-desativação por rotura de stock ou opção "manter visível para o SEO" (URL e indexação preservadas)
🛒 Pipeline de encomendas 100% automático
O cenário que muda tudo:
- 👤 Um cliente faz uma encomenda na sua loja PrestaShop
- 💳 Paga → a encomenda passa para o estado "Pagamento aceite"
- ⚡ O módulo encaminha automaticamente a encomenda para a Matterhorn (PUT /B2BAPI/ACCOUNT/ORDERS/)
- 📨 Recebe um e-mail da Matterhorn com um link de pagamento (valida com 1 clique)
- 📦 A Matterhorn expede a encomenda diretamente ao seu cliente (em marca branca)
- 🚚 O CRON do módulo recupera o número de tracking quando estiver disponível
- 📧 O PrestaShop envia automaticamente o e-mail de expedição ao cliente com o seu tracking
→ Não tocou em NADA. A encomenda foi tratada de uma ponta à outra.
- Hook PS nativo
actionOrderStatusUpdate — disparo instantâneo na mudança de estado
- Seleção da transportadora: automática (a mais barata) ou por preferência (GLS, FEDEX, GLOBAL, INPOST…)
- Morada do cliente convertida para o formato Matterhorn (split street + house_number automático)
- Moeda configurável: EUR, GBP, USD, CHF, CZK, DKK, HUF, NOK, PLN, RON, RUB, SEK, BGN, CAD, AUD
- Idempotente: não volta a encaminhar uma encomenda já transmitida
- Painel de controlo: ver todas as suas encomendas PS e o estado Matterhorn num só olhar
- Vista de encomendas Matterhorn: lista de TODAS as encomendas do lado do fornecedor (manuais ou via API), com detalhes de fatura e tracking
⏰ CRON 24/7 — 4 URLs prontos a colar no seu crontab
| Ação CRON |
Função |
Frequência aconselhada |
full_import | Importação completa do catálogo (criação ou atualização) | 1×/dia |
stock_check | Atualização apenas de stock + preço (filtro delta 24h) | a cada 2h |
tracking_sync | Recupera trackings + e-mail de expedição ao cliente | a cada hora |
orders_refresh | Lista de encomendas Matterhorn atualizada | a cada hora |
- Chave segura de 32 caracteres gerada na instalação — os seus URLs 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) — sem timeout do Apache
- Retoma precisa: continua exatamente na página onde tinha parado
- Throttle Matterhorn 600ms: respeita o limite API de 2 req/seg
- Retry automático em caso de rate-limit / erro 429
- Estado em tempo real no BO: página atual, criados, atualizados, erros
- Botão de paragem: para de forma limpa o CRON em execução
- Limite de produtos configurável: importa apenas N produtos por "job" (teste, amostra)
📊 O catálogo Matterhorn em números
~50 000
PRODUTOS DISPONÍVEIS
Vestidos, blazers, blusas, lingerie, meias, soutiens, acessórios… Marcas conhecidas como Top Secret, Nife, Numoco, Axami, Mat, Gaia — ou pequenas joias menos conhecidas para descobrir e divulgar em exclusivo na sua loja.
⭐ 10 razões para escolher o Módulo Matterhorn
- 🚀 Instalação em 5 minutos: cole a sua chave API, teste a ligação e comece
- 🤖 100% AJAX, zero recarregamentos: interface fluida, moderna e agradável
- 📚 Documentação integrada em 12 secções: nenhuma ligação à internet necessária para a consultar
- 🛡️ Compatível PS 1.7 → 9.x: camada de compatibilidade interna para gerir as evoluções do PrestaShop
- ⚡ Otimizado para alojamento modesto: importação de 1 produto por chamada, throttle 600ms, time-budget 60s
- 🔐 Segurança máxima: chave API protegida na desinstalação, throttle anti rate-limit, validação no servidor
- 🎨 Design personalizado: cabeçalho com gradiente, separadores estilizados, paleta violeta/púrpura coerente
- 🧹 Manutenção fácil: eliminação seletiva com 6 opções, hook auto-clean dos produtos
- 💎 Sem AdminController, sem 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 a partir do BO. Cria automaticamente 6 tabelas, 1 fornecedor, 4 URLs CRON seguros.
2
Ligue a sua conta
Cole a sua chave API Matterhorn, escolha o seu idioma principal, teste a ligação (1 clique).
3
Configure as suas margens
8 escalões por padrão (200% a 35%). Modelos SEO, categoria-pai, multi-imagens, multilíngue: tudo é configurável.
4
Inicie a importação
Filtre por marcas + categorias, escolha a quantidade, clique em "Iniciar". Depois disso, o CRON assume 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-loja | Compatível (utiliza a loja atual) |
| Hooks utilizados | actionProductDelete, actionOrderStatusUpdate |
| Override de classe | Nenhum (zero override para preservar os seus outros módulos) |
| AdminController | Nenhum (configuração apenas na ficha do módulo) |
| Separador na sidebar do BO | Nenhum (não polui o seu menu) |
| Conta Matterhorn | Conta B2B necessária (gratuita em matterhorn-wholesale.com) |
| Chave API Matterhorn | Para gerar no seu painel de cliente (gratuita, instantânea) |
❓ Perguntas frequentes
P: O módulo Matterhorn dropshipping funciona em PrestaShop 9?
R: Sim, totalmente compatível com PS 9.x. Uma camada de compatibilidade interna também gere as versões 1.7 e 8 sem modificações.
P: Quantos produtos posso importar?
R: Sem limite por parte do módulo. O catálogo Matterhorn completo tem cerca de 50 000 produtos. Pode importar tudo ou segmentar por marcas/categorias.
P: O meu alojamento partilhado de 9 €/mês vai aguentar?
R: Sim, o módulo está especialmente otimizado para alojamentos modestos. Modo CRON 1 produto/chamada, time-budget 60s, auto-relançamento assíncrono. Sem risco de timeout.
P: As encomendas são pagas automaticamente na Matterhorn?
R: Não, a API da Matterhorn não permite o pagamento automático. Recebe um e-mail com um link de pagamento para validar com 1 clique. É intencional (segurança contabilística). Em seguida, o módulo recupera automaticamente o tracking + e-mail ao cliente.
P: Só tenho 1 idioma ativo, para que serve o multilíngue?
R: Pode desativar o multilíngue (ganho de velocidade). Se mais tarde ativar o alemão ou o italiano em PS, o módulo deteta automaticamente e obtém os textos nativos corretos da Matterhorn.
P: O que acontece se a Matterhorn estiver temporariamente indisponível?
R: O módulo deteta os erros de rede, retenta automaticamente (3 tentativas com backoff exponencial) e retoma onde tinha parado na próxima execução do CRON.
P: Posso desinstalar de forma limpa?
R: Sim, mas a desinstalação mantém intencionalmente os seus produtos importados (perda irreversível evitada). Uma área "Eliminação seletiva" no separador Importação permite uma limpeza granular com confirmação.
🎯 Pronto para automatizar o seu dropshipping?
O Módulo Matterhorn dropshipping é a ferramenta mais completa para PrestaShop. Uma vez configurado, 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: wp_matterhorn_history, wp_matterhorn_import_errors, wp_matterhorn_product_meta, wp_matterhorn_combination_meta, wp_matterhorn_category_mapping, wp_matterhorn_orders
Configurações PS: WPMH_SETTINGS (JSON), WPMH_CRON_KEY, WPMH_SUPPLIER_ID, WPMH_CRON_PROGRESS, caches de dicionários
Endpoints API utilizados: GET /B2BAPI/ITEMS/, GET /B2BAPI/ITEMS/{id}, GET /B2BAPI/DICTIONARIES/BRANDS, GET /B2BAPI/DICTIONARIES/CATEGORIES, GET /B2BAPI/DICTIONARIES/DELIVERY, PUT /B2BAPI/ACCOUNT/ORDERS/, GET /B2BAPI/ACCOUNT/ORDERS/, GET /B2BAPI/ACCOUNT/ORDERS/{id}
Arquitetura: 7 classes PHP limpas (MhCompat, MhApiClient, MhCategoryMapper, MhProductImporter, MhOrderForwarder, MhTrackingSync, mais o módulo principal). Sem override de classes core do PrestaShop. Código comentado em francês.
Segurança: hash_equals() na chave CRON (anti timing attack), pSQL() em todo o lado, token CSRF nativo PS em AJAX, throttle anti DoS, validação do formato das imagens.
📦 Módulo desenvolvido pela WebPoint · webpoint.fr · Atualizações regulares · Código limpo e comentado
