Maio/Junho 2024: mudanças entre as edições

De Adapter
Ir para navegação Ir para pesquisar
 
(23 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 192: Linha 236:


[[Arquivo:Permisosessxsxaawssdswdwasd.png|600x600px|miniaturadaimagem|centro|''Cada permissão nova é referente a um tipo de baixa'']]
[[Arquivo:Permisosessxsxaawssdswdwasd.png|600x600px|miniaturadaimagem|centro|''Cada permissão nova é referente a um tipo de baixa'']]
===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)
[[Arquivo:Venda equipamento.png|300x300px|miniaturadaimagem|centro|Venda Equipamento]]
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"
<pre>
{
...
"DocumentLines": [
{
...
...
"SerialNumbers": [
{
"InternalSerialNumber": "*******",
"Quantity": "1"
}
],
"VendaComodato": "Y"
},
{
...
}
],
...
}
</pre>
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)
[[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 integração do faturamento referente ao equipamento vendido, serão encaminhados os novos campos na integração, como mostra a seguir:
<pre>
{
...
"VendaImobilizado": "Y",
"DocumentLines": [
{
...
"MAC_SERIE": "mac_equipamento_venda",
"SL1Code": "id_tecnico_ou_campo_vazio"
...
}
],
...
}
</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 202: 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 368: Linha 540:


''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.''
''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).
[[Arquivo:Cadastro telemedicina.png|500x500px|miniaturadaimagem|centro|Cadastro cliente na existente na plataforma]]
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

Vínculo de tipos de contrato x usuário
Campo 'Tipo do contrato' no momento da venda

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.


Aceite de contrato


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


Aceite Contrato


Aceite Contrato Complemento


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.


Cadastro de 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.


Flag CNI na tela de cadastro de cliente


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:

Vínculo da chave no cadastro do plano

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.

Campo para filtrar 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.

Vencimentos e os dias de faturamento referentes

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"

Cada permissão nova é referente a um tipo de baixa


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)


Venda Equipamento


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)

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


Faturas vencidas sem pagamento

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

Tela que retorna o histórico de envios de SMS


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.


Seleção do tipo de integração

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.


Seleção número disponível

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.


Inserir número do SIMCard

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


Dados de voz do contrato

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.

Cadastro de pacote de dados adicionais

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.


Compra pacote de dados adicionais


Ao clicar "Trocar SIM Card" será aberto o modal para inserção do novo SIMCArd e realizar a troca.


Troca do SIMCard


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.


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.


Status da portabilidade


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.


Cadastro do plano


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


Cadastro de grade de canais

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.


Momento da venda do plano


Após a venda, ficará salvo nos dados de tv do contrato os dados vinculados a ele.

Login

PIN

Senha

Smartcard atual


Dados de TV vinculados ao contrato


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

Cadastro cliente na existente na plataforma


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

.

MIGRAÇÃO

APLICATIVOS