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%
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.
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
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.'.
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.
Alteração em pacotes
Criada chave no módulo comercial PERMITE_ALTERACOES_INDIVIDUAIS_CONTRATOS_PACOTE.
TRUE (1): manterá o sistema como é atualmente, exibindo opções de UPGRADE/DOWNGRADE, ALTERAR TITULARIDADE e MIGRAR TECNOLOGIA individualmente por contrato do pacote.
FALSE (0): Ao clicar nos botões UPGRADE/DOWNGRADE e MIGRAR TECNOLOGIA, irá apresentar a seguinte mensagem ao usuário: A alteração não pode ser realizada, necessário desmontar o pacote para alteração".
ALTERAR TITULARIDADE: Será informado ao usuário que a ação será realizada para todos os planos do pacote e seguir com a alteração.
Criada nova opção em contratos chamada "ALTERAR PACOTE". Botão ficará disponível caso a chave PERMITE_ALTERAR_PACOTE seja = 1.
Ao clicar no botão será exibida lista de PACOTES disponíveis de acordo com as pré-validações existentes.
Nessa tela também deverá ser selecionado o planejamento tributário vinculado aos planos. Caso plano não utilize planejamento tributário será vinculada a composição configurada.
Ao salvar a alteração, todos os contratos do pacote anterior serão ser cancelados e cadastrados todos os novos contratos do novo pacote, semelhante ao que ocorre com os planos individuais.
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.
Usuário possua a permissão "NEGOCIAR COM VENCIMENTO LIVRE - ID23"
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.
Histórico de pagamento da fatura
Ao clicar em histórico de pagamento da fatura, ficará disponível na tela a forma de pagamento que foi utilizada para realizar a baixa. Caso não exista esse campo (IDFormaPagamento na TB_Fatura), o campo ficará em branco na tela.
Criação webhook sicoob API pix
URL: ws/financeiro/webhook/sicoob/pagamento/pix
Desenvolvido conforme documentação do banco Sicoob.
INTEGRAÇÃO
Integração INT6 Provisionamento
Foi desenvolvido uma nova integração de provisionamento INT6. Criado no sistema um novo tipo de integração no sistema referenciando a nova tabela criada TB_ProvisionamentoIntegradora para possibilitar a integração. Foi implementado ao sistema o endpoint /api/circuit/v1/create_update para integração com a plataforma INT6
Devido o conteudo do json encaminhado na requisição do endpoint implementado ser dinâmico, foram criados três ações para esse tipo de integração: ALTERAR_CONTRATO_PROVISIONAMENTO, ALTERAR_CONTRATO_CANCELAR_PROVISIONAMENTO e ALTERAR_CONTRATO_SALVAR_PROVISIONAMENTO.
Regra de negócio : Ativando a integração
Após configurado devidamente o servidor de integração e urls necessários para a integração (consulte configuração previa), será necessário vincular a integradora de provisionamento na configuração do plano na aba "Internet"
Após vinculado a integradora de provisionamento ao contrato, ao habilitar um contrato de internet no sistema, será chamada a integração com a plataforma encaminhando a ação ALTERAR_CONTRATO_PROVISIONAMENTO juntamente com o json os dados :
{
"circuit_id_integration": "xxxxx",(IDCONTRATO)
"subscriber_id": "xxxx", (IDCLIENTE)
"subscriber_name": "TESTE CLIENTE",
"contract_id": "xxxx",(IDCLIENTE)
"contract_service_id": "xxxxx",( IDCONTRATO)
"install_addr": "ENDEREÇO CLIENTE, 2000",
"install_addr_city": "CIDADE CLIENTE",
"install_addr_state": "ESTADO CLIENTE",
"install_addr_zip_code": "CEP CLIENTE ",
"pppoe_username": "pppoe_cliente",
"pppoe_password": "pass_pppoe_cliente",
"status": "active",
"service_id": "6506",(IDPLANO)
"service_name": "MEU PLANO",( DESCRIÇÃO_PLANO)
"updated_at": "2025-02-13 22:28:29",(DATA ULTIMA ATUALIZAÇÃO)
"created_at": "2025-02-13 22:27:21"(DATA DE CADASTRO CONTRATO)
}
Todas as interações com a plataforma da INT6 serão salvas na TB_LogProvisionamento e os contratos encaminhados para provisionamento permanecendo salvos na TB_ContratoProvisionamento ambas pertencentes ao modulo integração.
Upgrade/Downgrade e Alteração de Titularidade
Ao realizar upgrade/downgrade ou alteração de titularidade será encaminhado a plataforma a ação ALTERAR CONTRATO CANCELAR PROVISIONAMENTO (CREATE_UPDATE) contendo no json a informação para qual contrato será migrado (transferred_to) e alterando o status para deactivated como mostra abaixo:
{
"circuit_id_integration": "id_contrato",
"subscriber_id": "id_cliente",
"subscriber_name": "nome_cliente",
"contract_id": "id_cliente",
"contract_service_id": "id_contrato",
"install_addr": "meu_endereco",
"install_addr_city": "minha_cidade",
"install_addr_state": "meu_estado",
"install_addr_zip_code": "meu_cep",
"pppoe_username": "meu_pppoe",
"pppoe_password": "meu_pass_pppoe",
"status": "deactivated",
"service_id": "5295",
"service_name": "COMBO +",
"updated_at": "2025-03-19 17:13:05",
"created_at": "2020-02-12 12:11:11",
"transferred_to": "id_novo_contrato"
}
Em seguida será encaminhado a ação ALTERAR CONTRATO SALVAR NOVO PROVISIONAMENTO ativando o novo contrato na plataforma da INT6:
{ "circuit_id_integration": "novo_id_contrato", "subscriber_id": "id_cliente", "subscriber_name": "nome_cliente_ou_novo_titular", "contract_id": "id_cliente",
"contract_service_id":"novo_id_contrato",
"install_addr": "meu_endereco",
"install_addr_city": "minha_cidade",
"install_addr_state": "meu_estado",
"install_addr_zip_code": "meu_cep",
"pppoe_username": "meu_pppoe",
"pppoe_password": "meu_pass_pppoe",
"status": "active",
"service_id": "5295",
"service_name": "COMBO +",
"updated_at": "2020-02-17 12:18:05",
"created_at": "2020-02-12 12:11:11",
"transferred_from": "id_contrato_origem"
}
Ao ocorre alterações de status do contrato no sistema como CANCELADO, SUSPENSO, SUSPENSO PARCIALMENTE, INATIVO TEMPORARIAMENTE, HABILITADO EM CONFIANÇA e HABILITADO será encaminhado a ação ALTERAR CONTRATO PROVISIONAMENTO (CREATE_UPDATE) para plataforma alternado somente os campos updated_at e status no json encaminhado, podemos assumir valores active, deactivated, blocked e reduced_speed.
Ao realizar uma atualização de endereço do contrato tambem será encaminhado a ação de ALTERAR CONTRATO PROVISIONAMENTO (CREATE_UPDATE) atualizando as informações de endereço na plataforma INT6 como mostra abaixo:
{
"circuit_id_integration": "id_contrato",
"subscriber_id": "id_cliente",
"subscriber_name": "nome_cliente",
"contract_id": "id_cliente",
"contract_service_id": "id_contrato",
"install_addr": "meu_novo_endereco",
"install_addr_city": "minha_nova_cidade",
"install_addr_state": "meu_novo_estado",
"install_addr_zip_code": "meu_novo_cep",
"pppoe_username": "meu_pppoe",
"pppoe_password": "meu_pass_pppoe",
"status": "deactivated",
"service_id": "5295",
"service_name": "COMBO +",
"updated_at": "data_atualizacao",
"created_at": "2020-02-12 12:11:11"
}
INTRANET
ESTOQUE
OPERACIONAL
RELATÓRIOS
REDES
Cadastro de Pool Concentrador
Retirada obrigatoriedade de preenchimento da cidade na tela Rdes > Controle de IP > Cadastro.
Criado novo TIPO IP 'POOL'.
Ao selecionar o novo tipo POOL, o campo IP será um texto livre.
Ao selecionar o novo tipo POOL, será permitido ao usuário vincular atributos pré-cadastrados.
Sistema irá permitir vincular o IP do tipo POOL a vários contratos, semelhante ao que é feito atualmente no tipo PERSONALIZADO.
O novo tipo de IP, assim como os novos atributos fixos deverão ser refletidos nas variáveis disponíveis para integração radius existentes:
$IP
$ATTRIBUTE_IP
Atualizações em atendimentos por massiva
Foi adicionado ComboBox para seleção de caixas na abertura de atendimentos de manutenção simples;
Retirado a obrigatoriedade da informação de entrada da caixa na abertura de manutenção simples;
Ajustado label em incidentes para Incidente/Manutenção;
Criado para o tipo de manutenção incidentes a possibilidade de seleção de poncard, porta poncard, portaDIO, entrada e saída da caixa;
Adicionado a possibilidade de fechamento do atendimento logo após abertura (antes ocorria a atualização do atendimento e retornava para a tela de atendimentos de manutenção);
Ao cadastrar um atendimento de manutenção do tipo incidente com status PENDENTE, quando atualizado os clientes afetados na área de manutenção será exibida uma mensagem na tela de cadastro do cliente informando que o cliente possui contratos em área de falha massiva;
Criado novo tipo de envio sms ATENDIMENTO_MASSIVA para que seja encaminhado aos clientes que estão em região de falha (criada chave no modulo comercial 'ID_MODELO_SMS_COMUNICAO_MASSIVA').
Adicionado as novas variáveis $titulo_manutencao$ e $previsao_solucao$ para uso no contexto da mensagem de massiva. Ao salvar um atendimento do tipo incidente será encaminhado automaticamente a mensagem SMS para todos os cliente pertencentes a área de manutenção que foram afetados;
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.
TELEFONIA
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.
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.
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.
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}
