Março/Abril 2025

AUTENTICAÇÃO

Cadastro de usuários - Contas financeiras

Alterada tela de cadastro de usuários, para que em usuários do tipo 'Vendedor' seja possível atribuir as contas financeiras.

COMERCIAL

Criação de fields de endereço

Criados fields referenciaEndereco e condominioEndereco

Obs: implementados os novos fields apenas para MODELO DE CONTRATO.

Distribuição de descontos no pacote

Na TB_DescontoPacotePlano foi criado atributo PercentualPacote. Ao editar/cadastrar pacote na tela Comercial > Tabelas de apoio > Pacotes de plano, será mostrado o percentual de cada plano dentro do pacote. Será levado em conta o valor do plano - desconto aplicado no pacote.

Exemplo prático:

Pacote possui dois planos:

Plano 1 no valor de R$ 99,90 + desconto de R$ 19,90

Plano 2 no valor de R$ 69,90 + desconto de R$ 10,00

Logo o cálculo para calcular o percentual de cada plano dentro do pacote irá retornar:

Plano 1 - Valor dentro do pacote: R$ 80,00 - Percentual no pacote: 57.18%

Plano 2 - Valor dentro do pacote: R$ 59,90 - Percentual no pacote: 42.82%

Tela de cadastro irá informar o percentual de cada plano dentro do pacote

Após o cadastro quando posteriormente um promoção for vinculada aos contratos do pacote, a distribuição dos percentuais da promoção será igual ao percentual do plano dentro do pacote.

Ou seja, em um exemplo de promoção de R$ 30,00 seria aplicado:

No plano 1 um desconto de R$ 17,15
No plano 2 um desconto de R$ 12,85

O proporcional aplicado nas promoções será feito desde que a chave APLICA_VALOR_PROPORCIONAL_PROMOCAO_PACOTE (Comercial) seja = 1. Caso contrário seguirá o funcionamento normal.

Chave de configuração para que o sistema calcule os proporcionais ao aplicar promoção.

Obs: será considerada a configuração da chave no momento que a promoção é vinculada ao contrato.

Novas permissões criadas para os perfis

Foram criadas novas permissões para bloqueio visual de alguns dados dos clientes/contratos:

VISUALIZAR DADOS DE CONTATO DO CLIENTE

VISUALIZAR CONTRATOS DE TELEFONIA

VISUALIZAR PROMOCOES DE CONTRATOS CONTRATOS

VISUALIZAR NOME DO CLIENTE

VISUALIZAR CONTRATOS DE INTERNET

VISUALIZAR DADOS CONTRATOS

VISUALIZAR CONTRATOS DE OUTRAS TECNOLOGIAS

VISUALIZAR CONTRATOS DE TV

VISUALIZAR DADOS DE COBRANCAS E FISCAIS

VISUALIZAR DOCUMENTOS DO CLIENTE

VISUALIZAR HISTORICO DE CONTRATOS

Exemplo de dados do cliente caso usuário não possua permissão para visualizar

Mais dados mascarados do cliente

Caso perfil não possua permissão relacionada a visualização de contratos por tecnologia, ao clicar no contrato será exibido o modal 'Você não possui permissão para visualizar os dados desse contrato.'.

Modal exibido caso usuário não possua permissão para a tecnologia do contrato

Obs: Em ambiente de produção todos os perfis terão essas permissões, ficando a critério dos Key Users remover a permissão caso necessário.

Validação de dados salvos na TB_DadosRedeContrato - Trial

Inserida validação de dados salvos na TB_DadosRedeContrato (IDVelocidadePersonalizadaConexãoRadius, DataInicioPersonalizacao e DataFimPersonalizacao ) ao aplicar trial de velocidade no contrato antes de encaminhar ação no radius.

Desconto por pagamento antecipado

Criada chave no módulo comercial: VALIDA_DESCONTO_PAGAMENTO_ANTECIPADO_UP_DOWN

No momento do upgrade/downgrade será validada a configuração da chave.

False: sistema irá permitir que o usuário realize o up/down de um plano que possua desconto antecipado para um que não possua e vice e versa, ou seja, manter o funcionamento atual.

True: o sistema ao selecionar planos para up/down com a configuração diferente o sistema irá imprimir mensagem ao usuário: "o plano selecionado possui/não possui desconto antecipado, a ação não pode ser concluída." O Up/Down poderá ocorrer quando ambos os planos (atual e novo) da ação possuírem a mesma configuração no campo DescontoPagamento da TB_Plano.

Nova chave que irá validar configuração do plano

FINANCEIRO

Alterações na spuBuscaFaturamentosPendentesIntegracao

SpuBuscaFaturamentosPendentesIntegracao e rotina de integração de faturamentos foram ajustadas para que retorne dados corretos na tela de acordo com filtro utilizado pelo usuário.

Negociação com vencimento atual

Ao realizar negociação e escolher o vencimento da fatura para a data atual, será possível desde que:

Chave criada "PERMITE_DATA_PRIMEIRA_PARCELA_NEGOCIACAO_SEM_REGRA" esteja = 1.

Chave de configuração no módulo comercial

Usuário possua a permissão "NEGOCIAR COM VENCIMENTO LIVRE - ID23"

Configuração da permissão no perfil

Renegociação de faturas que possuam pagamento

Situação onde o cliente realizava uma negociação, fazia o pagamento de uma ou mais parcelas, mas posteriormente fazia uma renegociação dos valores restantes, o sistema realizava o cancelamento desses boletos com pagamento.
Foi alterado para que nesse caso, os boletos que possuam pagamento terão o seu status alterado para RENEGOCIADA. A fatura não será cancelada.

Regra na spuGeraCobrancaCartaoRecorrente

Alterada lógica na spu para que valide também se a fatura está cancelada ou não (anteriormente validando apenas se extratos estão cancelados). Isso possibilitava gerar cobrança de faturas que foram negociadas.

ROTINAS

Rotina de envio de SMS - Novo parâmetro

Criado na rotina de envio de fatura por SMS, um parâmetro no conf para que sejam configuradas quais formas de cobranças devem ser consideradas.

Configuração no conf deve seguir o seguinte formato:

idsFormaCobrancaFatura=2,1,171

Rotinas de consulta e cancelamento de nota DFe - Ajuste na consulta

Ao encaminhar nota para ser cancelada na plataforma do DFE estava sendo encaminhado no JSON o campo numeroNfe sendo o "NumeroNF" da TB_Nota, em verificação com a plataforma deveria ser encaminhado o "numeroNfe" que está na plataforma (presente no endpoint de consulta, porém atualmente não salvamos a informação no adapter) e não o do Adapter.

Ajustes realizados nas duas rotinas citadas.

Rotina de suspensão/habilitação - Tipo pessoa

Ajustada a spu que é lida pela rotina (spuHabilitacaoSuspensaoContrato), para que siga regra de acordo com o tipo pessoa do cliente.

Campo criado na tela Comercial > Tabelas de apoio > Configuração de suspensão
Campo não obrigatório.

Ajuste na consulta da rotina de controle geração carnê

Ajustado .jar da rotina para ler o index IDX_IsCancelado.

Rotina de gerar faturamento - spuAjusteDesconto

Realizado ajuste na rotina que gera faturamento, para que ajuste o desconto aplicado nos faturamentos caso necessário. Será chamado esse ajuste caso a chave EXECUTA_SPU_AJUSTE_DESCONTO_APOS_FATURAMENTO seja = 1.

APLICATIVOS

APP do cliente - Ajuste para cartão de recorrência seja vinculado a todos os contratos do pacote

No APP do cliente havia possibilidade de alterar a forma de cobrança de apenas um dos contratos do pacote. Isso é feito abrindo o app, escolhendo o contrato > clicar no botão 'Dados de pagamento' > Cadastrar recorrência.

Tela onde apenas um dos contratos do pacote eram alterados

Com isso contratos do mesmo pacote poderiam ficar com forma de cobrança diferentes.

Alterado para que na tela informada acima, quando o contrato escolhido pertencer a um pacote devem ser feitas as alterações em todos os contratos do pacote (a exemplo do que acontece na central do assinante).

APP de vendas - Integração CLEAR SALE

Implementado fluxo da integração clear sale no APP, conforme funcionamento da tela do Adapter. Anteriormente caso prospecto chegasse ao funil de qualificação onde era enviado token ao cliente, não havia tela para ser inserido esse token.

Tela criada para que seja inserido o token enviado pela plataforma

APP de vendas - Permissão para buscar clientes

Inserida validação da permissão "VISUALIZAR CLIENTE - CL02", para que usuários que pertençam a perfil que não tem essa permissão, não possam visualizar os clientes no APP.

Caso não tenha essa permissão o botão 'Buscar clientes' ficará bloqueado.

APP vendas - Botão que passará a validar a permissão

API's

Para mais informações solicitar manual WEBSERVICE

API de faturas por data de vencimento e forma de cobrança

Endpoint criado: /ws/financeiro/faturas/formas_cobranca/vencimento

Exemplo de body:

{

"dataVencimentoInicial":"01-02-2025",
"dataVencimentoFinal":"02-05-2025",
"idsFormaCobranca": [3]

}

API para busca de dados do atendimento

Foi retirada obrigatoriedade do campo IDClassificacaoEndereco na API /ws/comercial/atendimentos/{id}

API de busca de fatura por documento

Incrementado no retorno da api /ws/financeiro/faturas/{documento}/todas, a informação do IDFormaCobranca que a fatura pertence

API para consulta de faturas por ID

Endpoint criado: /ws/financeiro/faturas/{idfatura}

Exemplo de retorno com sucesso da API