Agosto/Setembro 2025

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}.

Alteração mapeamento

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.

Cadastro novo plano

Tipo "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:

Seleção contrato plano tipo recarga

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.

Dados voz apos envio dos dados

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

Modal de refresh

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.

Modelo de e-mail

Modelo SMS

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.

Retorno :

{
	"Email": "emailcliente@",
	"Empresa": "EMPRESA LTDA",
	"NomeCliente": "FULANO DA SILVA",
	"TelefoneFixo": "31999999999",
	"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.