# DataFirefly Marketplace: guia completo > Guia completo de instalação, configuração e utilização do módulo DataFirefly Marketplace para PrestaShop 8 e 9. - Página: - Idioma: pt - Atualizado em: 2026-10-12 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/datafirefly-marketplace/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-marketplace/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-marketplace/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-marketplace/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-marketplace/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-marketplace/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-marketplace/index.md) - Índice: ## Apresentação O DataFirefly Marketplace transforma a sua loja PrestaShop num marketplace multivendedor. Vendedores terceiros registam-se, publicam os seus produtos, preparam e enviam as suas encomendas e respondem aos seus clientes, enquanto o senhor gere as comissões, os pagamentos e a conformidade a partir do back-office. O módulo cobre todo o ciclo: registo e validação dos vendedores, área de vendedor organizada em separadores, divisão real das encomendas em subencomendas, comissões, pagamento repartido (Mangopay e Stripe Connect), entrega por vendedor, seguimento das encomendas pelo comprador, mensagens, conformidade europeia (DSA, P2B, IVA), avaliações, planos, litígios e estatísticas. A interface e os e-mails estão traduzidos em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português. ## 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 ou Stripe Connect (chaves sandbox para os testes, chaves de produção para a exploração) ## Instalação 1. No back-office, abra **Módulos > Gestor de Módulos**, clique em **Carregar um módulo** e selecione o arquivo `dfmarketplace.zip`. 2. A instalação cria as tabelas, regista os hooks, adiciona o menu **DataFirefly Marketplace** ao back-office (com os nomes na língua de cada funcionário) e cria três planos de demonstração: Free, Pro e Premium. 3. Abra **DataFirefly Marketplace > Configuração** para parametrizar o módulo. Na desinstalação, as tabelas de dados são **conservadas** de propósito, para não perder o histórico dos vendedores, das encomendas e das comissões. ## Atualização a partir de uma versão anterior Carregue o novo arquivo no Gestor de Módulos e clique em **Atualizar**. Não é necessário desinstalar o módulo: o script de atualização cria as tabelas em falta, adiciona as novas colunas sem perda de dados, regista os novos hooks, acrescenta as novas definições, protege as pastas privadas e esvazia as caches Smarty e Symfony. Funciona a partir de qualquer versão 1.0, 1.1, 1.2 ou 1.3. Durante a atualização, os nomes dos menus do back-office passam para a língua de cada funcionário. Um nome que o senhor tenha alterado manualmente é mantido. ## Configuração inicial Em **DataFirefly Marketplace > Configuração**, preencha os parâmetros principais: - **Comissão predefinida**: taxa aplicada quando não existe nenhuma regra mais específica (15% por predefinição). - **PSP predefinido**: o prestador de pagamento, Mangopay ou Stripe Connect, seguido das chaves correspondentes. - **Modo híbrido**: o operador vende também os seus próprios produtos ao lado dos vendedores terceiros. - **Faturar as subencomendas**: é gerada uma fatura própria para cada subencomenda de vendedor. - **Estado que liberta os fundos (escrow)**: estado de encomenda que aciona a libertação dos fundos para as carteiras dos vendedores (por exemplo «Enviado» ou «Entregue»). - **Mostrar a identidade do vendedor (DSA)**: apresenta na montra o bloco de identidade do vendedor profissional. - **Prefixo da fatura de comissão** e **Pré-aviso P2B (dias)**. - **Aprovação automática de vendedores** e **Aprovação automática de produtos**: sem moderação, as contas e os produtos são publicados logo após a criação. - **Categorias disponíveis para os vendedores**: limita a árvore de categorias que os vendedores veem no formulário de produto. Deixe vazio para propor todas as categorias (a categoria «Raiz» nunca é proposta). ## Gestão dos vendedores ### Registo Um cliente com sessão iniciada torna-se vendedor a partir da página de registo do módulo (ligação na sua conta e no diretório de vendedores). A página explica as etapas e apresenta os planos com a respetiva comissão. O futuro vendedor indica o nome da loja, o seu estatuto (particular ou profissional), as suas informações legais, o IBAN e o BIC, e aceita as condições para vendedores. São verificados a unicidade do nome da loja, a denominação social (obrigatória para um profissional), os dígitos de controlo do IBAN e o formato do BIC. Em caso de erro, os valores introduzidos são mantidos. É enviado um e-mail de confirmação de receção. ### Validação e KYC Em **DataFirefly Marketplace > Vendedores**, o operador pode **Aprovar**, **Suspender** ou **Rejeitar** um vendedor. Cada mudança de estado envia um e-mail ao vendedor. Na aprovação, é iniciado o onboarding junto do prestador de pagamento. O vendedor carrega os seus documentos KYC (certidão permanente do registo comercial, documento de identificação, comprovativo de IBAN) no separador **Documentos** do seu painel. Na ficha do vendedor, o painel KYC lista os documentos: o senhor abre-os a partir do back-office e depois valida ou recusa o KYC. Os documentos KYC e as faturas de comissão são guardados em pastas inacessíveis a partir da web, com nomes de ficheiro impossíveis de adivinhar. O tipo real de cada ficheiro é verificado e o tamanho está limitado a 10 MB. Em conformidade com o regulamento P2B, qualquer suspensão é acompanhada de um e-mail que informa o vendedor, com uma exposição dos motivos comunicada separadamente. ## Área de vendedor O vendedor só tem acesso aos seus próprios dados. O seu painel está organizado em separadores. ### Visão geral - Lista **Primeiros passos**: validação da conta, logótipo e apresentação, KYC, transportadoras, primeiro produto. Desaparece quando tudo estiver concluído. - Indicadores: encomendas por preparar, vendas do mês, saldo da carteira, nota média. - Gráfico das vendas dos últimos 6 meses (apenas vendas pagas e não canceladas, consoante o plano do vendedor). - Últimas mensagens recebidas. ### Encomendas A lista pode ser filtrada por **Todas**, **Por preparar**, **Enviadas** e **Concluídas**. Cada encomenda tem a sua própria página com os artigos, a morada de entrega e o telefone, a transportadora escolhida pelo cliente, a mensagem deixada na encomenda, os totais e o valor líquido do vendedor após comissão. O vendedor faz avançar a encomenda etapa a etapa: 1. **Aceitar**: a encomenda passa de «Por preparar» a «Em preparação». 2. **Confirmar o envio**: escolhe a transportadora e introduz o número de seguimento. O link de seguimento é construído a partir da transportadora do PrestaShop. O botão **Adicionar um volume** permite declarar outros volumes para a mesma encomenda. O cliente recebe um e-mail a cada envio. 3. **Marcar como entregue** depois de o volume ter sido entregue. O botão **Imprimir a guia de preparação** gera uma página limpa, sem os elementos do site, para colocar dentro do volume. ### Finanças Saldo disponível, pedido de levantamento (bloqueado se já houver um pedido em curso), histórico dos levantamentos, faturas de comissão para descarregar e extrato dos movimentos da carteira. ### Documentos Carregamento dos documentos KYC e acompanhamento do respetivo estado. ### Produtos O formulário de produto está organizado por secções: informações, preço e IVA, stock, categorias (em árvore), envio (peso e dimensões com as respetivas unidades), descrições e fotografias. A fotografia principal é assinalada; uma fotografia recusada é indicada com o motivo. Os erros de preenchimento (nome, preço, EAN, dimensões) aparecem por cima do formulário e os valores introduzidos são mantidos. A lista mostra o stock, o estado de validação e uma ligação para a página do produto na loja. ### Perfil e entrega - **O meu perfil de vendedor** (separador Perfil): logótipo e banner com pré-visualização, apresentação, políticas de envio e de devolução, contactos públicos, campos DSA, IBAN e BIC. - **Entrega**: escolha das transportadoras propostas e regras de portes por transportadora, zona e escalão (preço ou peso), com limiar de portes grátis. Cada regra é apresentada de forma legível. ## Área do comprador - **Página do produto**: o bloco «Vendido e enviado por» mostra o logótipo do vendedor, a sua nota e uma ligação para lhe colocar uma questão antes da compra. - **Detalhe nativo da encomenda**: o bloco «Os seus vendedores para esta encomenda» lista cada vendedor com o estado da sua parte. - **A minha conta > Os meus vendedores e mensagens**: as subencomendas agrupadas por vendedor, com o estado, o total e o número de mensagens não lidas. - **Página de seguimento por vendedor**: etapas da encomenda, volumes com link de seguimento, conversa com o vendedor, comunicação de um problema ou pedido de devolução, avaliação do vendedor. Motivos propostos para comunicar um problema: encomenda não recebida, artigo danificado, artigo não corresponde à descrição, artigo errado recebido, devolução, outro problema. O vendedor é avisado por e-mail e a comunicação aparece na conversa. ## Mensagens Cada conversa liga um cliente, um vendedor e, se for o caso, uma encomenda. O cliente pode escrever antes da compra (a partir da página do produto ou da montra) ou a propósito de uma encomenda. O vendedor responde a partir da sua caixa de mensagens; só pode escrever a um cliente que lhe tenha feito uma encomenda ou que já o tenha contactado. Cada nova mensagem envia um e-mail ao destinatário. Para evitar abusos, um cliente está limitado a 15 mensagens por hora. ## 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 portes, a sua comissão fixada, a sua fatura e o seu crédito de carteira. O detalhe lógico é conservado para efeitos de rastreabilidade e a separação entre vendedores é estrita. O estado de pagamento da encomenda-mãe (pagamento aceite, cancelamento, reembolso) é replicado nas encomendas filhas. O vendedor recebe o e-mail «Nova encomenda» uma única vez, quando a encomenda é paga. A fatura da encomenda-mãe segue o fluxo nativo do PrestaShop. Confirme, na sua versão, que o módulo de pagamento não emite uma fatura-mãe com o montante total antes da divisão. ## Comissões O motor aplica uma cascata de regras, da mais específica à mais geral: **produto, vendedor, categoria, global**, recorrendo à comissão predefinida quando nenhuma se aplica. Uma regra pode ser em percentagem, em montante fixo ou mista, sobre uma base com IVA ou sem IVA. São suportados **escalões de volume de negócios mensal**: por exemplo, 15% até 5.000 € de volume de negócios mensal e 12% acima desse valor. A comissão é fixada no momento da encomenda e nunca é recalculada. ## Pagamento repartido, carteira e escrow Os adaptadores Mangopay e Stripe Connect recebem os fundos de forma repartida e mantêm-nos em escrow. Quando a encomenda atinge o **estado configurado**, os fundos são libertados para as carteiras dos vendedores. ### Transferências O vendedor solicita um levantamento no separador Finanças. O operador executa as transferências em **DataFirefly Marketplace > Comissões e pagamentos** com um clique (transferência SEPA através do prestador). Cada movimento fica registado no extrato da carteira. ### Webhooks Declare o URL de webhook do módulo (controlador `webhook`) junto do seu prestador para sincronizar os estados de pagamento. A assinatura é verificada em cada chamada. ## Entrega por vendedor Cada vendedor define as suas transportadoras e as suas regras de portes. Quando todas as subencomendas de uma encomenda estão enviadas, a encomenda-mãe passa automaticamente ao estado «Enviado», sem reenviar o e-mail nativo em duplicado, uma vez que o cliente já recebeu um e-mail por volume. ## Montra e diretório Cada vendedor dispõe de uma montra pública com banner, logótipo e nota. Os produtos são apresentados com as miniaturas do seu tema (fotografia, preço no formato local, adicionar ao carrinho), com ordenação e paginação. Separadores apresentam a loja, a política de envio, a política de devolução e as informações legais DSA. As avaliações mostram o autor, a data e as estrelas. A montra tem o seu caminho de navegação (breadcrumb), um título e uma descrição para os motores de pesquisa e um URL canónico. O diretório lista os vendedores validados, com pesquisa, o número de produtos, um excerto da apresentação e um convite para se tornar vendedor. ## Conformidade europeia - **DSA**: a identidade do vendedor profissional (denominação social, número de registo, NIF/IVA, ponto de contacto) é apresentada na sua montra. - **Faturas de comissão**: geradas automaticamente todos os meses, numeradas e arquivadas. Lance a geração em massa em **DataFirefly Marketplace > Faturas de comissão**; o botão **Ver** abre cada fatura. O vendedor descarrega-as no seu separador Finanças. - **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. O vendedor aceita estas condições no registo. Quando altera as condições, o botão **Enviar o aviso aos vendedores**, na configuração do módulo, avisa todos os vendedores por e-mail. - **IVA «plataforma considerada fornecedora»**: um indicador por vendedor é apresentado e reportado na fatura de comissão. O módulo apresenta o indicador de IVA, mas não inclui um motor de repartição OSS. A repartição do IVA continua a depender da configuração de impostos da sua loja. ## Avaliações, planos, litígios e estatísticas - **Avaliações**: um comprador que fez uma encomenda a um vendedor pode avaliá-lo, a partir da montra ou da página de seguimento. As avaliações são moderadas em **DataFirefly Marketplace > Avaliações** e a nota média é recalculada automaticamente. - **Planos de vendedor**: Free, Pro e Premium por predefinição, com limite de produtos, taxa de comissão e acesso às estatísticas. Geridos em **DataFirefly Marketplace > Planos de vendedor**. - **Litígios e devoluções**: abertos pelo comprador sobre uma subencomenda, resolvidos em **DataFirefly Marketplace > Litígios e devoluções**, com eventual reembolso refletido na carteira do vendedor. - **Estatísticas**: vista do operador (volume de negócios, taxa de comissão, melhores vendedores) em **DataFirefly Marketplace > Estatísticas**, e estatísticas do vendedor no seu painel, consoante o plano. ## E-mails São fornecidos nove modelos em HTML e texto: registo recebido, vendedor validado, pedido recusado, conta suspensa, alteração das condições (P2B), encomenda enviada, nova encomenda, nova mensagem e litígio aberto. Cada e-mail é enviado na língua do destinatário, incluindo o assunto, com o inglês como alternativa. Pode personalizá-los em **Internacional > Traduções > Traduções de e-mails** ou diretamente na pasta `mails/` do módulo. ## Línguas e traduções O módulo é fornecido traduzido em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português: páginas do vendedor e do comprador, mensagens de erro e de confirmação, back-office e e-mails. Para alterar um texto, abra **Internacional > Traduções**, escolha **Traduções dos módulos instalados**, o módulo DataFirefly Marketplace e a língua. ## Menus do back-office O menu **DataFirefly 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, Estatísticas e Configuração. ## FAQ e resolução de problemas ### Os fundos não são libertados para os vendedores Verifique se o «Estado que liberta os fundos (escrow)» está definido na configuração e se os vendedores em causa concluíram o onboarding junto do prestador (carteira criada). ### Um produto de vendedor não aparece na loja Um produto fica oculto enquanto não for aprovado. Verifique o seu estado na lista de produtos do vendedor ou ative a aprovação automática de produtos. ### O vendedor não recebe o e-mail de nova encomenda O e-mail é enviado quando a encomenda passa a um estado pago. Uma encomenda a aguardar transferência bancária ou cheque não envia nada enquanto o pagamento não for validado. ### As etiquetas dos formulários estão mal alinhadas Alguns temas alinham todas as etiquetas à direita. O módulo volta a alinhá-las à esquerda nas suas páginas; se a apresentação antiga persistir, esvazie a cache do PrestaShop e a do navegador. ### Após uma atualização, uma página dá erro ou não mudou Esvazie a cache em **Parâmetros Avançados > Desempenho** (ou a pasta `var/cache`) e recarregue a página.