Novembro/Dezembro 2024: mudanças entre as edições
(23 revisões intermediárias por 2 usuários não estão sendo mostradas) | |||
Linha 26: | Linha 26: | ||
===Criação de novo endpoint de cartão recorrente=== | ===Criação de novo endpoint de cartão recorrente=== | ||
Desenvolvido novo dados_cartao/recorrencia/cadastrar/externo visando maior segurança dos dados. Para mais informações consultar manual webservice. | Desenvolvido novo endpoint /dados_cartao/recorrencia/cadastrar/externo visando maior segurança dos dados. Para mais informações consultar manual webservice. | ||
===Lentidão para atualizar planos=== | ===Lentidão para atualizar planos=== | ||
Linha 52: | Linha 50: | ||
Exclusivamente para esse tipo de arquivo, será possível o vincular apenas um arquivo por contrato. Isso visa impedir possíveis duplicidades para casos onde o cliente poderia assinar diversas vezes antes de concluir a ação. | Exclusivamente para esse tipo de arquivo, será possível o vincular apenas um arquivo por contrato. Isso visa impedir possíveis duplicidades para casos onde o cliente poderia assinar diversas vezes antes de concluir a ação. | ||
=== | |||
===Field para retornar dias fidelidade=== | |||
Criado field PeriodoFidelizado, o qual irá retornar a diferença em dias entre DataInicioFidelidade e DataVencimentoFidelidade.<br> | |||
Exemplo:<br> | |||
DataInicioFidelidade: 20/10/2024<br> | |||
DataVencimentoFidelidade: 25/10/2024<br> | |||
Neste caso o field irá retornar: 5 | |||
===Novo tipo de arquivo para o cliente (ESTORNO)=== | |||
Na tela do cliente, aba 'ARQUIVOS' criado novo tipo de arquivo com o nome ESTORNO. | |||
[[Arquivo:ESTRONO.jpg|500x500px|miniaturadaimagem|centro|Novo tipo de arquivo]] | |||
===Melhorias para iniciar atendimento no APP do técnico=== | |||
Criado chave no módulo comercial: | |||
VERIFICA_ASSINATURA_CONTRATO_APP_TECNICO | |||
Chave booleana para utilização da função verificar assinatura no contrato. '0' = Não | '1' = Sim | |||
Na tela, ao clicar em INICIAR ATIVIDADE o sistema irá validar a chave de configuração acima, se for false, manter o sistema como é atualmente. Se for true verificar se o contrato vinculado ao atendimento/OS possui atributo DataAceite preenchido. Se sim, prosseguir com o inicio da atividade normalmente, se nao, apresentar | |||
mensagem ao usuário “O contrato vinculado ao atendimento ainda não foi assinado pelo cliente, favor solicitar assinatura para prosseguir” e não permitir o inicio da atividade. | |||
Trava será apenas para atendimentos de ativação/reativação. | |||
[[Arquivo:QAappmsg.jpg|500x500px|miniaturadaimagem|centro|Tela app técnico caso contrato não tenha o aceite]] | |||
===Visualização de velocidade vinculado ao plano=== | |||
Implementada melhoria para que seja mostrado nos APPs e central a velocidade vinculado ao plano/pacote, mesmo que o contrato possua lista de preços unitários (ou seja o mesmo plano possua várias velocidades x planos). | |||
Implementação no backend, sem necessidade de alteração nos aplicativos ou central. | |||
==FINANCEIRO== | ==FINANCEIRO== | ||
Linha 65: | Linha 105: | ||
Na aba das faturas de negociação, ao clicar mais detalhes poderá ser visto quais faturas foram negociadas para gerar a fatura de negociação que se encontra ativa.<br> | Na aba das faturas de negociação, ao clicar mais detalhes poderá ser visto quais faturas foram negociadas para gerar a fatura de negociação que se encontra ativa.<br> | ||
Haverá a informação de IDFatura, DataVencimento, NumeroBoleto e Valor. | Haverá a informação de IDFatura, DataVencimento, NumeroBoleto e Valor. | ||
===Inclusão do filtro 'Tipo Pessoa' para integração de faturamentos=== | |||
Incluído novo campo 'Tipo Pessoa' para que possa ser filtrado em tela. | |||
Alteração feita também na rotina de integração de faturamentos, para que seja respeitado o filtro aplicado pelo usuário na tela. | |||
===Novo filtro na tela de remessa de alteração=== | |||
Incluído novo filtro na tela Financeiro > Integração bancária > Gerar arquivo de remessa de alterações. Preenchimento da data de cancelamento é opcional. | |||
[[Arquivo:QAcancel.jpg|500x500px|miniaturadaimagem|centro|Filtro de cancelamento]] | |||
==INTEGRAÇÃO== | ==INTEGRAÇÃO== | ||
Linha 88: | Linha 141: | ||
Exemplo: Nome do cliente: TESTE DA PARETO DESCONSIDERE<br> | Exemplo: Nome do cliente: TESTE DA PARETO DESCONSIDERE<br> | ||
A chave irá retornar: DA PARETO DESCONSIDERE | A chave irá retornar: DA PARETO DESCONSIDERE | ||
===Integração Pagamento Cartão AUTTAR=== | |||
Desenvolvido APP onde o atendente poderá escolher, ao fazer o pagamento de uma fatura: CARTAO DE DÉBITO, CRÉDITO OU PIX. Logo o Adapter envia os dados do pagamento para a maquininha e a AUTTAR | |||
O retorno da validação do pagamento, seguindo o fluxo normal de pagamento. | |||
Criadas as telas onde é possível consultar as faturas em aberto do cliente a partir da informação do documento (CPF/CNPJ), consulta realizada através de endpoint do Adapter URL.<br> | |||
https://[URL]/ws/financeiro/faturas/cliente/documento/{aqui CNPJ/CPF}<br> | |||
[[Arquivo:Telasapp.jpg|500X500px|miniaturadaimagem|centro|Telas do app]]<br> | |||
Ao selecionar a fatura a ser paga o sistema deve nesse momento realizar as chamadas devidas dos métodos de pagamento da GetNet conforme documentação. Somente após ocorrido o pagamento com sucesso na máquina de cartão, o App irá realizar | |||
chamada no endpoint do Adapter de pagar fatura. | |||
• Criado endpoint (conforme manual webservice) https://[URL]/ws/integracao/getnet/log/cadastrar para registrar, em log, os pagamentos realizados pela getnet por meio do app de pagamentos. Necessário a permissao: | |||
REALIZAR PAGAMENTO VIA GETNET ECOMMERCE (WEBSERVICE) - WS55<br> | |||
• Inserido a opção de pagamento por pix, na mesmo tela onde retorna a opção de crédito e débito. Ao escolher opção pix deve seguir o fluxo atual da central/app cliente, ou seja, gerar o QRCode para pagamento da fatura.<br> | |||
• Na tela onde são listadas as faturas disponíveis para pagamento,criado a opção para que o usuário tenha mais informações sobre a fatura. É possível ver qual/quais contratos estão vinculados a essa fatura, e também mostrar o endereço vinculado a cada contrato. | |||
===Envio de movimentação ao SAP - App técnico=== | |||
Realizado ajuste para que seja enviada a movimentação para o SAP mesmo que o fechamento escolhido seja IsReagendamento = 1. Anteriormente essa movimentação era enviada apenas quando o fechamento escolhido tivesse a flag IsSolucionado = 1. | |||
==INTRANET== | ==INTRANET== | ||
==ESTOQUE== | |||
===Ajustes necessários para de devolução de equipamentos=== | |||
Removido seção "Dados de devolução de equipamentos" da tela de análise de comissionamento(''Operacional -> Análise de comissionamento'') e mantido funcionalidade na tela de devolução de equipamento (''Estoque -> Movimentações -> Devolução de equipamentos'') nas duas telas era possível realizar a devolução podendo gerando informação duplicada. Ajustado para quando for realizado a devolução de equipamento não ter necessidade de uma analise de comissionamento prévia, isso estava gerando erro caso possuísse imagens vinculadas ao atendimento (na TB_AtendimentoDocumento). | |||
Caso na tela de devolução NÃO seja escolha o tipo da devolução 'Não devolvido', o campo 'Data de devolução' deve ser obrigatório. | |||
[[Arquivo:Devolucao.png|400x400px|miniaturadaimagem|centro|Devolução de equipamento]] | |||
===Equipamentos comodatos no APP e Central=== | |||
Na tela ou APP, poderá ser feita a consulta que irá retornar os equipamentos em custódia do cliente. | |||
[[Arquivo:Custodia central.jpg|500xx500px|miniaturadaimagem|centro|Equipamentos na Central]] | |||
[[Arquivo:Custadoappp.jpg|500x500px|miniaturadaimagem|centro|Equipamentos no APP do cliente]] | |||
==OPERACIONAL== | ==OPERACIONAL== | ||
Linha 109: | Linha 211: | ||
==TERCEIROS== | ==TERCEIROS== | ||
===API de endereços do Adapter=== | |||
Ao realizar o cadastro de endereço para o cliente/prospecto ou verificação de disponibilidade da fibra | |||
(Comercial -> Verificar disponibilidade da fibra), caso o endereço não seja encontrado na base do Adapter, o sistema irá buscar na API de endereços criada pelo setor de dados. | |||
Ao realizar a busca de endereços por CEP, caso o mesmo ainda não exista na base, deverá utilizar o endpoint de | |||
“Buscar Endereço Por CEP” (/ws/endereco/cep/) realizando uma requisição POST (logradouro). | |||
[[Arquivo:Cepqa.jpg|500x500px|miniaturadaimagem|centro|Requisição via Postman]] | |||
Ao realizar a busca de endereços por Logradouro, caso o endereço não exista na base, deverá consulta o endpoint “Buscar Endereço Por Cidade ” (/ws/endereco/cidade/ ) realizando uma requisição POST. | |||
==WEBSERVICES== | ==WEBSERVICES== | ||
===Validação CREDITO_INTERNO_CREDITO_CPF em app de vendas=== | |||
Criado um endpoint que realize a viabilidade do funil que tenha a qualificação CREDITO_INTERNO_CREDITO_CPF, onde será realizado as 2 viabilidades simultaneamente (consulta de crédito interno e consulta cpf) | |||
As duas validações CREDITO_INTERNO e CREDITO_CPF serão realizadas simultaneamente pelo endpoint criado. | |||
Será necessário configurar um novo funil com a qualificação CREDITO_INTERNO_CREDITO_CPF. | |||
Na regra de movimentação de funil, este deverá seguir a mesma do CREDITO_INTERNO. | |||
Por ordem, este endpoint fará CREDITO_INTERNO e CREDITO_CPF internamente. | |||
Endpoint criado: ''comercial/prospectos/credito_interno_credito_cpf/consultar''<br> | |||
Permissão necessária ao webservice: '''CONSULTAR_CREDITOS_E_VIABILIDADE_WEBSERVICE''' | |||
==WEB== | |||
===Valor negativo na edição de um faturamento=== | |||
Na tela do cliente > aba extrato financeiro, ao editar um extrato havia a possibilidade de deixar o mesmo com valor negativo (inserindo um desconto maior que o valor do extrato). Com isso poderiam ser gerados diversos erros relacionados a fatura, NF, integrações etc. | |||
Foi inserida uma validação nessa tela para que quando o valor final for menor do que 0, não permitir ao usuário realizar essa alteração. | |||
===Salvar dados do refidelizador do contrato=== | |||
Foi criado novo atributo na TB_Contrato 'IDUsuarioFidelizacao' | |||
Será atualizado esse campo sempre que um contrato for refidelizado, seja na funcionalidade do botão “refidelizar contrato” ou nas funcionalidades | |||
automáticas de refidelização como upgrade/donwgrade, e alteração de titularidade. | |||
[[Arquivo:Refil.jpg|500x500px|miniaturadaimagem|centro|Campo do usuário refidelizador]] | |||
===Reversão de faturamentos ao cancelar fatura=== | |||
Realizada implementação para que ao cancelar uma fatura, caso algum contrato vinculado a essa fatura não possua data de UltimoFaturamento, não dar a opção ao usuário de realizar a reversão do faturamento. |
Edição atual tal como às 11h54min de 18 de dezembro de 2024
AUTENTICAÇÃO
COMERCIAL
Inclusão de campos no endpoint comercial/clientes/logar
Incluídos os campos DataCancelamento e DataHabilitacao no retorno do endpoint.
Opções de padrões de login para TV
Criadas as chaves:
$PRIMEIRO_NOME
$ULTIMO_NOME
$IDCONTRATO
Criação de novo endpoint de cartão recorrente
Desenvolvido novo endpoint /dados_cartao/recorrencia/cadastrar/externo visando maior segurança dos dados. Para mais informações consultar manual webservice.
Lentidão para atualizar planos
Desenvolvida melhoria para otimizar atualização dos dados do plano, onde caso houvessem muitos contratos vinculados ao plano o sistema estava apresentando lentidão.
Ajuste no limite de caracteres no campo 'Descrição fiscal'
Ajuste realizado na tela das composições para que a limitação seja a mesma do banco de dados (255).
Foi alterado o funcionamento do campo número. Antes ele pesquisava sempre que havia uma alteração no campo, agora ele só pesquisa quando o campo não é focado (quando você sai do campo ou clica em outro lugar).
Arquivo do tipo ASSINATURA_CONTRATO
Exclusivamente para esse tipo de arquivo, será possível o vincular apenas um arquivo por contrato. Isso visa impedir possíveis duplicidades para casos onde o cliente poderia assinar diversas vezes antes de concluir a ação.
Field para retornar dias fidelidade
Criado field PeriodoFidelizado, o qual irá retornar a diferença em dias entre DataInicioFidelidade e DataVencimentoFidelidade.
Exemplo:
DataInicioFidelidade: 20/10/2024
DataVencimentoFidelidade: 25/10/2024
Neste caso o field irá retornar: 5
Novo tipo de arquivo para o cliente (ESTORNO)
Na tela do cliente, aba 'ARQUIVOS' criado novo tipo de arquivo com o nome ESTORNO.
Melhorias para iniciar atendimento no APP do técnico
Criado chave no módulo comercial:
VERIFICA_ASSINATURA_CONTRATO_APP_TECNICO
Chave booleana para utilização da função verificar assinatura no contrato. '0' = Não | '1' = Sim
Na tela, ao clicar em INICIAR ATIVIDADE o sistema irá validar a chave de configuração acima, se for false, manter o sistema como é atualmente. Se for true verificar se o contrato vinculado ao atendimento/OS possui atributo DataAceite preenchido. Se sim, prosseguir com o inicio da atividade normalmente, se nao, apresentar mensagem ao usuário “O contrato vinculado ao atendimento ainda não foi assinado pelo cliente, favor solicitar assinatura para prosseguir” e não permitir o inicio da atividade.
Trava será apenas para atendimentos de ativação/reativação.
Visualização de velocidade vinculado ao plano
Implementada melhoria para que seja mostrado nos APPs e central a velocidade vinculado ao plano/pacote, mesmo que o contrato possua lista de preços unitários (ou seja o mesmo plano possua várias velocidades x planos). Implementação no backend, sem necessidade de alteração nos aplicativos ou central.
FINANCEIRO
Data de pagamento Webhook Bradesco
No banco Bradesco o horário recebido no webhook segue o padrão UTC 0, tomando com o fuso horário de Brasília UTC-3, tomando como exemplo o horário informado: horario=2024-10-22T02:34:16.760Z o pagamento realmente ocorreu em 2024-10-21 as 11:34:16 (3 horas a menos). Foi implementada a regra para essa validação.
Exibição de faturas que foram negociada
Na aba das faturas de negociação, ao clicar mais detalhes poderá ser visto quais faturas foram negociadas para gerar a fatura de negociação que se encontra ativa.
Haverá a informação de IDFatura, DataVencimento, NumeroBoleto e Valor.
Inclusão do filtro 'Tipo Pessoa' para integração de faturamentos
Incluído novo campo 'Tipo Pessoa' para que possa ser filtrado em tela. Alteração feita também na rotina de integração de faturamentos, para que seja respeitado o filtro aplicado pelo usuário na tela.
Novo filtro na tela de remessa de alteração
Incluído novo filtro na tela Financeiro > Integração bancária > Gerar arquivo de remessa de alterações. Preenchimento da data de cancelamento é opcional.
INTEGRAÇÃO
Boas vindas SVA
Foi criado o atributo enviaEmail na tela Integração > Ações de integradoras SVA > Cadastro
E-mail será enviado de acordo com configuração nas chaves do módulo comercial:
ID_MODELO_EMAIL_PLAYHUB
REMETENTE_EMAIL_PLAYHUB
Ajuste em chaves da integração Telemedicina IXER
Criada chave "_SOBRENOME_COMPLETO_" onde irá retornar todos os nomes do cliente, menos o primeiro.
Exemplo: Nome do cliente: TESTE DA PARETO DESCONSIDERE
A chave irá retornar: DA PARETO DESCONSIDERE
Integração Pagamento Cartão AUTTAR
Desenvolvido APP onde o atendente poderá escolher, ao fazer o pagamento de uma fatura: CARTAO DE DÉBITO, CRÉDITO OU PIX. Logo o Adapter envia os dados do pagamento para a maquininha e a AUTTAR O retorno da validação do pagamento, seguindo o fluxo normal de pagamento.
Criadas as telas onde é possível consultar as faturas em aberto do cliente a partir da informação do documento (CPF/CNPJ), consulta realizada através de endpoint do Adapter URL.
https://[URL]/ws/financeiro/faturas/cliente/documento/{aqui CNPJ/CPF}
Ao selecionar a fatura a ser paga o sistema deve nesse momento realizar as chamadas devidas dos métodos de pagamento da GetNet conforme documentação. Somente após ocorrido o pagamento com sucesso na máquina de cartão, o App irá realizar
chamada no endpoint do Adapter de pagar fatura.
• Criado endpoint (conforme manual webservice) https://[URL]/ws/integracao/getnet/log/cadastrar para registrar, em log, os pagamentos realizados pela getnet por meio do app de pagamentos. Necessário a permissao:
REALIZAR PAGAMENTO VIA GETNET ECOMMERCE (WEBSERVICE) - WS55
• Inserido a opção de pagamento por pix, na mesmo tela onde retorna a opção de crédito e débito. Ao escolher opção pix deve seguir o fluxo atual da central/app cliente, ou seja, gerar o QRCode para pagamento da fatura.
• Na tela onde são listadas as faturas disponíveis para pagamento,criado a opção para que o usuário tenha mais informações sobre a fatura. É possível ver qual/quais contratos estão vinculados a essa fatura, e também mostrar o endereço vinculado a cada contrato.
Envio de movimentação ao SAP - App técnico
Realizado ajuste para que seja enviada a movimentação para o SAP mesmo que o fechamento escolhido seja IsReagendamento = 1. Anteriormente essa movimentação era enviada apenas quando o fechamento escolhido tivesse a flag IsSolucionado = 1.
INTRANET
ESTOQUE
Ajustes necessários para de devolução de equipamentos
Removido seção "Dados de devolução de equipamentos" da tela de análise de comissionamento(Operacional -> Análise de comissionamento) e mantido funcionalidade na tela de devolução de equipamento (Estoque -> Movimentações -> Devolução de equipamentos) nas duas telas era possível realizar a devolução podendo gerando informação duplicada. Ajustado para quando for realizado a devolução de equipamento não ter necessidade de uma analise de comissionamento prévia, isso estava gerando erro caso possuísse imagens vinculadas ao atendimento (na TB_AtendimentoDocumento).
Caso na tela de devolução NÃO seja escolha o tipo da devolução 'Não devolvido', o campo 'Data de devolução' deve ser obrigatório.
Equipamentos comodatos no APP e Central
Na tela ou APP, poderá ser feita a consulta que irá retornar os equipamentos em custódia do cliente.
OPERACIONAL
RELATÓRIOS
REDES
ROTINAS
TELEFONIA
TERCEIROS
API de endereços do Adapter
Ao realizar o cadastro de endereço para o cliente/prospecto ou verificação de disponibilidade da fibra (Comercial -> Verificar disponibilidade da fibra), caso o endereço não seja encontrado na base do Adapter, o sistema irá buscar na API de endereços criada pelo setor de dados.
Ao realizar a busca de endereços por CEP, caso o mesmo ainda não exista na base, deverá utilizar o endpoint de “Buscar Endereço Por CEP” (/ws/endereco/cep/) realizando uma requisição POST (logradouro).
Ao realizar a busca de endereços por Logradouro, caso o endereço não exista na base, deverá consulta o endpoint “Buscar Endereço Por Cidade ” (/ws/endereco/cidade/ ) realizando uma requisição POST.
WEBSERVICES
Validação CREDITO_INTERNO_CREDITO_CPF em app de vendas
Criado um endpoint que realize a viabilidade do funil que tenha a qualificação CREDITO_INTERNO_CREDITO_CPF, onde será realizado as 2 viabilidades simultaneamente (consulta de crédito interno e consulta cpf) As duas validações CREDITO_INTERNO e CREDITO_CPF serão realizadas simultaneamente pelo endpoint criado.
Será necessário configurar um novo funil com a qualificação CREDITO_INTERNO_CREDITO_CPF. Na regra de movimentação de funil, este deverá seguir a mesma do CREDITO_INTERNO. Por ordem, este endpoint fará CREDITO_INTERNO e CREDITO_CPF internamente.
Endpoint criado: comercial/prospectos/credito_interno_credito_cpf/consultar
Permissão necessária ao webservice: CONSULTAR_CREDITOS_E_VIABILIDADE_WEBSERVICE
WEB
Valor negativo na edição de um faturamento
Na tela do cliente > aba extrato financeiro, ao editar um extrato havia a possibilidade de deixar o mesmo com valor negativo (inserindo um desconto maior que o valor do extrato). Com isso poderiam ser gerados diversos erros relacionados a fatura, NF, integrações etc.
Foi inserida uma validação nessa tela para que quando o valor final for menor do que 0, não permitir ao usuário realizar essa alteração.
Salvar dados do refidelizador do contrato
Foi criado novo atributo na TB_Contrato 'IDUsuarioFidelizacao' Será atualizado esse campo sempre que um contrato for refidelizado, seja na funcionalidade do botão “refidelizar contrato” ou nas funcionalidades automáticas de refidelização como upgrade/donwgrade, e alteração de titularidade.
Reversão de faturamentos ao cancelar fatura
Realizada implementação para que ao cancelar uma fatura, caso algum contrato vinculado a essa fatura não possua data de UltimoFaturamento, não dar a opção ao usuário de realizar a reversão do faturamento.