Notificación
Definición de Notificación:
Notificaciones son respuestas asíncronas enviadas por la Plataforma CREA después del procesamiento de ciertas solicitudes realizadas por los Participantes o tras la ocurrencia de eventos específicos.
- EndPoints de tipo POST (envío) y PATCH (actualización) son asíncronos con una respuesta de aceptación síncrona.
- Esto significa que la confirmación de recepción es inmediata, pero el procesamiento completo ocurre posteriormente, y el resultado se informa al Participante a través de Notificaciones (explicado en esta sección).
- Endpoints de tipo GET (consulta) son síncronos.
- Esto significa que la respuesta a la solicitud se proporciona instantáneamente, permitiendo al Participante consultar el estado actual de la información solicitada de forma inmediata.
Paso a Paso de la Solicitud de Servicios con Notificaciones (caso genérico):
A continuación, detallamos el paso a paso para EndPoints POST y PATCH asíncronos con respuesta de aceptación síncrona:
1 ) Envío de la Solicitud:
El Participante envía una solicitud a través de un EndPoint POST (envío) o PATCH (actualización).
2 ) Recepción de la Solicitud y Retorno Síncrono:
La Plataforma CREA recibe la solicitud y envía inmediatamente una confirmación de recepción al Participante, indicando si la solicitud ha sido aceptada para su procesamiento o si presenta algún error.
En esta etapa, se realizan verificaciones básicas para asegurar que la solicitud se haya hecho correctamente, tales como la validación de campos obligatorios y el formato de los datos enviados.
3 ) Procesamiento de la Solicitud:
La Plataforma CREA procesa la solicitud de manera asíncrona, lo que significa que el procesamiento ocurre en segundo plano y puede tomar algún tiempo.
4 ) Notificación de Resultado:
Tras el procesamiento completo de la solicitud, la Plataforma CREA envía una Notificación asíncrona al Participante informando el resultado final del procesamiento.
Este flujo garantiza que los participantes sepan inmediatamente que sus solicitudes han sido recibidas, mientras que el procesamiento detallado ocurre posteriormente y los resultados son comunicados tan pronto como estén disponibles.
El siguiente diagrama de flujo resume estas etapas descritas anteriormente:
Pre-Requisitos para la recepción de Notificaciones:
Para estar habilitado para recibir Notificaciones, es necesario que el Participante desarrolle un único servicio (API RESTFUL) que será utilizado por CREA para el envío de todos los tipos de Notificaciones. La URL de este servicio debe ser proporcionada al equipo de CREA para la configuración adecuada del envío de Notificaciones.
Consulta de Notificaciones:
Si el Participante no tiene un Webhook configurado para recibir Notificaciones, estas también podrán consultarse a través de los endpoints de Consulta de Notificación a continuación.
Tipos de Notificación
La Plataforma CREA envía diversos tipos de Notificaciones, cada una relacionada con solicitudes específicas realizadas por los Participantes:
| Nombre | eventType | Descripción |
|---|---|---|
| Envío de Inventario | position | Envío de Inventario realizado diariamente según Horario Operativo, con la posibilidad de envío durante el día (“intra-day”) ante eventos como Anotaciones, Liquidaciones, Anticipos y Opt-Ins. |
| Anotación de Anticipo Eventual | advancement | esultado del procesamiento de la Anotación de Anticipo Eventual, incluyendo solicitudes no atendidas. |
| Anotación de Cambio de Titularidad o Garantía | contract | Resultado de la Anotación de Cambio de Titularidad o Garantía, incluyendo datos actualizados del Contrato y Cupones de Tarjeta afectados. |
| Reprocesamiento de Anotaciones | execute | Notificación de cambios en el Inventario que afectan la Anotaciones previamente registradas, recalculando los Contratos y Obligaciones de Contractuales. |
| Opt-In / Anuencia | consent | Resultado del procesamiento de la anuencia (Opt-In) para Consulta de Cupones de Tarjeta e Inventario. |
| Liquidación | settlement | Notificación tras el procesamiento de informes de Liquidación. |
| Rechazo de Liquidación | settlementreject | Notificación en caso de Rechazo de Liquidación. |
| Consulta En Línea de Inventario | onlinePosition | Respuesta asíncrona enviada vía webhook al solicitante de la consulta online de recebibles. |
Envío de Notificación a los demás Participantes vinculados al Cupón de Tarjeta afectado:
Cabe resalta que un Participante también puede recibir Notificaciones en casos donde no fue el propio Participante quien realizó la solicitud inicial.
El objetivo es mantener a todos los Participantes que tienen algún vínculo con los Cupones de Tarjeta afectados informados sobre cualquier modificación. Esto asegura que todos los involucrados estén al tanto de las actualizaciones y cambios relevantes, promoviendo la transparencia y facilitando la gestión y el seguimiento de los activos.
Envío de Notificación de Inventario “intra-day”:
Para los eventos de Notificación enumerados en la sección anterior, la Plataforma CREA tiene la capacidad de informar a los Participantes vinculados sobre cambios que ocurren durante el día (“intra-day”) en los Cupones de Tarjeta. De esta manera, los Participantes no necesitan esperar el ciclo de procesamiento completo, que envía las Notificaciones de Inventario una vez al día, para estar actualizados.
Beneficios:
- Actualización en Tiempo Real: Permite que los Participantes obtengan información actualizada a lo largo del día, mejorando la gestión de los activos.
- Agilidad en las Decisiones: Con datos actualizados continuamente, los Participantes pueden tomar decisiones más rápidas e informadas.
- Transparencia: Asegura que todas las partes interesadas estén al tanto de los cambios y puedan actuar en consecuencia.
Este sistema de Notificación “intra-day” facilita la gestión de los Cupones de Tarjeta, proporcionando mayor control y eficiencia operativa.
En caso de que el Participante no desee recibir estas Notificaciones “intra-day,” puede solicitar la desactivación del servicio con el equipo de CREA.
Updated about 1 month ago