Cómo confirmar o cancelar una reserva de vuelo
Después de crear una reserva, puedes confirmarla para emitir boletos o cancelarla si la reserva ya no es necesaria. Ambas acciones utilizan el mismo punto final PATCH con diferentes cuerpos de solicitud.
Punto final
PATCH /flights/api/v2/bookings/{booking_id}
encabezados
| Encabezado | Requerido | Descripción |
|---|---|---|
x-api-key | Sí | Su clave API. |
x-correlation-id | Sí | ID de correlación de la respuesta de autocompletar. |
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
booking_id | cadena | Sí | El ID de reserva devuelto cuando se creó la reserva. |
Confirmar una reserva
Envíe una solicitud PATCH con booking_status configurado en "Confirm" para emitir tickets.
Cuerpo de solicitud
JSON
{
"booking_status": "Confirm"
}Solicitud de ejemplo
PATCH /flights/api/v2/bookings/XNFiEtVA3LL
JSON
{
"booking_status": "Confirm"
}Ejemplo de respuesta
JSON
{
"status": "success",
"data": {
"booking_id": "XNFiEtVA3LL",
"booking_status": "TICKETED"
},
"message": "Booking confirmed successfully"
}Posibles estados de confirmación
| Estado | Descripción |
|---|---|
TICKETED | Los boletos se emitieron de inmediato. |
TICKETINPROCESS | La emisión de billetes está en curso. Vuelva a consultar en breve utilizando el punto final de obtención de reservas. |
Cancelar una reserva
Envíe una solicitud de PATCH con booking_status configurado en "Cancel" para cancelar la reserva.
Cuerpo de solicitud
JSON
{
"booking_status": "Cancel"
}Solicitud de ejemplo
PATCH /flights/api/v2/bookings/XNFiEtVA3LL
JSON
{
"booking_status": "Cancel"
}Ejemplo de respuesta
JSON
{
"status": "success",
"data": {
"booking_id": "XNFiEtVA3LL",
"booking_status": "CANCELLED"
},
"message": "Booking cancelled successfully"
}Referencia del estado de la reserva
| Estado | Descripción |
|---|---|
BOOKED | La reserva está retenida pero aún no se ha emitido el billete. Debe confirmarse antes del límite de tiempo del boleto. |
TICKETED | Se han emitido billetes. La reserva está totalmente confirmada. |
TICKETINPROCESS | Se está procesando la emisión de boletos. Sondee el punto final de obtención de reserva para verificar que se haya completado. |
CANCELLED | La reserva ha sido cancelada. |
Notas importantes
- Límite de tiempo del ticket. Cuando una reserva tiene el estado
BOOKED, debe confirmarse antes de que se devuelva eltickettimelimiten la respuesta de creación de la reserva. Pasado este plazo, la reserva podrá ser liberada automáticamente por la aerolínea. - Malificaciones por cancelación. La cancelación de una reserva con boleto puede generar multas según las reglas de tarifas. Revise las reglas tarifarias antes de cancelar. Consulte Cómo recuperar reglas de tarifas para un vuelo.
- Cancelar una reserva retenida. La cancelación de una reserva con estado
BOOKED(aún sin emitir el boleto) generalmente no genera ninguna penalización. - TICKETINPROCESS. Si la respuesta de confirmación devuelve
TICKETINPROCESS, la emisión de boletos aún está en curso. Utilice el punto final Obtener detalles de reserva para sondear el estado final.
Artículos relacionados
- Cómo reservar un vuelo: crea la reserva que luego confirmas o cancelas.
- Cómo recuperar detalles de la reserva de un vuelo: verifique el estado actual de cualquier reserva.
- Cómo recuperar las reglas de tarifas de un vuelo: comprenda las sanciones por cancelación antes de cancelar.