# Visão geral da loja Abra a loja da sua cidade, receba por Pix e cartão direto na sua conta e acompanhe vendas, pedidos e entregas no jogo. Source: https://fivedash.fivex.gg/docs/pt/store/overview A **Loja** do FiveDash vende VIPs, veículos, dinheiro e itens da sua cidade com entrega automática dentro do servidor. O jogador compra pelo site da loja (ou pelo Discord), paga por Pix ou cartão, e o FiveDash no servidor entrega a compra no personagem dele, mesmo se ele estiver fora da cidade na hora. O dinheiro cai direto na conta da cidade no provedor de pagamento, sem passar pelo FiveDash. Esta página é para donos e equipe que vão abrir e cuidar da loja. [Vídeo: como fazer em menos de 20 segundos](https://fivedash.fivex.gg/docs/videos/store-overview-pt.mp4) > Disponibilidade por região > > A Loja está disponível apenas para organizações brasileiras. Organizações internacionais não têm acesso ao módulo, inclusive no teste grátis. O idioma do painel é independente da região: uma organização brasileira pode usar a Loja com a interface em inglês. ## Antes de começar * **Plano:** a Loja está nos planos Plus, Pro e Ultra. Alguns recursos só abrem a partir do Pro (veja [Plano e limites](#plano-e-limites)). * **Servidor:** a loja fica ligada a um servidor FiveM. Ele precisa ter o recurso do FiveDash instalado e conectado. Veja [Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource). * **Provedor de pagamento:** uma conta no Mercado Pago, na AbacatePay ou na Stripe. | Ação | Nível | | ----------------------------------------- | -------------- | | Vendas, números e pedidos recentes | **Ver** | | Configuração inicial e pagamento de teste | **Configurar** | Esses níveis são da página **Loja → Visão geral**. Cada página da loja tem o seu próprio nível; veja [Equipe e permissões](https://fivedash.fivex.gg/docs/pt/dashboard/team-and-permissions). > Quem não tem **Configurar** em **Visão geral** e abre uma loja ainda não configurada vê **A loja ainda não foi aberta**. Peça a quem cuida da loja da organização para fazer a configuração. ## Abrir a loja A configuração tem quatro passos e leva uns cinco minutos. Cada passo é salvo assim que você termina, então dá para fechar a página e continuar depois de onde parou. Para mudar um passo já feito, clique em **Editar** nele. ### Monte sua loja Abra **Loja** na barra lateral. Em **O que você vai vender?**, marque tudo o que a cidade vende (pelo menos uma opção). Em **Cor da loja**, escolha uma cor ou clique em **Escolher outra cor**. Clique em **Criar loja**. ### Receba os pagamentos Escolha onde a loja vai receber (Mercado Pago, AbacatePay ou Stripe), cole a credencial do provedor e escolha as formas de pagamento. O passo a passo de cada provedor está em [Pagamentos](https://fivedash.fivex.gg/docs/pt/store/payments). ### Entrega no jogo O FiveDash no servidor precisa estar conectado e com a entrega ligada. Em **Como o comprador diz quem recebe?**, escolha uma opção e clique em **Continuar**: * **ID na cidade** (ou o nome que o framework da cidade usa, como "Passaporte" ou "Citizen ID"): o jogador digita o ID dele na compra, e a cidade confere de quem é antes do pagamento. * **Conta do Discord**: o jogador entra com o Discord, e a compra vai para o personagem da conta da cidade ligada a ele. ### Confira e abra a loja O FiveDash confere o servidor e os pagamentos. Quando tudo estiver certo, clique em **Abrir loja**. Se algo faltar, resolva o item apontado e clique em **Verificar de novo**. Quando a loja abre, aparece **Cidade Exemplo está pronta!** (com o nome do seu servidor). Clique em **Ir para a loja** para ver a **Visão geral**. O nome da loja é sempre o nome do servidor. ### O que é conferido antes de abrir | Item | O que precisa estar certo | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Entrega na cidade** | O FiveDash no servidor está instalado, atualizado e com a entrega ligada. | | **Servidor no ar** | Mostra se o servidor está online. Se estiver fora do ar, as compras ficam na fila e chegam quando ele voltar. | | **Framework da cidade** | O framework foi reconhecido. Se não for, rode `fivedash detect` no console do servidor. | | **Pagamentos** | Pelo menos uma forma de pagamento ligada num provedor que aceitou a chave. | | **Aviso de pagamento** | O provedor avisa o FiveDash quando um pagamento é aprovado. Se o aviso não puder ser cadastrado, o FiveDash confere os pagamentos sozinho. | A loja só abre com a entrega na cidade pronta e os pagamentos funcionando. ### Mensagens comuns na entrega | Mensagem | O que fazer | | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | **Instale o FiveDash no servidor** | Instale o recurso e conecte o servidor. Veja [Instalar o recurso](https://fivedash.fivex.gg/docs/pt/getting-started/install-resource). | | **Atualize o FiveDash no servidor** | Atualize o recurso do FiveDash. | | **Reinicie o servidor para terminar a atualização** | A versão nova já foi baixada. Reinicie o servidor ou digite `restart fivedash` no console. | | **Ligue a entrega no servidor** | Em `fivedash/loja.lua`, deixe `Enabled = true` e rode `restart fivedash`. | | **Framework não reconhecido** | Rode `fivedash detect` no console do servidor. | Os detalhes da entrega estão em [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery). ## A página Visão geral Depois de aberta, **Loja → Visão geral** mostra as vendas da loja. No topo, escolha o **Período**: **7 dias**, **30 dias** (padrão) ou **90 dias**. Os números são comparados com o mesmo número de dias antes. > Se a entrega na cidade for desligada ou o servidor parar de responder, aparece **Vendas pausadas: a entrega na cidade está desligada**. O site para de vender e volta sozinho assim que o servidor responder. ### Números do período | Número | O que mostra | | ----------------- | ---------------------------------------------------------------- | | **Receita** | Quanto os pedidos pagos somaram no período. | | **Pedidos pagos** | Quantos pedidos foram pagos e quantos itens foram vendidos. | | **Ticket médio** | O valor médio de um pedido pago. | | **Compradores** | Quantas pessoas compraram e quantas compraram pela primeira vez. | ### O que precisa de atenção | Cartão | O que mostra | | ------------------ | ------------------------------------------- | | **Para entregar** | Pedidos pagos, esperando a cidade entregar. | | **Entrega falhou** | Pedidos em que a cidade não entregou. | | **Sem pagamento** | Pix e cartão esperando o comprador pagar. | | **Carrinhos** | Carrinhos abertos no Discord. | | **Comissões** | O que falta pagar aos criadores. | ### Gráficos e resumos | Seção | O que mostra | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Receita e pedidos** | Receita, pedidos e ticket por dia (ou **por semana**), com o melhor dia do período. | | **Resumo financeiro** | Dos pedidos pagos: **Vendas brutas**, **Descontos** (cupons e ofertas), **Receita líquida**, **Comissões de criadores** e o que **Fica com a loja**. Também mostra **Como pagaram** e os valores reembolsados, que ficam fora da receita. | | **Mais vendidos** | Os produtos que mais venderam pela receita, com aviso de **Estoque acabando** ou **esgotado**. | | **Receita por categoria** | O que cada categoria do catálogo vendeu. | | **Horários de pico** | Quando os pagamentos caem, por dia da semana e hora, com o **Dia mais forte** e a **Hora mais forte**. | | **Clientes** | Quem comprou pela primeira vez, quem voltou e **Quem mais comprou**. | | **Do pedido à entrega** | Pedidos **Feitos**, **Pagos** e **Entregues** no período, com os não pagos e os reembolsados. | | **Promoções** | **Pedidos com cupom**, **Vendido com cupom**, **Desconto dado** e **Comissões de criadores**. | | **Pedidos recentes** | Os últimos pedidos. **Ver todos** abre **Loja → Pedidos**. | ### Configuração da loja A lista **Configuração da loja** mostra o que falta para vender e os próximos passos. Enquanto os quatro primeiros itens não estiverem prontos, ela fica no topo da página; depois, vai para o fim, fechada. | Item | Pronto quando | | -------------------------------- | ----------------------------------------------------------- | | **Loja criada** | Sempre pronto depois da configuração. | | **Pagamentos conectados** | Há pelo menos uma forma de pagamento ligada. | | **Entrega automática na cidade** | A entrega foi salva e o servidor está pronto para entregar. | | **Cadastre o primeiro produto** | Há pelo menos um produto. Botão **Cadastrar**. | | **Crie cupons de desconto** | Há pelo menos um cupom ativo. Botão **Criar**. | | **Divulgue a loja** | Atalho para **Canais de venda**. | Quem tem **Configurar** em **Visão geral** ou em **Pagamentos** também vê ali o cartão **Pagamento de teste**. Veja [Pagamentos](https://fivedash.fivex.gg/docs/pt/store/payments#fazer-um-pagamento-de-teste). ## Menu Ver site No topo das páginas da loja, o botão **Ver site** abre um menu com o **Site da loja**: o endereço, se está **No ar** ou **Fora do ar**, **Copiar endereço**, **Gerenciar** (abre **Loja → Site**) e **Abrir site**. Veja [Site da loja](https://fivedash.fivex.gg/docs/pt/store/site). ## Assistente da loja Com a loja aberta e a **FiveDash IA** no plano da organização, o botão **Assistente** no topo abre o **Assistente da loja**. Ele responde sobre vendas, pedidos e clientes, procura e abre as páginas para você. Quem pode mudar a loja também pode pedir para criar produtos, cupons e ofertas e mexer no site. O assistente segue o seu nível de acesso em cada página e pede confirmação antes de excluir algo. > A IA pode errar. Confira as mudanças na loja depois que o assistente fizer algo. Sem a **FiveDash IA**, o assistente não abre. Adicione a IA em **Configurações → Plano**. ## Páginas da loja | Página no painel | O que faz | Plano | Guia | | --------------------- | ---------------------------------------------------------------------- | ----------------------------- | ---------------------------------------------------------------------------- | | **Visão geral** | Vendas, números, atenção e configuração. | Plus | Esta página | | **Pedidos** | Tudo o que foi comprado: pagamento, escolhas e entrega. | Plus | [Pedidos](https://fivedash.fivex.gg/docs/pt/store/orders) | | **Produtos** | O que a loja vende, preços, estoque, imagens e o que a cidade entrega. | Plus | [Produtos](https://fivedash.fivex.gg/docs/pt/store/products) | | **Categorias** | Como o catálogo é agrupado e em que ordem. | Plus | [Categorias](https://fivedash.fivex.gg/docs/pt/store/categories) | | **Cupons** | Códigos de desconto. | Plus | [Cupons](https://fivedash.fivex.gg/docs/pt/store/coupons) | | **Ofertas** | Combos, upgrades, leve junto e mais vendidos. | Pro | [Ofertas](https://fivedash.fivex.gg/docs/pt/store/offers) | | **Clientes** | Quem comprou, quanto gastou, bloqueios e notas. | Plus | [Clientes](https://fivedash.fivex.gg/docs/pt/store/customers) | | **Crédito** | Saldo na carteira e cashback. | Pro | [Crédito](https://fivedash.fivex.gg/docs/pt/store/credit) | | **Afiliados** | Criadores, comissões e pagamentos. | Pro | [Afiliados](https://fivedash.fivex.gg/docs/pt/store/affiliates) | | **Site** | Aparência, endereço e domínio do site da loja. | Plus (domínio próprio no Pro) | [Site](https://fivedash.fivex.gg/docs/pt/store/site) | | **Canais de venda** | Painel e carrinhos da loja no Discord. | Pro | [Canais de venda](https://fivedash.fivex.gg/docs/pt/store/sales-channels) | | **Avisos no Discord** | Avisos para compradores e VIPs vencendo. | Plus | [Avisos no Discord](https://fivedash.fivex.gg/docs/pt/store/discord-notices) | | **Pagamentos** | Provedores, formas de pagamento e cobranças. | Plus | [Pagamentos](https://fivedash.fivex.gg/docs/pt/store/payments) | | (no jogo) | Como a cidade entrega as compras. | Plus | [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery) | ## Plano e limites | | Plus | Pro | Ultra | | ---------------------------------- | ------ | ------- | ---------- | | Site, Pix e cartão | ✓ | ✓ | ✓ | | Entrega automática na cidade | ✓ | ✓ | ✓ | | Cupons e avisos no Discord | ✓ | ✓ | ✓ | | Produtos | até 50 | até 500 | ilimitados | | Ofertas, crédito e afiliados | — | ✓ | ✓ | | Venda pelo Discord | — | ✓ | ✓ | | Domínio próprio | — | ✓ | ✓ | | Taxa sobre as vendas pagas da loja | 3% | 1,5% | sem taxa | Preços dos planos em [Planos e cobrança](https://fivedash.fivex.gg/docs/pt/getting-started/plans-and-billing). ## Perfis prontos para a equipe Em **Configurações → Membros**, a loja tem perfis prontos além de **Sem acesso**, **Somente leitura** e **Acesso total**: | Perfil | O que libera | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Atendimento** | Acompanha pedidos e clientes, marca entregas e ajusta saldos. Ver em **Visão geral** e **Avisos no Discord**; Gerenciar em **Pedidos**, **Clientes** e **Crédito**. | | **Catálogo** | Cuida de produtos, categorias, cupons e ofertas. Ver em **Visão geral**; Configurar em **Produtos**, **Categorias**, **Cupons** e **Ofertas**. | | **Financeiro** | Vê vendas e pagamentos e paga os criadores, sem mexer nas chaves. Ver em **Visão geral**, **Pedidos**, **Crédito** e **Pagamentos**; Gerenciar em **Afiliados**. | ## Perguntas frequentes **O dinheiro passa pelo FiveDash?** Não. Cada pagamento cai direto na conta da cidade no Mercado Pago, na AbacatePay ou na Stripe. **A loja vende com o servidor desligado?** Sim, se a entrega estiver ligada no `loja.lua`. As compras ficam na fila e chegam quando o servidor voltar. Se a entrega for desligada (`Enabled = false`), o site para de vender. **Quem da equipe vê as chaves do provedor?** Ninguém. A chave fica guardada com criptografia no FiveDash e nunca volta para o painel. Para trocar, cole uma chave nova em **Loja → Pagamentos**. ## Próximos passos [Pagamentos](https://fivedash.fivex.gg/docs/pt/store/payments)Conecte o provedor e faça um pagamento de teste. [Produtos](https://fivedash.fivex.gg/docs/pt/store/products)Cadastre o que a cidade vende. [Entrega no jogo](https://fivedash.fivex.gg/docs/pt/store/in-game-delivery)Entenda como as compras chegam no personagem. [Pedidos](https://fivedash.fivex.gg/docs/pt/store/orders)Acompanhe e resolva pedidos.