Módulo MALFINI Importação XML Vestuário Promocional PrestaShop — 3100 Produtos, 230 Modelos, Stock Real, 8 Idiomas

Módulo PrestaShop de dropshipping MALFINI

Está a lançar uma loja de vestuário promocional personalizável? Trabalha com a MALFINI, a.s., o grossista checo de referência em têxtil B2B (T-shirts, Polos, Sweatshirts, Polares, Camisas, Casacos, Bonés, Sacos, Calçado de segurança…) e passa os dias a importar cada modelo, cada tamanho, cada cor a partir do portal B2B, a copiar as características técnicas (composição do tecido, gramagem, temperatura de lavagem, tipos de aplicação), a carregar as fotos das 5 vistas e a atualizar o stock tamanho a tamanho?

Com o Módulo MALFINI de importação de vestuário promocional para PrestaShop, tudo se torna automático. Indica o URL XML MALFINI no seu idioma (8 disponíveis), clica em "Iniciar importação" e o módulo cria os seus 3100 produtos PrestaShop com as suas combinações de tamanhos, o seu stock real por tamanho, as suas características técnicas, os seus PDFs de guia de tamanhos e as suas 5 vistas fotográficas — diante dos seus olhos.

⚡ Antes vs Depois do Módulo MALFINI

Tarefa	❌ Sem o módulo	✅ Com o módulo
Importação de 3100 produtos MALFINI	80h+ manual, cópia do portal B2B	1 clique, ~3-5h em segundo plano
Combinações de tamanhos (XS-S-M-L-XL...)	17 000 combinações a criar EAN a EAN	Auto via agrupamento VARIANT XML
Stock por tamanho	Atualização manual tamanho a tamanho	Stock real sincronizado em cada CRON light_sync
Categorias limpas e hierárquicas	15 cats planas + prefixo parasita "Categoria >"	4 grandes secções + 15 sub-cats, prefixo limpo
Descrição rica com pictogramas	Descrição plana "100% algodão" sem visual	Tabela auto com pictogramas SVG locais
PDFs guia de tamanhos + ficha de produto	Links partidos quando MALFINI muda CDN	PDFs descarregados localmente + anexos PS nativos
Pictogramas de atributos (lavagem, gramagem…)	Download em cada carregamento de ficha	SVG embutidos localmente, reutilizados em todos os produtos
Cores alternativas (mesmos tamanhos, outra cor)	Sem indicação visual	Secção "Disponível também em" com círculos de cor
Prefixo XML "Categoria >" parasita	Presente nas 15 categorias	Auto-limpo no parsing
Título SEO de produto (TITLE só = "Polo mulher")	Títulos duplicados entre modelos → KO Google	"Polo mulher Pamela 200 - branco" (composição auto)
Dados B2B internos (Pcs/embalagem, Compra mín.)	Risco de exibição ao cliente final	Filtro auto, nunca visível no front
Servir 8 mercados (idiomas)	Tradução manual das 3100 fichas	8 ficheiros XML MALFINI, troca em 30s

👤 A quem se destina este módulo?

🎯 Funcionalidades completas do Módulo MALFINI

📥 Importação inteligente e progressiva

• Importação otimizada: compatível com todos os tipos de alojamento, mesmo partilhado
• Progresso em tempo real: barra de progresso + log ao vivo (estado de cada produto)
• Retomar após interrupção: se fechar a página, a importação retoma onde parou
• Botão "Iniciar importação" com popup inteligente que avisa se já existem produtos
• Botão "Criar produtos em falta" (amarelo): pré-filtro inteligente que importa apenas as novidades — relançamentos diários ultra-rápidos
• Modo "Teste 10 produtos": valida a sua configuração numa amostra antes da importação completa

👕 Combinações de tamanhos + stock real por tamanho

• 1 produto PS = 1 cor de um modelo MALFINI (ex.: "Polo mulher Pamela 200 - branco" e "Polo mulher Pamela 200 - preto" são 2 produtos PS distintos)
• Tamanhos automáticos como combinações: XS, S, M, L, XL, 2XL, 3XL… ou para criança 110 cm/4 anos, 122 cm/6 anos…
• Stock real por tamanho recuperado diretamente do XML MALFINI (atualizado em cada CRON light_sync)
• EAN por tamanho armazenado na combinação PS (código de barras nativo)
• Peso bruto/líquido + volume por tamanho para cálculos precisos de portes
• Código aduaneiro (TARIFF_CODE) armazenado para conformidade aduaneira de exportação

🗂️ Categorias arborescentes + filtros inteligentes

• 4 grandes secções pai auto-criadas: Vestuário / Calçado e Segurança / Acessórios / Outlet
• 15 subcategorias MALFINI arrumadas dentro: T-shirts, Polo, Sweatshirts, Polar, Camisas, Casacos-coletes, Calções, Atoalhado, Calçado de segurança, Bonés, Sacos, Material promocional…
• Prefixo "Categoria >" auto-limpo (parasita XML resolvido)
• Categoria raiz configurável: escolha onde criar a árvore

📝 Descrição longa auto-gerada e enriquecida

• Descrição original MALFINI (specification + description)
• Tabela de características com pictogramas SVG locais: Composição do tecido, Gramagem, Temperatura de lavagem, Etiqueta, Tipo de aplicação (bordado / serigrafia / impressão digital / transfer…)
• Secção "Documentos para descarregar" com links para guia de tamanhos PDF + ficha de produto completa PDF
• Secção "Disponível também em" com círculos de cor das outras versões do modelo (apenas visual, sem links partidos)
• Posição configurável da tabela de características (topo ou fundo da descrição)

📷 Produto multi-imagem (até 5 vistas)

• 5 vistas diferentes por produto: frente, costas, lado, grandes planos, ambientado
• Download automático do CDN MALFINI (URLs fornecidos no XML)
• Redimensionamento automático em todos os ImageType do PrestaShop (home_default, large_default, medium_default, cart_default, thickbox_default…)
• Switch independente para ativar/desativar as vistas complementares (a capa principal é sempre importada)

🎨 Mídia anexa descarregada localmente

• Pictogramas SVG de atributos armazenados no módulo (composição, lavagem, gramagem…) — reutilizados em centenas de produtos, descarregados uma única vez
• Círculos de cor (VARIANT_GROUP_ICON) descarregados localmente para a secção "Disponível também em"
• PDFs guia de tamanhos + ficha de produto descarregados localmente + criados como anexos PS nativos (aparecem no separador "Downloads" do produto no front, conforme o seu tema)
• Cache estática inteligente: nenhum ficheiro é re-descarregado desnecessariamente

🔍 Características filtráveis (Features PS)

• 5 features filtráveis auto-criadas: Cor, Sexo (Mulher/Homem/Criança/Unissexo), Composição do tecido, Gramagem, Lavável a
• Compatível com o módulo oficial PrestaShop facetedsearch para filtros front avançados
• Switch on/off global

🛡️ Filtro B2B automático

• Os atributos MALFINI "Pcs na embalagem" e "Compra mínima" são dados B2B internos
• O módulo oculta-os automaticamente da descrição E das Features PS
• Os seus clientes finais NUNCA os verão, nem por acidente

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

Ação	Descrição	Frequência recomendada
full_import	Importação completa: criações + atualizações do catálogo.	1× por dia (3:00)
light_sync	Atualização de stock + preço por tamanho apenas. Ideal para stock real em tempo real.	A cada 4-6h
cleanup_logs	Limpeza de históricos e erros > N dias (retenção configurável).	1× por semana

🔐 Segurança: cada URL CRON contém uma chave secreta de 32 caracteres regenerável.

🧪 Modo teste a partir do BO: um botão "▶" lança a execução real e devolve o resultado no BO.

📏 Limitador integrado: campo "Limite de produtos por execução CRON" (predefinição 0 = ilimitado). Para alojamentos com timeout curto, o módulo auto-relança em lotes.

💰 Margens e IVA — Mantém o controlo

3 modos de cálculo do preço

• Margens por escalões (recomendado): 6 escalões comerciais pré-preenchidos adaptados ao têxtil promocional (180% nos preços baixos → 60% nos grandes volumes)
• Margem fixa: uma única percentagem para todo o catálogo
• Preço sem IVA bruto: nenhuma margem aplicada (revenda B2B sem margem)

IVA via TaxRulesGroup PrestaShop nativo

O módulo utiliza as regras de imposto que já configurou em Internacional → Impostos → Regras de imposto. Isto permite:

• IVA português (23% / 13% / 6%)
• IVA europeu por país (27 países UE)
• Isenções de IVA (regime simplificado)
• Distinção pro/particular via grupos de clientes PS

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

🛠️ Manutenção — Ferramentas integradas

📜 Histórico e erros

• Histórico dos últimos eventos (downloads XML, importações, eliminações)
• 100 últimos erros com SKU, tipo, mensagem completa

🗑️ Eliminação seletiva segura

• Eliminar os produtos importados apenas pela MALFINI
• Eliminar as categorias vazias provenientes do XML MALFINI (com segurança: apenas afeta categorias sem produto E sem subcategoria)
• Eliminar as marcas sem produtos restantes
• Eliminar os atributos (grupo Tamanho) se nenhuma combinação os utilize — dupla confirmação obrigatória
• Esvaziar o histórico e os erros

⚠️ Segurança: estas ações NUNCA mexem nos outros produtos/categorias da sua loja. O módulo identifica unicamente os seus próprios dados.

🏷️ O catálogo MALFINI em números

👕 Famílias de produtos cobertas pela MALFINI

• T-shirts (mulher, homem, criança, unissexo)
• Polos (mulher, homem, criança, unissexo)
• Sweatshirts (mulher, homem, criança, unissexo)
• Polares (mulher, homem, criança, unissexo)
• Camisas (mulher, homem)
• Casacos-coletes (softshell, anorak, casaco de trabalho)
• Calções
• Atoalhado (roupões, toalhas)
• Calçado de segurança (baixo, alto)
• Bonés, gorros, chapéus
• Sacos, mochilas, totes
• Material promocional diverso
• OUTLET e gama complementar (fim de série)

⭐ 14 razões para escolher o Módulo MALFINI

1. Compatível com PrestaShop 9.x (testado em produção), 8.x e 1.7.x
2. 3100 produtos importados em poucas horas (vs semanas manualmente)
3. 17 000+ combinações de tamanhos auto-criadas com stock real
4. Stock real por tamanho sincronizado via CRON light_sync (4×/dia recomendado)
5. 4 grandes secções + 15 subcategorias auto-criadas (prefixo parasita limpo)
6. Descrição enriquecida automática: tabela de características + pictogramas SVG locais + PDFs descarregáveis + cores alternativas
7. 5 vistas de imagem por produto descarregadas e redimensionadas
8. 8 idiomas disponíveis do lado do fornecedor
9. Margens por escalões pré-preenchidos comercialmente para o têxtil
10. IVA via TaxRulesGroup PS nativo
11. Botão "Criar em falta": pré-filtro SKU para relançamentos rápidos
12. CRON 24/7 seguro com modo teste BO + limitador integrado
13. Filtro B2B automático: "Pcs/embalagem" e "Compra mínima" nunca mostrados ao cliente final
14. Documentação integrada + Ferramentas de manutenção com dupla confirmação para ações sensíveis

🎬 Como funciona em 5 passos

🔧 Compatibilidade técnica

PrestaShop	1.7.0 → 9.x (testado 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	~1 GB (3100 produtos × 5 vistas × 6 declinações + SVG + PDFs)
Memória PHP mínima	128 MB
Multi-loja	✅ Nativo
Alojamento	Compatível com partilhado (OVH, o2switch, Hostinger), VPS, dedicado, cloud

❓ Perguntas frequentes

Como obter o URL XML MALFINI?

Contacte o seu comercial MALFINI ou o serviço de partnership deles. O acesso ao fluxo XML é reservado às contas parceiras MALFINI — receberá o URL adaptado ao seu mercado (8 idiomas disponíveis).

O módulo funciona no PrestaShop 9?

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

Quanto tempo demora a importação completa?

Com todas as vistas de imagem: 3-5h para 3100 produtos + 17 000 combinações de tamanhos. Sem as vistas complementares: ~1h. Dica: deixe correr via CRON noturno.

O stock é mesmo real?

Sim, o XML MALFINI contém STOCK_AMOUNT por variant (tamanho). O módulo sincroniza este stock em cada importação (full_import) ou atualização rápida (light_sync). Execute light_sync 4×/dia para ter stock quase em tempo real.

Porquê 1 produto PS por cor e não 1 produto com 2 eixos (cor×tamanho)?

Por simplicidade de exibição no front e robustez: 1 ficha de produto = 1 visual coerente (as imagens são por cor). A secção "Disponível também em" indica visualmente as outras cores disponíveis. Esta abordagem evita também os bugs de cache de imagem PS quando se altera a combinação.

O que acontece se a MALFINI alterar um preço ou adicionar um produto?

No próximo CRON full_import: o novo produto é criado, os preços existentes atualizados conforme os seus escalões, o stock por tamanho sincronizado. Mantém as suas descrições modificadas se o tiver feito a partir do BO.

O que são os atributos B2B "Pcs na embalagem" e "Compra mínima"?

São dados B2B internos que a MALFINI fornece aos seus revendedores (quantas unidades por caixa, compra mínima junto deles). O módulo oculta-os automaticamente da descrição e das Features PS para nunca serem visíveis ao seu cliente final.

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, é preciso fazer 1 importação por idioma (clone o módulo).

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

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

O módulo gere a personalização têxtil (bordado, serigrafia)?

O módulo importa as características técnicas do produto (tipos de aplicação possíveis: bordado, serigrafia, transfer digital, transfer litho, transfer serigráfico, mudança de etiqueta). No entanto, não inclui o serviço de personalização no front (configurador de marcação, upload de logótipo do cliente) — para isso, utilize um módulo dedicado à personalização do produto.

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