Notificação
A Plataforma TAG é baseada em eventos e boa parte destes eventos são processados após a solicitação. Nestes casos, ela envia uma Notificação ao final do processamento, informando sobre a situação atual da solicitação, sendo ela atendida ou não.
Resumindo, podemos separar uma solicitação de serviço em 4 partes:
Exemplo:
1. Solicitação de Serviço
O cliente envia um contrato para averbação de URs.
2. Confirmação do recebimento da Solicitação
A plataforma avalia se a solicitação foi enviada corretamente e responde ao cliente que a averbação do contrato está em processamento.
Na imagem abaixo, a Plataforma TAG entende que não há nada de errado com a solicitação.
3. Processamento da Solicitação
A solicitação é processada pela plataforma, ela pode ser atendida ou não, dependendo dos critérios enviados.
Na imagem abaixo, podemos ver que o processamento foi feito corretamente, o Contrato enviado gerou uma Obrigação de Contrato e uma nova Obrigação de Liquidação.
4. Envio de Notificação pela Plataforma TAG
Independente do resultado do processamento, é enviada uma notificação ao cliente informando a situação da solicitação.
Na imagem abaixo, a Plataforma TAG notifica o cliente que o Contrato está averbado, enviando os dados da Averbação de Unidades de Recebíveis.
Tipos de Notificação
Podem ser enviados diversos tipos de notificação, sendo cada um deles relacionado ao tipo de solicitação enviada para a Plataforma TAG.
Posição atualizada da Agenda de Recebíveis (eventType position)
Por este tipo de Notificação é feito o Envio de Posição de Agenda de Recebíveis. Este evento pode ocorrer em 2 situações:
- Logo após o informe de uma Anuência para recebimento da Agenda de Recebíveis;
- Diariamente após a janela de processamento noturno ou após eventos que modifiquem a posição da agenda, conforme o Horário de Processamento definido.
Antecipação Pós-Contratada (eventType advancement)
Resposta ao envio de uma Antecipação Pós-Contratada para a Plataforma TAG, informando o resultado do processamento, ela é enviada mesmo nos casos onde a solicitação não pôde ser atendida.
Averbação (eventType contract)
Quando solicitada uma Averbação de Unidades de Recebíveis, independente do tipo de efeito do contrato (Alteração de Titularidade, Garantia ou Penhor). A Notificação informará o resultado do processamento, se foi ou não atendida.
Nos casos onde a Averbação de Unidades de Recebíveis é aceita, na Notificação são enviados os dados atualizados do contrato e das URs afetadas.
Recálculo da Averbação (eventType execute)
A Plataforma TAG notifica os Participantes quando a Posição da Agenda de Recebíveis é alterada e isso impacta uma Averbação de Unidades de Recebíveis, recalculando os valores da Obrigação de Liquidação e da Obrigação de Contrato.
Anuência (eventType consent)
O informe de Anuência para recebimento da Agenda de Recebíveis é um dos eventos que a Plataforma TAG notifica o resultado do processamento, sendo ela atendida ou não.
Liquidação (eventType settlement)
Esta Notificação é enviada após o processamento de informes de Liquidação, porém não é enviada quando é informada uma Rejeição de Liquidação.
Liquidação (eventType settlementreject)
Esta Notificação é enviada após a Rejeição de Liquidação ser enviada pela Credenciadora, porém não é enviada quando é informada uma Rejeição de Liquidação.
Conciliação (eventType reconciliation)
O processo de Conciliação é exclusivo do perfil Credenciadora e tem diversas etapas. Esta Notificação é enviada após o processo de Conciliação ser iniciado, e nela são enviados os links de download dos arquivos de Conciliação.
Consulta Online de Recebíveis (eventType onlinePosition)
O serviço de Consulta Online de Recebíveis é exclusivo do perfil Credor. Esta Notificação é a resposta assíncrona enviada via webhook ao solicitante da consulta.
Notificação de eventos solicitados por terceiros
A Plataforma TAG também enviará Notificações ao cliente de eventos que ele não é o solicitante, mas que a solicitação esteja relacionada a:
- Unidade de Recebíveis (UR) por ele registrada (perfil Credenciadora);
- Unidade de Recebíveis (UR) que ele tenha visibilidade, por ter informado a Anuência para recebimento da Agenda de Recebíveis (perfil Credor).
Eventos de terceiros enviados para Credenciadora e Subcredenciadora:
- Posição de Agenda (eventType position)
- Anuência (eventType consent)
Evento de terceiros enviados para Credor:
- Posição de agenda após Averbação (eventType position)
- Posição de agenda após Liquidação (eventType position)
- Posição de agenda após Antecipação (eventType position)
Pré-Requisito para o envio de Notificações
Para que seja possível a Plataforma TAG enviar as Notificações, é necessário que o cliente:
- Desenvolva um um serviço (API RESTFUL);
- Informe ao time de Operações da TAG a url que aponta para o serviço de desenvolvido.
Este único serviço será utilizado para o envio de todos os Tipos de Notificação, a Plataforma TAG sempre enviará a tag "eventType" para identificação do conteúdo da mensagem.
{
"data": {
//*** Dados no layout do serviço processado pela Plataforma TAG ***
},
"eventType":"", //*** Identificador do tipo de Notificação ***
"processKey":"2ec6a7f4-c9bb-40d3-96fa-cf8ae5d",
"createdAt":"2020-10-25T11:42:35.6003348Z"
}
Lista de "eventType":
"eventType" | Layout |
---|---|
position | Layout (Perfil Credenciadora): Envio para Credenciadora, Subcredenciadora ou Conciliadora Layout (Perfil Credor): Envio para Credor |
advancement | Layout: Notificação - Antecipação Pós-Contratada |
contract | Layout: Notificação de Ônus e Gravames ou Alteração de Titularidade |
execute | Layout: Notificação de Ônus e Gravames ou Alteração de Titularidade** |
consent | Layout: Notificação de Opt-In |
settlement | Layout: Notificação de Informe de Liquidação |
settlementreject | Layout: Notificação de Rejeição de Liquidação |
reconciliation | Layout: Notificação de Conciliação de Agenda |
onlinePosition | Layout: Notificação da Consulta Online de Recebíveis |
Updated 7 months ago