DataFirefly Marketplace: guia completo

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.

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.

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.

Á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.

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.

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.