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
- Rois de Apoio
- Processamento de Baixas
- Hidrometria
- Agência Virtual
- SSB Principal
- Libraries (Bibliotecas)
- Corte
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
SSB - Manual de Procedimentos e Operações.
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.
Ingraçã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.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
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.utilizaIntegracaoSmar = Sim
- baixa.codigoUnidadeGestora = 301
- baixa.codigoHistoricoIntegracao = Para o cliente Santa Bárbara, o valor deve ser 2; caso contrário, consultar a SMAR para obter a informação correta.
- baixa.urlApiConsultaIntegracaoSmar = https://cp1-demo.smarapd.com.br/cpserver/integracaotributacao/consultaIntegracaoTerceiros
- baixa.urlIntegracaoBaixa = https://cp1-demo.smarapd.com.br/cpserver/integracaotributacao/integracaoterceiros
- baixa.clientId = integracao
- baixa.clientSecret = lAcKMalctItO
- baixa.userAuth = WebSmarAPD
- baixa.utlRestSharp = https://cp1-demo.smarapd.com.br
- baixa.urlToken = /authserver/OAuth20/Token
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
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.