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
- Teste no Postman para uso de API externa para monitoramento.
- Balcão Web
- Sistema Balcão Web - Cebi Informática
- Tela para configuração de itens do menu ações.
- Protocolos da ligação
- API de Ligação com Contas Retidas
- Resíduos da Ligação
- Benefício Social - ARES PCJ
- Funcionalidade de Distribuição de Valor de Serviço em Contas/Faturas
- Protocolos de Entrega
- Conta Antecipada
- Resíduos
- Rois de Apoio
- Processamento de Baixas
- Hidrometria
- Agência Virtual
- SSB Principal
- Libraries (Bibliotecas)
- Corte
- Remessa de cobrança
- Inclusão de título protestado em remessa de execução fiscal
- Modal de detalhe do título
- Relatório de Protocolos Protestados
- Leitura
- Dívida Ativa
Leitura Android
SSB - Manual de Procedimentos e Operações.
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.
-
Conectar impressora ao computador pelo cabo USB e seguir os passos abaixo.
-
Clicar no botão "Connect" > Clicar campo "User Setting" > Clicar botão "Configure Printer Setting".
- 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".
- 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".
- 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".
- Na aba "Language", clicar no botão 'Get" > Deixar as opções igual a imagem abaixo > Clicar no botão "Set".
- 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".
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:
- Reiniciar o aparelho, tentar transmissão pelo 4G e Wifi;
- 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;
- 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.
- 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";
- 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;
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.
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:
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.
-
grant_type
:client_credentials
-
scope
:Cebi.Api
-
client_id
:SeuClienteId
-
client_secret
:SeuClienteSecret
Nota: Substitua
SeuClienteId
eSeuClienteSecret
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:
-
grupoId
: ID do grupo desejado -
anoReferencia
: Ano de referência (formatoYYYY
) -
mesReferencia
: Mês de referência (formatoMM
)
Importante: Certifique-se de que os nomes dos parâmetros estão exatamente como descritos acima.
4. Autorização
Clique no botão Send para fazer a chamada da API e obter as rotas desejadas.
Considerações Finais
- Verifique as Configurações: Certifique-se de que todos os campos e parâmetros estão corretamente configurados antes de enviar a requisição.
- Mensagens de Erro: Se a API retornar uma mensagem de erro, verifique novamente os parâmetros e o token.
- Ambiente de Teste: Garanta que está utilizando o ambiente de teste correto, trocando a porta e URLs conforme necessário para cada cliente.
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.
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:
- 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”.
- O sistema apresenta a tela inicial do sistema.
Consulta de Cadastro
Passo a passo:
- 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”
- Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
- 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:
-
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”
-
Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
-
O sistema apresenta a tela de “Detalhes da Ligação”.
-
Clique na aba “Contas”.
- 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.
- 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.
- 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:
-
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”
-
Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
-
O sistema apresenta a tela de “Detalhes da Ligação”.
-
Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Extrato de Débito”.
- Localize o painel “Contas em Aberto”. Selecione o(s) débito(s) que deseja consultar clicando na conta.
- 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:
-
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”
-
Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
-
O sistema apresenta a tela de “Detalhes da Ligação”.
-
Selecione a aba “Ligação”.
- Localize o painel “Consumidores” e clique no botão alterar correspondente ao cadastro que deseja modificar.
- Verifique se é o cadastro correto e clique no botão “Editar Pessoa”.
- 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.
- Após a atualização do cadastro, clique em “Gravar” para finalizar.
Detalhamento da conta
Passo a passo:
-
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”
-
Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
-
O sistema apresenta a tela de “Detalhes da Ligação”.
-
Clique na aba “Contas”.
- O sistema mostra as contas “Abertas” por padrão. O usuário poderá utilizar outros filtros de pesquisa de contas para auxiliar na busca.
- Localize o painel “Contas” e clique no botão “mais detalhes” da conta que deseja consultar.
- 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:
-
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”
-
Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
-
O sistema apresenta a tela de “Detalhes da Ligação”.
-
Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Histórico de Consumo”.
- O sistema apresenta a tela com todo o histórico de consumo da ligação.
Parcelamento de Contas
Passo a passo:
-
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”
-
Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
-
O sistema apresenta a tela de “Detalhes da Ligação”.
-
Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Parcelamento em Carnê”.
- 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.
-
Clique no botão “Próximo Passo” para continuar.
-
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.
- O sistema apresenta os valores das parcelas. Caso o cliente queira realizar o parcelamento, clique em “Executar Parcelamento” para dar continuidade.
- 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:
-
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”
-
Dependendo do tipo de pesquisa selecionado, insira a informação solicitada e clique no botão “Procurar”.
-
O sistema apresenta a tela de “Detalhes da Ligação”.
-
Clique no botão “Ações” localizado no canto superior direito da tela e selecione a opção “Guias de Recolhimento”.
-
Clique no botão “Incluir”.
-
No painel “Incluir Guia Recolhimento”, seleciona o requisitante clicando em “Selecionar Pessoa”.
- Informe o CPF ou CNPJ do requisitante.
- Para incluir o serviço, selecione o “Tipo Serviço” e clique no botão “incluir Serviço”.
- Para gerar a guia, clique em “Gravar”.
- Você poderá “Imprimir Guia” ou “Enviar guia por E-mail”.
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.
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:
-
Descrição de cada Item: Breve descrição que ajuda a identificar cada item do menu.
-
Status Atual: Indica se o item está ativo (visível) ou inativo (oculto).
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".
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.
- Detalhes: Na lista, é possível visualizar os detalhes de um protocolo. Para isso, clique no ícone de lupa, o que abrirá uma tela flutuante contendo todas as informações relacionadas ao protocolo selecionado.
- Atualizar Lista: Este botão realiza a chamada da API que busca os protocolos vinculados à ligação, com base na tabela sb_protocolos. Ao clicar neste botão, qualquer novo registro será exibido na lista, caso exista.
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:
-
integracaoProtocolo.webServiceSmarpd.password
-
integracaoProtocolo.webServiceSmarpd.urlAtualizaProtocolo
-
integracaoProtocolo.webServiceSmarpd.urlBase
-
integracaoProtocolo.webServiceSmarpd.urlConsultaProtocolo
-
integracaoProtocolo.webServiceSmarpd.urlToken
-
integracaoProtocolo.webServiceSmarpd.username
-
integracaoProtocolo.webServiceSmarpd.tokenHeaderSmar
API de Ligação com Contas Retidas
Parâmetros
- Data de Leitura
Retorno
- cdc - CDC
- referencia - Referência
- dtalei - Data de Leitura
Endpoint
- Method - GET
- Endereço Base - https://arturnogueirasaegg.cebicloud.com.br/analytics
- API/Token - Api/Consultas/Executar/wM1UO2Ti7CYjAUCODa9Q6QPAhaoirG3RBHM3xwz6
- Identificador Consulta - identificacaoConsulta=ssb.leitura.ligacoesComContasRetidas
- Filtros - filtros=dataLeitura;12-09-2024
Exemplo
https://arturnogueirasaegg.cebicloud.com.br/analytics/Api/Consultas/Executar/wM1UO2Ti7CYjAUCODa9Q6QPAhaoirG3RBHM3xwz6?identificacaoConsulta=ssb.leitura.ligacoesComContasRetidas&filtros=dataLeitura;12-09-2024
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:
- Visualizar os detalhes do registro, abrindo um modal com todas as informações.
- Editar o registro, sendo direcionado para a tela de edição.
É 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.
-
Dados da Ligação: O usuário deve informar o número da ligação e clicar em "Buscar". O sistema verificará a existência da ligação e, se estiver tudo correto, preencherá automaticamente os campos Identificação, Grupo e Endereço.
-
Dados Gerais: O usuário deverá preencher diversos campos, que serão exibidos conforme a configuração do parâmetro web 3010195 (detalhado no tópico 4).
⚠️ 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 :
- 3010195 - Indica se exibe os campos dos resíduos da ligação de forma simplificada.
- 3010196 - Indica troca dos nomes 'Taxa de Lixo' por 'Disponibilidade' na tela 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:
- Categorias de Resíduos
- Faixas de Cobrança
- Formas de Cálculo
- Frequências
- Infectantes
- Setores de Coleta
Benefício Social - ARES PCJ
Objetivo:
Esse artigo tem como objetivo demonstrar a solução desenvolvida para atendimento da Resolução ARES-PCJ 592/2024.
O desenvolvimento foi feito com base a levantamento e reunião com a própria ARES-PCJ.
A rotina consiste de 3 etapas básicas: A primeira é a importação do arquivo .csv disponibilizado (Famílias com Benefício Social), a segunda é vinculaçao de CDCs aos endereços das famílias e a última etapa é a definição dos usuários responsáveis para essas ligações. O benefício somente será concedido para os CDCs selecionados do arquivo csv cujo responsável da ligação tenha CPF igual ao de um membro da família no momento da execução da rotina.
IMPORTANTE: O desenvolvimento não leva em conta situações específicas de clientes relacionadas ao faturamento, impressão nas contas, segundas vias e outros docuemntos e atuações sobre os benefícios anteriores, essas questões devem ser tratadas individualmente com os clientes antes da implementação do recurso.
Funcionamento do Sistema:
No balcão existe um novo menu chamado "Benefício Social", nele é possível fazer o upload dos arquivos csv enviados pela ARES-PCJ para aplicar o benefício social.
Configuração de parâmetros:
Antes de importar o primeiro arquivo csv é necessário configurar os quatro parâmetros obrigatórios do benefício. É possível pesquisar "benefício" para achar todos rapidamente.
- O parâmetro número 3010199 deve ser obrigatoriamente preenchido como "Sim", caso contrário não é possível fazer upload do arquivo csv
- O parâmetro número 3010200 indica qual o código da categoria que será utilizada no benefício.
- O parâmetro número 3010201 indica qual o código do tipo de benefício será utilizado na efetivação dos dados do arquivo, é possível ver o código ou cadastrar um novo pelo SSB Principal
- O parâmetro número 3010202 indica qual o código do tipo de proprietário que será utilizado ao trocar o responsável da ligação por um dos que estão no arquivo csv
Quando da implantação do sistema indicar o cliente para cadastrar um tipo de benefício facilmente identificável como ARES-PCJ.
A categoria Residencial Social definida na Resolução deve ser criada previamente no sistema para utilização no parâmetro. A categoria deve conter as regras do Art. 3º da resolução, aplicados diretamente sobre os valroes da categoria Residencial existente.
Importação do arquivo .csv
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 dois arquivos csv no mesmo mês.
Quando a importação for feita será possível editar ou excluir a planilha (com os dados do csv), esses botões ficarão disponíveis até a finalização da planilha.
Existem regras de importação do arquivo csv. Não podem ser carregados dois arquivos para a mesma referência. Quando da atribuição de referência o sistema não permitirá a importação de planilha para uma referência de mês igual ao de importação e verificará o status da leitura para impedir benefício concedido parcialmente na referência. Os clientes devem se ajustar e antecipar a carga dos dados - inclusive considerando o tempo das operações de vínculo e atribuição de responsável, para se adequar a essas regras. A ideia é garantir que 100% dos benefícios sejam aplicados à referência solicitada.
Vinculações da Planilha:
Busca de endereços (vínculo CDC):
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 "Contuar" 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
O usuário também poderá incluir uma nova família de forma manual, onde poderá acessado dentro da rotina de busca de endereços, no menu ação.
Após isso, o mesmo será enaminhado para uma nova tela, em que poderá inserir todas as informações da família. Finalizando, ele poderá clicar no botão Gravar e será redirecionado para a tela anterior, da busca de endereços.
A busca de endereços automática só funcionará em casos onde o endereço informado na planilha for exatamente igual ao endereço cadastrado no sistema, ou se existir uma planilha anterior com o mesmo endereço da família. Nos casos diferentes o sistema não atribuirá endereços.
Como a planilha possui cadastros familiares como índice, a vinculação do CDC terá que ser feita a cada carga de planilha (visto que o endereço da família pode mudar entre uma planilha e outra).
Busca de pessoas (atribuição de responsável):
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.
O sistema fará a inclusão do responsável automaticametne com a tipificação indicada no parâmetro de tipo de usuário.
O usuário anterior, caso ativo, terá sua responsabilidade encerrada no mês anterior à indicação da planilha.
Caso a alteração seja feita mais de uma vez na mesma carga de planilha, o sistema reconhecerá e apenas incluirá o último usuário definido na rotina.
Finalizar Importação (Atribuição de Benefícios):
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.
A regra de atribuição de benefício valida os CPFs de responsável da ligação com as pessoas da família do CDC vinculado na planilha no momento da aplicaçao.
Além disso, se houver outros CDCs com o benefício social em aberto, mas que não estejam listados na planilha, o sistema encerrará o benefício dessas ligações.
Se houverem CDCs com benefício social e o responsável não for mais uma das pessaos cosntantes da planilha, o sistema encerrará 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.
O sistema utilizará a estrutura de benefícios já estabelecida no sistema gravando automaticamente as configurações necessárias para aplicação do benefício por troca de categoria indicadas na Resolução, em cada CDC.
Se houver benefício anterior diferente no CDC que receber o benefício da ARES-PCJ, o benefício anterior será cancelado e sobreposto pelo benefício da ARES-PCJ.
Se houverem benefícios anteriores referentes a CDCs não vinculados na planilha, estes serão mantidos da forma que eram. Cabe negociar com o cliente como serão tratadas essas situações.
IMPORTANTE: O benefício não será aplicado pelo botão de Finalizar Impotação caso a referência da planilha estiver em processo de leitura. É imprescindível que os clientes se antecipem e que finalizem a planilha tão logo ela for carregada para evitar problemas nessa etapa.
Funcionalidade de Distribuição de Valor de Serviço em Contas/Faturas
1. Acesso à funcionalidade na tela de ligação
Foi implementada uma nova funcionalidade na aba "Serviços" da tela de ligação, denominada "Selecionar Contas/Faturas para Lançamento". Essa opção permite que o usuário associe o valor de um serviço previamente selecionado a contas ou faturas em aberto, vinculadas à ligação em questão.
2. Listagem de contas e faturas em aberto
Ao acionar o botão "Selecionar Contas/Faturas para Lançamento", o sistema redireciona o usuário para uma nova tela, na qual são exibidas todas as contas e faturas em aberto referentes à ligação atual.
No canto superior esquerdo da interface, encontra-se o campo "Valor Total Serviço", que exibe o valor do serviço selecionado na tela anterior. Esse valor servirá de base para a distribuição entre as faturas.
A tabela apresentada ao usuário contém as seguintes informações:
- Referência: Período a que a fatura se refere.
- Tipo da Fatura: Indica o tipo (ex.: mensal, extraordinária).
- Valor da Fatura: Valor total individual da fatura.
- Opções: Permite selecionar manualmente as faturas que receberão parte do valor do serviço.
3. Distribuição do valor do serviço entre as faturas selecionadas
Após a seleção das faturas desejadas, o usuário deve clicar no botão "Distribuir Valor Serviço". Em seguida, será exibido um modal com os seguintes campos informativos:
- Valor Total do Serviço: Valor total disponível para distribuição.
- Valor Restante a Ser Devolvido: Quantia ainda disponível para ser distribuída nas faturas selecionadas.
Neste modal, o usuário poderá inserir manualmente os valores a serem atribuídos a cada fatura. No entanto, o sistema impõe as seguintes regras de validação:
- O valor distribuído não pode exceder o valor da fatura.
- O valor restante a ser devolvido não pode ser negativo.
Após a distribuição adequada dos valores, o usuário pode confirmar a operação clicando em "Salvar". O sistema então realiza o lançamento do valor do serviço nas respectivas faturas, finalizando o processo com sucesso.
Protocolos de Entrega
Procedimentos
1. Menu lateral
2. Filtros
Ao acessar a rotina, o usuário poderá pesquisar pelos protocolos de entrega já registrados no sistema, utilizando os seguintes filtros: Nº do Processo, Ligação Associada, Status, Endereço de Entrega e Ativo/Inativo. Após realizar a busca, o sistema exibirá uma lista com os protocolos encontrados. Na coluna Opções, poderão estar disponíveis até quatro botões:
-
Detalhes: Redireciona o usuário para a tela de detalhes do protocolo. Este botão estará sempre visível.
-
Editar: Redireciona o usuário para a tela de edição do protocolo. Estará visível apenas se o Status da Atividade for "Ativo".
-
Inativar: Ao clicar, será exibido um modal solicitando a confirmação da inativação do protocolo selecionado. Este botão segue a mesma regra de visibilidade do botão "Editar", aparecendo somente quando o Status da Atividade for "Ativo".
-
Reativar: Ao clicar, será exibido um modal solicitando a confirmação da reativação do protocolo selecionado, sendo confirmado, o protocolo é reativado e o usuário é direcionado para a tela de Edição, para vincular as ligações necessárias. Este botão aparecerá somente quando o Status da Atividade for "Inativo".
3. Inclusão
A tela de inclusão é separada em 3 seções ('Dados do Protocolo', 'Dados do Endereço de Entrega' e 'Ligações Vinculadas')
3.1. Dados do protocolo
Nesta seção, o usuário poderá definir o Status do protocolo e adicionar uma observação relacionada, se necessário.
3.2. Dados do endereço de entrega
Nesta etapa, poderá ser informado todos os dados referentes ao endereço de entrega do protocolo. O preenchimento inicia-se pelo campo Endereço, correspondente ao logradouro do local.
3.3. Ligações vinculadas
Na última seção, o usuário deve informar o número da ligação que será vinculada ao protocolo. Após adicioná-la à lista, estarão disponíveis na coluna Opções dois botões:
-
Um para remover a ligação vinculada;
-
Outro para utilizar o endereço da ligação como o endereço de entrega do protocolo.
3.4. Gravar
Para concluir o processo, é obrigatório preencher todos os campos obrigatórios e ter ao menos uma ligação vinculada ao protocolo. Após essas condições serem atendidas, o sistema realizará o registro do protocolo e gravará o histórico de vínculo nas respectivas ligações incluídas na lista.
4. Detalhes
Já na tela de detalhes, o sistema exibe todos os campos seguindo a mesma divisão de seções da tela de inclusão. Logo abaixo das informações, se o protocolo estiver no Status de Atividade como 'Ativo', será exibido o botão de Editar
5. Edição
A tela de Edição mantém a mesma estrutura da tela de Inclusão/Detalhes, com algumas regras específicas a serem observadas.
5.1. Mudança do endereço de entrega
Caso o usuário modifique qualquer campo do endereço de entrega, ao clicar em Gravar, o endereço anterior será automaticamente marcado como inativo, e um novo registro será criado com os dados atualizados, vinculado ao protocolo em edição.
Outra alternativa, o usuário pode utilizar o endereço de uma das ligações vinculadas como endereço de entrega do protocolo. Para isso, basta clicar no ícone de casa na lista de Ligações Vinculadas. Um modal será exibido solicitando a confirmação da alteração. Ao confirmar, o sistema seguirá a mesma lógica: inativará o endereço anterior e criará um novo registro com o endereço da ligação selecionada.
5.2. Vincular ligação
Ao inserir o número de uma ligação e clicar em Vincular, o sistema verificará se:
-
A ligação existe no sistema;
-
A ligação já está vinculada a outro protocolo.
Se a ligação estiver vinculada a outro protocolo, a ação será bloqueada automaticamente.
5.3. Desvincular ligação
Para desvincular uma ligação, o sistema verificará se ela é a única ligação ativa no protocolo. Caso seja, a ação será bloqueada, pois é obrigatório que exista ao menos uma ligação ativa vinculada ao protocolo.
5.4. Inativar protocolo
Ao clicar no botão Inativar Protocolo, será exibido um modal de confirmação. Se confirmado, o protocolo será inativado, assim como todos os registros relacionados a ele. O sistema também gravará o histórico de desvinculação nas ligações afetadas.
Conta Antecipada
Procedimentos
1. Menu Ação
Para gerar uma conta antecipada para a ligação, é necessário verificar se o campo correspondente no Nenu Ação está habilitado, garantindo o devido acesso à opção: Conta Antecipada.
(https://wiki.cebi.com.br/uploads/images/gallery/2025-06/image-1749283019235.png)
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. Model Conta Antecipada
Após acessar a rotina, o usuário será direcionado à um model para gerar a conta antecipada vincula à ligação de origem.
(https://wiki.cebi.com.br/uploads/images/gallery/2025-06/image-1749283191134.png)
- Detalhes: No model o usuário deve informar um vencimento para a nova conta e a leitura atual.
Resíduos
SSB - Manual de Procedimentos e Operações.
Cadastramento de Informações do Lixo (Principal)
Objetivo:
O Objetivo desse documento é apresentar a sequencia de cadastramento necessária para aplicação geral dos cálculos e faturas de lixo nos clientes.
A taxa de lixo posssui diferentes configurações conforme o município, visto que a estrutura é única para todas as situações.
Operação do Sistema:
1. Cadastro de Leis:
O primeiro passo é cadastrar a(s) lei(s) determinantes da taxa de lixo. Isso é feito pelo caminho SSB - Principal > Parâmetros > Leis.
2. Fórmula de Cálculo:
Deve ser cadastrada a Fórmula de Cálculo para os resíduos cadastrados. Isso é feito pelo caminho SSB - Principal > Resíduos > Fórmula de Cálculo.
A fórmula de cálculo necessita da lei para ser aplicada.
Na fórmula de cálculo poderá estar ligada à package de cálculo utilizada para o cliente.
3. Categoria de Resíduos:
Devem ser cadastradas as Categorias de Resíduo que serão utilizadas pelo cálculo. Estas serão posteriormente cadastradas para os CDCs. Isso é feito pelo caminho SSB - Principal > Resíduos > Categorias de Resíduo.
4. Faixas de Cobrança:
Devem ser cadastradas as faixas de cobrança utilizadas para cobrança da taxa de lixo. Estas serão utilizadas pelo cálculo, direta ou indiretamente. Isso é feito pelo caminho SSB - Principal > Resíduos > Faixas de Cobrança.
A utilização de metragens pode ou não ser usada, conforme a regra de cálculo de cada cliente. Clientes que não utilizam metragem tem apenas uma faixa para cobrança.
5. Frequencias:
Devem ser cadastradas Frequências que serão utilizadas pelo cálculo. Estas serão posteriormente cadastradas para os CDCs. Isso é feito pelo caminho SSB - Principal > Resíduos > Frequências.
6. Infectantes:
Devem ser cadastrados os infectantes para utilização do cálculo. Isso é feito pelo caminho SSB - Principal > Resíduos > Infectantes.
Alguns clientes não utilizam os infectantes, caso seja, é necessário fazer um registro de infectante com valor zero. A vinculação é obrigatória posteriromente.
7. Setores de coleta:
Devem ser cadastrados os setores de coleta para posterior vinculação aos CDCs que são objetos de cobrança. Isso é feito pelo caminho SSB - Principal > Resíduos > Setor de Coleta.
Alguns clientes não utilizam Setores de coleta, nesse caso basta não registrar. A vinculação não é obrigatória.
Regra de calculo lixo São Carlos
Cobrança de Resíduos Sólidos com Base nas Normas do Departamento de Água
O processo de geração de faturas para a cobrança de resíduos sólidos é realizado em conformidade com as normas estabelecidas pelo Departamento de Água. A cobrança é calculada com base em critérios específicos, como a metragem do terreno e/ou a área construída. Esses parâmetros são verificados em uma tabela de faixas de valores predefinidos, permitindo um cálculo preciso e transparente das taxas devidas.
Modelagem dados faixas de cobrança
Processo de Faturamento e Parcelamento
Com base em diretrizes estabelecidas pela autarquia, são geradas faturas para pagamento à vista, com a possibilidade de aplicação de um desconto percentual. Caso não haja registro de pagamento da fatura única até o início do mês seguinte ao seu lançamento, novos serviços são automaticamente criados para o parcelamento do valor devido. Esse parcelamento é distribuído mês a mês, facilitando o pagamento.
Interface
Opção para Visualização de Faturas de Água, Esgoto e/ou Resíduos Sólidos
Fatura Lixo
Faturas de Água, Esgoto e/ou Resíduos Sólidos
Rois de Apoio
SSB - Manual de Procedimentos e Operações.
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
- 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
- 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.
-
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.
-
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.
-
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'.
- Ao acessar a lista de 'Biblioteca de Relatórios', a notificação exibida será semelhante à imagem abaixo:
- 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.
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
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.utilizaEmpresaTerceiraIntegracao
com o valor 99, baixa.codigoAcessoIntegracaoBaixa
com o token de acesso e baixa.tipoArquivoGeracaoIntegracao
com o valor 1.
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
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:
- AgenteArrecadadorId: (int).
- DataPagamento: (DateTime).
- DataContabil: (DateTime).
- Valor: (decimal).
- LigacaoId: (int) 'se trata do CDC do débito'.
- Referencia: (DateTime) 'mês e ano do débito'.
- DigitoVerificador: (int) 'DV da conta'.
- ContaEmDividaAtiva: (bool) 'passar como true por padrão'.
- TipoMovimento: (int) 'passar como 0 por padrão'.
Após a execução da chamada, a mensagem "Processamento de baixa realizado com sucesso." será exibida como resposta.
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:
- baixa.utilizaEmpresaTerceiraIntegracao = 1
- baixa.tipoArquivoGeracaoIntegracao = 0
- baixa.codigoUnidadeGestora = 301
- baixa.codigoHistoricoIntegracao = Para o cliente Santa Bárbara, o valor deve ser 2; SAESA deve ser 1.
- baixa.urlApiConsultaIntegracaoSmar = Santa Bárbara: https://cp1-demo.smarapd.com.br/cpserver/integracaotributacao/consultaIntegracaoTerceiros; SAESA: https://integracp-saesa.smarapd.com.br/cpserver/integracaotributacao/consultaIntegracaoTerceiros
- baixa.urlIntegracaoBaixa = Santa Bárbara: https://cp1-demo.smarapd.com.br/cpserver/integracaotributacao/integracaoterceiros; SAESA: https://integracp-saesa.smarapd.com.br/cpserver/integracaotributacao/integracaoterceiros
- baixa.clientId = Santa Bárbara: integracao; SAESA: CEBI.
- baixa.clientSecret = Santa Bárbara: lAcKMalctItO; SAESA: 6m!v1Loj#7hV6A~N.
- baixa.userAuth = WebSmarAPD
- baixa.utlRestSharp = Santa Bárbara: https://cp1-demo.smarapd.com.br; SAESA: https://integracp-saesa.smarapd.com.br
- baixa.urlToken = //authserver/OAuth20/Token
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
Hidrometria
SSB - Manual de Procedimentos e Operações.
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:
-
Acesse o módulo de Hidrometria: Entre no módulo de Hidrometria no sistema.
-
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
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:
- 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.
- 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:
- A partir da tela inicial clique em “Relação de Débito” (Menu lateral ou botão azul).
- 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:
- A partir da tela inicial clique em “Histórico de Consumo” (Menu lateral ou botão laranja).
- 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:
- 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.
- Clique no ícone da impressora referente a conta que deseja emitir.
- 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:
- A partir da tela inicial clique em “2ª via de Carnê” (Menu lateral ou botão roxo).
- No quadro “Carnês”, o sistema apresenta a relação dos carnês em aberto.
- 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”.
- Após clicar no ícone da impressora, o sistema apresenta a 2ª via do carnê.
Certidão Negativa
Passo a passo:
- A partir da tela inicial clique em “Certidão Negativa” do menu lateral.
- O sistema apresenta a tela de emissão da Certidão Negativa de Débito.
- Clique no botão “Download” para gerar a certidão negativa.
- 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:
- A partir da tela inicial clique em “Simulação de Parcelamento” do menu lateral.
- O sistema apresenta todas as contas em aberto.
- No campo “Quantidade de Parcelas” informe o número de parcelas e clique no botão “Simular”.
- 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:
- A partir da tela inicial clique em “Solicitações” no menu lateral.
- 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
- 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:
- O sistema apresenta a opção para o contribuinte abrir um chamado de serviço. Selecione o “Serviço” que deseja abrir.
- Informe os campos e clique no botão “Enviar”.
Importante: Os campos que estiverem com * serão obrigatórios.
Auto Leitura
Passo a passo:
- 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:
- Para cadastrar ou atualizar seus dados, informe o campo “E-mail”, “Confirmar E-mail” e clique no botão “Salvar”.
Tarifas
Passo a passo:
- O sistema apresenta as faixas de consumo para cada tipo de ligação.
Simulação de Consumo
Passo a passo:
- Selecione a “Categoria” que deseja simular o consumo.
- Informe o campo “Economia”, “Consumo” e clique no botão “Simular”.
Importante: Os campos com * são obrigatórios.
- 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:
- Informe o número do “Protocolo”, o “Ano” e clique no botão “Pesquisar”.
- 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:
- Clique no botão “Agendamentos”.
- Informe os campos obrigatórios: “CPF/CNPJ” e “Email”. Clique em “Agendar Novo Atendimento”.
- Sistema apresenta a tela de agendamento. É obrigatório informar todos os campos.
- Selecione o posto de atendimento.
- Ao selecionar o posto de atendimento, sistema apresenta o endereço e horário de atendimento do mesmo.
- Selecione a unidade de atendimento.
- Selecione o serviço da unidade correspondente:
- Ao selecionar o serviço que deseja, fique atento nos documentos necessários para o atendimento presencial, em informações do serviço.
- Selecione uma data para o atendimento.
- Selecione um horário para o atendimento.
- 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:
- Clique no botão “Agendamentos”.
- Informe os campos obrigatórios: “CPF/CNPJ” e “Email”. Clique em “Consultar”.
- 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:
- Solicitação de Serviço
- Auto Leitura
- Registro de e-mail
- Tarifas, Simulação de Consumo
- Consulta de Protocolo
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
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
Além disso é necessário a Unit of Work da própria notificação, exemplo:
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:
- Emissor - string - Emissor da notificação (mas é um string então pode ser qualquer coisa)
- Tipo - Enum (0 - Notificação, 1 - Aviso, 2 - Erro/Problema, 3 - Manutenção) - Tipo de notificação
- Descrição - string - Descrição da Notificação
- UrlRedirecionamento - string - Url que o usuário é redirecionado quando clica na notificação
- UsuariosAlvosIds - IEnumerable int - Usuários que a notificação vai aparecer
- PerfisAlvosIds - IEnumerable int - Perfis que a notificação vai aparecer
- SistemasAlvos - IEnumerable Enum SIstemas - Sistemas que a notificação vai aparecer (23/10/2024 - Não coloque nada nessa propriedade porque a rotina não implementa ela ainda)
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.
Remessa de cobrança
Inclusão de título protestado em remessa de execução fiscal
Procedimentos
1. Tela de criação de remessa
Para incluir um título já protestado no cartório em uma remessa para execução fiscal foi disponibilizado um recurso para filtrar apenas os títulos já protestados no momento da criação de remessa. opção: Somente Enviadas para Prostesto.
(https://wiki.cebi.com.br/uploads/images/gallery/2025-06/image-1749842465035.png)
Modal de detalhe do título
Procedimentos
1. Tela de detalhe da remessa
Para visualizar os detalhes dos títulos, foi disponibilizada uma opção na tela de detalhes da remessa selecionando o número do título para exibir o modal de detalhes.
(https://wiki.cebi.com.br/uploads/images/gallery/2025-06/image-1749843062956.png)
2. Model Detalhe do título de Cartório
Após selecionar o número do título, no caso de remessa de cartótio, o usuário será direcionado à um model para visualizar os detalhes do título de cartorio
(https://wiki.cebi.com.br/uploads/images/gallery/2025-06/image-1749843302498.png)
3. Model Detalhe do título de Execução Fiscal
Após selecionar o número do título, no caso de remessa de execuxão fiscal, o usuário será direcionado à um model para visualizar os detalhes do título de execução fiscal
- Detalhes: No caso de um título já protestado em cartótio o model irá exibir as informações dos títulos já protestados separados por seus respectivos catórios.
Relatório de Protocolos Protestados
Procedimentos
1. Tela de detalhe da remessa
Para visualizar o relatório foi disponibilizado um botão na lista de detalhes da remessa.
(https://wiki.cebi.com.br/uploads/images/gallery/2025-06/image-1749844401342.png)
2. Relatório
Modelo do relatório que será impresso.
(https://wiki.cebi.com.br/uploads/images/gallery/2025-06/image-1749844912548.png)
Parâmetro utilizado.
Na tabela de CB_PARAMETROS, foi criado o seguinte parâmetro que é utilizado para permitir a visualização da opção de impressão de protocolo de processo.
- crc.imprimeProtocoloProtestoCda
Leitura
SSB - Manual de Procedimentos e Operações.
Leitura via Rádio
Introdução
A rotina tem o intuito de criar o arquivo de leitura para os radiotransmissores e também receber o arquivo após a leitura, para assim, o sistema atualizar os devidos CDC's.
Rotina
1. Localização e listagem
No módulo de Leitura, é possível encontrar a opção 'Leitura via Rádio' no Menu Lateral, dentro da opção de Grupos.
Ao acessar a opção, o usuário será redirecionado para uma nova tela, onde será possível visualizar uma listagem de grupos.
2. Geração do arquivo para leitura
Ao visualizar os grupos, na coluna de 'Opções', existe o botão 'Gerar Arquivo'. Ao ser selecionado e o usuário confirmar a criação, será gerado um arquivo chamado "IMPORT.txt", para que assim, seja possível realizar a leitura via radiotransmissor. Obs: Gerando pela primeira vez o arquivo de um determinado grupo em uma determinada referência, será gravado um registro como histórico em nosso sistema.
3. Exibição na crítica de leitura
É possível visualizar as informações da leitura via rádio dentro da rotina de crítica de leitura, em que pode ser acessada ao selecionar uma ligação e clicar no botão 'Leitura via Rádio'.
Ao clicar no modal, abrirá um modal exibindo as informações da leitura.
Permissões e parâmetros
Permissões criadas para acessar a rotina:
Parâmetros criados para acessar a rotina:
Dívida Ativa
Integração GIDEP - Cancelamento (desinscrição)
Introdução
A rotina tem o intuito de cancelar (desinscrever) os lançamentos integrados com a empresa GIDEP.
Rotina
1. Localização o recurso
No módulo de Dívida Ativa, é possível encontrar a opção 'Cancelar Inscrição' no Menu Lateral, dentro da opção de Integração.
Ao acessar a opção, o usuário será redirecionado para uma nova tela, onde será possível visualizar uma listagem de Livros e outra de Lançamentos.
2. Cancelar Livro
Ao visualizar o livro, nas colunas 'Número' e 'Tipo da Dívida', existe o botão 'Desinscrever Livro'. Ao ser selecionado, o livro será cancelado juntamente com todos os seus lançamentos.
3. Cancelar Lançamento
Ao visualizar o lançamento, existe o botão 'Desinscrever Lançamento'. Ao ser selecionado, o lançamento será cancelado, o livro será cancelado caso não exista mais lanãmentos integrados.