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:

Clique para ampliar (+)
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.

Clique para ampliar (+)
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.

Clique para ampliar (+)
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.

Clique para ampliar (+)
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.
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.
Rejeição de Liquidação (eventType settlementreject)
Esta Notificação é enviada após a Credenciadora realizar uma operação de Rejeição de Liquidação, desfazendo uma Liquidação que foi previamente realizada.
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.

Clique para ampliar (+)
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 |
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 5 days ago