DT DRHMEURH-14324 Push Notification - Gatilho Envelope de Pagamento.

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

       Como usuário do RH

       Quero avisar os colaboradores do envelope de pagamento disponível

       Para que os colaboradores recebam a notificação sem necessidade de acessar o aplicativo Meu RH

       Critério de aceite:

• No processo deverá ter uma forma de selecionar vários funcionários, de acordo com departamento e filial para aviso do envelope de pagamento disponível;
• Deverá ter a possibilidade de alterar a mensagem de texto que o usuário irá receber, deverá ter uma mensagem padrão.

03. SOLUÇÃO

Foi implementado um novo processo de disparo da notificação, chamado Gatilho do Envelope de Pagamento.

O processo estará detalhado no item 04 deste documento.

IMPORTANTE: Esta implementação ainda não está disponível para o mercado.

IMPORTANTE: Os aplicativos precisam estar, obrigatoriamente, nas versões 3.1.13 ou superior 

04. DETALHES DA IMPLEMENTAÇÃO

         No modulo 18 ( SIGATCF ), foi disponibilizado um novo menu chamado Gatilho Envelope Pagto.

         Como o menu oficial somente será disponibilizado na nova release ( 12.1.2410 ), tal menu poderá ser criado manualmente. Para isto, basta chamar a rotina TCFA160.

        Ao acessar o cadastro da tela de processamento ( conforme print abaixo), será possível filtrar os registros.

       Algumas perguntas desta tela merecem destaque.

        Roteiro: Roteiro que será considerado para buscar as verbas e checar se o funcionário possui pagamento.

        Tipo Mensagem: Mensagem que será considerada para enviar a notificação ao celular do colaborador.

        Titulo Mensagem e Mensagem: Esses campos somente serão considerados caso o campo Tipo Mensagem esteja vazio. Neste caso, o usuário poderá colocar um Titulo e uma Mensagem conforme a sua escolha.

        Ao final do processamento da rotina, um log será disponibilizado, onde cada mensagem será explicada abaixo.

        1 - Funcionário sem token cadastrado na tabela RUY: Funcionário foi processado, mas não foi encontrado token na tabela RUY. Possivelmente o usuário não liberou permissão receber notificações do App Meu RH.

        2 - Funcionários sem pagamentos para o período/roteiro: Funcionário foi processado, porém para o mês e roteiro escolhidos, ele não possui pagamentos. Pode ser por estar afastado, por ex.

        3 - Recibo de pagamento ainda não está disponível para ser consultado. Funcionário foi processado e possui pagamento, mas conforme configuração dos MVs ( item 05 deste doc ), o gatilho não foi disparado.

        4 - Falha de comunicação com o firebase. Caso esta mensagem apareça, não foi possivel estabelecer uma conexão com o endpoint mencionado no item 05 deste documento.

        5 - Notificação enviada com sucesso. Esta mensagem quer dizer sucesso. O funcionário foi processado, o pagamento foi encontrado, o recibo está disponível para ser consultado, a conexão com o endpoint foi realizada, o smartphone do funcionário permite receber notificações do App Meu RH e a notificação foi, de fato, enviada.

        Exemplos:

05. MECÂNICA DE ENVIO DA NOTIFICAÇÃO/GATILHO.

        Neste bloco do documento, será detalhado a mecânica de envio da notificação. Os itens que serão destacados abaixo são de extrema importância.

        1 - A rotina identificará se o funcionário possui pagamento para o mês em aberto. Com isso, serão buscadas verbas na tabela SRC, e somente na SRC. A tabela SRD não será considerada.

        2 - Funcionários demitidos e transferidos serão automaticamente desprezados.

        3 - Funcionários afastados serão considerados, mas somente receberão a notificação caso possuam pagamento no mês.

        4 - É importante se atentar ao roteiro escolhido de acordo com o período de pagamento. Por exemplo, se for época de dezembro e o cliente deseja enviar a notificação sobre o 13 salário, deverá escolher os roteiros 131/132.

        5 - Os parâmetros utilizados na rotina de consulta do envelope no Meu RH também são utilizados.

        6.1 - MV_TCF013A, MV_TCFDADT, MV_TCFDFOL, MV_TCFD131, MV_TCFD132, MV_TCFDEXT, MV_TCFDOUT.

        6.2 - A forma de checagem do parâmetro é exatamente igual. Portanto, é extremamente importante checar a configuração dos MVS. Por exemplo.

                MV_TCFDFOL configurado com -02.

                Data de pagamento 05/03/2024.

                Caso o usuário do RH se conecte no ERP Protheus com data do dia 28/02/2024 e tente disparar o gatilho, nenhuma notificação será enviada.

                Caso o usuário do RH se conecte no ERP com data igual ou superior a 03/03/2024, o gatilho será disparado e a notificação será enviada.

        7 - É obrigatório que o cliente libere à sua infraestrutura acesso ao endpoint https://fcm.googleapis.com/fcm/send 

05. DICIONÁRIO DE DADOS.

• Criação SX6 - Parâmetro MV_MRHPUSH

• Criação SX2- Tabela RUZ - MeuRH - Push Notifications 

• Criação SIX - Nova tabela RUX

• Criação SX3 - Nova tabela RUX

• Criação SX1 - Novas perguntas TCFA160

04. DEMAIS INFORMAÇÕES

Materiais importes complementares:

DT DRHMEURH-13078 Push Notification - Gravação do token.

DT DRHMEURH-13606 Push Notification - Cadastro dos Tipos de Notificação

05. ASSUNTOS RELACIONADOS

Para saber mais detalhes sobre o Meu RH, acesse: Documento de Referência