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: POST
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.
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.
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
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