Acesse Administração → Configurações da loja e preencha:

• Identificação: nome, razão social, nome fantasia, CNPJ, contato e endereço (o CEP preenche o endereço).
• Dados bancários e chave PIX (úteis para conferência e conciliação).
• Loja maçônica: o Rito praticado e a Potência (obediência). O rito define os cargos da loja.
• Sessões: marque os dias da semana e a periodicidade (semanal, quinzenal ou mensal) das sessões.

Se trocar o rito, clique em Aplicar cargos deste rito para incluir os cargos correspondentes (a ação só adiciona o que falta — não remove os cargos existentes).

Dica: Mantenha o CNPJ e os dados bancários corretos: eles aparecem em relatórios e ajudam na conciliação financeira.

Aparência: na própria página de Configurações há a seção Aparência, onde você escolhe o tema Escuro (padrão), Papiro (pergaminho suave) ou Sistema (segue o modo claro/escuro do seu computador). A preferência fica salva neste navegador e vale para todas as telas.

O Asaas é o gateway que emite boleto e PIX para os membros. No modelo do Sigma Horus, cada loja conecta a própria conta Asaas — o dinheiro cai direto na conta bancária da loja; a plataforma nunca toca no dinheiro. Veja o passo a passo completo.

Parte A — Criar a conta e gerar a chave no Asaas:

1. Crie uma conta no Asaas. Para testes use o ambiente Sandbox (sandbox.asaas.com); para valer, a conta de Produção (asaas.com), que exige validação cadastral da loja.
2. No painel do Asaas, abra Minha Conta → Integrações → Chave de API.
3. Clique em Gerar chave de API e copie a chave (ela começa com $aact_). Guarde com segurança — o Asaas só a mostra uma vez.

Parte B — Inserir a chave no Sigma Horus:

1. No Sigma Horus, vá em Administração → Integrações.
2. No cartão Asaas, cole a chave no campo Chave da API do Asaas.
3. Em Ambiente, escolha Sandbox (testes) ou Produção — o mesmo da chave que você gerou.
4. (Recomendado) Defina um Token do webhook — um texto secreto de sua escolha.
5. Clique em Conectar Asaas. Se a chave for válida, o status muda para Conectado e mostra o ambiente e a chave mascarada.

Parte C — Configurar a baixa automática (webhook) no Asaas:

1. Ainda em Integrações, copie a URL do webhook exibida no cartão do Asaas.
2. No painel do Asaas, em Integrações → Webhooks (Notificações), cadastre essa URL e ative os eventos de cobrança/pagamento.
3. No campo de autenticação do webhook do Asaas, informe o mesmo token do passo B (cabeçalho asaas-access-token).

Dica: Com o webhook configurado, quando o membro pagar, a cobrança é baixada automaticamente no Sigma Horus — sem lançamento manual. Para trocar a chave, cole uma nova e clique em Atualizar chave; para encerrar, use Desconectar.

Todo obreiro pode ter acesso ao sistema a partir do próprio cadastro de membro. O login é o e-mail cadastrado e a senha inicial é gerada pelo sistema.

1. Em Loja & cadastros → Membros, confirme que o membro tem e-mail e abra o cadastro.
2. Clique em Conceder acesso. O sistema cria o login e envia a senha provisória por e-mail ao obreiro.
3. No primeiro acesso, o obreiro é obrigado a definir uma nova senha.
4. Se precisar, use Reenviar acesso para gerar outra senha provisória.

Em Administração → Usuários & acessos o Administrador define o papel (cargo de permissão) de cada usuário — Administrador, Venerável, Tesoureiro, Secretário, Hospitaleiro ou Membro —, reenvia senha e ativa/desativa logins.

Dica: Quem faz o quê: só o Administrador define papéis e concede acesso. O obreiroedita o próprio cadastro (contato, endereço, família) e troca a própria senha, mas nunca o próprio papel. Conceda sempre o menor privilégio necessário. A loja precisa de ao menos um Administrador (o sistema impede remover o último).

Em Administração → Configurações da loja → Permissões você ajusta a matriz papel × recurso × ação (ex.: quem pode ler/escrever em membros, documentos, mensagens, contas e portal). A loja parte de uma configuração padrão e pode personalizá-la.

Em Administração → Assinatura você escolhe e gerencia o plano que a loja paga ao Sigma Horus. Veja os detalhes de planos e regras no capítulo 12. Resumo: teste de 10 dias, depois Oficina, Loja ou Potência; no anual há desconto (10% no cartão, 5% no boleto).

O Sigma Horus envia avisos aos irmãos (felicitações de aniversário, jubileus, lembretes de cobrança e convocações de campanha). O e-mail é provido pela plataforma — já funciona, sem configuração. Já WhatsApp e SMS são conectados pela própria loja (o custo das mensagens é direto da loja), em Administração → Integrações, no cartão Comunicação (WhatsApp / SMS).

WhatsApp (Meta Cloud API):

1. Crie um app no Meta for Developers com o produto WhatsApp e obtenha o Phone Number ID e um token (de preferência permanente, via Usuário do Sistema).
2. Crie e aprove um template de mensagem (categoria Utilidade, idioma pt_BR, corpo com 1 variável, ex.: Loja Maçônica: {{1}}) — mensagens proativas exigem template aprovado.
3. Em Integrações, preencha Phone Number ID, Token, Nome do template e o idioma, e clique em Conectar WhatsApp.

SMS (Twilio): informe Account SID, Auth Token e o número remetente, e clique em Conectar SMS.

Dica: Enquanto um canal não estiver conectado, as mensagens daquele canal ficam registradas e enfileiradas (aparecem no histórico de Comunicação) e saem assim que a loja conectar a conta. As credenciais são guardadas criptografadas e isoladas por loja.

O plano de contas classifica receitas e despesas no formato de livro caixa, com codificação hierárquica (grupo.subgrupo.conta) — por exemplo 1.1.01 Mensalidades,2.1.05 Concessão/Aluguel, 8.9.03 Ação Social e Caridade. O código serve de base para a totalização por grupo no balancete e no fechamento.

Consulte e ajuste em Cadastros mestre → Plano de contas. Para completar com o modelo padrão, use Popular dados padrão (Brasil) (adiciona apenas os códigos que faltam, sem duplicar). Para retirar uma conta que não usa, clique em Remover ao lado dela.

Se a sua loja foi criada com uma versão antiga do plano (códigos como 1.01 em vez de 1.1.01), clique em Atualizar plano de contas para migrar ao padrão atual: ele adiciona as contas que faltam e remove as contas padrão antigas que não estão em uso(as contas vinculadas a lançamentos são preservadas). Isso também habilita o Tronco de Solidariedade usado pela Hospitalaria (capítulo 11).

Em Financeiro → Contas, no bloco Nova conta:

1. Escolha a Categoria (plano de contas) — ela já sugere o título e o tipo.
2. Confira o Título da conta e o tipo: Conta a receber ou Conta a pagar.
3. Informe o Valor e a Data de vencimento.
4. Defina o Status (Pendente, Pago ou Vencido).
5. Opcional: Vincular a um membro e escrever uma Descrição.
6. Clique em Salvar conta. A conta aparece na lista Contas cadastradas; use Remover para excluir.

Cobranças são os títulos que você gera para receber dos membros. Em Financeiro → Cobranças, no bloco Nova cobrança:

1. Selecione a conta (a receber) à qual a cobrança se refere.
2. Vincular a um membro — necessário se você for emitir boleto/PIX depois (ver 7.4).
3. Informe o Valor e a Data de vencimento. O Número / referência é gerado automaticamente (formato COB-AAAAMM-NNNN) se você deixar o campo em branco.
4. Opcional: Descrição.
5. Para mensalidades, marque Criar como cobrança recorrente e defina o intervalo (Mensal, Trimestral ou Anual) e a quantidade de ocorrências.
6. Clique em Criar cobrança.

Para gerar as parcelas recorrentes que já venceram/estão previstas, use o botão Processar recorrentes no bloco Recorrência — ele cria as cobranças do período automaticamente.

Cobrança em massa: para cobrar todos os irmãos de uma vez (ex.: mensalidade), use o bloco Cobrança em massa — escolha a conta, o público (membros ativos ou todos), o valor por membro e o vencimento, e clique em Gerar para todos os membros. Cria uma cobrança numerada automaticamente para cada membro (e, se marcado, recorrente).

Na lista Cobranças cadastradas, cada item mostra um status: Pendente, Emitida, Paga ou Vencida.

Pré-requisitos: o Administrador já conectou o Asaas (6.2) e a cobrança está vinculada a um membro com CPF cadastrado.

1. Confirme que o membro tem CPF preenchido em Membros (sem CPF o Asaas recusa).
2. Em Cobranças, localize a cobrança e clique em Emitir no Asaas.
3. O sistema cria o cliente do membro no Asaas, gera a cobrança (boleto/PIX) e devolve o link Abrir cobrança para enviar ao membro.
4. O status passa a Emitida. Se precisar refazer, use Reemitir.

Dica: Quando o membro pagar, o webhook do Asaas (6.2-C) baixa a cobrança automaticamente e registra o pagamento — você não precisa lançar nada à mão.

Para pagamentos recebidos fora do Asaas (dinheiro, PIX direto, etc.) ou para baixar contas a pagar, useFinanceiro → Pagamentos, bloco Novo pagamento:

1. Selecione a conta correspondente e, se quiser, vincule a um membro.
2. Informe o Valor e a Data do pagamento.
3. Escolha o método: Manual, PIX, Dinheiro ou Cartão.
4. Opcional: Observação.
5. Marque a declaração de ciência (confirma a veracidade e o aceite dos Termos) — obrigatória.
6. Clique em Registrar pagamento. Ele aparece em Pagamentos recentes.

Em Financeiro → Relatórios você acompanha Resumo de abertura, Próximos vencimentos e Últimos registros, com filtro por período e Exportar (CSV).

Em Financeiro → Fechamento está o relatório financeiro completo no formato livro caixa, para o fechamento do veneralato: Balanço Financeiro, Balancete por plano de contas, Receitas × Despesas mensal, Livro Caixa, Cobranças e Saldo dos Irmãos. Escolha o período e useSalvar como PDF para gerar o documento. As contas são agrupadas pelo plano de contas (código), então vincule cada lançamento a uma categoria do plano de contas para o relatório sair correto.

Ao fim da gestão, em Loja & cadastros → Veneralato o encerramento segue três passos encadeados, cada um com um responsável — não se pula etapa:

1. 1. Fechamento de caixa (Tesoureiro): abra o período e clique em Fechar caixa deste período. O sistema registra o snapshot — saldo de abertura (herdado), entradas, saídas e saldo final.
2. 2. Prestação de contas (Venerável): o Venerável revisa e clica em Aprovar prestação de contas.
3. 3. Encerrar veneralato (Administrador): só fica disponível após a aprovação. Ao encerrar, os lançamentos do período ficam travados e o saldo final é herdado pela próxima gestão como saldo de abertura.

Dica: Depois de encerrado, nenhum lançamento (conta ou pagamento) pode ter data dentro do período fechado — o sistema bloqueia para preservar a prestação de contas aprovada. Ao criar o novo veneralato, o livro caixa já abre com o saldo herdado do período anterior.

Em Loja & cadastros → Membros, a tela abre com a lista de obreiros em formato de tabela compacta. Use a busca (por nome, CPF ou CIM) e o filtro de situação para encontrar rapidamente. Clique numa linha para expandir os detalhes, onde ficam os botões Editar e Excluir cadastro.

1. Clique em + Novo membro. Só o nome é obrigatório; os demais blocos abrem conforme a necessidade.
2. Essencial: nome, e-mail, telefone, situação, rito e potência atual.
3. Dados pessoais: nascimento, CPF, RG, estado civil, profissão e nacionalidade.
4. Família e dependentes: Mãe, Pai e Esposa (com nascimento, e-mail e telefone) e a lista de dependentes (Filho/Filha/Outro, com CPF e contatos). Esses contatos servem às felicitações da Hospitalaria.
5. Endereço: o CEP preenche o endereço automaticamente.
6. Evolução maçônica: os marcos Iniciação, Elevação, Exaltação e Instalação (data + loja de cada um).
7. Clique em Salvar membro.

• Situação simbólica automática: o sistema deduz Aprendiz, Companheiro, Mestre ou Mestre Instalado a partir dos marcos preenchidos — não se digita.
• Grau Filosófico atual: opcional, selecione de 4 a 33 (REAA); se vazio, vale a situação simbólica.
• Tempo de Ordem: calculado da data de iniciação (ex.: "12 anos e 3 meses").
• Origem: potência e loja de origem do irmão (se diferente da atual).

Situações (afastamentos): além de Ativo, Suspenso e Inativo, há os afastamentos maçônicos —Quit Placet (a pedido do membro), Placet Ex Officio (por determinação da Loja) eArt. 002 (com cobertura de direitos). Apenas membros Ativos entram na cobrança em massa.

Relatório em PDF: use o filtro de situação (ex.: Ativos) e clique em Relatório PDFpara gerar a lista dos membros conforme o filtro, com cabeçalho da loja.

Dica: Preencha o CPF de quem terá cobrança via Asaas — é obrigatório para emitir boleto/PIX (ver 7.4). A exclusão é bloqueada para quem já tem histórico financeiro ou documentos; nesse caso, inative em vez de excluir.

Em Cadastros mestre você gerencia Ritos, Potências e o Plano de contas(Adicionar/Remover). Em Cargos, mantém os cargos da loja conforme o rito.

Em Veneralato, crie um Novo período (ex.: "Gestão 2025-2026") e Vincular os oficiais aos cargos daquele período.

Em Atividades → Sessões, use Criar sessão (título, grau opcional, observações). Em cada sessão, registre a presença dos membros (toggle por obreiro) para acompanhar a frequência.

Em Documentos, use Enviar e salvar documento (título + arquivo) para guardar atas, comprovantes e certificados em armazenamento privado; o download é por link seguro temporário. EmComunicação, registre avisos aos membros (recurso em evolução).

• Primeiro acesso: entre com o e-mail e a senha provisória recebida por e-mail; o sistema pede para você definir uma nova senha.
• Editar meus dados: você pode atualizar o próprio cadastro (contato, endereço, família). O seu papel/cargo só é definido pelo Administrador.
• Trocar senha: a qualquer momento, em /trocar-senha, informando a senha atual.
• Tema Papiro: prefere a interface clara? Veja a seção Aparência (capítulo 6.1) — a escolha vale para o seu navegador.

Em Hospitalaria → Irmãos (consulta) você vê a lista de obreiros em somente leitura, com busca por nome, telefone ou e-mail. Clique numa linha para ver os contatos do irmão e os da família (mãe, pai, esposa, filhos) — úteis para visitas, acompanhamento e felicitações.

Dica: Esta tela não permite editar nem excluir cadastros: o cadastro dos membros é feito pela Secretaria (capítulo 8).

O Tronco de Solidariedade é o dinheiro reservado à benemerência: faz parte do caixa total da loja, mas fica em conta separada, com finalidade específica. O Hospitaleiro acompanha o seu saldo disponível no topo da tela de Campanhas.

O saldo é calculado pela contabilidade: entradas do Tronco(conta "Tronco de Beneficência") menos os gastos de benemerência(conta "Ação Social e Caridade"). Se o saldo aparecer indisponível, peça ao Tesoureiro/Administrador para clicar em Atualizar plano de contas em Cadastros (capítulo 7.1) — isso habilita as contas do Tronco.

Em Hospitalaria → Campanhas, clique em + Nova campanha:

1. (Opcional) Escolha um Modelo entre os exemplos (cadeira de rodas, cesta básica, auxílio funeral, material escolar, medicamentos, doação a instituição) — ele preenche título e descrição.
2. Ajuste o Título e a Meta (valor estimado, opcional).
3. Em Para quem?, escolha o beneficiário: Pessoa física, Empresa ou Instituição, e informe o nome.
4. Defina a Fonte: Tronco de Solidariedade (se houver fundo), Doação voluntária dos irmãos ou Tronco + doações.
5. Escreva a Descrição e clique em Criar campanha.

Cada campanha mostra o progresso (arrecadado em relação à meta). Clique nela para abrir o detalhe e registrar doações, custear pelo Tronco, convocar os irmãos e, ao final, Concluir ou Cancelar.

Doação voluntária dos irmãos (no detalhe da campanha, bloco Registrar doação):

1. Informe o Valor e o Nome do doador. Marque Doador anônimo se ele preferir não ser identificado (o nome é guardado, mas exibido como "Doador anônimo").
2. Clique em Registrar. Cada doação entra no financeiro automaticamente, como receita na conta do Tronco — sem lançamento manual do Tesoureiro.

Custear pela própria loja (bloco Custear pelo Tronco):

1. Veja o saldo disponível do Tronco e quanto a campanha já consumiu.
2. Informe o valor e clique em Custear. O sistema lança a despesa de benemerência e reduz o saldo do Tronco — o valor não pode ultrapassar o saldo disponível.

No detalhe da campanha, o bloco Convocar os irmãos dispara um chamado à participação. Escolha os canais (E-mail, WhatsApp, SMS), o público(irmãos ativos ou todos) e, se quiser, escreva uma mensagem própria (em branco, o sistema usa um texto padrão com o resumo da campanha). Clique em Convocar.

Dica: Todo envio fica registrado no histórico de Comunicação. O envio externo realpor e-mail já sai de imediato (provido pela plataforma); WhatsApp/SMS saem quando a loja conectar a própria conta em Integrações (ver 6.6). Até lá, esses ficam enfileirados e prontos para sair, no histórico de Comunicação.