Your EPS account
Sign in to view secure API documentation, update your account details, log support requests and much more.
Your email or password is incorrect. Please try again or reset your password.
If the issue persists please contact your EPS representative.
Reset your password
Please enter your email address below. We will send password reset instructions to the email associated with your EPS account.
Thank you
An email has been sent to your account email address with further instructions on how to reset your password.
Notificaciones
Esta página describe el servicio de notificaciones, que le envía a usted alertas de eventos relacionados con las reservas
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:
Origen | Evento | Detalles |
---|---|---|
Agente de atención al cliente o Voyager para afiliados | Creación de las reservas | Una nueva reserva ha sido creada por un agente de atención al cliente de EPS o Voyager para afiliados. |
Actualización de las reservas |
Una reserva existente ha sido actualizada por un agente de atención al cliente de EPS o Voyager para afiliados. |
|
Cancelación de la reserva | Una reserva existente ha sido cancelada por un agente de atención al cliente de EPS o Voyager para afiliados. | |
Hotel | Cancelación de la reserva | Una reserva existente ha sido cancelada por el hotel. El cliente debe ponerse en contacto con el servicio de atención a clientes empresariales. |
Expedia | Cancelación de la reserva |
Una reserva existente ha sido cancelada por Expedia porque la reserva no cumplía los términos y/o las condiciones aplicables a la transacción. El cliente tendrá que ponerse en contacto con transactionprocessing@travelscape.com para comunicar su número de teléfono y la mejor hora para hablar sobre la cancelación. |
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.
Objeto | Descripción |
---|---|
event_id |
Identificador único para cada mensaje |
event_type |
Una indicación sobre qué evento ha generado la notificación. Este valor se puede utilizar para gestionar y enrutar los mensajes. Consulte la lista de tipos de eventos para obtener más información. |
event_time |
Marca de hora de la notificación del evento en UTC. |
itinerary_id |
El ID del itinerario de la reserva afectada |
email |
La dirección de correo electrónico del cliente que esté asociada al itinerario afectado |
message |
Descripción de la notificación del evento |
affiliate_reference_id |
El ID de referencia del afiliado de la reserva afectada |
Temas admitidos de los mensajes
Origen | Evento | Valor event_type |
---|---|---|
Agente de atención al cliente o Voyager para afiliados | Creación de las reservas | itinerary.agent.create |
Actualización de las reservas | itinerary.agent.change |
|
Cancelación de las reservas | itinerary.agent.cancel |
|
Hotel | Cancelación de las reservas | itinerary.supplier.cancel |
Expedia | Cancelación de las reservas | itinerary.fraud.cancel |
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.
Resultado de la gestión | Detalles | Código de estado de la respuesta |
---|---|---|
Acierto |
|
200 |
Error |
|
Códigos 400 |
|
Códigos 500 |
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:
- Primer reintento después de 5 minutos
- Segundo reintento después de 1 hora
- 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.
EPS Home | EPS Portal Login | Expedia Partner Central | Advertise with Expedia | News | Privacy Policy | Cookie Policy
© 2020 Expedia, Inc. All Rights Reserved.