Manual Completo do Zenith

Passo a passo de cada módulo, alinhado com o que o app faz hoje.

Módulos

Visão Geral e Ordem Recomendada

Rota: /modulos/dashboard

O AppZenith organiza o negócio do MEI e do profissional autônomo em módulos (Motores).

Não tente usar tudo de uma vez. Siga esta ordem:

  • Configurações — cadastre CNPJ/CPF, endereço e Zenith ID.
  • CRM — cadastre clientes (e fornecedores se precisar).
  • Orçamentos — faça propostas e aprove quando o cliente fechar.
  • Financeiro — registre receitas/despesas (ou deixe a aprovação do orçamento gerar a receita).
  • Fiscal — emita a NFS-e pelo App com o certificado A1 da conta, ou use a colinha (login e senha) no portal oficial; gere DAS no PGMEI.
  • Meu Contador — se não quiser emitir sozinho, peça o serviço ao contador por mensagem.
  • Agenda — marque atendimentos (pode gerar receita ao concluir).

    • Comércio e serviços gerais também usam Cardápio, Pedidos e Vendas.

    Comércio não usa Ordem de serviço, Orçamentos nem Obras.

    Mecânico (cadastro em serviços gerais), eletricista, salão e veterinário usam Ordem de serviço.

    Extras: Metas, Investimentos, Documentos (PRO), Vacinas (PRO),

    Eventos (produção/escalas — perfil Eventos, PRO ou modo operação Contador),

    Músicos (shows — perfil/beta).

    (Ciclo Feminino está oculto no momento.)

    Regras gerais para o assistente

  • Você é um guia: explique o passo a passo e indique o menu/rota. Não execute ações na conta.
  • Sempre termine com um link markdown para o módulo certo, no formato [Abrir Nome](/modulos/slug).
  • Dashboard usa [Abrir Dashboard](/dashboard).
  • Se pedirem "faça por mim", explique que no momento você só orienta e direcione ao módulo certo.
  • Pedidos de NFS-e de serviço: oriente o Fiscal (A1 no App ou colinha no portal); se não quiser emitir, leve a [Abrir Meu Contador](/modulos/contador).
  • NFC-e e NF-e de mercadoria ficam em Vendas, só na homologação da SEFAZ de SP. MEI não emite nota de mercadoria. Não diga que a produção da SEFAZ está ligada.
  • Nunca invente botões, telas ou campos que não existem neste manual.
  • Se o módulo estiver PRO e o usuário for Free, explique o bloqueio e ofereça [Assinatura](/modulos/configuracoes).

    • Configurações

    Rota: /modulos/configuracoes

    Rota: /modulos/configuracoes

    Abas

  • Meu Perfil
  • Certificado A1
  • Plano de Contas
  • Assinatura & Plano
  • Personalização
  • Sair

    • Rotina: Completar o perfil (obrigatório antes de NFS-e)

  • Abra Configurações no menu.
  • Na aba Meu Perfil, preencha:

    • - Nome

    - Telefone

    - E-mail

    - CPF ou CNPJ

    - Inscrição Municipal (se PJ / emissão NFS-e)

    - Endereço (use o CEP — busca automática)

    - Zenith ID (usado no link público da Agenda: /agendar/@seu_id e exigido para se candidatar como prestador em /evento/[id])

  • Clique em Salvar Alterações.

    • Rotina: Guardar o certificado A1 (emissão de NFS-e pelo App)

  • Aba Certificado A1.
  • Envie o arquivo .pfx / .p12 da própria conta e a senha do certificado.
  • O App usa esse A1 para emitir e cancelar NFS-e Nacional nesta conta. Não use o certificado de outra pessoa.
  • Sem A1 ativo, a nota ainda pode sair pela colinha + portal (login e senha).

    • Rotina: Assinar Zenith PRO

  • Aba Assinatura & Plano.
  • Escolha PIX (1 mês ou 3 meses com desconto) ou cartão.
  • Ou use um código de ativação, se tiver.

    • Rotina: Personalizar cor do tema

  • Aba Personalização.
  • Escolha a cor — fica salva no navegador.

    • Rotina: Sair da conta

  • Aba Sair (ou logout no menu).

    • Erros comuns

  • Sem CNPJ no perfil → Fiscal não gera colinha completa de NFS-e.
  • Zenith ID vazio → link público de agendamento não funciona bem.
  • Cadastro incompleto (nome, telefone ou Zenith ID) → bloqueia candidatura de prestador no link de Eventos e o agendamento público da Agenda.

    • CRM (Contatos)

    Rota: /modulos/crm

    Rota: /modulos/crm

    Rotina: Cadastrar contato

  • Abra CRM.
  • Clique em Adicionar Contato (ou “Cadastrar Meu Primeiro Contato” se a lista estiver vazia).
  • Preencha:

    • - Papel: Cliente | Prestador/Equipe | Fornecedor

    - Status: Ativo / Inativo

    - Nome (obrigatório)

    - Tipo: Pessoa Física ou Jurídica

    - CPF ou CNPJ

    - Inscrição Municipal (se PJ e for emitir nota)

    - E-mail, Telefone

    - CEP → preenche endereço; complete Número

    - Gênero (opcional), Observações

  • Salve.

    • Rotina: Editar ou excluir

  • Na lista, use os ícones de editar ou excluir no contato.

    • Para que serve

  • Orçamentos precisam de um cliente do CRM.
  • Fiscal usa dados do tomador (cliente) na colinha da NFS-e.
  • Vacinas/Agenda podem vincular dono/cliente.

    • Erros comuns

  • Cadastrar só o nome sem documento → dificulta nota fiscal.
  • Esquecer Inscrição Municipal do cliente PJ → portal NFS-e pode exigir.

    • Orçamentos

    Rota: /modulos/orcamentos

    Rota: /modulos/orcamentos

    Preview: /modulos/orcamentos/preview/[id]

    Status do orçamento (fluxo)

    Draft (Rascunho) → Sent (Enviado) → Approved (Aprovado) ou Recusado → Invoiced (após NF) / Cancelled

    Rotina: Criar orçamento

  • Abra Orçamentos → Novo Orçamento.
  • Selecione o Cliente (precisa existir no CRM).
  • Adicione itens: descrição, quantidade, valor unitário.
  • Opcional: desconto, observações/termos, serviço pré-cadastrado (catálogo fiscal em Configurações), competência fiscal, válido até.
  • Salve (fica em Draft).

    • Rotina: Enviar ao cliente

  • No orçamento Draft, marque como Enviado (Sent).
  • Use Ver / Imprimir (preview) ou WhatsApp (abre wa.me com link do preview).

    • Rotina: Aprovar (gera receita)

  • Com status Sent, clique em Aprovar.
  • Confirme se deseja gerar a receita no Financeiro (geralmente pendente).
  • Status vira Approved.

    • Rotina: Recusar / Excluir / Editar

  • Recusar: disponível em Sent.
  • Editar/excluir: não disponível se já Invoiced ou Cancelled.

    • Rotina: Ir para emissão de nota

  • Orçamento Approved → botão/link para Emitir Nota (leva ao Fiscal).

    • Erros comuns

  • Criar orçamento sem cliente no CRM.
  • Tentar emitir NF antes de Aprovar.

    • Financeiro

    Rota: /modulos/financeiro

    Rota: /modulos/financeiro

    Atalho: /modulos/financeiro?new=true abre o modal de lançamento.

    Abas

  • Visão Geral (lançamentos)
  • Contas
  • Categorias

    • Rotina: Registrar receita

  • Botão Receita.
  • Campos: Descrição, Valor, Data, Conta, Categoria, Situação (Recebido | Pendente).
  • Opcional: parcelar (qtd de parcelas), aquisição de bem.
  • Salve.

    • Rotina: Registrar despesa

  • Botão Despesa.
  • Mesmos campos; Situação = Pago | Pendente.

    • Rotina: Transferir entre contas

  • Botão Transferir.
  • Informe conta origem, conta destino, valor e data.

    • Rotina: Editar ou excluir lançamento

  • Na lista da Visão Geral, use os ícones no item.

    • Rotina: Criar conta

  • Aba Contas → Nova Conta.
  • Nome, Tipo (Corrente / Digital / Poupança / Cartão / Dinheiro / Investimentos), Saldo inicial.

    • Rotina: Criar categoria

  • Aba Categorias → Nova Categoria.
  • Nome, tipo Receita ou Despesa, cor.
  • Categorias de sistema não são editáveis.
  • O app já traz duas categorias de sistema: Vendas (receita) e Custos (despesa).

    • Integrações

  • Aprovar orçamento pode criar receita.
  • Concluir agendamento na Agenda pode criar receita “Atendimento: …”.
  • Confirmar uma venda lança a receita na categoria Vendas.
  • Concluir uma ordem de serviço lança a receita numa categoria de serviço, não em Vendas.

    • Erros comuns

  • Lançar tudo sem conta → saldos ficam inconsistentes.
  • Marcar como Recebido/Pago sem ter entrado o dinheiro.

    • Cardápio

    Rota: /modulos/cardapio

    Rota: /modulos/cardapio

    Página pública: /cardapio/{final-do-link}

    Quem vê: perfil Comércio ou Serviços gerais. É módulo grátis.

    O que a tela tem

  • Nome da lanchonete, WhatsApp para pedido, frase curta e final do link.
  • Foto de capa da página.
  • Caixa Publicar a página. Sem ela marcada no momento de salvar, o link não abre o cardápio.
  • Itens: categoria, nome, preço digitado (exemplo 10,50), descrição, foto e caixa À venda.
  • Em cada item: variedade (nome da lista, mínimo e máximo de sabores) e Adicionar sabor (nome, descrição, preço, máximo e foto).
  • Botões: Salvar cardápio, Copiar link, Abrir página.

    • Rotina: publicar

  • Preencha o nome e o final do link (pelo menos 3 letras ou números).
  • Cadastre o item com nome, preço e À venda marcado.
  • Se o produto tem sabores, use Adicionar sabor e coloque o preço de cada um.
  • Marque Publicar a página.
  • Clique em Salvar cardápio e espere a frase de cardápio publicado.
  • O link público é o que aparece embaixo do final do link, no formato /cardapio/seu-nome.

    • Página pública

  • Os itens aparecem em caixas. Toque no item para abrir a tela de detalhes.
  • Sem sabores, a quantidade e o total usam o preço do item.
  • Com sabores, o total é a soma dos sabores escolhidos. O preço do item principal não entra nessa soma.
  • A pessoa vê os produtos e usa Adicionar ao pedido sem conta. O carrinho fica salvo no celular.
  • Em Ver pedido ela escolhe Entrega ou Retirada e faz o cadastro: nome, CPF ou CNPJ, e-mail, senha, WhatsApp, CEP, rua, número, complemento, bairro, cidade e UF.
  • O botão Cadastrar e enviar pedido continua obrigatório. Cria a conta de quem compra e grava o cliente no CRM da loja. Sem esse cadastro o pedido não entra em Pedidos.
  • A conta da própria loja não grava pedido. O teste é feito em outra conta.
  • Depois de gravar, a tela mostra o número do pedido e o WhatsApp abre com esse número e o link do cardápio.
  • No carrinho dá para aumentar, diminuir ou tirar o item antes de enviar. Cancelar no painel só enquanto o pedido está Novo.
  • Se o mínimo de sabores for maior que o máximo, o cardápio não salva. Na página pública um intervalo impossível não trava o pedido: basta escolher um sabor.
  • Bate-papo do cardápio: botão verde no canto da página, no estilo de uma conversa. A loja fala primeiro e o cliente escolhe opções; cada escolha abre a resposta e as próximas opções. Cada loja pode gravar as próprias perguntas. Sem respostas salvas, a conversa usa um roteiro genérico de confeitaria. Só aparece em cardápio de comércio ou serviços gerais.
  • Chave do Asaas: a loja cola a chave da própria conta no cardápio e salva. O pagamento do pedido cai nessa conta. O botão de teste abre uma cobrança de R$ 10. Não pague.
  • Quem já tem conta entra e os dados vêm preenchidos. O pedido não segue sem cadastro.
  • O pedido entra em Pedidos (/modulos/pedidos), com itens, total, endereço e link para o cadastro de clientes.
  • A loja muda a situação: Novo, Preparando, Pronto, Entregue ou Cancelado. A lista atualiza sozinha.
  • Se a loja cadastrou WhatsApp, o cliente também pode avisar por lá. O pedido da tela não depende disso.

    • O que não fazer

  • Não confunda À venda com Publicar a página. À venda só mostra o item. Publicar abre o link.
  • O endereço /cardapio/sua-lanchonete é só um exemplo vazio. Não abre um cardápio.
  • Nada é gravado antes de Salvar cardápio.
  • Foto: JPG, PNG ou WebP, até 2 MB. HEIC do celular precisa ser convertido para JPG.

    • Vendas

    Rota: /modulos/vendas

    Rota: /modulos/vendas

    Quem vê: perfil Comércio ou Serviços gerais. É módulo grátis.

    Loja, como tênis, vende o que entrou no estoque. Alimentação vende pelo cardápio, sem controlar estoque.

    Produtos da loja

  • Ler com a câmera lê só o número do código. Nome, preço e estoque aparecem depois de cadastrar esse número.
  • Se o código é novo, preencha nome, preço, quantidade e unidade e toque em Dar entrada.
  • Só nesta venda coloca o item na conta sem cadastrar estoque.
  • No produto já cadastrado: toque nele para ir à conta; Entrada soma estoque; Fiscal guarda os códigos do produto; Livro mostra o movimento; Tirar remove o cadastro.
  • Também dá para subir um XML de cupom ou NFC-e de compra para dar entrada. O preço de venda continua o da loja.

    • Conta e venda

  • A seção Alimentação, sem estoque lista os itens publicados do cardápio. Eles não baixam estoque.
  • Na Conta, ajuste a quantidade com + e -.
  • O cliente é opcional e vem do CRM (Salvar no CRM quando for cliente novo).
  • Pagamento: Pix, Dinheiro, Cartão ou Boleto.
  • Confirmar venda grava a venda, baixa o estoque dos produtos da loja e lança a receita na categoria Vendas do Financeiro.
  • Em Últimas vendas, abra o comprovante. Dá para Imprimir ou Cancelar venda. Cancelar devolve o estoque. Não cancela uma nota já autorizada na SEFAZ.

    • NF-e e NFC-e de mercadoria

  • O bloco NF-e e NFC-e guarda inscrição estadual, séries e CSC. Salvar esse bloco não envia nota.
  • O envio, quando a venda está pronta, é o botão Enviar para homologação no comprovante.
  • Só homologação de São Paulo. MEI não emite NFC-e nem NF-e de mercadoria.
  • Não diga que a nota de produção da SEFAZ já sai pelo app.
  • NFS-e de serviço continua no módulo Fiscal, não aqui.

    • Entregas

    Rota: /modulos/entregas

    Rota: /modulos/entregas

    Quem vê: perfil Comércio ou Serviços gerais. É módulo grátis.

    A entrega é opcional. Venda e pedido sem entrega continuam iguais. A entrega aponta para a venda ou para o pedido, sem criar outra venda.

    Taxa

  • Em Taxa, grave o endereço da loja e o preço por quilômetro.
  • A conta usa a rota de ida, não a linha reta. Dá para definir taxa mínima, raio máximo, pedido mínimo e entrega grátis acima de um valor.
  • Se o mapa falhar, a tela avisa. A distância não é inventada. Um usuário da loja pode informar a taxa manualmente.
  • Mudar o preço por quilômetro não altera entregas já criadas.

    • Operação

  • No Painel, escolha o pedido de entrega ou a venda e toque em Calcular, depois em Criar entrega.
  • Atribua um entregador. Dois motoqueiros não ficam ao mesmo tempo na mesma entrega.
  • Copie o link do cliente. O link é aleatório e pode ser revogado.
  • Lançar taxa no caixa grava só a taxa, separada dos produtos. Lançar pagamento do entregador grava a despesa do motoqueiro, com o valor informado.

    • Entregador

  • Cadastre nome e telefone e envie o convite. Cada motoqueiro aceita na própria conta.
  • Ele só vê as entregas atribuídas a ele.
  • A localização só é enviada com a tela Minhas entregas aberta e o celular desbloqueado. Com a tela bloqueada, o rastreamento para. Uma posição velha não aparece como se fosse atual.

    • Mobilidade

    Rota: /modulos/mobilidade

    Rota: /modulos/mobilidade

    Quem vê: perfil Empresa de transporte. O administrador também vê. É módulo grátis.

    O passageiro não pede corrida num aplicativo público. A empresa registra a origem, o destino e escolhe os motoristas que recebem a oferta.

    Como usar

  • Em Tarifas, grave a tarifa inicial, o preço por quilômetro e o percentual do motorista.
  • Cadastre o motorista e envie o convite. Ele aceita na própria conta, em /parceiro.
  • Cadastre o veículo e vincule ao motorista.
  • Em Corridas, calcule a rota e registre. Se o mapa falhar, a distância não é inventada.
  • Marque os motoristas e toque em Enviar oferta. Quem aceitar primeiro fica com a corrida. O outro recebe que ela já foi atribuída.
  • O link do cliente só abre depois da atribuição. A localização só sai com a tela do motorista aberta.

    • A cobrança do cliente e o pagamento do motorista são lançamentos separados. Concluir a corrida não significa que o dinheiro entrou.

    Ordem de serviço

    Rota: /modulos/ordens

    Rota: /modulos/ordens

    Quem vê: Serviços gerais, Eletricista, Comércio, Cabeleireiro e Veterinário. É módulo grátis.

    Mecânico se cadastra como Serviços gerais. Motorista, músico, contador e cliente não veem este módulo.

    Abrir uma ordem

  • Cliente e telefone.
  • Placa e veículo ou equipamento são opcionais. Eletricista, salão e clínica usam a mesma ordem sem placa.
  • Campo O que o cliente pediu.
  • Em Serviços e peças, cada linha é Serviço ou Peça, com descrição, quantidade e preço.
  • Adicionar linha inclui outra linha.
  • Abrir ordem grava. Depois, Salvar ordem atualiza a mesma OS.

    • Situação

    Depois de aberta, a ordem pode ficar: Aberta, Em andamento, Concluída ou Cancelada.

    A primeira vez que fica Concluída, o app lança a receita no Financeiro numa categoria de serviço, não na categoria Vendas.

    Cancelar não deve ser orientado como se apagasse uma nota fiscal. Esta tela não emite nota.

    Impressão

    Com a ordem aberta, Imprimir mostra a OS para o cliente.

    Fiscal / Impostos

    Rota: /modulos/fiscal · Requer plano PRO

    Rota: /modulos/fiscal

    Abas

  • Emissão NFs
  • Histórico NFs
  • Guia DAS
  • Consulta Simples (optantes / desenquadramento)

    • Pré-requisitos para NFS-e

  • CNPJ (e dados) em Configurações > Meu Perfil.
  • Cliente completo no CRM (documento e endereço).
  • Orçamento com status Approved.
  • Para emitir pelo App: certificado A1 da conta em Configurações > Certificado A1.
  • Para emitir no portal: login e senha do Emissor Nacional na colinha (copie e cole no site).

    • Há dois caminhos. Os dois partem do orçamento aprovado em Emissão NFs → Emitir NFS-e.

    Rotina A: Emitir NFS-e pelo App (certificado A1)

  • Aba Emissão NFs.
  • No orçamento aprovado, Emitir NFS-e.
  • Confira tomador, serviço e valor.
  • Clique Emitir NFS-e no App (ou Emitir NFS-e real no App em produção).
  • O App assina com o A1 desta conta e transmite à NFS-e Nacional.
  • Copie a chave, abra a consulta pública ou o DANFSe. O orçamento fica emitido e a receita pode ir ao Financeiro.

    • Sem A1 na conta, o botão do App fica indisponível — use a Rotina B.

    Rotina B: Emitir NFS-e no portal (colinha + login e senha)

  • No mesmo modal, bloco 1. Acesso (Seu Login NFS-e): grave o CNPJ e a senha do portal desta conta (Configurar / Salvar Acesso desta Conta).
  • Copie os blocos da colinha (login, tomador, serviço).
  • Abra o portal oficial (nfse.gov.br / Emissor Nacional).
  • Entre com o login e a senha da colinha e preencha com os dados copiados.
  • Depois da nota no portal, cole a chave de 50 dígitos no App (ou confirme a emissão) para vincular o orçamento e o Financeiro.

    • Rotina: Cancelar nota no histórico

  • Aba Histórico NFs.
  • Cancelar Nota Fiscal.
  • Com A1 na conta e a chave da nota, o App cancela na Sefin. Sem chave ou sem A1, cancele no Emissor Nacional e confirme no App.

    • Rotina: Gerar DAS (MEI)

  • Aba Guia DAS.
  • Copiar CNPJ.
  • Abrir o portal PGMEI e gerar a guia lá (o Zenith facilita o acesso; a guia oficial sai no governo).

    • Rotina: Declaração Anual MEI (DASN-SIMEI)

  • Aba Guia DAS.
  • Copiar CNPJ (somente números).
  • Clique em Fazer Declaração Anual MEI (DASN-SIMEI) e conclua no portal oficial.

    • Rotina: Consultar optante Simples Nacional

  • Aba Consulta Simples.
  • Confirme o CNPJ (pré-preenchido do perfil) → Consultar.
  • Veja se permanece optante pelo Simples / SIMEI ou se há exclusão (desenquadramento).
  • Para confirmação oficial, use o link Consulta Optantes (Receita Federal).

    • Dashboard: alerta de limite MEI

  • Com base em Receitas Totais Ano, o painel avisa quando o faturamento se aproxima de R$ 81.000 (teto MEI).
  • Ex.: no mês 08, com ~R$ 73 mil, o aviso indica proximidade do limite.

    • Importante

  • Com certificado A1 da conta, o App emite e cancela NFS-e Nacional direto (Sefin). O A1 é do titular da conta, não um certificado Zenith compartilhado.
  • Sem A1, a emissão continua pela colinha: login e senha do portal + preenchimento no site do governo.
  • Login/senha da colinha valem só para o portal; não substituem o A1.
  • A consulta de optantes usa base pública de CNPJ e pode atrasar; o portal da Receita é a fonte oficial.

    • Contador / Meu Contador

    Rota: /modulos/contador

    Rota: /modulos/contador

    Para o MEI / profissional (Meu Contador)

  • Abra Meu Contador.
  • Escolha o tipo (emissão de NF, parcelamento, lançamentos ou geral).
  • Escreva a mensagem e envie.
  • Acompanhe a conversa na lista de solicitações.
  • Alternativa: tente sozinho no [Fiscal](/modulos/fiscal) ou peça orientação no [Assistente](/modulos/assistente).

    • Para o Contador (hub do escritório)

  • Veja Solicitações dos clientes no topo.
  • Responda a mensagem; se precisar, use Abrir conta completa do cliente (com autorização ativa).
  • Cadastre clientes e cola de NF/gov.br como de costume.

    • Modo operação (conta do cliente)

  • Com autorização ativa, o Contador pode abrir a conta completa do cliente (faixa amarela "Modo operação").
  • Nesta sessão ficam liberados Fiscal, Documentos e Eventos, mesmo se o cliente for Free — sem elevar o plano do titular.
  • Ao sair ("Voltar para minha conta de contador"), o cliente volta às regras do plano dele.

    • Autorizações

  • Cliente aceita o vínculo em /aceitar-acesso e pode revogar em /autorizacoes.

    • Agenda

    Rota: /modulos/agenda

    Rota: /modulos/agenda

    Link público: /agendar/@{zenith_id} (Zenith ID em Configurações)

    Abas

  • Agendamentos
  • Meus Serviços

    • Rotina: Cadastrar serviço

  • Aba Meus Serviços → Novo Serviço.
  • Nome, Preço, Duração (minutos).
  • Pode ativar/desativar depois.

    • Rotina: Novo agendamento

  • Aba Agendamentos → Novo Agendamento.
  • Nome do cliente, WhatsApp, Serviço, Data, Horário (faixa típica 08–18h).
  • Salve.

    • Rotina: Bloquear horário

  • Bloquear Horário — reserva o slot sem atendimento.

    • Rotina: Compartilhar agenda pública

  • Copie o link ou QR Code na tela de Agendamentos.
  • Cliente (com conta Zenith e cadastro completo) agenda sozinho em /agendar/@seu_id.
  • O agendamento cria o horário e sincroniza o cliente no CRM do prestador (role cliente).
  • Cadastro incompleto do cliente → tela pede finalizar nome, telefone e Zenith ID.

    • Rotina: Reagendar, concluir ou cancelar

  • Abra o detalhe do compromisso.
  • Reagendar, Cancelar, ou Concluir.
  • Ao Concluir, o sistema pode lançar receita no Financeiro (“Atendimento: …”).
  • WhatsApp disponível no detalhe.

    • Erros comuns

  • Sem serviços cadastrados → agendamento fica limitado.
  • Zenith ID vazio → link público fraco/quebrado.

    • Metas

    Rota: /modulos/metas

    Rota: /modulos/metas

    Seções

  • Financeiras
  • Investimento
  • Saúde & Hábitos

    • Rotina: Criar meta

  • Nova Meta.
  • Categoria, Título, Objetivo (número), Unidade (R$, vezes, dias, etc.), Prazo.
  • Salve.

    • Rotina: Avançar meta de hábitos

  • Em Saúde & Hábitos, use +1 para registrar progresso.
  • Excluir meta: ícone de excluir.

    • Limitações atuais

  • Não há edição completa após criar — exclua e recrie se precisar mudar o objetivo.

    • Investimentos

    Rota: /modulos/investimentos

    Rota: /modulos/investimentos

    Rotina: Adicionar ativo

  • Adicionar Ativo.
  • Tipo: Imóveis, Automóveis, Terrenos, Aluguéis, Ações, Dinheiro, Cripto, Renda Fixa, Outros.
  • Nome, Valor, Data de aquisição, Rendimento mensal (opcional), Observações.
  • Opcional: parcelado (qtd + dia de vencimento).
  • Salve. Edite ou exclua depois na lista.

    • Documentos

    Rota: /modulos/documentos

    Rota: /modulos/documentos

    Disponível no plano Free — inclusive para baixar NF e arquivos que o Contador enviar após um serviço pago.

    Rotina: Enviar arquivo

  • Fazer Upload.
  • Selecione o arquivo.

    • Rotina: Baixar ou excluir

  • Na lista: Download ou Excluir.

    • Entrega do Contador

    Quando o Contador conclui um serviço pago com arquivo, o PDF aparece aqui automaticamente.

    Limitações atuais

  • Sem pastas, tags ou filtros avançados — lista simples (nome, tamanho, data).

    • Controle de Vacinas

    Rota: /modulos/vacinas · Requer plano PRO

    Rota: /modulos/vacinas

    Abas

  • Revacinações Programadas
  • Cadastro de PETs

    • Rotina: Cadastrar PET

  • Aba PETs → cadastrar.
  • Nome, raça, peso, nascimento, dono (CRM ou manual), telefone.

    • Rotina: Programar revacinação

  • Programar Revacinação.
  • PET (ou dados manuais), tipo de vacina, data.
  • Pode criar compromisso na Agenda automaticamente.

    • Outras ações

  • Buscar/filtrar na lista
  • Marcar SMS enviado
  • Emitir Laudo / Termo (impressão)
  • Excluir programação

    • Eventos (produção e escalas)

    Rota: /modulos/eventos · Requer plano PRO

    Rota do organizador: [Abrir Eventos](/modulos/eventos)

    Presenças do convidado: [Abrir Meus Eventos](/meus-eventos)

    Link público de um evento: /evento/{id}

    Acesso: perfil Eventos, plano PRO, admin (beta), ou modo operação do Contador na conta do cliente (libera Eventos sem tornar o cliente PRO).

    Abas no módulo

  • Projetos (lista de eventos)
  • Escala de Prestadores

    • Rotina: Criar evento e compartilhar link

  • Abra [Abrir Eventos](/modulos/eventos) → Novo Evento.
  • Preencha nome, data, local, valor e custos.
  • Copie o link público do evento (/evento/{id}?ref=...). O parâmetro ref é o UUID do organizador.
  • O mesmo link serve para convidados e prestadores.
  • Se um visitante criar conta por esse link e depois assinar PRO/Simples, a comissão cai em [Indicar & Ganhar](/indicacoes) do organizador (regra de referral já existente).

    • Proteção: exclusão com partes envolvidas

  • Evento com prestador Confirmado, vínculo Zenith (staff_user_id), lançamento financeiro ou presenças confirmadas → não pode excluir.
  • Prestador confirmado / com financeiro → não remove da escala com 1 clique.

    • Aceite mútuo de alterações

  • Prestador Confirmado com conta Zenith: mudar diária/ajudas/função ou desconfirmar não aplica na hora.
  • O organizador cria um pedido (event_change_requests). O prestador vê em [Meus Eventos](/meus-eventos) e Aceita/Recusa.
  • Organizador acompanha pedidos pendentes no módulo Eventos.
  • Ao aceitar termos com financeiro Pending, os valores das txs vinculadas são atualizados.
  • Migration: 202608101400_event_change_requests.sql (aplicar no Supabase).

    • Rotina: Convidado confirma presença

  • Pessoa abre /evento/{id} e faz login/cria conta.
  • Clica Confirmar presença.
  • Entra em event_attendees e no CRM do organizador como cliente.
  • Aparece em [Abrir Meus Eventos](/meus-eventos) e no widget "Meus Eventos (inscrições)" do Dashboard.

    • Rotina: Prestador se candidata à escala

  • Prestador (outra conta Zenith) abre o mesmo /evento/{id}.
  • Precisa de cadastro completo: nome, telefone e Zenith ID em [Abrir Configurações](/modulos/configuracoes). Se faltar, a tela bloqueia e pede finalizar cadastro.
  • Clica Quero trabalhar neste evento.
  • Entra na Escala do organizador como Pendente, com vínculo de usuário; CRM do organizador recebe como prestador.
  • Organizador preenche a diária (e ajudas, se houver) e confirma na Escala (Pendente → Confirmado).

    • Regra financeira ao confirmar prestador (contratação)

    Ao marcar Confirmado (com valor > 0):

  • Organizador (dono do evento) → lançamento de despesa a pagar no [Financeiro](/modulos/financeiro) (categoria "Eventos / Prestadores").
  • Prestador com conta Zenith (veio pelo link / tem staff_user_id) → receita a receber no Financeiro dele + orçamento Approved em [Orçamentos](/modulos/orcamentos) (caminho para [Fiscal](/modulos/fiscal) / NFS-e se precisar emitir nota).
  • Prestador só no CRM (sem conta Zenith vinculada) → gera apenas a despesa do organizador.
  • Diária/custo zerado → confirma a escala sem criar lançamentos (edite o valor antes se quiser financeiro).
  • Não volte o status para Pendente para “desfazer” o financeiro: os lançamentos já criados ficam no Financeiro (cancele/edite lá se precisar).
  • No orçamento gerado automaticamente, não aprove de novo só para gerar receita — a receita já foi lançada na confirmação.

    • Rotina: WhatsApp na Escala

  • Em Eventos → Escala de Prestadores, use o botão WhatsApp da linha.
  • Abre conversa com mensagem casual (sem emoji) pedindo confirmação real da presença.
  • Telefone vem do CRM / telefone da escala. Sem telefone → oriente completar CRM/cadastro.

    • Dashboard do organizador

  • Widget Eventos & Escalas Operacionais mostra próximo evento real, escala confirmada e custo (não é mock).
  • Perfil Eventos (e admin) vê esse bloco.

    • O que NÃO fazer / não confundir

  • Confirmar presença ≠ entrar na escala. Presença = convidado/público. Escala = prestador.
  • Shows de músico → use [Abrir Músicos](/modulos/musicos), não Eventos.
  • Não diga que o assistente cria evento ou escala sozinho — oriente o usuário nas telas acima.

    • Motor Músicos

    Rota: /modulos/musicos · Requer plano PRO

    Rota: /modulos/musicos

    Abas

  • Shows & Cachets
  • Repertório

    • Rotina: Cadastrar um show

  • Aba Shows → Novo Show.
  • Preencha título, data, local, cidade, cachet, contratante e status.
  • Status possíveis: Proposta, Confirmado, Realizado, Cancelado, Pago.
  • Quando receber o cachet, registre a receita em [Abrir Financeiro](/modulos/financeiro) (não duplique lançamento aqui).

    • Rotina: Montar repertório

  • Aba Repertório → Nova Música.
  • Título, artista, tom, BPM, gênero.
  • Desmarque "Ativa" para arquivar sem excluir.

    • O que NÃO fazer

  • Não use o módulo Eventos genérico para shows de músico — use Músicos.
  • Eventos = produção/escalas de equipe; Músicos = shows e cachet.
  • Não lance cachet duas vezes (aqui + Financeiro). O cachet no show é referência; o caixa fica no Financeiro.

    • Fluxos cruzados (receita ponta a ponta)

    Rota: /modulos/dashboard

    1) Do zero até a NFS-e

  • Configurações → perfil com CNPJ/IM.
  • CRM → cadastrar cliente completo.
  • Orçamentos → criar → enviar → aprovar.
  • Fiscal → Emitir NFS-e: pelo App com A1, ou colinha (login e senha) no portal.

    • 2) Orçamento vira caixa

  • Aprovar orçamento.
  • Confirmar geração de receita no Financeiro.
  • Quando receber, edite o lançamento para Recebido/Completed.

    • 3) Atendimento na Agenda vira caixa

  • Agendar serviço.
  • No dia, Concluir.
  • Conferir receita criada no Financeiro.

    • 4) DAS do MEI todo mês

  • Fiscal → Guia DAS → copiar CNPJ → PGMEI → pagar.

    • 5) Vacina + Agenda (PRO)

  • Cadastrar PET.
  • Programar revacinação (cria compromisso na Agenda).

    • 6) Show do músico (PRO / beta)

  • CRM → cadastrar contratante (casa/produtor), se ainda não existir.
  • Músicos → Novo Show (data, local, cachet).
  • Financeiro → registrar receita do cachet quando receber.

    • 7) Evento: presença ou prestador pelo link

  • Organizador cria o evento em [Abrir Eventos](/modulos/eventos) e copia o link /evento/{id}.

    • 2a. Convidado → Confirmar presença → vê em [Abrir Meus Eventos](/meus-eventos); CRM do dono recebe cliente.

    2b. Prestador (cadastro completo) → Quero trabalhar neste evento → Escala Pendente; CRM do dono recebe prestador.

  • Organizador confirma na Escala e usa WhatsApp para alinhar presença de verdade.