Agosto/Setembro 2025
AUTENTICAÇÃO
COMERCIAL
Fluxo de alteração de mapeamento e alteração de titularidade no Geogride
Para mudanças em informações de cliente (alteração de titularidade) será realizado a requisição POST ao endpoint /integracao/atender na plataforma Geogride.
Para quando ocorre alterações na porta que o cliente esta alocado no Adapter, será realizado a requisição DELETE para o endpoint /integracao/atender/{idPorta}/{idCliente} para liberar a porta na plataforma e logo em seguida vinculado o cliente a nova porta através da requisição PUT para o endpoint /clientes/{idCliente}.
Nova flag para modelos de E-mail, SMS e Aviso App
Criado nova flag "Ativo" no cadastro de modelos de E-mail, modelos de SMS e modelos de aviso no APP para exibição ou não no envios do sistema
REGRA:
Ao selecionar um modelo de email para envio de fatura na aba "Dados Financeiros", serão exibidos todos os modelos cadastrados que estejam com a flag "Ativo" e "E-mail de cobrança" marcados
Ao selecionar um modelo de sms para envio de código de barras na aba "Dados Financeiros", serão exibidos todos os modelos cadastrados que estejam com a flag "Ativo".
Para a tela de "Envios" do cadastro do cliente, ao selecionar um modelo de sms serão carregados todos os modelo que estiverem marcados "Ativo", que não sejam "SMS de cobrança" e sejam do tipo de envio "CADASTRO_CLIENTE".
Ao selecionar um modelo de e-mail serão carregados todos os modelo que estiverem marcados "Ativo", que não sejam "E-mail de cobrança" e sejam do tipo de envio "CADASTRO_CLIENTE".
Ao selecionar um modelo de aviso no App serão carregados todos os modelo que estiverem marcados "Ativo", que não sejam "Aviso de cobrança" e sejam do tipo de envio "CADASTRO_CLIENTE".
Para a tela de envios em massa (em Intranet -> Envio de comunicados em massa), ao selecionar um modelo de sms serão carregados todos os modelo que estiverem marcados "Ativo" e foram do tipo de envio MARKETING.
Aplicação de trial de velocidade no cadastro do contrato
Para utilização da funcionalidade foi criado uma nova flag Trial na venda no cadastro do plano (Comercial > Tabelas de apoio > Planos > Cadastro) como mostra imagem a seguir.
Estando com a flag marcada no plano, ao criar um novo contrato será exibido uma nova seção Dados de trial de velocidade onde estará disponível para a seleção a velocidade de degustação e o período que ficará disponível esta velocidade.
Filtro de arquivos por contrato
Implementado no cadastro do cliente na tela de "Dados Pessoais" no menu lateral de "Arquivos", os novos filtros de "Status do Contrato" e "Filtrar por contrato" para adição de documentos.
Os novos filtros criados também ficarão disponíveis para filtrar arquivos na tela
Limitação de distância para fechamento de OS
Para a funcionalidade foi criada uma chave de configuração no módulo comercial "DISTANCIA_MAXIMA_TECNICO_CLIENTE_OS" (valor informado em metros). No cadastro de Tipos de atendimento foi criado uma nova flag "Verifica local técnico" para que seja validado no momento do fechamento do atendimento no App de Técnico
REGRA:
Caso chave seja null, o sistema irá manter a funcionalidade sem controle de distância para fechamento comoé atualmente.
Caso chave não seja igual null e tipo de atendimento tem atributo “Verifica local técnico” desmarcado,o sistema irá manter a funcionalidade sem controle de distância para fechamento como é atualmente.
Caso a chave não seja null e tipo de atendimento tem atributo “Verifica local técnico” marcado, o sistema irá olhar a localização atual do técnico calcular a distância entre o ponto georreferenciado atual do mesmo e o endereço (INSTALAÇÃO se houver, ou PADRÃO). Se a distancia calculada for maior que a informada na chave de configuração, o app de técnico irá apresentar mensagem “Você se encontra muito longe do local apontado para execução dessa OS. Favor volte ao local para ser possível realizar o fechamento” e não realizar o fechamento da OS.
OBS: Para que não seja comprometida a funcionalidade de alteração de latitude x longitude no cadastro de endereço do contrato, foi criado também a nova chave ATUALIZA_LATITUDE_LONGITUDE_NA_ATIVACAO onde por default assumirá valor = 1. Caso seja = 0 não ocorrerá a atualização das coordenadas no momento da ativação.
Token de cancelamento
Para a funcionalidade foi criado no módulo comercial uma tela para cadastro de tipos de cancelamento (em Comercial > Tabelas de apoio > Contratos > Tipos de cancelamento). Para ter acesso a essa tela foi criada a permissão por perfil (ALTERAR_TIPOS_CANCELAMENTO CN104)
No cadastro o usuário poderá configurar qual Modelo de E-MAIL, SMS ou Modelo de Aviso no APP que será enviado no momento do cancelamento.
Foram criadas as chaves de configuração (modulo comercial) “ENVIA_CHAVE_CANCELAMENTO” e "UTILIZA_TIPO_CANCELAMENTO"(esta definindo se será utilizado ou não os tipos de cancelamento por token). O envio do token só será feito caso a chave ENVIA_CHAVE_CANCELAMENTO seja = 1.
Nos modelos de envio sms, e-mail ou aviso app utilizados no tipo de cancelamento onde será solicitado token para validação do cancelamento, deverá constar a variável $tokenCentral.
Ao realizar o cancelamento do contrato via tela, caso a chave UTILIZA_TIPO_CANCELAMENTO = 1, será solicitado a seleção do tipo de cancelamento como mostra imagem a seguir:
Em seguida será encaminhado para o cliente um token através de sms, e-mail ou aviso no app (conforme previamente configurado no tipo de cancelamento), referente ao processo de cancelamento do contrato. Uma vez recebido de token, o mesmo deverá ser informado no modal para conseguir prosseguir com o processo, no modal ainda será possível cancelar o processo ou reenviar o token para o cliente.
O cancelamento só terá sucesso quando for informado na tela o token recebido pelo cliente.
Filtros ao adicionar/consultar arquivos
Na tela do Cliente > Dados pessoais > Arquivos, ao adicionar novos arquivos foi criada uma opção (não obrigatória) para filtrar status do contrato e contrato. Ao selecionar algum status ou contrato específico, os arquivos serão vinculados de acordo com essa seleção. Caso opte por 'Todos os status' e 'Todos os contratos' o arquivo não será vinculado a algum contrato específico.
Posteriormente também será possível utilizar os mesmos filtros para buscar arquivos por status/contrato
FINANCEIRO
Informações complementares em boletos sem remessa
Criado a nova chave de configuração INFORMACAO_COMPLEMENTAR_FATURA_SEM_REMESSA (modulo financeiro) para que seja utilizado (de forma opcional) no campo de observações da fatura($F{observacaoFatura) em caso de impressão do boleto sem remessa.
A chave deverá conter a informação que será impressa no boleto sem remessa como mostra imagem de exemplo a seguir:
INTEGRAÇÃO
Integração CardHub (Recarga)
Para possibilitar esse tipo de integração iniciaremos pela configuração do plano. Na configuração do plano de “TECNOLOGIA MOVEL” na aba “Telefonia” foi criado um novo tipo de integração RECARGA.
Ao marcar esse tipo de integração, isso garantirá que nenhuma requisição será encaminhada à integradora ao cadastrar um novo contrato de telefonia móvel.
Com o plano devidamente configurado para o tipo de integração Recarga, ao selecionar o plano no cadastro de um novo contrato, será exibido a mensagem O plano selecionado é do tipo RECARGA e não irá possibilitar cadastro e/ou manutenção das linhas. Como mostra imagem a seguir:
Ao salvar o contrato, será salvo o registro na TB_DadosVozContrato porém sem informações relevantes para a linha (como número, portabilidade, etc.), esses dados serão posteriormente populados quando encaminhados da integradora para o CRM Adapter.
Para possibilitar o envio de informações da linha pela integradora para o Adapter, foi desenvolvido o novo endpoint abaixo, conforme solicitado:
Endpoint: https://URL_BASE/ws/comercial/contratos/telefonia_movel/dados_voz/cadastrar
Body:
{
"idContrato": 37944,
"ICCID": "89552600000020552020",
"msisdn": "5531999993700",
"Status": "ATIVO"
}
Obs: para mais informações, consulte/solicite o manual do webserver.
A ideia da integração é que a integradora encaminhe para o CRM Adapter os dados posteriormente através do endpoint informado acima. Uma vez encaminhado a requisição com os dados válidos, serão salvos os registros de número na tabela TB_DadosVozContrato e também serão salvos os dados de Status, msisdn e ICCID na TB_DadosVozIntegracao.
Após encaminhado a requisição para o Adapter a informação de número do telefone será mostrada na seção Dados de Voz do contrato.
Ajuste Integração Watch (edição de dados pessoais)
Ao editar dados de telefone nos Dados Pessoais do cliente, será realizada a requisição na integradora por método POST para o endpoint v2/assinantes/editPhone.
Ao editar o dado de e-mail nos Dados Pessoais do cliente, caso o e-mail que esta sendo editado esteja salvo na Tb_DadosContratoTV, o registro nesta tabela também será atualizado e a requisição POST para o endpoint v2/assinantes/editEmail também será encaminhada à integradora para que seja atualizado.
Ajuste em URLs de autenticação
Adicionado nova flag Retorno no header no cadastro da URL de autenticação (em Integração -> URLs de autenticação -> Cadastro) para que o campo a ser recuperado na requisição de autenticação (onde será utilizado posteriormente nas URLs que farão as interações nas integradoras ), seja um campo presente nos headers do retorno da requisição de autenticação.
Integração MVNO DATORA
Desenvolvido nova integração para tecnologia "TELEFONIA MOVEL" com a plataforma de telefonia DATORA.
As configurações para possibilitar venda de contrato com tecnologia móvel MVNO integrados a plataforma DATORA se iniciam no cadastro do plano. Ao cadastrar um plano com “TECNOLOGIA MOVEL” na aba “Telefonia” do plano estará disponível para a seleção o “Tipo de integração ” e este deverá esta marcado MVNO, com a opção marcada, será habilitado os campos “Quantidade de linha” onde será informado o número de linhas máximo que o plano suporta e o “Código de produto Integradora” (referenciando o iD do produto na plataforma).
OBS: ao adicionar a quantidade de linhas maior que 1, será habilitado o campo “Código do produto das linhas adicionais” referenciando o id produto “filho” de linhas adicionais na plataforma, até o momento este desenvolvimento não abrange o produto com linhas adicionais
Na tela a seguir também foi adicionado a flag “Altera titular” onde caso não esteja selecionada, não será permitido a realização da alteração de titularidade do contrato após criado.
Para possibilitar a integração na plataforma DATORA, foram criadas algumas ações cadastrada previamente (em modulo Integração -> Ações de integradoras de voz-> Cadastro) que realizarão as chamadas na plataforma DATORA. Na nova integração serão aplicadas as seguintes ações configuradas previamente :
LISTAR_NUMEROS_DISPONIVEIS (GET endpoint /msisdns?area_code=_AREA_TELEFONE_&status=AVAILABLEE), LISTAR_SIMCARDS, CADASTRAR_CONTRATO(GET endpoint /available/random ), CONSULTAR_CHIP (GET endpoint /account/_NUMERO_TELEFONE_), CADASTRAR_CLIENTE (POST endpoint /activations/create_customer ), CONSULTAR_CLIENTE (GET endpoint /manager/v1/clients/documents/_DOCUMENTO_CLIENTE_), CONSULTAR_CONTRATO (/account/_NUMERO_TELEFONE_), ATIVAR_SIMCARD (POST endpoint /activations/create_subscription_cart), TROCAR_LINHA_POR_PORTABILIDADE (POST endpoint /portabilities/Create_portability), ALTERAR_ENDERECO_CLIENTE (PUT endpoint /clients/_CLIENTE_INTEGRADORA_), ALTERAR_ENDERECO_CONTRATO (PUT endpoint /clients/_CLIENTE_INTEGRADORA_), ALTERAR_CLIENTE_CONTRATO(PUT endpoint /clients/_CLIENTE_INTEGRADORA_), ALTERAR_PRODUTO (PUT endpoint /manager/v1/subscriptions/carts/_CONTRATO_INTEGRADORA_), BLOQUEAR_SIMCARD (PUT endpoint /accounts/blockers/_NUMERO_TELEFONE_), BLOQUEAR_SIMCARD_PARCIAL(PUT endpoint /accounts/suspensions/_NUMERO_TELEFONE_), DESBLOQUEAR_SIMCARD (PUT endpoint /accounts/releases/_NUMERO_TELEFONE_), CANCELAR_SIMCARD (DELETE endpoint /deleteAccount/_CONTRATO_INTEGRADORA_), REATIVAR_CONTRATO (PUT endpoint /accounts/releases/_NUMERO_TELEFONE_), TROCAR_SIMCARD (POST endpoint /accounts/_NUMERO_SIM_CARD_/sim-cards/exchanges), COMPRAR_DADOS (POST endpoint /recharges/create_recharge_cart ), ATIVAR_COMPRA_DADOS (POST endpoint /manager/v1/recharges/carts/_CONTRATO_UNICO_INTEGRADORA_/moneys )
Onde cada ação ficará a cargo de requisitar um endpoint (citados mais acima) na integradora DATORA.
Ao realizar o cadastro de um novo contrato para o cliente, na seção de “Dados Voz” do contrato que esta sendo cadastrado, ao informar o código de área será chamado ação LISTAR NUMEROS DISPONÍVEIS onde será exibido no combobox ao lado o resultado da requisição com os número disponíveis para a área de cobertura informada
Ao clicar para salvar o novo contrato será exibido o modal para a seleção do tipo de SIMCARD como mostra imagem a seguir:
Caso selecionado o tipo SIMCARD físico será aberto um novo modal para inserção do simcard e em seguida o contrato no sistema e as chamadas de criação do cliente e do contrato serão realizadas na plataforma de telefonia.OBS: quando selecionado este tipo de SimCard o contrato só será salvo após o preenchimento da informação.
Caso seja selecionado o tipo eSIM, serão realizadas as ações já mencionadas CADASTRA CLIENTE, LISTAR SIM CARDS DISPONIVEIS (onde será atribuído um SIMCARD de forma aleatória que estiver disponível) e por fim a ação de CADASTRAR CONTRATO .
Na plataforma DATORA será validado no momento do cadastro se o CPF é um documento valida na base da Receita Federal e se os dados pessoais informados estão de acordo com as informações encaminhadas no cadastro. Caso possua dados divergente será retornado a critica como mostra exemplo abaixo:
Caso o cadastro ocorra com sucesso na plataforma, será encaminhado automaticamente um e-mail de configuração para o novo cliente cadastrado.
Ao habilitar o contrato no Adapter será encaminhado as ações de ATIVAR SIM CARD e um novo email de boas vindas será encaminhado automaticamente da integradora para o e-mail cadastrado do cliente.
OBS: Algumas ações como consulta saldo, zerar saldo ainda não possuem endpoint definido para a integração. Ações de alteração de titularidade e upgrade/downgrade estão em fase de levantamento da regra de negócio contudo poderão ser realizadas no CRM mas ainda não serão encaminhadas a plataforma DATORA, para mais informações consulte o suporte técnico.
Para a integração há a possibilidade da compra de pacote de dados de telefonia, para que seja possível a compra da dados adicionais é necessário realizar o cadastro prévio (em Comercial -> Tabelas de apoio -> Pacotes -> Pacotes de dados adicionais -> Cadastro) como mostra imagem a seguir :
Então com o contrato habilitado ao clicar no botão “Compra pacote de dados” serão exibidos todos os pacotes de dados cadastrados previamente disponíveis para a compra
Quando selecionado o pacote de interesse e confirmado a compra serão chamadas as ações de COMPRAR DADOS e em seguida ATIVAR COMPRA DADOS para de fato efetivar a compra na plataforma. No CRM Adapter será lançado para o cliente um serviço adicional para o contrato e este será faturado no próximo vencimento.
Para as ações de suspensão, suspensão parcial, habilitação em confiança e habilitação do contrato (reativação do contrato) serão também realizadas as respectivas interações na plataforma de telefonia móvel DATORA.
Ainda na integração com a plataforma, após o contrato salvo há a possibilidade de consulta do status do chip e troca de linha por portabilidade
Ao clicar e "Status do SIM Card" será exibido um modal com as informações do simcard:
Ao clicar em "Trocar por portabilidade" será exibido um modal para informar o numero a ser realizado a portabilidade
INTRANET
Habilitação em confiança para webservice
Criado nova chave de configuração (modulo intranet) PERMITE_HABILITAR_CONFIANCA (valor 0 ou 1), para funcionalidade de habilitação em confiança através de canais digitais usando os endpoints (/ws/comercial/contrato/habilitar_confianca e ws/comercial/contrato/ID_CONTRATO/webservice/alterar/status?descricaoStatus=HABILITADO%20EM%20CONFIANCA&acessoCentral=S )
OBS: para mais informações de endpoints consulte manual do webserver
Removido modal de refresh no javascript
Removido modal de refresh no javascript do navegador quando era salvo as interações no sistema
ESTOQUE
OPERACIONAL
RELATÓRIOS
REDES
ROTINAS
TELEFONIA
APLICATIVOS
Atualizado nível de API dos Apps Vendas, Cliente e Técnico para Google
A estrutura básica dos aplicativos não foi alterada. Apenas modificada a compatibilidade com nova API da Google (Android 15).
Ajuste redefinição de senha e segurança do APP do Cliente/Central do assinante
Adicionado no App de Cliente e Central do Assinante, novos padrões para redefinição de senha. Criado as novas chaves ID_MODELO_EMAIL_RECUPERAR_SENHA e ID_MODELO_SMS_RECUPERAR_SENHA (modulo comercial) para especificação do modelo de email e sms específicos para recuperação de senha nos canais digitais mencionados.
Nos novos modelos de email e sms devem ser utilizados com as variáveis $username$ para nome do cliente e $password$ para senha, o Tipo de envio deverá ser criado como RECUPERACAO_SENHA para a funcionalidade.
Cadastro CNI no App de Vendas
Adicionado nova flag CNI no App de vendas para quando o documento cadastrado se tratar de uma Carteira de Identidade Nacional, ao marcar a opção CNI o campo RG ficará desativado.
API's
Novas informações do técnico em endpoint de atendimentos
Adicionado informações do técnico responsável pela visita técnica no retorno do endpoint ws/comercial/atendimentos/{idAtendimento} (Buscar dados detalhados do atendimento)
Retorno :
{
...
"Contrato": {
"IDContrato": idContrato,
....
},
"IdTecnicoVisita": 151,
"NomeTecnicoVisita": "Fulano da Silva",
"Plano": "INTERNET RESIDENCIAL 600 MBPS",
...
},
"DadosCaixa": {
...
}
OBS: para mais informações, solicite o manual do webserver
Novo endpoint para informações básicas do cliente
Criado novo endpoint para requisição GET /ws/comercial/cliente/{idCliente: [0-9]+} onde será retornado informações básicas do cliente.Entre os dados de retorno do endpoint, o campo "Ativo" (true ou false) estará relacionado quanto ao cliente possuir ou não contratos ativos na base.
Retorno :
{
"Email": "emailcliente@",
"Empresa": "EMPRESA LTDA",
"NomeCliente": "FULANO DA SILVA",
"TelefoneFixo": "31999999999",
"Ativo": false,
"IDCliente": 1,
"TelefoneMovel": "31999999999",
"Documento": "11111111111",
"Enderecos": [
{
"Logradouro": "RUA ABC",
"UF": "SP",
"Numero": 1,
"Tipo": "PADRAO",
"Complemento": null,
"Condominio": null,
"Referencia": null,
"Bairro": "ABC",
"Cidade": "ABC",
"CEP": "14701220"
},
{
"Logradouro": "RUA ABC",
"UF": "SP",
"Numero": 2,
"Tipo": "PADRAO",
"Complemento": "",
"Condominio": null,
"Referencia": null,
"Bairro": "ABC",
"Cidade": "ABC",
"CEP": "14701320"
}
]
}
OBS: para mais informações solicite/consulte o manual do webserver.
CENTRAL DO ASSINANTE
Cadastro de recorrência sem fatura
Adicionado a possibilidade de cadastro de recorrência na central do assinante e app de cliente, anteriormente era necessário possuir pelo menos uma fatura no contrato que fosse possível o cadastro da recorrência .
