BI & Dashboards executivos

Painéis de leitura para o executivo municipal: quanto foi previsto, facturado e arrecadado, onde e em que rubricas, com descida até ao documento de origem. O módulo chama-se Analítica / Executivo na consola e cobre estes menus:

Secção	Menus
Analítica / Executivo	Dashboard do Presidente · Vereador (Finanças) · Explorador de receita · Relatórios · Exportações

Todos os ecrãs exigem bi.view; Gerar relatório exige bi.manage. Perfis de origem com acesso: Presidente / Executivo, Vereador de Finanças (único com bi.manage), Técnico de Tributação, Tesoureiro / Caixa, Contabilista, Chefe de Urbanização e Auditor (leitura). Ver Perfis e permissões.

Conceitos comuns

Indicadores canónicos

Indicador	Fórmula	Meta de referência
Taxa de cobrança	arrecadado ÷ facturado	≥ 75 % (mensal)
Execução da receita	arrecadado ÷ previsto	≥ 90 % (anual)
Taxa de evasão	dívida vencida ÷ previsto	≤ 10 % (mensal)
Dependência de transferências	transferências do OE ÷ receita total	≤ 50 % (anual)

Percentagens arredondadas a uma casa decimal. Valores em meticais (MT).

Semáforo de execução

Execução	Estado	Cor
≥ 90 %	Normal	verde
60 – 89 %	Atenção	amarelo
< 60 %	Crítico	vermelho

Filtro de exercício

Os três painéis têm o selector Exercício (2026 / 2025 / 2024), com o exercício corrente por defeito. Ao mudar o exercício, os números anteriores ficam visíveis até chegarem os novos.

De onde vêm os números

O BI lê agregados consolidados de receita (previsto / facturado / arrecadado / em aberto, por exercício, período, tipo de receita, posto administrativo e bairro) e um retrato de KPIs por exercício (contribuintes activos, guias emitidas, guias pagas, dívida vencida, dependência de transferências). O drill-down até ao documento de origem lê directamente os lançamentos da Tributação. Os dados são pedidos ao servidor a cada abertura e guardados no browser por 30 segundos; não há actualização automática em segundo plano.

Painéis a zero

Se os agregados do exercício ainda não tiverem sido consolidados, os cartões e gráficos aparecem a 0 e o Explorador só devolve linhas na dimensão Documento de origem. A rotina de consolidação não está incluída nesta versão da consola (não verificado) — confirme com a equipa de sistemas antes de apresentar números.

Dashboard do Presidente

Analítica / Executivo › Dashboard do Presidente — «Visão executiva da receita própria».

Quatro cartões:

• Receita arrecadada — valor arrecadado, com «de X previstos»;
• Execução da receita — %, «arrecadado / previsto», cor pelo semáforo;
• Taxa de cobrança — %, «pagas/emitidas guias pagas»;
• Dívida em aberto — valor, com «evasão X %»; a cor reflecte 100 − evasão.

Painéis:

• Evolução mensal da receita — barras agrupadas por mês, séries Facturado (cinza) e Arrecadado (verde), com o total arrecadado no título;
• Top receitas — as 5 maiores rubricas do exercício, ordenadas por arrecadado;
• Receita por tipo — barras horizontais do arrecadado por imposto/taxa;
• Receita por posto administrativo — barras horizontais com «valor · peso %» de cada posto;
• Dashboards executivos — atalhos para Vereador (Finanças), Explorador de receita e Relatórios.

O botão Explorar receita (cabeçalho) abre o Explorador. Os gráficos deste painel não têm clique: para descer ao detalhe use o Explorador.

Vereador (Finanças)

Analítica / Executivo › Vereador (Finanças) — «Execução da receita própria por tipo · previsto vs arrecadado».

Cartões: Receita arrecadada («de X facturados»), Dívida em aberto («evasão X %»), Execução da receita e Dependência de transferências («das transferências do OE»).

• Previsto vs arrecadado por tipo — barras agrupadas por imposto/taxa, séries Previsto e Arrecadado;
• Alertas — regras fixas avaliadas sobre o exercício seleccionado:

Condição	Alerta	Gravidade
Evasão > 15 %	«Evasão elevada: X % da receita prevista.»	grave
Execução < 60 %	«Execução da receita abaixo do esperado: X %.»	grave
Dependência de transferências > 50 %	«Dependência de transferências elevada: X %.»	aviso
Rubrica com previsto > 0 e execução < 50 %	«Tipo: execução crítica (X %).»	grave

Sem condições activas aparece «Sem alertas — indicadores dentro dos limites.»

• Detalhe por tipo de receita — tabela Tipo · Previsto · Facturado · Arrecadado · Em aberto · Execução · Semáforo.

O botão Presidente (cabeçalho) volta ao painel anterior.

Explorador de receita

Analítica / Executivo › Explorador de receita — «Drill-down por período × tipo × território até ao documento de origem». É o único ecrã de BI com descida ao detalhe.

Filtros

Filtro	Opções	Notas
Exercício	2026 / 2025 / 2024
Dimensão base	Tipo de receita · Posto administrativo · Mês	bloqueada durante o drill
Tipo	Todos os tipos · IPRA — Imposto Predial · IPA — Imposto Pessoal · IAV — Veículos · SISA · Taxa · Licença	só activo com a dimensão Tipo de receita e sem drill

Vista gráfica

Gráfico combinado: barras Facturado (cinza) e Arrecadado (verde) e linha Previsto (vermelha), no máximo 12 pontos. A dimensão Documento de origem não é desenhada — só a tabela.

Tabela e drill-down

Colunas Dimensão · Previsto · Facturado · Arrecadado · Em aberto, 25 linhas por página. As linhas com detalhe disponível mostram uma seta à direita:

1. Clique na linha (ex.: «IPRA — Imposto Predial») — a tabela desce para os documentos de origem dessa linha;
2. O trilho passa a Tipo de receita › IPRA › Documento de origem; Voltar sobe um nível;
3. Na dimensão Documento de origem, o rótulo de cada linha é um link para o lançamento em Gestão tributária › Lançamentos, onde se vê a guia, o pagamento e o contribuinte.

Nos documentos, facturado = valor calculado + juros, e arrecadado = facturado apenas quando o lançamento está pago.

Exportar CSV

O botão Exportar CSV gera o ficheiro explorador-{exercício}.csv no browser, com as colunas dimensao, chave, rotulo, previsto, faturado, arrecadado, em_aberto, codificado em UTF-8 com BOM (abre correctamente no Excel). Exporta apenas a página visível — para tabelas longas, exporte página a página ou use os mapas da Contabilidade.

Relatórios

Analítica / Executivo › Relatórios — «Catálogo de relatórios legais e de gestão». Cada cartão tem a categoria (Receita · Execução · Legal · Operacional), o nome, a base legal e os formatos suportados.

Relatório	Categoria	Base legal	Formatos
Mapa de execução orçamental	Execução	Lei 1/2008	PDF · Excel · CSV
Conta de gerência (prestação de contas)	Legal	Lei 1/2008	PDF · Excel
Receita por tipo de imposto/taxa	Receita	—	PDF · Excel · CSV
Receita por território (posto/bairro)	Receita	—	PDF · Excel · CSV
Mapa de dívida e cobrança coerciva	Operacional	—	PDF · Excel · CSV

Gerar um relatório

1. Gerar no cartão pretendido (exige bi.manage);
2. No painel Gerar relatório, escolha Exercício e Formato; o campo Pré-visualização mostra CÓDIGO · exercício · formato;
3. Gerar relatório → mensagem «Relatório gerado: ficheiro» e atalho Ver exportações.

Geração simulada nesta versão

O catálogo regista a execução no histórico, mas não produz o ficheiro PDF/Excel — o próprio ecrã indica «geração simulada». Para mapas oficiais com PDF e Excel reais use Contabilidade & Orçamento › Mapas & relatórios (balancete, execução da receita, conta de gerência). Ver Contabilidade.

Exportações

Analítica / Executivo › Exportações — «Histórico de relatórios gerados». Tabela Relatório (nome + referência do ficheiro) · Gerado por · Parâmetros · Data · Formato · Estado, com pesquisa por nome do relatório.

Estados: Em processamento, Concluído, Erro. Acções por linha:

• Descarregar — activo só em Concluído. Nesta versão entrega um ficheiro de resumo (nome, data, autor, parâmetros, formato), não o relatório em si;
• Reproduzir com os mesmos parâmetros — cria uma nova execução com o mesmo exercício e formato.

O botão Catálogo volta aos Relatórios.

Exportar mapas reais (PDF / Excel)

Os botões PDF e Excel existem nos mapas da Contabilidade (balancete, execução da receita, conta de gerência) e aplicam exactamente os filtros do ecrã:

• Enquanto gera, ambos os botões mostram «A gerar…» e aparece Cancelar; sair do ecrã cancela o pedido;
• Limites: PDF até 1 000 linhas, Excel até 5 000 linhas. Acima disso o sistema recusa com uma mensagem clara — estreite o período ou os filtros;
• O PDF sai em papel timbrado do município com o código de documento no rodapé, e é depositado no Arquivo;
• Cada exportação fica na trilha de auditoria (quem, quando, formato, período e filtros).

Perguntas frequentes

Os números do Presidente e do Vereador não batem com a Tesouraria. Os painéis lêem agregados consolidados por exercício; a Tesouraria mostra o movimento em tempo real. Diferenças aparecem até à consolidação seguinte.

Posso filtrar por bairro? O Explorador oferece Tipo de receita, Posto administrativo e Mês. O detalhe por bairro está no relatório Receita por território e nos cartões territoriais do Presidente (não verificado no Explorador).

Consigo abrir o BI sem permissão? O menu não aparece e a API responde «Sem permissão para esta operação.» Se o módulo estiver desligado para o município, a mensagem é «O módulo bi está desactivado para este município.»

Há actualização automática? Não. Recarregue a página ou mude o exercício para pedir números novos.