2.5 Recebimento de Notificação
Caso queira, o Participante poderá desenvolver a integração de uma URL para recebimento de Notificações da TAG, para não haver necessidade de que esses usuários acessem a Plataforma ativamente por meio de consultas para verificarem a ocorrência de um evento. Para que seja possível a Plataforma TAG enviar as Notificações, é necessário que o cliente:
- Desenvolva um um serviço (API RESTFUL);
- Prepare um endereço DNS para recebimento das notificações POST disparadas pela plataforma TAG;
- Informe ao time de Operações da TAG a URL que aponta para o serviço de desenvolvido.
Utilizamos Basic Authentication, que é uma URL com token fixo onde o Participante informa e nós cadastramos essa chave em nossa base para que o Participante receba todas as notificações em um só local. Este mesmo serviço será utilizado para envio de diversas Notificações, como por exemplo:
-
Posição atualizada da Agenda de Recebíveis (eventType = position);
-
Envio de Posição de Agenda para Credor - Existem 5 eventos gatilhos que desencadeiam o envio de uma Notificação de Posição. São eles:
- Envio de Posição Diário (após janela de registro e atualização de URs e atualização de agendas de interop)
- Envio de Posição após evento de Contrato;
- Envio de Posição após evento de Liquidação;
- Envio de Posição após evento de Antecipação;
- Envio de Posição após evento de Opt-in (posição atual completa de agenda no momento do opt-in);
Importante
Caso o Participante não queira receber notificações do tipo position, ele poderá solicitar o desligamento dessa função. Para maiores informações, acesse a Notificação de Posição Opcional para Credores
-
-
Averbação (eventType = contract);
-
Anuência (eventType consent);
To-dos de Desenvolvimento
- Ler a Documentação de apoio em Envio de Agenda de Recebíveis;
- Desenvolver o serviço de Notificação e publicar em ambiente de homologação;
- Enviar a URL do serviço para o e-mail [email protected], solicitando o cadastramento da URL de Notificação para o ambiente de homologação;
- Desenvolver o recebimento e leitura da Notificação de Posição de Agenda (considerando o campo eventType como position);
- Desenvolver o recebimento e leitura da Notificação de Opt_in(utilizando o campo eventType como consent);
- Desenvolver o recebimento e leitura da Notificação de Averbação de Unidades de Recebíveis (utilizar o campo eventType como "contract");
- Testar o recebimento de todas essas Notificações.
Updated 5 months ago