Cómo recuperar las reglas de tarifas de un vuelo

Antes de reservar un vuelo, puede consultar las reglas de tarifas para comprender las políticas de cancelación, las opciones de cambio y las sanciones asociadas. El punto final de las reglas de tarifas utiliza el cabinavailabilitytoken obtenido de la verificación de disponibilidad.

Punto final

GET /flights/api/v2/farerules/{cabinavailabilitytoken}

encabezados

Parámetros de ruta

Solicitud de ejemplo

GET /flights/api/v2/farerules/cat_xyz789abc123

Ejemplo de respuesta

{
  "status": "success",
  "data": {
    "fare_type": "Published",
    "fare_rules": [
      {
        "city_pair": "SFO - BLR",
        "void_applicable": true,
        "fareruletext": "CANCELLATIONS: Ticket is non-refundable after 24 hours of purchase. CHANGES: Changes permitted with a fee of USD 200 per passenger.",
        "structuredpenaltyinfo": {
          "cancellable": true,
          "exchangeable": true,
          "penalty_details": [
            {
              "passenger_type": "ADULT",
              "cancellation_charge": {
                "amount": 250,
                "currency": "USD",
                "type": "fixed"
              },
              "exchange_charge": {
                "amount": 200,
                "currency": "USD",
                "type": "fixed"
              }
            },
            {
              "passenger_type": "CHILD",
              "cancellation_charge": {
                "amount": 250,
                "currency": "USD",
                "type": "fixed"
              },
              "exchange_charge": {
                "amount": 200,
                "currency": "USD",
                "type": "fixed"
              }
            },
            {
              "passenger_type": "INFANT",
              "cancellation_charge": {
                "amount": 0,
                "currency": "USD",
                "type": "fixed"
              },
              "exchange_charge": {
                "amount": 0,
                "currency": "USD",
                "type": "fixed"
              }
            }
          ]
        }
      }
    ]
  },
  "message": "Fare rules retrieved successfully"
}

Campos de respuesta

Campos de nivel superior

Objeto de regla de tarifa

Información de penalización estructurada

Detalles de la penalización (por tipo de pasajero)

Comprender las reglas de tarifas

Cancelable vs. No cancelable

• Si cancellable es true, la reserva se puede cancelar, pero se puede aplicar una penalización basada en cancellation_charge.
• Si cancellable es false, el billete no es reembolsable. No recibirás ningún reembolso si cancelas.

Intercambiable versus no intercambiable

• Si exchangeable es true, puedes cambiar las fechas de viaje o ruta pagando la penalización exchange_charge.
• Si exchangeable es false, no se permiten cambios. Deberías cancelar y volver a reservar.

Ventana vacía

Si void_applicable es true, es posible que pueda anular el boleto dentro de un breve período (a menudo 24 horas después de la compra) sin penalización. Las políticas varían según la aerolínea.

Consejos

• Presente siempre las reglas tarifarias a los usuarios antes de confirmar una reserva para que comprendan las políticas de cancelación y cambio.
• El campo fareruletext contiene los términos oficiales de la aerolínea. Utilícelo para mostrar cuando se necesiten términos detallados.
• El structuredpenaltyinfo es mejor para la lógica programática, como calcular posibles montos de reembolso.
• Las reglas de tarifas pueden diferir entre pares de ciudades en itinerarios de múltiples segmentos. Verifique cada entrada en la matriz fare_rules.

Artículos relacionados

• Cómo verificar la disponibilidad y los precios de los vuelos: obtenga el cabinavailabilitytoken necesario para este punto final.
• Cómo reservar un vuelo: continúe con la reserva después de revisar las reglas de tarifas.