SSB - Manual de Procedimentos e Operações

Os manuais de sistema faz com que os usuários tenha uma visão abrangente e detalhada dos produtos da Cebi.

Leitura Android

SSB - Manual de Procedimentos e Operações.

Leitura Android

Configuração Inicial Impressora Bixolon

Disponivel na rede no link "//192.168.4.4\kits\Pacotes\Cebi\SSB\SAC\Impressora Bixolon" onde tem a pasta "Programa_Bixolon_Configuracao" que contem o programa para configuração inicial da impressora Bixolon.

  1. Conectar impressora ao computador pelo cabo USB e seguir os passos abaixo.

  2. Clicar no botão "Connect" > Clicar campo "User Setting" > Clicar botão "Configure Printer Setting".

Config_00.jpg

  1. Na aba "Interface", selecionar as opções "Serial Communication Setting" e o "Bluetooth Communication Setting" > Clicar no botão "Get" > Deixar as opções igual a imagem abaixo > Clicar no botão "Set".

Config_01.jpg

  1. Na aba "Basic", clicar no botão 'Get From Printer" > Selecionar o campo "UNIT" como "mm" > Deixar as opções igual a imagem abaixo > Clicar no botão "Set to Printer".

Config_02.jpg

  1. Na aba "Advanced", clicar no botão 'Get From Printer" > Deixar as opções igual a imagem abaixo > Clicar no botão "Set to Printer".

Config_03.jpg

  1. Na aba "Language", clicar no botão 'Get" > Deixar as opções igual a imagem abaixo > Clicar no botão "Set".

Config_04.jpg

  1. Na aba "Power", clicar no botão 'Get From Printer" > Deixar as opções igual a imagem abaixo > Clicar no botão "Set to Printer".

Config_05.jpg

Leitura Android

Procedimento para ligações / fotos que não retornaram.

Cliente informou que ligações / fotos não retornaram ao sistema.

Verificar no aparelho pelo App Leitura na tela inicial se na coluna LNT(Ligações Não Transmitidas) e coluna FNT(Fotos Não Transmitidas) existem informações não transmitidas ainda.

Identificado que no aparelho pelo App Leitura não transmitiu ao site, segue algumas alternativas:

  1. Reiniciar o aparelho, tentar transmissão pelo 4G e Wifi;
  2. Tentar retransmitir, no aplicativo selecionar ícone de configurações > Nos parâmetros ao final da tela em Rotas Carregadas > selecionar a imagem de retransmitir na frente da rota;
  3. Gerar o backup no aparelho do cliente e tentar carregar em celular da Cebi;

Obs.: Mesmo fazendo os procedimentos acima ainda assim não sejam transmitidas, abrir incidente anexar o backup do cliente. Nos casos de fotos além do backup é necessário o envio da pasta fotos que fica na memória interna do aparelho "Pasta AppLeitura > Fotos".

Identificado que no aparelho pelo App Leitura já foi transmitido ao site, siga para os próximos passos.

  1. Acessar o site http://gps.cebinet.com.br > login do cliente > clicar em Arquivos > Pesquisar > verificar se tem arquivos com o status "ErroDeRecebimento". Caso sim, clicar em cima do status "ErroDeRecebimento" > abrira a lista dos arquivos > clicar no ID > no final da tela em "Editar" > trocar a Situação para "Gerado" > No final da tela em "Gravar";
  2. Caso no site GPS não de para identificar ou que tenham muitas arquivos com erros de transmissão, abrir prestação a Infra para que seja feito verificação no sync;

CicloLeituraAndroid.png

Teste no Postman para uso de API externa para monitoramento.

SSB - Manual de Procedimentos e Operações - Explicação de como se utilizar o Postman para que seja feito o teste da API externa desenvolvida para retornar os dados das rotas realizadas pelos leituristas.

Teste no Postman para uso de API externa para monitoramento.

API para Monitoramento

Guia de Teste API Monitoramento

Foi desenvolvida uma nova API, semelhante a uma existente no projeto de Leituras. Essa nova API será consultada externamente através do Postman. Abaixo, segue uma explicação detalhada de como obter as informações desejadas através dela.

1. Configuração da URL e Método

No Postman, configure a URL e o tipo de método que será utilizado. Para obter o token, utilize o método POST e a URL:

http://win13.cebisist:40010/login/connect/token

OBS: Troque a porta 40010 pela porta referente ao cliente em questão.

Na aba Headers, configure o Content-Type para application/x-www-form-urlencoded, conforme ilustrado na imagem abaixo:

Configuração Authorization

2. Configuração dos Parâmetros do Body

Na aba Body, selecione a opção x-www-form-urlencoded e configure os parâmetros conforme mostrado na imagem abaixo.

Nota: Substitua SeuClienteId e SeuClienteSecret pelo usuário e senha do cliente em questão.

Após configurar, clique no botão Send para obter o token.

3. Configuração da Nova Requisição

Abra uma nova aba no Postman e configure a URL da API criada:

http://localhost:58000/leitura/Api/Rotas/PosicaoPorGrupo

Na aba Params, adicione os seguintes parâmetros:

Importante: Certifique-se de que os nomes dos parâmetros estão exatamente como descritos acima.

4. Autorização

Na aba Authorization, selecione o tipo Bearer Token e insira o token gerado no passo 2 no campo Token.

Configuração Params

Clique no botão Send para fazer a chamada da API e obter as rotas desejadas.

Considerações Finais

Com essas instruções, qualquer pessoa deve ser capaz de utilizar a API sem dificuldades. Se precisar de mais algum ajuste, sinta-se à vontade para pedir!

Balcão Web

SSB - Manual de Procedimentos e Operações - Sistema online que permite aos funcionários resolver as demandas dos consumidores numa plataforma centralizada onde é possível acessar informações detalhadas sobre contas, histórico de consumo, débitos pendentes e solicitações dos clientes. 

Balcão Web

Sistema Balcão Web - Cebi Informática

O sistema permite a realização de uma variedade de tarefas no atendimento ao contribuinte, incluindo consulta de ligações e seus dados, emissão de 2ª via de faturas, consulta de débitos, parcelamentos, histórico, entre outros.

Entrando no Sistema Balcão Web

Passo a passo:

  1. Ao acessar o endereço informado pela CEBI Informática, no quadro “Acessar o Sistema” informe o seu “Usuário” e “Senha” e clique no botão “Entrar”.

  1. O sistema apresenta a tela inicial do sistema.

Consulta de Cadastro

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma das modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  1. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  1. O sistema apresenta a tela de “Detalhes da Ligação”.

Importante: A partir desta tela você poderá realizar a quase totalidade de tarefas do Balcão de Atendimento.

Emissão de 2ª via de Conta

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma as modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  2. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  3. O sistema apresenta a tela de “Detalhes da Ligação”.

  4. Clique na aba “Contas”.

  1. Localize o painel “Contas” e selecione a conta em aberto que deseja imprimir a 2ª via.

Dica: o sistema apresenta a relação de contas em aberto por padrão.

  1. Selecione a(s) conta(s) para emissão de 2ª via. Esta ação pode ser realizada clicando no botão “Selecionar Todas” ou utilizando o botão de marcação individual.

  1. Após selecionar a(s) conta(s) clique no botão “Imprimir Contas Selecionadas” para impressão ou “Enviar por e-mail as Contas Selecionadas” para envio por e-mail.

Extrato de débito

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma as modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  2. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  3. O sistema apresenta a tela de “Detalhes da Ligação”.

  4. Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Extrato de Débito”.

  1. Localize o painel “Contas em Aberto”. Selecione o(s) débito(s) que deseja consultar clicando na conta.

  1. Localize o painel “Relação de Débitos” e clique no botão “Download” para imprimir o extrato ou informe um e-mail para recebimento e selecione “Enviar”.

Editar Cadastro de Ligação

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma as modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  2. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  3. O sistema apresenta a tela de “Detalhes da Ligação”.

  4. Selecione a aba “Ligação”.

  1. Localize o painel “Consumidores” e clique no botão alterar correspondente ao cadastro que deseja modificar.

  1. Verifique se é o cadastro correto e clique no botão “Editar Pessoa”.

  1. Uma nova tela será aberta com as informações do cadastro. Faça a alteração necessária.

Importante: Todas as alterações ficarão registradas no histórico.

  1. Após a atualização do cadastro, clique em “Gravar” para finalizar.

Detalhamento da conta

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma as modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  2. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  3. O sistema apresenta a tela de “Detalhes da Ligação”.

  4. Clique na aba “Contas”.

  1. O sistema mostra as contas “Abertas” por padrão. O usuário poderá utilizar outros filtros de pesquisa de contas para auxiliar na busca.

  1. Localize o painel “Contas” e clique no botão “mais detalhes” da conta que deseja consultar.

  1. Para imprimir o detalhamento da(s) conta(s) para o cliente, selecione a(s) conta(s) usando o botão “selecionar conta” ou “Selecionar Todas” e clique no botão “Imprimir Contas Selecionadas”.

Verificando o Histórico de Consumo

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma as modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  2. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  3. O sistema apresenta a tela de “Detalhes da Ligação”.

  4. Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Histórico de Consumo”.

  1. O sistema apresenta a tela com todo o histórico de consumo da ligação.

Parcelamento de Contas

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma as modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  2. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  3. O sistema apresenta a tela de “Detalhes da Ligação”.

  4. Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Parcelamento em Carnê”.

  1. Localize o painel “Contas”, clique no botão “Opções” e selecione o tipo de pesquisa para localizar o requisitante do parcelamento.

Selecione as contas que deseja parcelar clicando na linha correspondente ou use o botão “Selecionar Todas” para marcar todas as contas para parcelamento.

  1. Clique no botão “Próximo Passo” para continuar.

  2. Você vai informar as condições de parcelamento e fazer uma simulação. Os campos “Quantidade de Parcelas” e “Data de Vencimento” são obrigatórios. Clique em “Simular Parcelamento” para continuar.

  1. O sistema apresenta os valores das parcelas. Caso o cliente queira realizar o parcelamento, clique em “Executar Parcelamento” para dar continuidade.

  1. Quando as condições de parcelamento forem acordadas, você poderá imprimir o termo e os carnês. Se realizar alguma alteração cadastral clique em “Gravar”.

Emissão de Guia de Recolhimento

Passo a passo:

  1. A partir da tela inicial do sistema, localize a ligação clicando em uma as modalidades de busca disponível: “CDC”, “Logradouro”, “CPF/CNPJ”, “Nome” ou “IPTU”

  2. Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.

  3. O sistema apresenta a tela de “Detalhes da Ligação”.

  4. Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Guias de Recolhimento”.

  1. Clique no botão “Incluir”.

  2. No painel “Incluir Guia Recolhimento”, seleciona o requisitante clicando em “Selecionar Pessoa”.

  1. Informe o CPF ou CNPJ do requisitante.

  1. Para incluir o serviço, selecione o “Tipo Serviço” e clique no botão “incluir Serviço”.

  1. Para gerar a guia, clique em “Gravar”.

  1. Você poderá “Imprimir Guia” ou “Enviar guia por E-mail”.

Balcão Web

Tela para configuração de itens do menu ações.

Introdução

Foi desenvolvida uma nova tela para a configuração dos itens presentes no menu de ações, vinculado à tabela "MENU_ACOES_COMERCIAL". Com essa funcionalidade, os usuários poderão escolher quais itens estarão ativos ou inativos no balcão comercial, permitindo uma personalização conforme suas necessidades.

Localização da Funcionalidade

Para acessar essa nova tela, siga os passos abaixo:

1.Acesse o Balcão Comercial: Entre no módulo de balcão comercial no sistema.

2.Menu Lateral: No menu lateral, selecione a opção "Configurações".

3.Configuração do Menu Ações: Dentro das configurações, clique na opção "Configuração do Menu Ações".

Veja a localização dessa opção na imagem abaixo:

Configuração dos Itens do Menu

Ao acessar a tela de configuração, você verá uma lista com os seguintes detalhes:

Essa tela fornece uma visão clara dos itens disponíveis e seus respectivos status, conforme mostrado na imagem:

Edição do Status dos Itens

Para alterar o status de qualquer item:

1.Selecione "Editar": Na lista de itens, clique na opção "Editar" para modificar o status de um item específico.

A imagem abaixo ilustra como acessar a edição: 2.Modifique o Status: No modo de edição, você poderá alterar apenas o status do item, definindo se ele ficará ativo ou inativo.

3.Salve as Alterações: Após fazer as alterações desejadas, clique em "Salvar" para aplicar as mudanças.

A tela de edição é representada na imagem abaixo:

Após salvar as alterações, quando o usuário acessar qualquer ligação pelo balcão, no meu ações, será exibido somente os itens que estiverem como "ativo" na tela de "Configuração do Menu Ações".

Balcão Web

Protocolos da ligação

Procedimentos

1. Menu Ação

Para acessar a lista de protocolos associados à ligação, é necessário verificar se o campo correspondente no Nenu Ação está habilitado, garantindo o devido acesso à opção: Consulta de Protocolos.

Observação: Para realizar alterações nos campos do Menu Ação, consulte o seguinte documento: https://wiki.cebi.com.br/books/ssb-manual-de-procedimentos-e-operacoes/page/tela-para-configuracao-de-itens-do-menu-acoes

2. Lista de Protocolos

Após acessar a rotina, o usuário será direcionado à lista de protocolos, que exibe os registros presentes na tabela sb_protocolos, vinculados à ligação de origem.

Parâmetros utilizados.

Na tabela de CB_PARAMETROS, foram criados os seguintes parâmetros que são utilizados para atualizar a tabela de protocolos, os mesmos são os seguintes:

Balcão Web

API de Ligação com Contas Retidas

Parâmetros

Retorno

Endpoint

Exemplo

https://arturnogueirasaegg.cebicloud.com.br/analytics/Api/Consultas/Executar/wM1UO2Ti7CYjAUCODa9Q6QPAhaoirG3RBHM3xwz6?identificacaoConsulta=ssb.leitura.ligacoesComContasRetidas&filtros=dataLeitura;12-09-2024 Pasted image 20240919105823.jpg

Balcão Web

Resíduos da Ligação

Procedimentos

1. Menu Lateral

A opção "Resíduos da Ligação" foi adicionada ao menu lateral, acessível pelo caminho: Balcão de Atendimento >> Taxa Lixo >> Resíduos da Ligação.

Observação: O acesso a essa opção depende de uma permissão específica, que pode ser gerenciada no Módulo de Usuários e Permissões. A permissão está descrita como "Consultar Resíduos da Ligação".

2. Listagem

Ao acessar a tela, é necessário informar uma ligação como filtro. Após preenchê-la, o usuário pode:

É normal que a ligação apareça com pontos, ex: 1.010.024. Isto acontece pois existe uma máscara no sistema que permite apenas números inteiros, não deixando-o inserir qualquer outro caracter.

3. Inclusão/Edição

A rotina é dividida em duas partes: Dados da Ligação e Dados Gerais.

⚠️ Atenção: Apenas um Resíduo da Ligação pode ser gravado como Categoria Principal. Caso o usuário tente incluir outro com essa categoria, o sistema bloqueará a operação.

4. Parâmetros

Foram criados os seguintes parâmetros web para a rotina de Resíduos da Ligação :

Observação: Ao habilitar o parâmetro 3010195, os seguintes campos não são exibidos campos: Área Construída, Setor de Coleta e Infectante.

5. Tabelas relacionais

Foram criadas rotinas para manutenção das seguintes tabelas no módulo SSB - Principal:

Balcão Web

Benefício Social

No balcão existe um novo menu chamado "Benefício Social", nele é possível fazer o upload das planilhas enviadas pela ARES-PCJ para aplicar o benefício social.

Configuração de parâmetros

Antes de importar a primeira planilha é necessário configurar os quatro parâmetros obrigatórios do benefício. É possível pesquisar "benefício" para achar todos rapidamente.

Importação de planilha

Ao clicar em nova importação na lista de planilhas, aparecerá um menu para selecionar o arquivo de importação, é obrigatório o preenchimento do mês e ano de referência, não sendo possível fazer a importação de duas planilhas no mesmo mês.

Quando a importação for feita será possível editar ou excluir a planilha, esses botões ficarão disponíveis até a finalização da planilha.

Editar

Busca de endereços

Na primeira tela é feita a busca de endereços, caso o endereço não for achado automaticamente, é preciso busca-lo usando a ferramenta disponibilizada. Após procurar o endereço e achar o certo, é só clicar no botão azul do menu opções. As familías com o CDC encontrado ficam com a barra na cor verde

Após encontrar o CDC de todas as familias, é só clicar no botão "Mapear CDCs" no final da página, não é obrigatório o mapeamento de todos os CDCs para passar pra próxima etapa, mas aparecerá um aviso se você deseja continuar. Todas as famílias com CDCs não mapeados não irão receber o benefício social

Busca de pessoas

Na segunda tela é feita a busca de pessoas, as famílias que têm o responsável cadastrado na planilha aparecem em verde e tem o benefício concedido.

Caso a família não tenha o responsável cadastrado na família, é possível selecionar um dos integrantes dela para ser o novo responsável e assim concerder o benefício a ela. Para trocar o responsável da ligação é necessário clicar no botão de opções amarelo, após isso o responsável é trocado pela pessoa selecionada e a referência é aberta com base na referência da planilha.

Finalizar Importação

No final da página, há um botão denominado "Finalizar Importação". Ao acioná-lo, o benefício será concedido a todas as famílias cuja barra de status esteja na cor verde. Caso exista alguma família sem o mapeamento do CDC ou do responsável, um modal será exibido antes da importação, informando essa situação e solicitando a confirmação para prosseguir.

Além disso, se houver outros CDCs com o benefício social em aberto, mas que não estejam listados na planilha, o sistema removerá o benefício dessas ligações.

Por fim, os botões de edição e exclusão da planilha ficarão indisponíveis na listagem de planilhas.

Resíduos

SSB - Manual de Procedimentos e Operações.

Resíduos

Cadastramento e Configuração de Resíduos Sólidos (Principal e Balcão).

Objetivo:

Esse artigo tem como objetivo subsidiar os técnicos em relação aos procedimentos e recursos dos sistemas SSB para

Boa parte dos recursos apresentados nesse artigo tem fundamento no atendimento da RM 58302.

Funcionamento do Sistema:

Rois de Apoio

SSB - Manual de Procedimentos e Operações.

Rois de Apoio

SNIS001 - Relatório SINISA

Introdução

O Relatório SNIS (Sistema Nacional de Informações sobre Saneamento) é um documento elaborado anualmente pelo Ministério das Cidades, responsável por compilar dados e informações sobre os serviços de saneamento básico no Brasil. Esse relatório abrange os principais aspectos do saneamento, como abastecimento de água, esgotamento sanitário, manejo de resíduos sólidos e drenagem urbana. Seu principal objetivo é fornecer uma visão abrangente da situação do saneamento no país, apoiando a formulação de políticas públicas e permitindo o monitoramento da eficiência dos serviços prestados.

Procedimentos

  1. Ao acessar o sistema de apoio do Rois, na seção 'Lista de Relatórios', localize o registro intitulado 'SNIS001 - Relatório SINISA'. Para acessá-lo, basta clicar no referido item

  1. Na tela de filtros do relatório, insira o Exercício desejado. O campo 'Referência' será habilitado somente se o exercício selecionado corresponder ao ano atual.

  1. Para efetuar a impressão do relatório, selecione o Exercício e clique no botão 'Imprimir'. O sistema verificará se há registros correspondentes ao ano informado. Caso positivo, o relatório será imediatamente impresso.

  2. No caso da geração dos dados para o SINISA, selecione o Exercício desejado. Se o Exercício for do ano corrente, será possível selecionar também uma Referência. Observação: caso o campo 'Referência' não seja preenchido, o sistema assumirá o mês de dezembro como padrão.

  3. Ao clicar no botão 'Gerar', abrirá um modal para que o usuário preencha alguns campos do próprio relatório. Em seguida o sistema exibirá uma notificação informando que os dados estão sendo processados. Essa notificação poderá ser acessada posteriormente através do botão 'Biblioteca SNIS001'.

  1. Ao acessar a lista de 'Biblioteca de Relatórios', a notificação exibida será semelhante à imagem abaixo:

  1. Após a conclusão da geração dos dados, o relatório poderá ser impresso clicando no botão 'Relatório', localizado na coluna de Opções.

Manutenção

Caso o relatório não esteja na 'Lista de Relatórios', é possível que seu parâmetro de exibição esteja desabilitado. Para verificação, deve-se acessar o sistema de Administração, na opção de 'Config. Parâmetros', existe a manutenção para este parâmetro. Segue a imagem abaixo para auxílio.

Processamento de Baixas


SSB - Manual de Procedimentos e Operações.

Processamento de Baixas

Integração Contábil (WEB)

Introdução

Com a implementação de diversas RMs, foram feitas mudanças na rotina da Integração Contábil, além das mudanças feitas na consulta, foram implementadas novas funcionalidades, como a possibilidade de ser feita a verificação de inconsistências na parametrização da composição do analítico da receita, a liberação a contabilidade, um novo parâmetro que deve ser ativado para separar a composição dos acréscimos.

Novo menu e estrutura

O novo menu lateral agora apresenta uma aba para a Integração Contábil, nessa aba existem duas opções Processar e Liberar.

Processar

Na opção Processar foi mantido o layout anterior, mas a diferença é que ao clicar no botão Processar, é gerado uma prévia da receita, em vez de ser liberado para a Contabilidade automaticamente, como era feito anteriormente. A prévia pode ser feita na nova aba Liberar, que se encontra no menu lateral.

Liberar

Na nova tela, há uma tabela que contém as receitas que foram geradas para prévia, sendo possível identificá-las pela aba Data Contábil. Na coluna Ações há três botões; o primeiro é para o download do relatório, o segundo libera aquela receita para a Contabilidade, e o último exclui a prévia.

Parametrização da composição do analítico da receita

Na nova versão da tela da Ingração Contábil na Web, é verificado se há erros na parametrização após clicar no botão Processar. Se houver algum erro, é exibida uma tabela como a mostrada a seguir, e para prosseguir com a geração, é necessário corrigir essas inconsistências.

Como é feita a busca de "inconsistências"

Em cada composição é necessário que tenha um dos seguintes tipos: 1 "Normal" + 1 "Dívida Ativa" ou 1 "Ambos", se ela não apresentar esse padrão, são exibidos os parâmetros atuais e não os que devem ser adicionados, como era feito anteriormente pelo VB, essa correção deve ser feita caso a caso.

Exemplos

Integração com sistemas externos

Intertec

Para fazer a integração com a Intertec, é necessário primeiramente realizar algumas parametrizações no sistema. No módulo de Administração é preciso configurar os parâmetros baixa.urlIntegracaoBaixa com a URL http://ws.presconinformatica.com.br/Prescon/ws/servicos/arrecadacao, baixa.codigoAcessoIntegracaoBaixa com o token de acesso e baixa.utilizarXML com o valor sim. No módulo Principal é necessário configurar o código da Rubrica e o código externo. O código da Rubrica pode ser configurado na tela da Conta Analítico da Receita Já o código externo pode ser configurado na tela de Agentes Arrecadadores

Processamento de Baixas

API (externa) de pagamento.

Introdução

No módulo de Processamento de Baixas, foi desenvolvida uma rota de API destinada ao processamento de contas que estejam em dívida ativa.

Procedimentos

A ferramenta utilizada para demonstrar os procedimentos a seguir e acessar a API externa é o Postman. Recomenda-se o uso dessa ferramenta, porém a escolha fica a critério do usuário.

1. Autenticação

Para iniciar a chamada da API desenvolvida, é necessário realizar a autenticação a fim de obter um token que será enviado para essa API. Utilizando a ferramenta escolhida, configure a requisição como POST e insira a URL de autenticação fornecida pela CEBI, que deve se assemelhar a: urlCebi/login/connect/token. É necessário preencher os parâmetros nos campos "Headers" e "Body". Em seguida, clique no botão "Send" para obter o token de autenticação. Para os parâmetros client_id e client_secret, é necessário fornecer o usuário e a senha disponibilizados pela própria CEBI.

2. Chamada da API

Para realizar a chamada da API, o tipo de requisição deve ser POST. A URL da API deve estar no seguinte formato: urlCebi/baixa/Api/MovimentosBaixaLancada/InclusaoMovimento/Externo.

No fornecimento das keys para a API, é necessário preencher os seguintes campos:

Após a execução da chamada, a mensagem "Processamento de baixa realizado com sucesso." será exibida como resposta.

Processamento de Baixas

Integração Contábil (Empresa: SMAR)

Introdução

A empresa SMAR forneceu duas APIs: uma destinada ao envio de um arquivo JSON, gerado no processo de Integração Contábil, e outra para consulta do status desse JSON enviado.

Parametrização

1. Administração

No módulo de administração, é necessário realizar a configuração dos seguintes parâmetros:

Exemplo:

2. Usuário e Permissões

No Mapa de Permissões, é necessário habilitar a opção "Lista de Integrações (APIs Externas)" para que a funcionalidade correspondente no menu lateral (Integração Contábil >> Lista) esteja disponível para o usuário.

Funcionalidade

1. Geração da Prévia

Ao acessar a rotina de "Integração Contábil", o usuário deve informar a "Data da Contabilização Inicial" e a "Data da Contabilização Final". Após isso, ao clicar em "Processar", o sistema gera uma prévia da integração, que pode ser acessada no caminho (Menu Lateral >> Integração Contábil >> Liberar).

2. Envio da Integração

Na rotina de liberação, é possível visualizar todas as prévias criadas das integrações contábeis. Para enviar o arquivo JSON à API da empresa SMAR, basta clicar em "Liberar Integração". O sistema então iniciará a montagem do arquivo para envio.

Exemplo da estrutura do JSON que é enviado:

3. Consulta do envio da integração contábil

Ao acessar o menu lateral (Integração Contábil >> Lista), o usuário pode buscar a integração enviada. Na "Lista de Integrações Contábeis", na coluna "Ações", é possível clicar no botão "Verificar Status", que consulta a API da SMAR para obter o status da integração enviada, atualizando a lista com a informação mais recente.

Hidrometria

SSB - Manual de Procedimentos e Operações.

Hidrometria

Aferição de hidrômetros

Introdução

Rotina em que é possível fazer a aferição do hidrômetro que está vinculado a uma CDC, onde traz o laudo se o mesmo está Aprovado ou Reprovado

1. Localização

Para acessar essa nova rotina, siga os passos abaixo:

  1. Acesse o módulo de Hidrometria: Entre no módulo de Hidrometria no sistema.

  2. Menu Lateral: No menu lateral, selecione a opção "Aferição de Hidrômetros ".

2. Lista de aferições

A lista de aferição de hidrômetros é ordenado, em ordem crescente, pelo Hidrômetro.

A coluna Opções traz dois botões: Detalhes e Excluir.

3. Inclusão

Na rotina da lista de aferições, no canto superior direito, é possível localizar o menu Ações, onde traz a opção 'Nova Aferição'.

O usuário deverá inserir um CDC e clicar em 'Pesquisar', pois assim será preenchido os campos que estão desabilitados, o sistema buscará essas informações que estão vinculados ao CDC informado. O restante das informações o próprio usuário deverá inserir.

Logo abaixo é possível encontrar uma tabela onde o usuário deverá preencher as informações de 'Vazão Litros/Hora', 'Escoamento Litros', '2° Leitura' e '1º Leitura'. Com essas informações preenchidas, o sistema irá fazer o cálculo da 'Diferença' e do 'Resultado', e assim, definir se o laudo final da aferição está Aprovada ou Reprovada

Agência Virtual

Agência Virtual

Manual da Agência Virtual - CEBI Informática

Agência Virtual

No portal Agência Virtual, o cidadão consegue visualizar seus débitos, históricos de consumo, 2ª via de conta, certidão negativa e registrar uma ocorrência (OS).

Acessando a agência virtual

Passo a passo:

  1. Para acessar a Agência Virtual informe o “Cadastro (CDC)”, o “Digito do CDC”, o número do “CPF/CNPJ” ou a “Inscrição Cadastral” e clique no botão “Entrar”.

Importante: Os campos: Cadastro (CDC), Dígito Identificador e CPF/Inscrição Cadastral são obrigatórios.

Importante: Caso esteja com dúvidas de como acessar o sistema, clique na palavra “Obter Dados”.

Importante: Caso as informações inseridas nos campos estarem corretas e o sistema recusar o acesso informando “Não foi possível validar os dados”, clique no botão “Atualizar CPF/CNPJ” para atualizar seus dados cadastrais.

Veja os detalhes dos campos solicitados.

Dica: Na tela Login - Consumidor o sistema permite “Verificar status da Ocorrência”, “Validar Certidão Negativa” e “Consultar Protocolo” sem entrar no sistema.

  1. Com login realizado, o sistema apresenta a tela inicial do “Portal Agência Virtual”.

Importante: Caso o CPF esteja cadastrado e ativo em mais de uma ligação, será listado na tela inicial todas as ligações pertencentes ao CPF. Clique em “Ver detalhes da ligação”.

Relação de Débitos

Passo a passo:

  1. A partir da tela inicial clique em “Relação de Débito” (Menu lateral ou botão azul).

  1. Clique no botão “Download” para visualizar/imprimir a relação de débitos.

Importante: Este documento não tem valor Legal (não substitui a Certidão Negativa).

Dica: O sistema oferece a opção de receber o Relação de Débito por e-mail.

Preencha o campo “E-mail” e clique em “Enviar”.

Dica: Marque a opção “Salvar e-mail” para atualizar o seu cadastro e não preencher esse campo futuramente.

Aguarde a mensagem “Extrato de Débito enviado com sucesso”.

Histórico de consumo

Passo a passo:

  1. A partir da tela inicial clique em “Histórico de Consumo” (Menu lateral ou botão laranja).

  1. O sistema apresenta em gráfico o consumo dos últimos 24, 18 ou 12 meses.

Importante: Nos dispositivos móveis, como o telefone celular, o sistema apresenta os últimos 9, 6 ou 3 meses.

Importante: Este atestado não vale como atestado porque as informações podem ser alteradas em decorrência de eventuais correções/revisões.

Emitir 2ª via de contas

O sistema permite a impressão da 2ª via da conta.

Passo a passo:

  1. A partir da tela inicial clique em “2ª via de Conta” (Menu lateral ou botão verde).

2.No quadro “Contas”, o sistema apresenta a relação de contas em aberto.

  1. Clique no ícone da impressora referente a conta que deseja emitir.

  1. O sistema apresenta a 2ª via da conta desejada.

Dica: O sistema permite o envio da 2ª via de contas por e-mail. Basta clicar no ícone do envelope.

Informe o e-mail e clique em “Enviar”.

Aguarde a mensagem: “Segunda via enviada com sucesso”.

Dica: Clicando no ícone “Ver códigos de barras”, o sistema apresenta o campo com o número do código de barras.

Emitir 2ª Via de Carnê

Passo a passo:

  1. A partir da tela inicial clique em “2ª via de Carnê” (Menu lateral ou botão roxo).

  1. No quadro “Carnês”, o sistema apresenta a relação dos carnês em aberto.

  1. Clique no ícone da impressora para emitir a 2ª via do carnê com todas as parcelas.

Dica: O sistema visualizar o cálculo de acréscimo clicando no botão “Lançar acréscimos no carnê” (ícone do +).

Dica: O sistema permite que o usuário escolha a parcela que deseja imprimir clicando no botão da lupa.

Dica: O sistema permite o envio da 2ª via de carnê por e-mail. Basta clicar no ícone do envelope.

Informe o e-mail e clique em “Enviar”.

  1. Após clicar no ícone da impressora, o sistema apresenta a 2ª via do carnê.

Certidão Negativa

Passo a passo:

  1. A partir da tela inicial clique em “Certidão Negativa” do menu lateral.

  1. O sistema apresenta a tela de emissão da Certidão Negativa de Débito.

  1. Clique no botão “Download” para gerar a certidão negativa.

  1. O sistema apresenta a Certidão Negativa de Débitos na tela para impressão.

Dica: O sistema oferece a opção de receber a Certidão Negativa por e-mail.

Preencha os campos solicitados e clique em “Enviar”.

Dica: Clicando em “Verificar Validade de Certidão”, o sistema a autentica a certidão negativa.

Informe o “Número da Certidão”, o “Código de Validação” e clique em “Buscar”.

Simulação de Parcelamento

Passo a passo:

  1. A partir da tela inicial clique em “Simulação de Parcelamento” do menu lateral.

  1. O sistema apresenta todas as contas em aberto.

  1. No campo “Quantidade de Parcelas” informe o número de parcelas e clique no botão “Simular”.

  1. O sistema apresenta o valor individual de cada parcela.

Importante: Esse procedimento não serve como comprovante de parcelamento.

Solicitações

São todos os chamados e ordens de serviço abertas para o período de responsabilidade do CPF logado.

Passo a passo:

  1. A partir da tela inicial clique em “Solicitações” no menu lateral.

  1. O sistema apresenta a relação de chamados e O.S. Clique no chamado/O.S. para ver mais informações.

Dica: O sistema relaciona as ordens de serviço e as qualifica por cores:

  • Verde – em execução
  • Branco – executado
  • Amarelo – em aberto
  • Vermelho - cancelado
  1. Clicando no chamado/O.S., o sistema apresenta todos os serviços vinculados e a situação da execução.

Solicitar Serviço

Passo a passo:

  1. O sistema apresenta a opção para o contribuinte abrir um chamado de serviço. Selecione o “Serviço” que deseja abrir.

  1. Informe os campos e clique no botão “Enviar”.

Importante: Os campos que estiverem com * serão obrigatórios.

Auto Leitura

Passo a passo:

  1. Informe a “Leitura Atual”, o “Nome do Informante”, o “Telefone de Contato” e clique no botão “Enviar” para que a autarquia receba as informações.

Registrar E-mail

Passo a passo:

  1. Para cadastrar ou atualizar seus dados, informe o campo “E-mail”, “Confirmar E-mail” e clique no botão “Salvar”.

Tarifas

Passo a passo:

  1. O sistema apresenta as faixas de consumo para cada tipo de ligação.

Simulação de Consumo

Passo a passo:

  1. Selecione a “Categoria” que deseja simular o consumo.

  1. Informe o campo “Economia”, “Consumo” e clique no botão “Simular”.

Importante: Os campos com * são obrigatórios.

  1. O sistema apresenta a simulação de consumo baseado nos dados inseridos, com estimativa e faixas de preços.

Ouvidoria

O munícipe poderá registrar serviços na ouvidoria e acompanhar o protocolo de atendimento.

Consulta de Protocolo

Passo a passo:

  1. Informe o número do “Protocolo”, o “Ano” e clique no botão “Pesquisar”.

  1. O sistema apresenta a situação do protocolo pesquisado.

Agendamentos

O Agendamento Online é uma forma rápida e fácil de controlar a quantidade de munícipes que precisam estar presencialmente nos postos de atendimento.

Agendar Novo Atendimento

Passo a passo:

  1. Clique no botão “Agendamentos”.

  1. Informe os campos obrigatórios: “CPF/CNPJ” e “Email”. Clique em “Agendar Novo Atendimento”.

  1. Sistema apresenta a tela de agendamento. É obrigatório informar todos os campos.

  1. Selecione o posto de atendimento.

  1. Ao selecionar o posto de atendimento, sistema apresenta o endereço e horário de atendimento do mesmo.

  1. Selecione a unidade de atendimento.

  1. Selecione o serviço da unidade correspondente:

  1. Ao selecionar o serviço que deseja, fique atento nos documentos necessários para o atendimento presencial, em informações do serviço.

  1. Selecione uma data para o atendimento.

  1. Selecione um horário para o atendimento.

  1. Para que o agendamento seja efetuado, informe os campos obrigatórios e marque a opção que confirme que leu as informações do posto de atendimento e serviço selecionado. Clique em agendar.

Consultar Atendimentos Agendados

Passo a passo:

  1. Clique no botão “Agendamentos”.

  1. Informe os campos obrigatórios: “CPF/CNPJ” e “Email”. Clique em “Consultar”.

  1. Sistema apresenta o agendamento com a data e hora, número do protocolo gerado, local do atendimento e o serviço agendado.

Versões do Manual

Versão 1.3 – Inclusão do item Agendamentos

Versão 1.2 – Inclusão do item Ouvidoria

Versão 1.1 – Telas atualizadas e novos procedimentos:

SSB Principal

SSB Principal

Importações de planilha

Introdução

No sistema web SSB Principal exite uma opção para realizar a importação de planilhas no formato XLSX (Formato padrão do Microsoft Excel) para as tabelas do sistema. A planilha não precisa atender um formato específico, apenas apresentar todos os campos obrigatórios para a criação de um loteamento ou de ligações secundárias de um condomínio.

Importação

Para iniciar a importação é necessário clicar no menu Importações por planilha no sistema SSB Principal.

Na nova tela selecione o menu Ações > Nova importação. Escolha uma das opções de tipo de importação e clique no botão Procurar... para selecionar a planilha em formato XLSX e depois clique em Mapear. Após isso irá aparecer uma tabela para mapear o que cada coluna significa, será mostrado algumas linhas de exemplo para ajudar no mapeamento. Após mapear todas as colunas clique no botão para ir para o próximo passo. Para prossegir com a importação é necessário que todos os campos sejam válidos, para fazer essa verificação é necessário clicar no botão Verificar. Quando a verificação for finalizada, pode ser que ocorra algum erro por consequência de uma linha ou mais linhas inválidas, essas linhas são apontadas na tabela com um símbolo de erro.

Ao clicar na linha é possível ver o erro que ocorreu. Se o erro for simples de concertar, é possível editar os campos nessa própria tela, digitando um novo valor e clicando em Salvar.

Quando todos os erros forem corrigidos, o botão Importar será liberado para a importação completa da planilha.

Libraries (Bibliotecas)

Manuais de como implementar bibliotecas nos projetos

Libraries (Bibliotecas)

Cebi.NotificacoesAmbiente

Cebi.NotificacoesAmbiente

Essa documentação serve como guia para utilização da biblioteca de notificações, o guia majoritariamente servirá para a utilização em sistemas SSB, mas muito possivelmente funcionará em outros sistemas com algumas alterações

Avisos

A biblioteca só pode ser instalada nos projetos de API, sendo assim só pode ser usada na API

Pasted image 20241023145453.png

Além disso é necessário a Unit of Work da própria notificação, exemplo:

Pasted image 20241023145921.png

Pode ser feito um service exclusivo pra ela no projeto de API que realiza o processo sem precisar chamar a unit em cada controller que for ser utilizado a notificação, exemplo:

using Cebi.NotificacoesAmbiente.Dal;
using Cebi.NotificacoesAmbiente.Domain.Enums;
using Cebi.NotificacoesAmbiente.Domain.Interfaces;
using Cebi.NotificacoesAmbiente.Domain.Services;
using Cebi.Util.Domain.Exceptions;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace Cebi.Ssb.DividaAtiva.Api.Services
{
    public class NotificacoesAmbienteService
    {
        private static INotificacoesAmbienteUnitOfWork _unitNotificacao =  new NotificacoesAmbienteUnitOfWork();

        public static async Task IncluirNotificacaoAmbiente(string emissor, TipoNotificacaoAmbienteEnum tipoNotificacao, string descricao, string url = "",
                                                            IEnumerable<int> usuariosIds = null, IEnumerable<int> perfis = null)
        {
            if (!usuariosIds.Any() && !perfis.Any())
                throw new CebiException("Algum alvo é necessário para o envio da notificação");

            IncluirNotificacoesAmbienteCommand notificacao = new IncluirNotificacoesAmbienteCommand
            {
                Emissor = emissor,
                Tipo = tipoNotificacao,
                Descricao = descricao,
                UrlRedirecionamento = url,
                UsuariosAlvosIds = usuariosIds,
                PerfisAlvosIds = perfis
            };

            new IncluirNotificacoesAmbienteService(_unitNotificacao).Executar(notificacao);

            _unitNotificacao.CompleteAsync();
        } 
    }
}

Exemplo de Uso

var command = new IncluirNotificacoesAmbienteCommand()
{
	Emissor = "Teste Url 2",
	Tipo = TipoNotificacaoAmbienteEnum.Notificacao,
	Descricao = "Teste Divida Ativa",
	UsuariosAlvosIds = new List<int> { 59 },
	UrlRedirecionamento =    "/divida_ativa_ssb/Api/DividaAtiva/Acompanhamento/Receita/UltimoAno/Grafico"
};

new IncluirNotificacoesAmbienteService(_unitNotificacao).Executar(command);

_unitNotificacao.Complete();

O Objeto da notificação (IncluirNotificacoesAmbienteCommand) possui algumas propriedades:

As únicas propriedades obrigatórias são: Emissor, Tipo, Descrição e algum alvo (UsuariosAlvosIds ou PerfisAlvosIds)

Corte

SSB - Manual de Procedimentos e Operações.