Agosto/Setembro 2025

De Adapter
Revisão de 01h01min de 18 de setembro de 2025 por Philip.alves (discussão | contribs) (→‎Ateste)
Ir para navegação Ir para pesquisar

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


Alteração mapeamento

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:

Informação complementar para boletos sem remessa

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

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

teste

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


500x500px
Modal de refresh

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.


Modelo de e-mail


Modelo SMS

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.

Cadastro CNI

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