Maio/Junho 2024: mudanças entre as edições
(16 revisões intermediárias pelo mesmo usuário não estão sendo mostradas) | |||
Linha 12: | Linha 12: | ||
==TERCEIROS== | ==TERCEIROS== | ||
===Caracteres especiais no cadastro de bairros=== | |||
Ao cadastrar bairros com caracteres especiais, poderia acarretar erros em algumas integrações, foi restringido cadastro de bairro com caracteres especiais. | |||
==COMERCIAL== | ==COMERCIAL== | ||
Linha 129: | Linha 133: | ||
''*Para mais informações solicitar manual do WebService'' | ''*Para mais informações solicitar manual do WebService'' | ||
===Alteração na API,endpontoint consulta dados por CPF=== | |||
Foi adicionado no retorno do endpoint de "busca dados gerais dos contratos ativos e faturas de um cliente" (''/ws/comercial/cliente/dados?dataInicioVencFatura=30-10-2024&dataFimVencFatura=30-10-2024'') informações de e-mail e endereços de contratos. | |||
<pre> | |||
{ | |||
... | |||
"Email": "meu_email@adaptersolucoes.com", | |||
... | |||
"Contratos": [ | |||
{ | |||
... | |||
"Enderecos": [ | |||
{ | |||
"Logradouro": "meu_logradouro", | |||
"UF": "uf", | |||
"Numero": numero_logr, | |||
"Tipo": "PADRAO", | |||
"Complemento": null, | |||
"Condominio": null, | |||
"Referencia": null, | |||
"Bairro": "meu_bairro", | |||
"Cidade": "minha_cidade", | |||
"CEP": "meu_cep" | |||
} | |||
], | |||
... | |||
} | |||
], | |||
... | |||
} | |||
</pre> | |||
OBS: Para mais informações solicitar manual do WebService. | |||
===Criação de novo de field para modelo de e-mail=== | |||
Criado nova chave ''$idContrato$'' para utilização em modelos de e-mail. | |||
==FINANCEIRO== | ==FINANCEIRO== | ||
Linha 233: | Linha 277: | ||
Para gerar a cobrança/faturamento do item/equipamento vendido, será necessária a utilização da chave ID_SERVICO_EQUIPAMENTO_VENDIDO na qual se referenciará a um serviço previamente cadastrado que seja do tipo Dinâmico (no qual o valor real será buscado da integração com SAP) | Para gerar a cobrança/faturamento do item/equipamento vendido, será necessária a utilização da chave ID_SERVICO_EQUIPAMENTO_VENDIDO na qual se referenciará a um serviço previamente cadastrado que seja do tipo Dinâmico (no qual o valor real será buscado da integração com SAP) | ||
[[Arquivo:Venda servico.png| | [[Arquivo:Venda servico.png|500x500px|miniaturadaimagem|centro|Serviço dinâmico vinculado]] | ||
Ao realizar a movimentação de um equipamento estando marcado como venda no fechamento do atendimento, o sistema criará um registro na TB_CobrancaVisitaTecnica (caso chave NECESSITA_CONFIRMACAO_COBRANCAS_VISITA_TECNICA = 1) onde a cobrança ficará disponível para analise futura em (''Financeiro -> Faturamento-> Cobranças adicionais''). Caso a chave NECESSITA_CONFIRMACAO_COBRANCAS_VISITA_TECNICA =0 , será lançado o faturamento do serviço vinculado a cobrança (TB_FaturamentoServico) e será lançado também o registro do equipamento vendido na TB_EquipamentoVendido. Adicionados os campos ItemCodeSap e IDTecnicoAtendimento (TB_EquipamentoVendido) para possibilitar a funcionalidade. | Ao realizar a movimentação de um equipamento estando marcado como venda no fechamento do atendimento, o sistema criará um registro na TB_CobrancaVisitaTecnica (caso chave NECESSITA_CONFIRMACAO_COBRANCAS_VISITA_TECNICA = 1) onde a cobrança ficará disponível para analise futura em (''Financeiro -> Faturamento-> Cobranças adicionais''). Caso a chave NECESSITA_CONFIRMACAO_COBRANCAS_VISITA_TECNICA =0 , será lançado o faturamento do serviço vinculado a cobrança (TB_FaturamentoServico) e será lançado também o registro do equipamento vendido na TB_EquipamentoVendido. Adicionados os campos ItemCodeSap e IDTecnicoAtendimento (TB_EquipamentoVendido) para possibilitar a funcionalidade. | ||
Ao realizar a integração do faturamento referente ao equipamento vendido, serão encaminhados os novos campos | Ao realizar a integração do faturamento referente ao equipamento vendido, serão encaminhados os novos campos na integração, como mostra a seguir: | ||
<pre> | <pre> | ||
Linha 256: | Linha 300: | ||
</pre> | </pre> | ||
===Registro de requisições de Webhook bancário=== | |||
Criado uma nova tabela (TB_RetornoWebhook), para registro de notificações de pagamento bancárias visando facilitar a consulta/tratativa de erros. | |||
===VAN Bancária=== | |||
Implementado VAN bancaria onde ocorrerá a troca de arquivos retorno/remessa de forma automática. | |||
Criado rotina de processamento automático de retorno, adicionado ao sistema a permissão PROCESSAR_RETORNO_WEBSERVICE (WS56) e o endpoint ''ws/financeiro/processar/retorno'' (interno) para permitir a funcionalidade através de requisição POST. | |||
Ao executar a rotina o comportamento de baixas será o mesmo como já ocorre manualmente no sistema. Após processado o retorno o mesmo será encaminhado para o diretório de arquivos processados. | |||
Devem ser configurados previamente alguns parâmetros como ID de forma de cobrança e caminho onde onde os arquivos de retorno se encontram , consulte configuração previa. Arquivos de mais de uma forma de cobrança podemos ser adicionados no msm diretório desde que sejam do mesmo banco e mesmo CNAB. Arquivos de formas de cobrança com CNAB e bancos distintos precisam ser configurados e diretórios separados, consulte configuração previa. | |||
Para conferencia foram adicionado os relatórios: | |||
FATURAMENTO - Controle Processamento Arquivo Retorno (Analítico); | |||
FATURAMENTO - Controle Processamento Arquivo Retorno (Sintético) | |||
OBS: Consulte com seu banco configuração previa sobre o funcionalidade de transmissão automática de arquivos | |||
===Novo filtro de faturas a negociar por contrato=== | |||
Adicionado novo filtro de busca de faturas por contrato no modal ''"Faturas vencidas sem pagamento"'' de faturas a negociar (''Financeiro -> Inadimplência -> Negociar''). | |||
[[Arquivo:Filtra contrato negociar00.png|600x600px|miniaturadaimagem|centro|Faturas vencidas sem pagamento]] | |||
==INTRANET== | ==INTRANET== | ||
Linha 266: | Linha 340: | ||
===Movimentação Equipamento imobilizado=== | |||
Criado chave ID_CLIENTE_EQUIPAMENTO_IMOBILIZADO (modulo de estoque) para utilização em atendimentos com equipamento imobilizado. | |||
Para tal cliente indicado na chave, não haverá faturamento, mesmo que haja serviços adicionais, visando apenas a movimentação de equipamentos perante ao SAP e será valido para atendimentos de instalacao, retirada e suporte. | |||
Ao realizar a integração/movimentação de estoque pelo endpoint /api/Operacao/FechamentoOS?Tecnico=<depositoTecnico> | |||
serão encaminhados os campos abaixo: | |||
<pre> | |||
{ | |||
... | |||
"DocumentLines": [ | |||
{ | |||
... | |||
} | |||
], | |||
"ProjectCode": "referencia_endereco", | |||
"ProjectName": "endereco", | |||
"ProjectType": "1" | |||
... | |||
} | |||
</pre> | |||
Caso o fechamento do atendimento não seja para o cliente referenciado na chave será encaminhado ao campo "ProjectType": "2". | |||
==OPERACIONAL== | ==OPERACIONAL== | ||
===Permitir o reagendamento / agendamento de OS's por meio de endpoint=== | |||
Criado novo endpoint ''ws/servicos/agendamento/agenda_tecnica/configuracoes/integrado_efetivar'' possibilitando o agendamento (caso ainda não exista) e reagendamento através de canais digitais através do método PUT encaminhando os seguintes parâmetros : | |||
<pre> | |||
{ | |||
"IDAtendimento": "1", | |||
"DataAgendamento": "01/10/2024", | |||
"HoraAgendamento": "08:00-12:00" | |||
} | |||
</pre> | |||
OBS: Agendamento/Reagendamento ocorrerá de acordo com agenda técnica do sistema, em casos de integração com OFS (agenda técnica integrada), será realizado o agendamento/ reagendamento conforme disponibilidade na plataforma OFS. Em caso de duvidas, consulte/solicite o manual do webserver. | |||
==REDES== | ==REDES== | ||
Linha 454: | Linha 562: | ||
OBS: Para utilização da integração com a plataforma Ixer , devem estar cadastrados previamente os servidores de integração, URL's, Integradoras, etc. Consulte configuração previa caso necessário. | OBS: Para utilização da integração com a plataforma Ixer , devem estar cadastrados previamente os servidores de integração, URL's, Integradoras, etc. Consulte configuração previa caso necessário. | ||
===Melhoria na tela de logs remessa eletronica=== | |||
Adicionado o retomo da requisição de cadastro da remessa eletrônica (juntamente com o body) na tela de log de remessa eletrônica (''Modulo integração -> Faturamento -> Logs de remessa eletrônica'') | |||
Conteúdo do modal: | |||
<pre> | |||
Body: | |||
{ | |||
... | |||
"DADOS ENVIADOS":"DADOS ENVIADOS" | |||
... | |||
} | |||
Resposta: | |||
{erro={errorMessage=RETORNO DA API, statusHttp=400.0}, url=https://URL_BANCO/registrar-boleto, status=400} | |||
</pre> | |||
Quando não tiver resposta da API o modal só irá mostra o Body, quando não tiver nenhum dos dois não irá mostra ícone [[Arquivo:Icone mais.png|100x100px|miniaturadaimagem|nenhum]] | |||
. | |||
==MIGRAÇÃO== | ==MIGRAÇÃO== | ||
==APLICATIVOS== | ==APLICATIVOS== |
Edição atual tal como às 18h27min de 22 de outubro de 2024
AUTENTICAÇÃO
Vínculo de tipo contrato x usuário
Criado vínculo de segmentos de contrato na tela de cadastro do usuário. Na venda de um contrato diretamente na tela de um cliente já criado, ao selecionar o campo 'Tipo do contrato' irão retornar os tipos vinculados ao usuário na tela de cadastro do mesmo. Lembrando que esse campo no usuário será mostrado caso o mesmo seja vendedor.
Relacionamento no banco de dados é feito na TB_UsuarioSegmentoContrato
TERCEIROS
Caracteres especiais no cadastro de bairros
Ao cadastrar bairros com caracteres especiais, poderia acarretar erros em algumas integrações, foi restringido cadastro de bairro com caracteres especiais.
COMERCIAL
Novos tipos de aceite para contrato
Desenvolvido tipos de aceite de contrato para serem evidenciados no contrato de forma manual,criado chave no modulo comercial UTILIZA_TIPO_ACEITE_CONTRATO (status 0 ou 1) para utilização da funcionalidade.
Ao clicar em +Adicionar Aceite serão exibidos no combo-box os tipos de aceite cadastrados e o campo para seleção de data do aceite, caso o tipo de aceite seja cadastrado com flag PossuiCompleto marcada, um novo campo de texto livre também será apresentado.O vinculo dos aceites ou a remoção deles no contrato são registrados no log após salvo o contrato em questão
Para a utilização dos tipos de aceites no contrato, é necessário o cadastro prévio dos tipos de aceite (em Comercial-> Tabelas de apoio -> Contratos -> Tipos de aceite), também foi criado a permissão ALTERAR TIPOS ACEITE - CN92 para criação dos tipos de aceite.
Data de aceite em modelos de contrato
Criado field dataAceite para ser utilizado em modelos de contrato, trazendo assim a data que o contrato aceitado pelo cliente (ou de forma automática caso a empresa não faça uso do aceite).
Obs: necessário ajuste no layout de contratos
Obrigatoriedade do campo RG no cliente/prospecto
No cadastro de novo cliente/prospecto, ao marcar a flag CNI (Carteira nacional de identidade) o campo RG não ficará disponível para ser preenchido. Caso queira preencher basta não marcar essa flag.
Endpoint para redefinir senha do cliente
Criado um novo endpoint para redefinir senha do cliente
URL: https://[URL]/ws/comercial/redefinir_senha_novo
Método: POST
Header: Token, Authorization Basic
Envio: {
"usuario": "12312312312", "senhaAntiga" : "2", "novaSenha" : "23"
}
- Para mais informações solicitar manual do WebService
Ajuste ao salvar arquivos de prospecto
Realizado ajuste para evitar erros ao salvar arquivos de prospecto provenientes de processo indevido do usuário.
Realizado ajuste no módulo WEB
Login RADIUS - Chave vinculada a empresa
Foi criada a chave $DOMINIO_EMPRESA$ para geração automática de login. A mesma pode ser vinculada ao plano na seguinte tela:
O nome do novo campo na TB_Empresa é DominioRadius.
Retornar novos campos no endpoint
Incluídos novos campos de referência e condomínio no retorno do endpoint: ws/comercial/cliente/dados
- Para mais informações solicitar manual do WebService
Pesquisa na tela de Lista de preços unitários de planos
Foi implementado campo de pesquisa para que o usuário possa filtrar os planos na tela.
Alteração no endpoint de atualização de dados do cliente
Alterado endpoint de atualização para permitir atualização de mais dados.
ws/comercial/clientes/atualizar
Os novos campos não são obrigatórios.
- Para mais informações solicitar manual do WebService.
Nova permissão para agendar cancelamento de contratos
AGENDAR CANCELAMENTO CONTRATOS - CN93
Pesquisa de satisfação - APP do cliente
No APP o cliente poderá avaliar um atendimento que gerou visita. Atendimento estará disponível para ser avaliado enquanto não estiver ultrapassado o número de dias configurado na chave DIAS_PESQUISA_ATENDIMENTO, desde a DataFimVisita.
Exemplo: Se um atendimento foi fechado no dia 15/07/2024 e a chave estiver configurada como 2 dias. Esse atendimento estará disponível para ser avaliado em até 2 dias contando a partir da data do fim da visita. O APP irá disponibilizar para avaliação atendimentos em que o campo GerouVisita = 1, e que não possuam na TB_InformacaoAdicionalAtendimento o campo PontuacaoTecnico preenchido.
Visão da avaliação do cliente poderá ser feita através dos relatórios:
ATENDIMENTOS - Controle Interno de OSs
ATENDIMENTOS - Relatorio de Atendimento Geral
Endpoint para retornar dados do prospecto atráves do CPF/CNPJ
https://[URL]/ws/comercial/prospectos/cpfcnpj/{cpf/cnpj})
*Para mais informações solicitar manual do WebService
Alteração na API,endpontoint consulta dados por CPF
Foi adicionado no retorno do endpoint de "busca dados gerais dos contratos ativos e faturas de um cliente" (/ws/comercial/cliente/dados?dataInicioVencFatura=30-10-2024&dataFimVencFatura=30-10-2024) informações de e-mail e endereços de contratos.
{ ... "Email": "meu_email@adaptersolucoes.com", ... "Contratos": [ { ... "Enderecos": [ { "Logradouro": "meu_logradouro", "UF": "uf", "Numero": numero_logr, "Tipo": "PADRAO", "Complemento": null, "Condominio": null, "Referencia": null, "Bairro": "meu_bairro", "Cidade": "minha_cidade", "CEP": "meu_cep" } ], ... } ], ... }
OBS: Para mais informações solicitar manual do WebService.
Criação de novo de field para modelo de e-mail
Criado nova chave $idContrato$ para utilização em modelos de e-mail.
FINANCEIRO
Geração de logs no servidor nas execuções de rotinas de GerarEventoFaturamento e GerarFaturamento
Adicionado logs nas rotinas de faturamento. Isso visa otimizar o processo de análise e identificação de possíveis erros. Obs: A pasta da rotina no servidor deverá ter a pasta 'logs' criada.
Botão de Gerar faturamentos de carnê
Foi alterado o funcionamento do botão 'Gerar faturamentos de carnê' na tela Cliente > Dados financeiros> Extrato financeiro. Agora o mesmo irá validar a chave no módulo financeiro (FATURAMENTO_STATUS_DIFERENCIADO), tal como é feito atualmente na geração através da execução da rotina.
Dias de faturamento referentes ao vencimento
Atualmente é permitido criar IDVencimentos diferentes, vinculados ao mesmo dia de vencimento. Exemplo:
Dia 1 (dia inicial 1 - dia final 31)
Dia 1 (dia inicial 2 - dia final 1)
Com isso em algumas telas não era possível o usuário diferenciar os vencimentos, pois era mostrado apenas o dia do vencimento. Foi ajustado para que nessas telas seja mostrado também os dias referentes a cada vencimento. Em anexo a imagem com o novo funcionamento da tela.
Foram alteradas as seguintes telas:
Financeiro > Integração bancária > Gerar arquivo de remessa
Financeiro > Faturamento > Pré faturamento
Financeiro > Faturamento > Gerar Faturas
Financeiro > Faturamento > Cobranças recorrentes de cartão de crédito
Otimização ao realizar negociação em massa
Foi substituído o método que o front-end utiliza para fazer a negociação. Foi utilizado o referente ao 'financeiro/faturas_negociar'.
Também ajustada a tela de salvar o parcelamento, para que os dados sejam mostrados corretamente mesmo que seja uma negociação com diversas faturas.
Endpoint para retornar fatura Base64
Criado o endpoint https://[URL]/ws/financeiro/fatura/{idFatura}/imprimirBase64
Esse endpoint irá retornar o Base64 do PDF da fatura.
Para mais informações solicitar manual Webservice.
Novas permissões para baixas por tipo de pagamento
Permissões criadas:
REALIZAR_BAIXA_COMPLETA_FATURAS = "CL88"
REALIZAR_BAIXA_PARCIAL_FATURAS = "CL89"
REALIZAR_BAIXA_PERDA_PDD_FATURAS = "CL90"
Venda de Equipamentos
Adicionado ao sistema a funcionalidade de venda de equipamento através do APP de Técnico. Ao realizar a movimentação de equipamento no fechamento da visita técnica, os equipamentos disponíveis para a movimentação serão exibidos através do novo endpoint incorporado (api/stock/Consulta_Stock?WhsCode={}), caso o endpoint em questão não esteja disponível, o App continuará consultando o endpoint de estoque atual como já é feito, porém sem a opção de venda.
A opção de venda do equipamento poderá ser utilizada para todos os tipo de serviço (instalação,retirada e suporte)
Ao realizar a movimentação de equipamento caso seja marcado a flag "Venda" será encaminhado na integração do estoque com o SAP o campo VendaComodato": "Y (caso flag Venda marcada) ou N"
{ ... "DocumentLines": [ { ... ... "SerialNumbers": [ { "InternalSerialNumber": "*******", "Quantity": "1" } ], "VendaComodato": "Y" }, { ... } ], ... }
OBS: para utilização da funcionalidade consulte disponibilidade em Integração com SAP.
Para gerar a cobrança/faturamento do item/equipamento vendido, será necessária a utilização da chave ID_SERVICO_EQUIPAMENTO_VENDIDO na qual se referenciará a um serviço previamente cadastrado que seja do tipo Dinâmico (no qual o valor real será buscado da integração com SAP)
Ao realizar a movimentação de um equipamento estando marcado como venda no fechamento do atendimento, o sistema criará um registro na TB_CobrancaVisitaTecnica (caso chave NECESSITA_CONFIRMACAO_COBRANCAS_VISITA_TECNICA = 1) onde a cobrança ficará disponível para analise futura em (Financeiro -> Faturamento-> Cobranças adicionais). Caso a chave NECESSITA_CONFIRMACAO_COBRANCAS_VISITA_TECNICA =0 , será lançado o faturamento do serviço vinculado a cobrança (TB_FaturamentoServico) e será lançado também o registro do equipamento vendido na TB_EquipamentoVendido. Adicionados os campos ItemCodeSap e IDTecnicoAtendimento (TB_EquipamentoVendido) para possibilitar a funcionalidade.
Ao realizar a integração do faturamento referente ao equipamento vendido, serão encaminhados os novos campos na integração, como mostra a seguir:
{ ... "VendaImobilizado": "Y", "DocumentLines": [ { ... "MAC_SERIE": "mac_equipamento_venda", "SL1Code": "id_tecnico_ou_campo_vazio" ... } ], ... }
Registro de requisições de Webhook bancário
Criado uma nova tabela (TB_RetornoWebhook), para registro de notificações de pagamento bancárias visando facilitar a consulta/tratativa de erros.
VAN Bancária
Implementado VAN bancaria onde ocorrerá a troca de arquivos retorno/remessa de forma automática.
Criado rotina de processamento automático de retorno, adicionado ao sistema a permissão PROCESSAR_RETORNO_WEBSERVICE (WS56) e o endpoint ws/financeiro/processar/retorno (interno) para permitir a funcionalidade através de requisição POST. Ao executar a rotina o comportamento de baixas será o mesmo como já ocorre manualmente no sistema. Após processado o retorno o mesmo será encaminhado para o diretório de arquivos processados.
Devem ser configurados previamente alguns parâmetros como ID de forma de cobrança e caminho onde onde os arquivos de retorno se encontram , consulte configuração previa. Arquivos de mais de uma forma de cobrança podemos ser adicionados no msm diretório desde que sejam do mesmo banco e mesmo CNAB. Arquivos de formas de cobrança com CNAB e bancos distintos precisam ser configurados e diretórios separados, consulte configuração previa.
Para conferencia foram adicionado os relatórios:
FATURAMENTO - Controle Processamento Arquivo Retorno (Analítico);
FATURAMENTO - Controle Processamento Arquivo Retorno (Sintético)
OBS: Consulte com seu banco configuração previa sobre o funcionalidade de transmissão automática de arquivos
Novo filtro de faturas a negociar por contrato
Adicionado novo filtro de busca de faturas por contrato no modal "Faturas vencidas sem pagamento" de faturas a negociar (Financeiro -> Inadimplência -> Negociar).
INTRANET
ESTOQUE
Otimização de consulta feita para selecionar produtos
Na tela Estoque > Movimentações > Entradas > Nova entrada, ao clicar em selecionar produtos a tela fica carregando e não finaliza. Ocorre caso existam muitos produtos para serem retornados. Foi feita uma otimização na consulta.
Movimentação Equipamento imobilizado
Criado chave ID_CLIENTE_EQUIPAMENTO_IMOBILIZADO (modulo de estoque) para utilização em atendimentos com equipamento imobilizado.
Para tal cliente indicado na chave, não haverá faturamento, mesmo que haja serviços adicionais, visando apenas a movimentação de equipamentos perante ao SAP e será valido para atendimentos de instalacao, retirada e suporte.
Ao realizar a integração/movimentação de estoque pelo endpoint /api/Operacao/FechamentoOS?Tecnico=<depositoTecnico> serão encaminhados os campos abaixo:
{ ... "DocumentLines": [ { ... } ], "ProjectCode": "referencia_endereco", "ProjectName": "endereco", "ProjectType": "1" ... }
Caso o fechamento do atendimento não seja para o cliente referenciado na chave será encaminhado ao campo "ProjectType": "2".
OPERACIONAL
Permitir o reagendamento / agendamento de OS's por meio de endpoint
Criado novo endpoint ws/servicos/agendamento/agenda_tecnica/configuracoes/integrado_efetivar possibilitando o agendamento (caso ainda não exista) e reagendamento através de canais digitais através do método PUT encaminhando os seguintes parâmetros :
{ "IDAtendimento": "1", "DataAgendamento": "01/10/2024", "HoraAgendamento": "08:00-12:00" }
OBS: Agendamento/Reagendamento ocorrerá de acordo com agenda técnica do sistema, em casos de integração com OFS (agenda técnica integrada), será realizado o agendamento/ reagendamento conforme disponibilidade na plataforma OFS. Em caso de duvidas, consulte/solicite o manual do webserver.
REDES
TELEFONIA
BI
RELATÓRIOS
INTEGRAÇÃO
Criação de tela para verificação de logs de envio de SMS (Integração)
Em alguns casos o histórico de SMS enviado é salvo no módulo integração (TB_LogSMS). Para essas mensagens não era possível o usuário ter a visão de histórico na tela. Foi implementada essa tela no caminho Cliente > Histórico > Aba ROTINAS AUTOMÁTICAS > SMS_INTEGRACAO
Integração MVNO
Desenvolvido no sistema a nova Integração MVNO (Mobile Virtual Network Operator) para ser utilizada em plano com tecnologia "TELEFONIA MOVEL", criado as novas permissões abaixo para serem utilizadas em contratos com planos de tecnologia móvel. Para possibilitar a integração também foram criadas as tabelas TB_DadosVozIntegração, TB_DadosVozPlanoIntegrado, TB_PacoteDadosAdicional, TB_LogPlataformaTelefoniaIntegracao e TB_VozIntegradora.
COMPRAR_DADOS_ADICIONAIS_DADOS_VOZ_CONTRATO = "DV01";
TROCAR_SIMCARD_DADOS_VOZ_CONTRATO = "DV02";
CONSULTAR_STATUS_SIMCARD_DADOS_VOZ_CONTRATO = "DV03";
CONSULTAR_STATUS_PORTABILIDADE_DADOS_VOZ_CONTRATO = "DV04";
REENVIAR_PORTABILIDADE_DADOS_VOZ_CONTRATO = "DV05";
CANCELAR_PORTABILIDADE_DADOS_VOZ_CONTRATO = "DV06";
BLOQUEAR_SIMCARD_DADOS_VOZ_CONTRATO = "DV07";
DISPONIBILIZAR_SIMCARD_DADOS_VOZ_CONTRATO = "DV08";
DESBLOQUEAR_SIMCARD_DADOS_VOZ_CONTRATO = "DV09";
ALTERAR_PACOTES_DADOS_ADICIONAIS = "PC06";
Ao cadastrar um novo plano de telefonia com "TELEFONIA MOVEL", na aba referente a "Telefonia" em "Dados de Telefonia" será mostrado um novo checkbox para a nova integração "MVNO" onde logo em seguida será disponibilizado o campo de texto pra "Código de produto da integradora" ser inserido.
Foram adicionados ao sistema os seguintes métodos ao sistema para interação com a plataforma de MVNO: listar_telefones_ddd, cadastrar_contrato, status_portabilidade,alterar_cliente_contrato, ativar_simcard, bloquear_simcard, desbloquear_simcard, cancelar_simcard, bloquear_simcard_parcial, trocar_simcard, comprar_dados, consultar_extrato, simcard_deixar_disponivel,consultar_chip, trocar_produto, reativar_contrato, reenviar_portabilidade, cancelar_portabilidade
Obs: para o correto funcionamento de toda a funcionalidade, é necessário que as exista uma integradora do tipo "MVNO" previamente cadastrada e que também que estejam previamente cadastradas as urls e ações no modulo integração do sistema que farão interação com a plataforma MVNO, consulte disponibilidade previa.
Regra de Negócio
No cadastro de um novo contrato com "TECNOLOGIA MOVEL" na seção "Dados de Voz" do contrato caso o contrato não seja portabilidade, após preencher o "Código de área", será carregado no combobox referente ao "Numero" todos os números disponíveis para venda com o código de área digitado.
Ao salvar o contrato com o número selecionado, será realizado o cadastro do mesmo na plataforma MVNO.
Com o contrato em "Aguardando Instalação", ao tentar "Habilitar" o contrato, será solicitado o número do SIMCard recebido pelo cliente como mostra abaixo, onde após salvo o SIMCard digitado será feita a interação de ativar o SIMCard na plataforma.
Ao realizar a suspensão parcial do contrato o SIMCard será bloqueado parcialmente na plataforma e quando realizado a suspensão do contrato o SIMCard será bloqueado com "MotivoBloqueio" sendo por inadimplência.
Quando realizado "Upgrade/Downgrade" ou "Alteração de Titularidade" serão chamados os respectivos métodos trocar_produto e alterar_cliente_contrato na plataforma.
Implementado as ações de "Comprar pacote de dados", "Trocar SIMCard ", "Status do SIMCard" e "Status da Portabilidade" (para em casos de contrato com número portado) que estarão disponíveis quando o contrato estiver "Habilitado".
Pacote de dados adicionais
Implementado o cadastro de pacote de dados adicionais (em Comercial -> Tabelas de apoio -> Pacotes -> Pacotes de dados adicionais ) para utilização em contratos de com plano de "TECNOLOGIA MOVEL". Ao cadastrar um novo pacote de dados adicionais, este será vinculado a um serviço previamente cadas trado.
Estando com os pacotes de dados adicionais previamente cadastrados ao clicar em "Comprar pacote de dados" os pacote serão carregados e ao selecionar um pacote, o serviço que foi vinculado ao pacote será lançado para o contrato.
Ao clicar "Trocar SIM Card" será aberto o modal para inserção do novo SIMCArd e realizar a troca.
Ao clicar em "Status do SIMCard" será carregado no modal as informações do SIMCArd com a possibilidade de "Bloquear SIMCard" e "Disponibilizar SIMCard".
OBS: Para que seja exibido o botão "Bloquear SIMCard" o status do SIMCard precisa estar ativo na plataforma e com status "EM USO". Ao clicar em "Disponibilizar SIMCard" o SIMCard será disponibilizado novamente para comercialização, sendo que para utilização da função de disponibilizar novamente o SIM Card, este precisa esta como "INATIVO" na plataforma MVNO. A disponibilização do SIMCard NÃO ocorrerá de forma instantânea e será "agendada" para ocorrer na plataforma MVNO.
Portabilidade
No cadastro de novo contrato com plano de "TECNOLOGIA MOVEL", ao marcar a flag "Portabilidade" serão disponibilizados os campos para seleção da "Operadora doadora" e inserção do "Numero" a ser portado. Ao informar os dados validos corretamente, quando salvar o contrato, o mesmo será cadastrado na plataforma como contrato de portabilidade.
Ao habilitar o contrato de portabilidade, será solicitado o número do SIMCard igual como é feito para habilitação de um contrato com numero não portado.Ainda em um contrato de portabilidade ao clicar em "Status da portabilidade" será carregado um modal com as informações recebidas da plataforma MVNO referente a solicitação de portabilidade com mostra imagem abaixo.
Caso ocorra alguma falha na solicitação de portabilidade, serão exibidos os botões de "Cancelar portabilidade" e "Reenviar portabilidade".
OBS: Para que a verificação dos status de portabilidade de novos contratos com tecnologia móvel seja feita de forma automática, foi implementado uma rotina que fará de forma agendada a atualização dos status das portabilidades na base de dados do sistema. (através do endpoint criado /ws/integracao/voz/portabilidades/atualizar )
Ao realizar o cancelamento do contrato no sistema, será encaminhado a plataforma a ação de cancelar o SIMCard e o status do mesmo será alterado pra "INATIVO" na base de dados do sistema. Ao reverter o cancelamento do contrato o sistemas irá fazer a validação da chave "DIAS_REVERSAO_CANCELAMENTO_CONTRATO" no modulo comercial, que caso esteja dentro do período aceito para a reversão, irá realizar a ação de habilitar o contrato novamente no sistema e reativar o contrato na plataforma MVNO.
Integração TV PanAccess
Para integração com a plataforma o plano (Tecnologia: TV/OTT) criado deve possuir na aba TV o tipo de integração 'PANACCESS'. Na mesma tela deve ser escolhido o servidor de integração referente a essa plataforma e a grade canais.
- Servidor de integração deve ser previamente cadastrado no módulo de integração.
- O cadastro da grade de canais é feito na tela Comercial > Tabelas de apoio > Grade de canais. Nessa tela será vinculado o código do produto na integradora, conforme print.
No momento da venda, ao escolher esse plano será mostrado o campo 'Smartcard' na tela, para que o usário selecione qual será vinculado a essa contrato. O smartcard mostrado é através de uma consulta retornada pela plataforma, onde irá apresentar o primeiro número de smartcard disponível.
Após a venda, ficará salvo nos dados de tv do contrato os dados vinculados a ele.
Login
PIN
Senha
Smartcard atual
Obs: Para alteração de senha, a nova senha digitada deve seguir os padrões da plataforma. Caso não siga, a plataforma irá retornar erro.
Integração IXER (Telemedicina)
Desenvolvido nova integração de SVA com IXER (Telemedicina). Adicionado no campo "CodClientePlataforma" em tabela (TB_DadosSvaProdutoIntegracao) para possibilitar a integração.
Semelhante ao que já ocorre em muitas outras integrações de SVA, os produtos relacionados a integração com a Ixer deverão estar previamente cadastrados em Produtos SVA's (Integração -> Tabelas de apoio -> Produtos SVA's), onde serão vinculados a uma composição previamente cadastrada.
Para esta integração, ao realizar o cadastro do plano, deverá ser vinculado a tal a tecnologia OUTROS e logo após associar as composições referentes ao SVA desejado.
Regra de Negócio :
Ao habilitar um contrato no sistema, deverá ser encaminha à plataforma da Ixer a requisição de cadastro (endpoint /api/v1/clientes).Ao cancelar um contrato será encaminha a plataforma a requisição de exclusão(/api/v1/clientes/{CodigoAssociacao}/{CPF}). Para os status de contrato (SUSPENSO, INATIVO TEMPORARIAMENTE) será encaminhado a plataforma a requisição de exclusão e para os demais status não será realizada interação com a plataforma. Ao reverter o cancelamento do contrato, será lançado novamente o cadastro na plataforma
Ao realizar o upgrade/downgrade de um contrato, será realizado o cancelamento do sva na plataforma da Ixer e logo em seguida o cadastro do novo sva já atualizado.
Cada cliente poderá ter somente um cadastro na plataforma da Ixer, caso seja realizado a tentativa de cadastro de um novo contrato com a mesma integração para o mesmo cliente o sistema irá alertar o usuário sobre a não realização do cadastro na plataforma. A mesma validação será feita ao realizar uma alteração de titularidade (onde caso o novo titular já possua o cadastro na plataforma, a alteração não será realizada).
OBS: Para utilização da integração com a plataforma Ixer , devem estar cadastrados previamente os servidores de integração, URL's, Integradoras, etc. Consulte configuração previa caso necessário.
Melhoria na tela de logs remessa eletronica
Adicionado o retomo da requisição de cadastro da remessa eletrônica (juntamente com o body) na tela de log de remessa eletrônica (Modulo integração -> Faturamento -> Logs de remessa eletrônica)
Conteúdo do modal:
Body: { ... "DADOS ENVIADOS":"DADOS ENVIADOS" ... } Resposta: {erro={errorMessage=RETORNO DA API, statusHttp=400.0}, url=https://URL_BANCO/registrar-boleto, status=400}
Quando não tiver resposta da API o modal só irá mostra o Body, quando não tiver nenhum dos dois não irá mostra ícone
.