Notificaciones

Descripción general

Notificaciones de EPS es una solución que le permite integrarse con EPS más cerca que nunca. Cuando tengan lugar cambios que puedan causar impacto sobre su negocio, EPS volcará los detalles del cambio directamente en sus sistemas mediante mensajes POST estándar.  Con nuestras notificaciones push, podrá permanecer informado, simplificar las operaciones y escalar su empresa.

Actualmente admitimos notificaciones de todos los eventos de reservas que tengan lugar fuera de nuestra API. De esta manera, si un centro de llamadas realiza un cambio o si un hotel cancela una reserva, recibirá una notificación inmediatamente. Esto es solamente el comienzo; pronto llegarán más tipos de notificación de eventos.

Al permitir la integración fluida con su empresa, estas notificaciones sirven para complementar los siguientes productos y servicios de EPS:

• APIs de EPS Rapid
• Herramienta de reservas de agentes «Voyager para afiliados»
• Servicios de atención al socio y al cliente

nuevas herramientas Ahora ofrecemos una API de prueba para todos los tipos de eventos compatibles con Notificaciones. Consulte todos los detalles en la siguientesección importante a continuación. Si no desea configurar sus propias solicitudes, también puede utilizar nuestra nueva herramienta de Comprobación de notificaciones.

Tipos de mensajes admitidos

Las notificaciones de EPS pueden informar a sus sistemas mediante un mensaje relacionado con los siguientes eventos:

Esquema y detalles de los mensajes

Todos los mensajes deben cumplir el esquema que aparece a continuación. Ya que los nuevos tipos de mensaje son añadidos a diferentes eventos, puede que el esquema varíe.

Temas admitidos de los mensajes

Cada mensaje es una solicitud POST HTTPS con un cuerpo de mensaje JSON.

Ejemplo:

 { "event_id": "dbacce6c-afcb-4b23-ae66-48050757551c", "event_type": "itinerary.agent.create", "event_time": "2017-08-09T16:47:32.039Z", "itinerary_id": "8091234567890", "email": "customer@example.com", "message": "An agent created a new itinerary." "affiliate_reference_id": "b086d299-2f1f-4134-a23c-f4a1c9286fac" }

Integración

Recepción de un mensaje

Para empezar a recibir notificaciones push, tendrá que establecer un punto de conexión HTTPS públicamente accesible que pueda aceptar mensajes POST que se envíen a su punto de conexión.

Trabaje con su consultor de integración de EPS para ponerse en marcha y facilitarles:

• Una lista de temas de eventos a la que quiera suscribirse (enumerada más arriba)
• El URL de su punto de conexión para gestionar los mensajes

Estamos trabajando para facilitarle herramientas de autoservicio que prueben su integración. Hasta ese momento, el consultor de integración le puede ayudar a realizar reservas de prueba para confirmar que usted está recibiendo notificaciones de los eventos ocurridos fuera de línea a los que se ha suscrito.

Notas importantes sobre la configuración

• EPS utiliza servidores en la nube; asegúrese de que los puntos de conexión del receptor estén configurados para recibir notificaciones push procedentes de distintas direcciones IP potenciales.
• Si desea cambiar el URL de su punto de conexión, debe mantener activo el URL hasta que validemos su nuevo URL para recibir notificaciones push. Póngase en contacto con su representante de EPS antes de realizar los cambios mencionados.
• Solo se puede utilizar un URL en las notificaciones; no se admite ninguna variación del event_type (tipo de evento) ni ningún otro criterio.

Gestión de un mensaje

Cuando reciba el mensaje de que ha tenido lugar un evento de reservas, utilice el ID del itinerario y la dirección de correo electrónico del mensaje para recuperar los detalles de la última reserva.

Puede que los mensajes lleguen desordenados. Consulte la marca de hora para determinar el orden y recuperar el itinerario de los eventos de reservas para obtener el estatus actualizado.

Después de recibir el mensaje, su integración deberá responder con el código de estado HTTP adecuado. Se considerará que no se han enviado los mensajes que no reciban un código de estatus de nivel 200 y serán puestos en cola para que el servicio de notificaciones vuelva a intentarlo.

Mensajes que no se pueden entregar

Si no podemos entregar un mensaje correctamente en su punto de conexión, volveremos automáticamente a intentarlo siguiendo el esquema descrito a continuación:

1. Primer reintento después de 5 minutos
2. Segundo reintento después de 1 hora
3. Los reintentos subsiguientes, cada 12 horas durante 7 días (14 en total)

Puede que usted reciba un mensaje duplicado si no recibimos la confirmación de la recepción (200 Código de estado correcto) y el mensaje es puesto en cola para volver a intentarlo. Puede detectar un mensaje duplicado buscando el mismo event_id (ID del evento), aunque en una timestamp marca de hora posterior a la original.

API de comprobación de notificaciones

La API de comprobación de las notificaciones de EPS le permite solicitar que se envíen notificaciones de prueba a su punto de conexión de prueba especificado para verificar su integración con el servicio de notificaciones. También puede utilizar nuestro Comprobador del servicio de notificaciones para enviar notificaciones de prueba directamente a su punto de conexión sin generar sus propias solicitudes.

Notas importantes

La función de solicitud de este servicio no está presente para la API de notificaciones de producción; no puede enviar solicitudes al punto de conexión activo para activar o actualizar notificaciones de producción. Las solicitudes se ofrecen a través de esta API de comprobación exclusivamente con fines de prueba.

Dado que esta API es exclusivamente para fines de prueba, su activador de solicitudes GET solo está disponible a través de test.ean.com.

Esquema y temas de mensajes admitidos

Todas las notificaciones de prueba siguen el mismo esquema y los mismos temas de mensaje que las notificaciones de producción, tal como se describe en la documentación de la API de notificaciones anterior a esta sección.

Integración

Recepción de un mensaje

Para comenzar a recibir notificaciones push, tendrá que establecer un punto de conexión HTTPS públicamente accesible que pueda aceptar mensajes POST que se envíen a su punto de conexión.

Trabaje con su consultor de integración de EPS para ponerse en marcha y facilitarles:

• Una lista de temas de eventos a la que quiera suscribirse para probar (enumerada más arriba)
• El URL de su punto de conexión de prueba para gestionar los mensajes

Si no recibe una notificación de prueba después de transcurridos 30 minutos desde la solicitud, póngase en contacto con su Consultor de integración de EPS para que le ayude a resolver su problema.

Notas importantes

En las notificaciones que recibe, no habrá distinciones entre una notificación de prueba y una notificación de producción. Le recomendamos encarecidamente que configure un punto de conexión específico para que las notificaciones de prueba para poder separar correctamente los mensajes de prueba frente a los de producción.

Al configurar diferentes puntos de conexión para la prueba y producción, solamente recibirá notificaciones de prueba en su punto de conexión de prueba, y del mismo modo, solo recibirá notificaciones de producción en su punto de conexión de producción.