Manual de Operação do Marketplace: PM MultiVendor

Guia Oficial do Marketplace Eukantu

Este manual detalha a arquitetura técnica, o funcionamento, as regras comerciais e os procedimentos operacionais do novo sistema de Marketplace com Múltiplos Vendedores (PM MultiVendor) integrado à loja HikaShop no Joomla 6.

1. Extensões Criadas na Plataforma

Para implementar a solução de marketplace mantendo total compatibilidade com o HikaShop e segurança no Joomla 6, foram desenvolvidas duas extensões principais:

Componente com_pmmultivendor
  • Backend (/administrator): Painel gerencial, moderação de vendedores, relatórios de vendas, controle de comissões e aprovação de saques.
  • Frontend (/painel-vendedor): Área exclusiva e isolada para o parceiro gerenciar seus produtos, acompanhar pedidos com itens de sua autoria e solicitar resgates via Pix.
  • Storefront Público: Vitrine personalizada do artista/produtor com banner, biografia e lista de faixas à venda.
Plugin plg_hikashop_pmmultivendor
  • Split Automático: Intercepta eventos de pedidos pagos no HikaShop (onAfterOrderUpdate) e credita o percentual de comissão (ex: 80%) diretamente na conta do vendedor.
  • Estorno de Cancelamentos: Reverte comissões caso o pedido seja cancelado ou estornado no HikaShop.
  • Vínculo de Produtos: Garante a associação do product_vendor_id aos produtos e aos itens dos pedidos.

2. Como o Multivendedor Acessa e Interage com o HikaShop

Segurança & Isolamento Total: O vendedor parceiro não acessa a administração geral (/administrator) do Joomla nem as configurações globais do HikaShop (meios de pagamento, fretes, relatórios confidenciais da loja). Toda a sua experiência acontece no Frontend.
2.1. Gestão de Produtos pelo Vendedor

No painel do vendedor, ao cadastrar ou editar uma música/produto:

  • O vendedor preenche nome, preço, capa e faz upload do arquivo seguro (MP3, KAR, ZIP, PDF).
  • O sistema grava os dados de forma transparente e segura diretamente nas tabelas nativas do HikaShop (#__hikashop_product, #__hikashop_price, #__hikashop_file).
  • O produto é vinculado exclusivamente ao ID do vendedor (product_vendor_id), garantindo que ele só veja e edite suas próprias faixas.
2.2. Exibição na Loja e Vitrine HikaShop

Para o cliente final navegando no site:

  • As faixas cadastradas pelos parceiros aparecem normalmente na busca, categorias e catálogo padrão do HikaShop.
  • Na página de detalhes do produto, é exibido o Card do Produtor com foto, nome e link direto para a vitrine pública do artista.
2.3. Fluxo de Compra e Pagamento
  1. O cliente adiciona as músicas ao carrinho e finaliza o pedido pelo checkout oficial do HikaShop (via EuPago, MB WAY, Multibanco, Cartão).
  2. Assim que o pagamento é confirmado, o plugin do marketplace calcula o split da comissão e credita o saldo líquido do vendedor.
  3. O pedido aparece na aba Meus Pedidos do painel do produtor contendo os itens vendidos e o valor recebido.

3. Gestão da Plataforma (Administrador Geral)

O administrador possui controle total sobre a moderação de vendedores, relatórios financeiros consolidados e liquidação de pagamentos.

3.1. Onde Acessar

No menu administrativo do Joomla, acesse: Componentes ➔ PM MultiVendor.

3.2. Painel de Controle (Dashboard)
Produtores Total de vendedores cadastrados, ativos e aguardando aprovação.
Faturamento Volume total transacionado em produtos de parceiros.
Receita Retida Total retido pela plataforma referente às taxas de comissão.
3.3. Moderação de Produtores e Comissões

Em PM MultiVendor ➔ Vendedores, você pode:

  • Aprovar ou Pausar Vendedores: Ative ou suspenda contas a qualquer momento.
  • Comissão Personalizada: Cada produtor pode ter uma taxa individual (ex: 85% ou 90%), prevalecendo sobre a taxa padrão do site.
  • Consulta de Dados: Visualize Chave PIX, e-mail, biografia e saldo em conta.
3.4. Solicitações de Saque (Payouts)

Em PM MultiVendor ➔ Solicitações de Saque:

  1. Visualize os pedidos de transferência com o valor e a Chave PIX informada.
  2. Realize a transferência bancária/PIX pelo seu banco.
  3. Clique em Marcar como Pago para debitar o saldo do vendedor e registrar o comprovante contábil.
  4. Caso haja inconsistência, clique em Rejeitar para estornar o saldo automaticamente para a conta do produtor.

4. Guia Rápido do Produtor / Vendedor Parceiro

4.1. Como se Tornar um Vendedor

Qualquer músico ou produtor cadastrado pode solicitar adesão pelo link: /index.php?option=com_pmmultivendor&view=register.

4.2. Painel do Produtor (Dashboard)

Acessível em: /index.php?option=com_pmmultivendor&view=dashboard

  • Saldo Disponível: Valor líquido acumulado pronto para resgate.
  • Extrato de Vendas: Relação de todos os pedidos contendo suas faixas.
  • Compartilhamento da Loja: Link direto para divulgação nas redes sociais.
4.3. Resgate de Valores (Saques via PIX)

Na aba Financeiro / Saques, ao atingir o valor mínimo configurado, o produtor clica em Solicitar Saque, confirma a chave PIX e aguarda o pagamento pela administração.