GESTÃO COMERCIAL · EDIÇÃO DE 12/11/2026

Manual do utilizador

Consultar pagamentos, acompanhar a liquidação bancária e conferir as vendas de energia, por entidade, com evidências de Transações, MEPS e ITRON.

1. Finalidade e acesso

A aplicação reúne os registos de pagamentos do portal SISP, os movimentos bancários MEPS e as vendas do sistema ITRON. Permite acompanhar as entidades 87 e 88 individualmente, identificar operações pendentes e descarregar os dados para conferência. Os processos de recolha, validação e conciliação funcionam automaticamente, mesmo sem uma sessão aberta.

Entre pela galeria de aplicações da Electra e selecione Operações Pré-pago · 24. A identidade e as permissões são verificadas pelo serviço central de autenticação. Se a sessão deixar de ser válida, volte a abrir a aplicação pela galeria. Para sair, clique no seu nome, no topo, e escolha Terminar sessão.

O manual explica o comportamento implementado. Dados ainda indisponíveis ou sem evidência suficiente permanecem identificados; o sistema não transforma uma ausência de correspondência numa aprovação.

2. Navegação e filtros

Escolha a área no menu: Indicadores, Transações, MEPS, Conciliação, Arquivo e relatórios ou Processamento.
Selecione o período. Um mês limita a análise a esse mês; a opção anual reúne o ano selecionado até ao último dia fechado.
Selecione uma entidade ou Todas as entidades. Nos indicadores, cada entidade conserva os seus próprios valores e contagens.
Para analisar um único dia, utilize Dia (opcional). A escolha ajusta o mês correspondente. Limpe o dia para retomar a consulta mensal ou anual.
Utilize pesquisa e resultado nas tabelas. A pesquisa procura identificadores, referências, contadores e estados presentes no conjunto selecionado.

Clique num cabeçalho para ordenar pela coluna; um novo clique alterna o sentido. As tabelas operacionais começam em ordem crescente de data e hora. A cobertura mensal começa pelo mês mais recente. Utilize os botões de página anterior e seguinte para percorrer os resultados.

Atualizar consulta novamente os resultados disponíveis, com indicação visual durante a consulta e confirmação após conclusão. Não é necessário clicar para iniciar os processos normais. Indicadores e Processamento atualizam-se periodicamente; uma consulta de detalhes aberta e as explicações expandidas são preservadas.

No telemóvel, abra a navegação pelo botão ☰. Feche-a escolhendo uma área, clicando fora do menu ou usando Escape. O botão de tema no topo alterna entre claro e escuro. Inicialmente acompanha a preferência do dispositivo; uma escolha manual fica guardada nesse navegador.

3. Indicadores de gestão

O mesmo conjunto de indicadores pode ser consultado por dia, mês ou ano. Os montantes são apresentados em CVE, com duas casas decimais. O período contabilístico e a última atualização permitem avaliar o âmbito e a atualidade dos números. Antes de decidir com base num total, confirme a cobertura do período.

Indicador	Como é apurado e como interpretar
Vendas confirmadas	Soma dos pagamentos concluídos, com confirmação de sucesso e comprovativo de energia. Cada operação lógica é contada uma vez; validações e tentativas intermédias não multiplicam a venda.
Recebimento bancário bruto	Soma dos movimentos MEPS de pagamento pré-pago, código de processamento 04, na entidade e no período selecionados.
Comissão SISP / tarifas	Soma das tarifas dos movimentos MEPS do período. É a remuneração da SISP pelo serviço prestado e não uma venda de energia.
Recebimento bancário líquido	Bruto bancário menos todas as tarifas MEPS do período. É apresentado separadamente do valor bruto e da comissão.
Operações únicas	Operações agrupadas por entidade, mês, período de compensação e identificador de transação. Um registo sem identificador não é fundido com outro sem prova.
Operações com falha	Operações com uma etapa de falha que não têm pagamento concluído no grupo analisado. Uma tentativa falhada seguida de sucesso não conta como uma nova venda perdida.
Estornos confirmados	Operações de venda com estorno identificado. O valor de vendas após estornos é o das vendas confirmadas menos o valor dessas vendas estornadas.
Taxa de conciliação	Operações sem divergência divididas pelo total analisado na conciliação Transações × MEPS, multiplicado por 100. Se não existem operações analisadas, não há percentagem calculável. Esta taxa não certifica os dois cruzamentos com ITRON; consulte-os na área Conciliação.
Dias conciliados e dias a recuperar	A cobertura verifica a presença e validação das origens e do resultado de conciliação. Um dia pendente não equivale a zero vendas.

Exemplo ilustrativo: num dia, a entidade tem 10 000,00 CVE de bruto bancário e 200,00 CVE de tarifas. O líquido é 9 800,00 CVE. A comissão não deve ser novamente deduzida desse líquido. Se as vendas e o banco diferirem, verifique datas de liquidação, estornos, cobertura e correspondências antes de concluir que existe uma perda.

Abra Consultar evolução diária para ver a distribuição dos valores. A série compara vendas confirmadas e recebimento líquido na data efetiva dos respetivos registos; uma liquidação tardia pode deslocar o valor bancário para outro dia. A exportação dos indicadores conserva o âmbito por entidade.

4. Transações pré-pago

Esta área mostra as fases registadas no portal de pagamentos: validação do cliente, processamento, confirmação, falha e estorno. As linhas são registos da operação; várias linhas podem pertencer ao mesmo pagamento.

Use Resultado → Com falhas ou divergências para concentrar a consulta nos problemas. Etapas intermédias permite consultar validações e fases que não demonstram, por si, o pagamento. Uma etapa intermédia não deve ser contabilizada como venda concluída.

Em Ver detalhes, consulte a data, entidade, referência, transação, valor, estado e outros dados de negócio disponíveis. O comprovativo de energia é protegido de acordo com o perfil. Para confirmar uma venda, procure o pagamento concluído e a correspondência ITRON; a existência de uma validação do cliente é insuficiente.

5. MEPS • movimentos bancários

Os ficheiros MEPS descrevem os movimentos bancários e a compensação. A tabela apresenta data e hora da operação, entidade, referência, transação, bruto, tarifa, líquido e resultado. A origem é validada antes de os movimentos integrarem os indicadores.

O bruto e o líquido têm significados diferentes. Para comparar uma venda de energia com o banco, compare primeiro o valor da venda com o bruto. O líquido é o valor após a comissão. A comissão explica uma diferença esperada entre bruto e líquido; não deve ser tratada como falta de pagamento.

O ficheiro é normalmente disponibilizado no dia seguinte às operações que consolida. O nome ou a data de geração do ficheiro pode pertencer a um mês diferente da data contabilística dos movimentos contidos nele. As consultas e a conciliação usam a data da operação e as chaves de compensação, em vez de se limitarem ao nome do ficheiro.

6. As três conciliações

Na página Conciliação, selecione o tipo no primeiro campo. Cada linha apresenta as evidências principais, os valores e um resultado visual. Ver detalhes separa os dados por origem — Transações, MEPS e ITRON — e mostra as evidências adicionais disponíveis. Um grupo ausente significa que não existe informação dessa origem naquela correspondência; não significa valor zero.

6.1 Transações × MEPS

Confere o pagamento do portal com o movimento bancário. São confrontados entidade, período de compensação, identificador da transação, referência e montante. O tratamento de estornos e de movimentos de períodos adjacentes evita confundir a data da venda com a da liquidação. O resultado mensal substitui os resultados diários do mesmo âmbito na tabela consolidada, evitando contagem duplicada.

Uma correspondência aprovada exige chaves consistentes e validação dos valores. Uma referência diferente, um valor diferente ou a ausência de movimento mantém a operação em divergência ou pendente, conforme as origens disponíveis.

6.2 Transações × ITRON

Procura a venda no ITRON primeiro pelo par token e contador. Se não encontrar, utiliza a referência do pedido de venda vendReq nas Transações e Vend_ref_sent no ITRON. Quando o contador é conhecido, também tem de ser coerente. O montante da venda tem de coincidir em cêntimos com o valor da transação.

Uma única correspondência é necessária. Várias vendas candidatas, contadores diferentes ou a mesma venda associada a várias operações não são aprovados automaticamente. A fonte ITRON considera vendas bem-sucedidas em CVE. Uma origem ITRON ainda não coberta mantém o caso pendente.

6.3 MEPS × ITRON

Considera apenas o revendedor SISP no ITRON. O objetivo é verificar se os movimentos bancários correspondem às vendas desse revendedor, usando o ITRON como referência da emissão de energia.

O MEPS não contém diretamente token e contador. A ligação usa a transação de origem: entidade, compensação e número de transação ligam o banco às Transações; o token/contador ou a referência do pedido ligam as Transações ao ITRON. A referência bancária e os valores também são verificados. O bruto MEPS é comparado com a venda ITRON; a comissão e os líquidos são apresentados separadamente.

O sistema pesquisa passagens de mês e admite ligações únicas até 31 dias quando as restantes evidências são coerentes. Também pode reconhecer uma venda confirmada pelo banco e pelo ITRON quando falta a confirmação final do portal, desde que as chaves e os montantes sustentem uma correspondência única. Não aprova apenas pela proximidade de datas ou igualdade de valor.

Vendas SISP sem movimento identificado aparecem como exceções. Quando a entidade é demonstrada por uma associação única do contador no arquivo, essa evidência fica indicada. Quando não é demonstrável, a venda fica Por atribuir, sem escolher uma entidade por suposição.

6.4 Ler o resultado

Concluída: correspondência e valor confirmados pelas regras aplicáveis.
Com divergência: existe diferença ou falta de ligação que exige conferência.
Pendente: faltam origens, fecho ou evidências para decidir.
Dados inválidos: uma origem falhou a validação; deve ser recuperada ou corrigida.
Estornada: existe evidência de reversão; consulte o detalhe antes de comparar o total com vendas.

Os resultados são atualizados quando novas origens válidas chegam. A correção automática melhora a ligação entre registos; não altera a venda ITRON nem inventa movimentos bancários.

7. Datas, fechos e mudança de ano

As Transações e o MEPS consolidam o dia anterior. O dia em curso não é tratado como fechado. Por exemplo, a recolha de 1 de janeiro pode trazer dados relativos a 31 de dezembro do ano anterior. Uma ausência antes do fecho não deve ser interpretada como falha financeira.

Para conferir janeiro, são necessários os CSV das operações de 1 a 31 de janeiro e os MEPS que liquidam essas operações, incluindo os ficheiros disponibilizados em 1 de fevereiro para o fecho de 31 de janeiro. Os cruzamentos com ITRON precisam também do Report ITRON correspondente.

O contexto de 31 de dezembro inclui Transações e ITRON desse dia e MEPS gerados em 1 de janeiro. O motor mensal utiliza ainda o histórico de dezembro para justificar movimentos anteriores. Esse contexto não é somado indiscriminadamente às vendas de janeiro. Liquidações tardias podem exigir ficheiros adicionais de outro período.

A hora mostrada pela aplicação utiliza o âmbito de Cabo Verde quando existe informação de fuso. Diferenças de hora nos ficheiros sem fuso explícito não justificam uma deslocação arbitrária de datas para forçar correspondências.

8. Falhas e divergências: como analisar

Situação	Leitura e ação recomendada
Ficheiro em falta / a aguardar fecho	Confira a cobertura e Processamento. A recuperação é automática. Aguarde o fecho ou a nova tentativa; não assuma que não houve operações.
Sem correspondência ITRON	Verifique a cobertura do Report, token/contador e referência do pedido no detalhe. Uma origem incompleta mantém o resultado pendente.
Valor diferente	Compare montantes da mesma operação e confirme se está a comparar bruto com bruto. Verifique tarifa e estorno separadamente.
Correspondência ambígua / duplicada	Há mais de um candidato ou uma venda já associada. O sistema mantém a exceção para evitar aprovação indevida; é necessária evidência adicional.
Venda ITRON sem Transações nem MEPS	A emissão está demonstrada no ITRON, mas a ligação à liquidação não. Solicite à SISP um mapa que relacione referência de venda, compensação, operação bancária e crédito. Montante e data coincidentes não bastam.
Pagamento confirmado sem MEPS	Confira ficheiros de liquidação posteriores e a referência bancária. Se continuam ausentes com cobertura completa, obtenha prova de liquidação e de crédito bancário antes de concluir a divergência financeira.
Entidade por atribuir	A origem não demonstra uma associação única à entidade. Consulte todas as entidades e o respetivo relatório; não atribua só por proximidade ou valor.
Acesso à origem recusado	O sistema espaça tentativas. Um responsável autorizado deve regularizar a credencial na origem. Nunca envie palavras-passe no relatório de conferência ou num pedido de suporte.

Uma falha de execução é diferente de uma divergência de negócio. Repetir uma recolha pode recuperar um ficheiro; não resolve uma venda sem prova de liquidação. Para tratar uma exceção, registe entidade, período, tipo de conciliação, referência, identificador e causa. Utilize a exportação filtrada para acompanhar os casos, respeitando a proteção dos tokens.

9. Processamento automático e recuperação

O coordenador verifica os dias fechados e identifica as origens que faltam.
Obtém os ficheiros e valida conteúdo, âmbito e consistência. Um ficheiro inválido não é considerado cobertura concluída.
Indexa os registos para pesquisa e consulta, conservando as origens.
Executa a conciliação diária e a mensal quando o respetivo âmbito está disponível; cruza as vendas ITRON disponíveis e publica os relatórios por entidade.
Atualiza os indicadores e a cobertura. As execuções e tentativas ficam registadas.

Na página Processamento, consulte período, entidades, situação, número de tentativas e última atualização. Em Ver detalhes encontra a explicação do estado e a próxima tentativa, quando agendada.

Uma execução falhada ou interrompida é novamente agendada com espera progressiva, de dois minutos até seis horas. Uma recusa de autenticação tem espera mínima de trinta minutos para proteger a conta. O intervalo não garante que a origem já esteja disponível; enquanto persistir a causa, as tentativas continuam espaçadas. Uma execução cancelada deliberadamente não é retomada automaticamente.

Recuperada indica que uma tentativa posterior concluiu e validou o trabalho. Na fila aguarda execução. Em execução está em curso. A aguardar acesso à origem exige a disponibilidade ou regularização da origem, mantendo os restantes períodos processáveis.

A Administração permite agendar operações excecionais por período e entidade e consultar diagnósticos técnicos. O uso normal não exige agendamentos manuais. O reprocessamento conserva as evidências de origem e substitui as representações consolidadas do mesmo âmbito, evitando somá-las novamente.

10. Arquivo, relatórios e downloads

10.1 Exportar uma tabela

Utilize Exportar Excel filtrado na área de dados. A versão simplificada contém todas as linhas que cumprem a seleção de período, entidade, pesquisa e resultado — não apenas a página visível. A ordenação escolhida é conservada; os identificadores permanecem texto para não perder zeros iniciais. Algumas áreas disponibilizam CSV para consulta em folha de cálculo.

10.2 Escolher a versão Transações ou MEPS

No campo Versão do download, escolha:

Simplificada · Excel: colunas de leitura direta, montantes e estados amigáveis, respeitando os filtros da tabela.
Originais SISP · ZIP: pacote dos ficheiros de origem validados relacionados com o período e a entidade selecionados. Mantém a estrutura SISP. A pesquisa e o filtro de resultado não recortam as linhas desses ficheiros. Um CSV original de Transações pode conter ambas as entidades; o ficheiro completo é incluído. Nos MEPS, uma origem de outro mês pode ser incluída por conter liquidações do período. Cópias idênticas não são repetidas no pacote.

Proteção nos originais: TI e administradores recebem os originais com tokens completos. Os restantes perfis recebem os CSV no formato de origem com os tokens mascarados; por esse motivo, esses CSV protegidos não são cópias binárias dos ficheiros SISP. Os MEPS não contêm o token de energia e são preservados. O pacote inclui uma nota com o âmbito e a proteção aplicada.

10.3 Arquivo mensal

O Arquivo e relatórios publica um consolidado por mês e entidade, com cinco folhas: Transações, MEPS e os três tipos de conciliação. Quando existem operações cuja entidade não foi demonstrada, aparece um âmbito separado Por atribuir. A coluna Entidade e o nome do relatório identificam a origem mesmo com Todas as entidades selecionado.

Clique Consultar para escolher uma folha, pesquisar, ordenar e percorrer os dados. A primeira leitura de um relatório grande pode mostrar A preparar a consulta; a aplicação acompanha a preparação. Se falhar, utilize Tentar novamente. Descarregar obtém o relatório, também com tokens protegidos conforme o perfil. A exportação na consulta inclui as linhas filtradas da folha selecionada.

Os ficheiros JSON e o diagnóstico técnico são reservados à administração. Para a conferência corrente, utilize os estados, os grupos de origem no detalhe e as tabelas de negócio.

11. Perfis, tokens e confidencialidade

Os perfis são obtidos da autenticação central e das atribuições administrativas autorizadas. Não basta alterar um filtro ou uma informação no navegador para obter outro nível de acesso.

Perfil	Tokens de energia	Diagnóstico e JSON
Utilizador comum	Mascarados nas consultas e nos downloads. Para um token de 20 dígitos, apenas os quatro primeiros e quatro últimos permanecem visíveis.	Sem acesso técnico.
TI	Completos, após confirmação da categoria central.	A categoria TI por si só não concede administração.
Administrador	Completos.	Acesso a diagnóstico e funções administrativas.

Exemplo fictício de apresentação: 1234************5678. A proteção aplica-se no servidor, incluindo detalhes, pesquisas apresentadas, consultas de ficheiros e exportações. As evidências guardadas para conciliação não são alteradas. Se não for possível confirmar o perfil TI, a aplicação conserva a máscara.

Os relatórios continuam a conter informação operacional e financeira confidencial. Partilhe-os apenas com destinatários autorizados e através dos canais institucionais. Antes de pedir suporte, recolha a referência, o período, a entidade e o estado; não inclua palavras-passe nem tokens completos.

12. Rotinas de conferência

Conferência diária

Selecione a entidade e o último dia fechado.
Confira se Transações, MEPS e conciliação têm cobertura válida.
Compare vendas, bruto bancário, comissão e líquido, considerando que as datas das duas origens podem diferir.
Consulte cada um dos três cruzamentos e filtre os casos com divergência; veja também os pendentes.
Abra os detalhes e identifique a origem da evidência em falta. Exporte os casos que exigem seguimento.

Fecho mensal e acompanhamento anual

Retire o filtro diário e selecione o mês ou o ano.
Confirme a cobertura dos dias e o contexto dos períodos adjacentes, especialmente dezembro/janeiro.
Analise cada entidade separadamente. Consulte Por atribuir na visão geral quando existirem vendas sem entidade demonstrada.
Descarregue o consolidado do mês e compare os três cruzamentos. Registe as exceções ainda sem prova.
Após chegarem novas origens, aguarde o reprocessamento automático e volte a conferir o estado. Não trate um relatório antigo como prova do resultado atual.

13. Perguntas frequentes

A tabela está vazia. Não houve vendas?: Verifique período, entidade, pesquisa e resultado. Consulte a cobertura e o acompanhamento. Sem origem disponível, uma tabela vazia não prova ausência de operações.
Porque há mais linhas de Transações do que pagamentos?: O portal regista várias fases e tentativas. Os indicadores agrupam a operação lógica; a tabela conserva as fases para permitir conferência.
Uma venda no ITRON prova depósito bancário?: Prova a emissão registada, não o crédito bancário. A liquidação requer correspondência MEPS ou outro comprovativo bancário demonstrável.
A tarifa deve coincidir com uma venda?: Não. É uma comissão de serviço. Compare venda e bruto; depois confirme a dedução da tarifa para obter o líquido.
Porque um ficheiro de fevereiro aparece numa análise de janeiro?: Pode liquidar operações do fim de janeiro. O sistema procura as operações e as suas chaves, não apenas o mês no nome do ficheiro.
Preciso de deixar a aplicação aberta para recuperar uma falha?: Não. O processamento é independente da sessão. Consulte Processamento para ver o estado e a próxima tentativa.
Uma divergência desaparece ao repetir o processo?: Só se novas evidências válidas resolverem a causa. A repetição não aprova correspondências ambíguas nem corrige valores nas origens.
Porque o download original contém mais linhas do que a tabela?: O original mantém o ficheiro SISP completo e não aplica pesquisa ou resultado. Utilize a versão simplificada para obter exatamente o âmbito filtrado.
Porque não vejo o token completo?: O perfil comum vê apenas uma parte dos primeiros e últimos dígitos. O acesso completo exige TI confirmado ou administração; recarregar a página não altera a permissão.

14. Glossário

Conciliação: Verificação da correspondência entre registos de origens diferentes e dos seus valores.
Cobertura: Presença e validação das origens e resultados necessários para o período.
Compensação: Período ou chave usada na identificação e liquidação das operações bancárias.
Entidade: Âmbito operacional identificado pelo código 87 ou 88 nesta aplicação.
Estorno: Reversão identificada de uma operação.
ITRON: Sistema que regista a venda e emissão de energia; referência da venda para os cruzamentos implementados.
MEPS: Ficheiro de movimentos bancários disponibilizado pela SISP.
Token / comprovativo de energia: Código de energia emitido para o contador. É informação protegida.
vendReq / Vend_ref_sent: Referência do pedido nas Transações e referência enviada no ITRON, utilizadas como evidência de ligação.
Bruto, tarifa e líquido: Valor bancário antes da comissão, comissão de serviço SISP e valor após a dedução da comissão, respetivamente.