Notificaciones

Recibe alertas de diversos eventos de reserva para simplificar tus operaciones y escalar eficazmente

El servicio de Notificaciones te permite integrarte estrechamente con la API de Vuelo Rápido. Cuando se produzcan cambios en las reservas que puedan afectar a tu negocio u operaciones, el servicio de Notificaciones enviará los detalles del cambio directamente a tus sistemas a través de los mensajes estándar de POST. Con estas notificaciones, podrás estar al día, simplificar las operaciones y aumentar tu volumen de negocio.

Actualmente admitimos notificaciones para los eventos de post-booking que se producen fuera de nuestra API. Así, por ejemplo, si un agente del centro de llamadas realiza un cambio o cancela una reserva, se te notificará inmediatamente.

A medida que añadimos características y funcionalidades a la API de Vuelo Rápido, a menudo también añadimos nuevos tipos de eventos de notificación para mejorar tu experiencia.

Al permitir una integración perfecta con tu empresa, estas notificaciones sirven para complementar Rapid API, Affiliate Voyager, y otros servicios de asistencia a socios y clientes.

Detalles del evento

Todos los eventos de notificación de POST se ajustan a los valores que se indican a continuación. A medida que se añadan nuevos tipos de eventos para diferentes acontecimientos, los valores pueden variar.

Objeto	Descripción
`affiliate_reference_id`	El número de referencia del afiliado de la reserva afectada.
`email`	La dirección de correo electrónico del cliente que esté asociada al itinerario afectado.
`event_id`	Identificador único para cada evento.
`event_time`	Marca de hora de la notificación del evento en UTC.
`event_type`	Una indicación sobre qué evento ha generado la notificación. Este valor se puede utilizar para gestionar y enrutar los mensajes. Consulta la lista de tipos de eventos para obtener más información.
`itinerary_id`	El ID del itinerario de la reserva afectada.

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

Nota: Debes activar cada tipo de evento individualmente para poder recibir ese tipo de notificaciones. Si quieres habilitar un nuevo tipo de evento de notificaciones, contacta con el servicio de asistencia.

Tipos de eventos admitidos

El servicio de Notificaciones de Vuelo puede informar a tus sistemas con un mensaje para los siguientes eventos:

`event_type` valor	Origen	Evento	Detalles
`itinerary.supplier.ticket`	Aerolínea	Reserva de vuelos	La compañía aérea ha confirmado la reserva y emitido un billete (para vuelos con billete).
`itinerary.unspecified.change`	Varias	Cambio de vuelo	El viajero, un agente o la compañía aérea actualizaron una reserva existente (para cambios involuntarios, como un cambio de horario).
`itinerary.unspecified.cancel`	Varias	Vuelo cancelado	El viajero, la compañía aérea o un agente han cancelado una reserva existente.
`itinerary.supplier.refund`	Aerolínea	Reembolso del vuelo	La compañía aérea está proporcionando a los viajeros los reembolsos solicitados. Si la compañía aérea es la Merchant de registro, es su deber asegurarse de que el viajero recibe el reembolso.
`itinerary.unspecified.void`	Varias	Vuelo nulo	El viajero, la compañía aérea o un agente anularon una reserva existente.

Ejemplo de código de emisión de billetes para proveedores

{  
    "affiliate_reference_id": "",  
   "email": "abc123@gmail.com",  
   "event_id": "dcec1653-3b7f-4b03-b056-50176642869d",  
   "event_time": "2025-12-10T17:15:13.115Z",  
   "event_type": "itinerary.supplier.ticket",  
   "itinerary_id": "9025417059279",  
   "message": "The supplier issued a ticket for this flight itinerary."  
}

Ejemplo de código de cambio no especificado

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
 "event_id": "ab1bce97-175d-43d9-91c8-b09cdbf5ea46",  
  "event_time": "2025-12-10T17:15:21.016Z",  
  "event_type": "itinerary.unspecified.change",  
  "itinerary_id": "9025417973523",  
  "message": "This flight itinerary was changed."  
}

Ejemplo de código de cancelación no especificado

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com",  
  "event_id": "221b5da6-820a-4e7b-85bd-1ba7639abda1",  
  "event_time": "2025-12-10T17:15:16.840Z",  
  "event_type": "itinerary.unspecified.cancel",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was canceled."  
}

Ejemplo de código de reembolso al proveedor

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.supplier.refund",  
  "itinerary_id": "9025417466019",  
  "message": "The supplier initiated a refund for this flight itinerary."  
}

Ejemplo de código nulo no especificado

{  
  "affiliate_reference_id": "",  
  "email": "abc123@gmail.com", 
  "event_id": "aad184e3-d13b-41c6-99f3-ac13451fe3cc",  
  "event_time": "2025-12-10T17:15:22.954Z",  
  "event_type": "itinerary.unspecified.void",  
  "itinerary_id": "9025417466019",  
  "message": "This flight itinerary was voided."  
}