Janeiro/Fevereiro/Março 2024
AUTENTICAÇÃO
TERCEIROS
API para buscar IDEndereco
URL: https://[URL]/ws/terceiros/enderecos/datatables
Método: GET
Entrada: Header: Token {token}, Authorization Basic {authorization}
QueryParam: Estado UF (texto) Cidade nome (texto) Bairro (texto) Logradouro (texto)
Saída: JSON contendo array de endereços encontrados ou json contendo erro
Exemplo de envio: https://[URL]/ws/terceiros/enderecos/datatables?estado=MG&cidade=BARBACENA&bairro=AGUA%20SANTA&logra douro=AGUA%20SANTA
Retorno: Sucesso: { "resposta": [4335654,4366754,756444] }
Obs: Para mais detalhes solicite/consulte Manual do Webservice Adapter.
COMERCIAL
Consulta Condomínios (Integração com Geogrid)
Para atender o conceito de subcondominios no Geogrid no cadastro/edição de endereços ao invés de realizar várias requisições a API de localização e a API do Geogrid quando realizado a ação de arrastar o boneco indicador (Pegman) no cadastro/edição de endereço, foi ajustado para que as requisições sejam feitas apenas quando seja feita a ação de soltar o boneco indicador (Pegman) no mapa.
Aceite Digital de Pacotes de Planos
Possibilidade de configuração de um modelo de contrato( em Comercial -> Tabelas de apoio-> Modelos de Contrato Cadastro) para pacotes e quando o sistema validar que tal plano faz parte de um pacote, recuperar o modelo de contrato configurado para aquele pacote. Para esses casos tanto para impressão quanto para realizar o aceite digital será realizada uma única vez abrangendo assim todos os planos do pacote.
Atualização de dados cadastrais de cliente (Webservice)
Criado um novo endpoint para atualização de dados cadastrais de clientes.
Endpoint: /ws/comercial/clientes/atualizar
Dados de entrada atraves do metodo POST:
{
"idCliente": "123456",
"telefoneFixo": “3333333333”
"telefoneCel": "33933333333",
"email": "teste@adapter.com",
}
Obs: Para mais detalhes solicite/consulte Manual do Webservice Adapter.
API para reversão de cancelamento de contrato
URL: https://[URL]/ws/comercial/contrato/reverter_cancelamento
Método: PUT
Entrada Header: Token, Authorization Basic
Body: Json constando o IDContrato Saída Resposta informando se o cancelamento do contrato foi revertido
Exemplo de envio: {“IDContrato”: 898998}
Opção de 'Permite negativar' disponível para contratos cancelados
Essa flag agora estará disponível também para contratos cancelados.
API para realizar upgrade/downgrade
URL https://[URL]/ws/comercial/contratos/updowngrade
Método: POST
Entrada Header: Token {token}, Authorization Basic {authorization}
Body: Json contendo os dados necessários para o cadastro
Saída: JSON contendo os dados do contrato cadastrado ou JSON contendo mensagem de erro
Exemplo de entrada:
{
“idContratoAnterior” : “111”, "idPlano": 1159, "idTipoContrato": 1, "idUsuario": 285, "idVencimento": 1, "valorContrato": 83.1, "idOrigemComercial": 1, "podeSuspender": 1, "idCanalVenda": 1, "naoCancelaPorInadimplencia": 0, "fidelizacao": "MESES_24", "idPlanejamentoTributario": 1, "migraDescontosServicos ": ”1”, "idVelocidade": 1
}
Obs: Para mais detalhes solicite/consulte Manual do Webservice Adapter.
Prospecto - Envio de e-mail configurado por funil
No módulo comercial foi criada a chave 'EMAIL_AVISO_PROSPECTO', onde poderá ser informado um ou mais endereços de e-mail. Na tela de cadastro/edição do funil poderá ser vinculado um modelo de email.
Caso o prospecto chegue a um funil que tenha um modelo de e-mail vinculado, será enviado um e-mail para o destinatário configurado na chave.
Criação de novo campo na tela do contrato (Observação no modelo de contrato)
Nesse campo poderão ser inseridas observações vinculadas a esse contrato. O field observacaoModeloContrato (String) poderá retornar a informação na impressão do contrato.
Filtro na API que retorna os contratos/faturas do cliente
Realizado um ajuste para que na API seja possível filtrar um limite de contratos que devem ser retornados.
URL: https://[URL]/ws/comercial/contratos/cliente/{idCliente}&limit=5
Método: POST
Entrada: Pelo PathParam passar o código do cliente e JSON contendo usuário e senha
Saída: JSON contendo os dados encontrados ou JSON contendo mensagem de erro.
Barra de SLA de atendimentos
Criado a exibição de uma barra de status no atendimento baseado no SLA cadastrado para o tipo de atendimento e a data de abertura do atendimento. Adiconada a TB_SLACategoria para possibilitar a uso da funcionalidade.
Ex: caso tenha um SLA de instalação de 4 dias e o atendimento estiver a:
- 01 dia aberta, apresentar uma barra com 25% preenchida na cor verde.
- 03 dias aberta, apresentar a barra com 75% preenchida na cor amarela.
- 05 dias aberta, apresentar a barra com 100% preenchida na cor vermelha sinalizando que o SLA está estourado.
Obs: As cores e a quantidade de categorias apresentadas no exemplo são apenas sugestões, podendo ter para mais ou para menos categorias criadas para um determinado SLA. Caso não seja criado nenhuma categoria no SLA a barra de status não será exibida.
Botão para retirar TRIAL
O botão irá remover os dados de TRIAL registrados no Adapter e gerar o histórico dessa alteração (TB_LogContrato). Ao acionado o botão irá executar a funcionalidade REMOVER_TRIAL_VELOCIDADE previamente configurada no cadastro de 'Conexões Radius'. Após esse processo o sistema irá gerar uma desconexão de rede do cliente para que a sessão seja reestabelecida com a velocidade padrão do contrato.
Aceite de contratos automático em caso de uso de aplicações de terceiros
Criado evento para realizar o aceites automático de contratos em caso de uso de App de cliente e Central de Assinantes de terceiros. Criado a chave no modulo comercial ACEITE_AUTOMATICO_CONTRATO onde caso seja = 1, o aceite será realizado de forma automática.
Permitir a criação de regras de negócio e interfaces para que sejam validados por empresas distintas
Criado no modulo de rotina o cadastro de SMTP para ser utilizado em empresas distintas. Criado o campo SMTP para seleção no cadastro de empresa para seleção de um SMTP cadastrado. Em conjunto foi criado a permissão ALTERAR SMTP - RT05 para a funcionalidade
Seleção de SMTP no cadastro de empresa
OBS:Caso seja utilizado a regra de SMTP por empresa o conteúdo da chave REMETENTE_EMAIL_EXTERNO não será considerado e o remetente de e-mails externos será o informado no cadastro de SMTP e que foi vinculado a empresa, caso não seja cadastrado ou não seja utilizado o cadastro de SMTP por empresa no campo "SMTP" do cadastro de empresas ficará como "GERAL" e o funcionamento de envios de e-mails externos no sistema não será modificado.
Funcionamento Rotinas
- Rotina de envio de faturas e notas fiscais
Caso a empresa opte por utilizar o envio de e-mails por diferentes remetentes de acordo com determinada empresa (tendo cadastrado previamente um SMTP e vinculado a uma empresa) a rotina de envio de faturas e notas fiscais também ira mudar o remetente de envio das faturas e notas. A rotina trará como remetente o e-mail cadastrado (no cadastro de SMTP) que esta vinculado a empresa da conta financeira da forma de cobrança.
- Rotina de suspensão de contratos
Caso a empresa opte por usar a suspensão de contratos com parâmetros distintos por empresas, será necessário especificar a empresa na configuração das métricas de suspensão (Comercial-> Tabelas de apoio-> Configuração de suspensão).
A rotina ao executar irá validar a empresa da qual o cliente pertence e realizar a ação de suspensão de acordo com o que foi especificado na configuração de suspensão para a determinada empresa.
FINANCEIRO
Melhoria em API de negociação
Adicionado ID da fatura gerada na negociação e das faturas negociadas no retorno do endpoint /ws/financeiro/faturas_negociar
- Parâmetros de saída:
{
"success": "Negociação realizada com sucesso!",
"object": [
{
"lancamento": "05-04-2024",
"idCliente": 27861,
"idsFaturasNegociadas": [
24778643
],
"numeroBoleto": "000096838126",
"linhaDigitavel": "23792.37304 90000.968389 12000.937909 9 96820000006670",
"valor": 66.7,
"numeroDocumento": "0424435294",
"vencimento": "10-04-2024",
"idFatura": 24876884,
"codigoBarras": "23799968200000066702373090000968381200093790"
},
{
"lancamento": "05-04-2024",
"idCliente": 27861,
"idsFaturasNegociadas": [
24778643
],
"numeroBoleto": "000096838118",
"linhaDigitavel": "23792.37304 90000.968389 11000.937901 2 97120000006670",
"valor": 66.7,
"numeroDocumento": "0524435294",
"vencimento": "10-05-2024",
"idFatura": 24876886,
"codigoBarras": "23792971200000066702373090000968381100093790"
}
]
}
Obs: Para mais detalhes solicite/consulte Manual do Webservice Adapter.
API para desfazer negociação
URL: https://[URL]/ws/financeiro/desfazer_negociacao
Método: POST
Entrada: Header: Token {token}, Authorization Basic {authorization}
Body: JSON contendo uma lista das faturas a serem desfeitas a negociação
Saída: JSON contendo mensagem de sucesso ou de erro.
Exemplo de envio: {
" idsFaturasNegociacao": [22094013, 22094015, 22094016, 22094018, 22097868]
}
Saída: Sucesso: {
"success": “Negociação desfeita.”
}
Obs: Necessária permissão para Webservice: DESFAZER NEGOCIACOES - ID02
Integração Bancária Sofisa
Desenvolvida integração bancária Sofisa, permitindo a transmissão de remessa bancária e processamento de retornos, seguindo um layout padrão de acordo com as regras do Banco Sofisa.
Exibição de baixa de faturas por perda
No cadastro das formas de pagamentos foi criada a flag 'PDD'. No momento de realizar a baixa manual de uma fatura, ao selecionar a flag 'PERDA PDD', o sistema irá apresentar as formas de pagamentos que possuem essa flag marcada.
Ajuste na ordenação nas telas 'Pré-faturamento' e 'Faturamentos a analisar'
Ajuste realizado na aba 'fila de execução' para que venha por padrão ordenado por ordem decrescente.
Permitir a geração de PIX dinâmico para faturas vencidas
Alteração para que faturas vencidas possam ter o PIX dinâmico gerado. Engloba Adapter, APP e central do assinante. O cálculo de juros/multas será o mesmo realizado no momento de uma baixa no manual no Adapter.
Adição da linha digital no base de dados
Foi desenvolvido um rotina (Rotina-GeraLinhaDigitavel) para que adicione na base de dados a linha digitável da fatura.
Regra:
- A configuração da rotina possui como parâmetros o "numeroThreads" e "limiteFaturas" para buscar determinada quantidade de fatura no base de dados.
- Caso "limiteFaturas" seja vazio ou igual a 0, a rotina buscará todas as faturas que estejam dentro da validação abaixo.
- A rotina buscará por faturas não pagas e não canceladas que não possuem registro na TB_InformacaoAdicionalFatura e fará a adição da linha digitável na mesma.
INTRANET
ESTOQUE
OPERACIONAL
REDES
Criação de nova variável para desprovisionamento Huawei
Para atender alguns modelos de ONU Huawei foi criado uma nova variável ( $INDEXONTID) utilizada no desprovisionamento de ONU Huawei.
TELEFONIA
BI
RELATÓRIOS
INTEGRAÇÃO
Integração API Bradesco PIX
Criado integração com o Banco Bradesco para emissão de boletos registrados utilizando a API de boleto híbrido e a API PIX do Bradesco, possibilitando assim a utilização de QRCode no boleto e a geração de PIX dinâmico em canais digitais de atendimento Em conjunto com a integração foi desenvolvido um webhook necessário para a notificação de pagamentos.
Obs: Consulte disponibilidade prévia no ambiente
Integração Plataforma EAI SMS
Desenvolvido nova integração com a plataforma de envio sms EAI SMS . Para proporcionar a integração foram adicionadas as seguintes tabelas ao modulo integração do sistema:
- LogSMS
- TB_SMSIntegradora
Passos para a utilização da integração :
Tendo cadastrado um novo Servidor de Integração (Modulo Integração-> Servidores de Integração) referente a plataforma EAI SMS é necessário cadastrar um "Tipo de integração" referenciando a TB_SMSIntegradora como mostra imagem abaixo:
Para esta integração de envio sms não é necessário o cadastro de "certificados" ou "Urls de autenticação" (presentes no modulo integração)
- Será necessário cadastro de "URLs" para interação com a plataforma como mostra abaixo :
Obs: Para detalhes de dados enviados a EAI SMS, consulte/solicite documentação.
- Para utilização da integração é necessário referenciar o ID do servidor na chave ID_SERVIDOR_INTEGRACAO_SMS do modulo comercial (Comercial -> Tabelas de apoio-> Configurações) referente ao Servidor de Integração da EAI SMS
- Ainda no modulo integração é necessário o cadastro das Integradoras de SMS(em Integração -> Integradoras de Sva) na qual iram disparar a ação de interação com a plataforma de SMS.
Integração Plataforma Campsoft
Desenvolvido nova integração com a plataforma de SVAs Campsoft. Para proporcionar a integração foram adicionadas as seguintes tabelas ao modulo integração do sistema:
- TB_SvaIntegradora
- TB_LogSva
- TB_DadosSvaProdutoIntegracao
Passos para a utilização da integração :
- Tendo cadastrado um novo Servidor de Integração (Modulo Integração-> Servidores de Integração) referente a plataforma Campsoft é necessário cadastrar um "Tipo de integração" referenciando a TB_SvaIntegradora como mostra imagem abaixo:
- Foi adicionado também uma nova chave no modulo comercial (Comercial -> Tabelas de apoio-> Configurações) de nome ID_INTEGRADORA_CAMPSOFT referenciando a Integradora Campsoft que deve estar previamente cadastrada (Integração -> Integradoras)
Para esta integração de SVAs não é necessario o cadastro de "certificados" ou "URLs de autenticação" (presentes no modulo integração).
- Será necessário cadastro de "URLs" para interação com a plataforma como mostra abaixo :
Obs: Para detalhes de dados enviados a Campsoft, consulte/solicite documentação.
- Ainda no modulo integração é necessário o cadastro das Integradoras de Sva (em Integração -> Integradoras de Sva) na qual iram disparar a ação de interação com a plataforma de SVAs como mostra abaixo:
- Para referenciar o produto da plataforma é necessário o cadastro do mesmo em "Produtos SVAs" (em Integração -> Tabelas de apoio -> Produtos SVA's) como mostra imagem abaixo, perceba que é necessário também o cadastro prévio de uma composição (em Financeiro -> Tabelas de apoio -> Composição Composições (Plano)):
Regra de negocio:
Foram desenvolvidos a chamadas ao metodos de Adicionar, Cancelar e Atualizar os dados na plataforma Campsoft:
- Para as ação de Habilitar será chamado a ação de Adicionar,
- Para as acoes de Supender/Inativar Temporariamente/Cancelar será chamado a ação de Cancelar
- Paras as ações de Upgrade/Downgrade será cancelado o atual produto na plataforma e adicionado o novo produto
MIGRAÇÃO
APLICATIVOS
APP do técnico
Feito ajuste para que em atendimentos do tipoServico INSTALACAO seja possível adicionar serviços a serem cobrados.