DataFirefly Marketplace: guia completo
Instalar, configurar e explorar o seu marketplace multivendedor no PrestaShop 8 e 9.
Apresentação
O DataFirefly Marketplace transforma a sua loja PrestaShop num marketplace multivendedor. Vendedores terceiros inscrevem-se, publicam os seus produtos e gerem as suas encomendas, enquanto a loja orquestra as comissões, os pagamentos e a conformidade a partir do back-office.
O módulo cobre todo o ciclo: inscrição e validação dos vendedores, área de vendedor completa, divisão real das encomendas em subencomendas, motor de comissões, pagamento repartido regulado (Mangopay e Stripe Connect), entrega por vendedor, conformidade europeia (DSA, P2B, IVA), avaliações, mensagens, planos, litígios e analytics, tudo em cinco idiomas (FR, EN, ES, DE, IT).
Adaptação para Portugal: o português não faz parte dos 5 idiomas entregues. Traduza as cadeias do módulo em Internacional → Traduções e crie as pastas mails/pt/ para os e-mails aos vendedores e compradores antes de abrir o marketplace ao público.
Compatibilidade e pré-requisitos
- PrestaShop 8.0, 8.1, 8.2 e 9.x
- PHP 8.1 ou superior
- Multiloja e multilingue
- Para o pagamento repartido: uma conta Mangopay e/ou Stripe Connect (chaves sandbox para os testes, chaves de produção para a exploração)
Instalação
- No back-office, aceda a Módulos > Gestor de módulos, clique em Carregar um módulo e selecione o arquivo
dfmarketplace.zip. - A instalação cria as tabelas necessárias, regista os hooks e adiciona o menu Marketplace no back-office, bem como um conjunto de dados de demonstração (planos e regras de comissão).
- Abra Marketplace > Configuração para parametrizar o módulo.
Na desinstalação, as tabelas de dados são conservadas deliberadamente para não perder o histórico dos vendedores, encomendas e comissões.
Configuração inicial
Em Marketplace > Configuração, preencha os parâmetros principais:
- Comissão por defeito: taxa aplicada quando não existe nenhuma regra mais específica (15% por defeito).
- Prestador de pagamento por defeito: Mangopay ou Stripe Connect, e depois as chaves correspondentes.
- Modo híbrido: autoriza o operador a vender os seus próprios produtos ao lado dos vendedores terceiros.
- Faturar as encomendas filhas: gera uma fatura dedicada para cada subencomenda de vendedor.
- Estado que liberta o escrow: estado de encomenda que aciona a libertação dos fundos para as carteiras dos vendedores (por exemplo «Expedida» ou «Entregue»).
- Mostrar a identidade do vendedor (DSA): ativa o bloco de identidade do vendedor profissional na montra.
- Prefixo da fatura de comissão e pré-aviso P2B (dias).
- Validação automática dos produtos: se ativa, os produtos dos vendedores são publicados sem moderação.
Gestão dos vendedores
Inscrição
Um cliente com sessão iniciada pode tornar-se vendedor através da página de inscrição do módulo (ligação a partir da sua conta). Preenche o nome da loja, a sua forma jurídica e as suas informações legais. É-lhe enviado um e-mail de acuse de receção.
Validação e KYC
A partir de Marketplace > Vendedores, o operador pode aprovar, suspender ou rejeitar um vendedor. Na aprovação, o onboarding no PSP é acionado e é enviado um e-mail de validação. O vendedor pode carregar os seus documentos KYC (certidão permanente do registo comercial, documento de identificação, comprovativo de IBAN) a partir do seu painel.
Em conformidade com o regulamento P2B, qualquer suspensão é acompanhada de um e-mail a informar o vendedor, com uma exposição dos motivos comunicada separadamente.
Área de vendedor
O vendedor dispõe de um painel compartimentado: acede apenas aos seus próprios dados.
- Painel: saldo da carteira, montante a transferir, número de produtos, estado, encomendas, livro-razão.
- O meu perfil: logótipo, banner, apresentação, políticas de devolução e de entrega, contactos públicos e campos DSA.
- Os meus produtos: criação e edição de fichas completas (fotografias, referência/SKU, EAN, estado, preço e IVA, quantidade, categoria, peso e dimensões, descrições).
- Entrega: seleção das transportadoras propostas e regras de custos (por preço ou peso, por zona, com limiar de gratuitidade).
Divisão das encomendas
Quando uma encomenda contém produtos de vários vendedores, o módulo divide-a em verdadeiras encomendas filhas (uma por vendedor). Cada subencomenda tem os seus próprios portes, a sua comissão fixada, a sua fatura e o seu crédito de carteira. O detalhe lógico é conservado para rastreabilidade, e a compartimentação entre vendedores é estrita.
A fatura da encomenda-mãe segue o fluxo nativo do PrestaShop. Verifique, na sua versão, que o módulo de pagamento não fixa uma fatura-mãe com o montante completo antes da divisão.
Comissões
O motor aplica uma cascata de regras, da mais específica à mais geral: produto › vendedor › categoria › global, com recurso à comissão por defeito. As regras podem ser em percentagem, em montante fixo ou híbridas, com base no valor com IVA ou sem IVA.
São suportados escalões de volume de negócios mensal: por exemplo, 15% até 5 000 € de faturação mensal, e depois 12% acima disso. A comissão é fixada no momento da encomenda e nunca é recalculada.
Pagamento repartido, carteira e escrow
Os adaptadores Mangopay e Stripe Connect cobram os fundos de forma repartida e conservam-nos em escrow. Quando é atingido o estado de encomenda configurado, os fundos são libertados para as carteiras dos vendedores.
Transferências
O vendedor pede um levantamento a partir do seu painel. O operador executa as transferências a partir de Marketplace > Comissões e pagamentos num clique (transferência SEPA através do PSP). Cada movimento é registado no livro-razão da carteira.
Webhooks
Configure o URL de webhook do módulo do lado do PSP (controlador webhook) para sincronizar os estados de pagamento. A assinatura é verificada a cada chamada.
Entrega por vendedor
Cada vendedor define as suas transportadoras e as suas regras de custos. Na expedição, introduz a transportadora e o número de seguimento a partir do seu painel: é enviado um e-mail ao comprador, e quando todas as subencomendas de uma encomenda estão expedidas, a encomenda-mãe passa automaticamente ao estado «Expedida».
Conformidade europeia
- DSA: a identidade do vendedor profissional (denominação social, número de registo, IVA, ponto de contacto) é apresentada na sua montra.
- Faturas de comissão: geradas automaticamente por período mensal, numeradas e arquivadas. O operador pode lançar a geração em massa a partir de Marketplace > Faturas de comissão.
- P2B: uma página publica as condições aplicáveis aos vendedores, os parâmetros de classificação e o pré-aviso em caso de alteração.
- IVA «plataforma considerada fornecedora»: um indicador por vendedor é apresentado e reportado na fatura de comissão.
O módulo expõe e apresenta o indicador de IVA, mas não inclui um motor de repartição OSS. A repartição fina do IVA continua a ser comandada pela configuração dos impostos da sua loja. As faturas de comissão geradas pelo módulo não substituem a faturação emitida por software certificado pela AT, exigida para o operador português.
Avaliações, mensagens, planos, litígios e analytics
- Avaliações: os compradores que encomendaram a um vendedor podem deixar uma avaliação, moderada a partir de Marketplace > Avaliações. A nota média é recalculada automaticamente.
- Mensagens: conversas entre comprador, vendedor e operador; caixa de entrada do lado do vendedor.
- Planos de vendedor: Free, Pro e Premium por defeito, com quotas de produtos, taxas de comissão e acesso a analytics. Geridos a partir de Marketplace > Planos de vendedor.
- Litígios e devoluções: abertos por subencomenda, resolvidos a partir de Marketplace > Litígios e devoluções, com eventual reembolso repercutido na carteira do vendedor.
- Analytics: vista do operador (GMV, taxa de comissão, melhores vendedores) em Marketplace > Analytics, e estatísticas por vendedor (condicionadas pelo plano) no seu painel.
Separadores do back-office
O menu Marketplace reúne: Vendedores, Encomendas de vendedores, Comissões e pagamentos, Faturas de comissão, Avaliações, Litígios e devoluções, Planos de vendedor, Analytics e Configuração.
FAQ e resolução de problemas
Os fundos não são libertados para os vendedores
Verifique que o «Estado que liberta o escrow» está definido na configuração e que os vendedores em causa concluíram o seu onboarding no PSP (carteira criada).
Um produto de vendedor não aparece na loja
Um produto permanece oculto enquanto não for aprovado. Verifique o seu estado de validação na lista de produtos do vendedor, ou ative a validação automática.
Após uma atualização, um ecrã de administração dá erro
Esvazie a cache do PrestaShop (pasta var/cache) após a instalação ou a atualização, e recarregue depois o back-office.