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

  • Notificação de Ônus e Gravames ou Alteração de Titularidade;
  • Notificação de Alteração de Averbação de Ônus e Gravames ou Alteração de Titularidade;

• Anuência (eventType consent);

  • Notificação de Opt-in.

🚧

To-dos de Desenvolvimento

1. Ler a Documentação de apoio em Envio de Agenda de Recebíveis;
2. Desenvolver o serviço de Notificação e publicar em ambiente de homologação;
3. 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;
4. Desenvolver o recebimento e leitura da Notificação de Posição de Agenda (considerando o campo eventType como position);
5. Desenvolver o recebimento e leitura da Notificação de Opt_in(utilizando o campo eventType como consent);
6. Desenvolver o recebimento e leitura da Notificação de Averbação de Unidades de Recebíveis (utilizar o campo eventType como "contract");
7. Testar o recebimento de todas essas Notificações.