Envio de Comunicação SMS

Visão Geral do Processo

O objetivo deste processo é integrar o sistema Gestão de Planos com serviços de terceiros para envio de SMS. É possível enviar comunicações quando guias passam para os status: Autorizada, Negada ou Cancelada.

Manutenção Parâmetros Web – hac.webParams

Objetivo da tela:

O objetivo deste programa é parametrizar as configurações da integração no grupo de campos "Envio de SMS".

Campos e Parâmetros:

Campo	Descrição
Envia SMS para guias autorizadas/negadas/canceladas	Indica se a integração com o serviço de SMS está ativa.
Envia mensagem automaticamente	Indica se ao autorizar, negar ou cancelar uma guia será enviado um SMS automaticamente. Quando desativado, uma mensagem em tela será exibida perguntando: "Deseja enviar SMS?" no momento da execução do processo.
Programa de layout para integração com o serviço	Nome do programa que será executado pelo RPW do Gestão de Planos para montagem da mensagem e comunicação com o serviço de SMS contratado. (Ex: dep/de-layout-sms.p).
Login	Usuário do serviço de SMS (se aplicável).
Senha	Senha do serviço de SMS (se aplicável).

Modificação de Guias - HAT0112C e Autorização Guias pelo Auditor/Responsável - HAT0110J

Objetivo da tela:

Ao autorizar , negar ou cancelar guias pelos programas mencionados, será criado um novo pedido de comunicação SMS (se habilitado), conforme parametrização.

Auditoria Médica

Objetivo da tela:

Ao autorizar , negar ou cancelar guias pela auditoria médica, será criado um novo pedido de comunicação SMS (se habilitado), conforme parametrização.

Comunicação Pedidos Pendentes - hat.pendingRequestCommunication

Objetivo da tela:

O objetivo deste programa é processar os pedidos de integração pendentes e realizar a comunicação com o serviço (chamada do layout configurado anteriormente). Para que a integração funcione corretamente é necessário que este RPW esteja configurado e rodando, caso contrário serão criados os pedidos de integração nos processos anteriores, mas não processados.

Campos e Parâmetros:

Campo	Descrição
Execução Contínua	Indica se a execução será continua, isto é, se depois de iniciado o processo só será parado através do programa "Monitor Pedido Execução".
Tipo de Integração	Indica o tipo de integração a ser realizado, neste caso SMS.
Execução	Configurações de RPW igual às demais telas do sistema.

Layout de comunicação especifico

Devido à possibilidade de diferentes operadoras contratarem diferentes serviços de SMS, é necessário que seja desenvolvido um programa de layout específico para integração. O gestão de planos envia para o layout os seguintes parâmetros no momento do processamento do pedido:

Parâmetro	Tipo	Campo	Descrição
Código do registro	input	ped-integr-dados.cdd-registro	Código identificador do pedido de integração
Tabela de erros	input-output	rowErrors	Tabela de erros declarada em {dbo/utils/rowerror.i}

Com esses dados, dentro do layout é possível buscar as informações necessárias, tais como o telefone celular do beneficiário da guia, e realizar a comunicação e tratamento do retorno de acordo com o manual do serviço contratado.

Para obter os dados da guia é necessário encontrar a tabela ped-integr-dados que possui o código (cdd-registro) recebido por input.

No campo "cod-chave-registro" da tabela ped-integr-dados é salvo a chave da tabela guiautor separada por virgulas. Ex: Unidade: 120, Ano: 2019 e Guia: 59.

Através da chave da guia é possível pesquisar os dados necessário para realizar a comunicação.

Caso a integração tenha comunicado com sucesso deve-se criar a tabela resposta-integr-dados e atualizar o valor do campo cdd-ped com o código do registro (cdd-registro) recebido por input.

Esta tabela salvará os erros ocorridos no processamento de outros sistemas.

Integração Entre Sistemas - hgp.systemIntegrations

Objetivo da tela:

O objetivo deste programa é consultar e reprocessar os pedidos de integração que falharam

Campos e Parâmetros:

Campo	Descrição
Sistema	No campo "Sistema" serão listados os sistemas que possuem integrações: HAT: Autorizador Cloud SMS: Envio de comunicação SMS
Status	No campo "Status" serão exibidos os status dos pedidos. Ao selecionar um status, serão trazidos na consulta os dados referente ao status informado.
Evento	No campo "Evento" serão exibidos os eventos disponíveis para cada sistema. Ao selecionar um evento, serão trazidos na consulta os dados referente ao evento informado.
Dt.Criação	No campo "Dt.Criação" é possível informar a data da criação do pedido. Ao realizar a consulta serão trazidos em tela os pedidos correspondentes à data informada.
Dt.Processamento	No campo "Dt.Processamento" é possível informar a data de processamento do pedido. Ao realizar a consulta serão trazidos em tela os pedidos correspondentes à data informada.

Ações

Ação	Descrição
Consultar	Ao clicar no botão "Consultar" será realizada a busca dos pedidos conforme filtros informados em tela:
Reenviar Todos	Ao clicar na opção "Reenviar Todos" será alterado os status do pedidos para "Pendente Re-comunicação", em todos os pedidos que possuírem os status "Erro na criação do pedido" e "Processado com erro", permitindo assim que o RPW realize uma nova tentativa de comunicação. A opção de reenviar todos irá respeitar os filtros informados em tela, reenviando o pedido apenas para os registros correspondentes à seleção, mesmo que este não esteja sendo apresentado em tela. Será exibida uma mensagem de confirmação informando que serão reenviados os pedidos. Ao clicar em "Confirmar" os pedidos serão reenviados, caso contrário a solicitação será cancelada. Ao final do processo será apresentado a quantidade de pedidos marcados para re-comunicação:
Reenviar Selecionados	Ao clicar no botão "Reenviar Selecionados" será alterado os status do pedidos para "Pendente Re-comunicação", que forem selecionados pelo usuário, permitindo assim que o RPW realize uma nova tentativa de comunicação. Será exibida uma mensagem de confirmação do reenvio. Ao clicar em "Confirmar" os pedidos selecionados serão comunicados, caso contrário a solicitação será cancelada: Ao final do processo será apresentado a quantidade de pedidos marcados para re-comunicação:
Carregar mais resultados	Ao clicar no botão "Carregar mais resultados" são carregados em tela mais 20 resultados correspondentes ao filtro informado em tela.