Cómo recuperar los detalles de la reserva del resort

Después de crear una reserva, puedes recuperar todos los detalles en cualquier momento utilizando el número de referencia de la reserva. Este punto final devuelve información completa que incluye el estado de la reserva, el desglose de la tarifa, los detalles del viajero, la información de la propiedad y las políticas de la propiedad.

Punto final

GET {{apihost}}/resorts/api/v2/booking/{referencenumber}

Encabezados requeridos

Parámetros de ruta

Solicitud de ejemplo

GET {{api_host}}/resorts/api/v2/booking/XRN-2026040100123

Ejemplo de respuesta

{
  "status": 200,
  "data": {
    "booking_status": "CONFIRMED",
    "booking_date": "2026-03-15T14:30:00Z",
    "checkin_date": "2026-04-01",
    "checkout_date": "2026-04-07",
    "checkin_time": "16:00",
    "checkout_time": "11:00",
    "fare_breakup": {
      "base_rate": 245,
      "taxesandfees": 38.5,
      "total_rate": 1710,
      "currency": "USD",
      "published_price": 1850
    },
    "traveler_details": {
      "first_name": "Jane",
      "middle_name": "",
      "last_name": "Doe",
      "email": "guest@example.com",
      "phone": "+1-555-123-4567",
      "address": "456 Palm Avenue",
      "city": "Los Angeles",
      "state": "CA",
      "zip_code": "90001",
      "country": "US"
    },
    "property_details": {
      "name": "Oceanfront Paradise Resort & Spa",
      "address": {
        "line_1": "100 Beachfront Drive",
        "city": "Kailua-Kona",
        "state": "HI",
        "country": "US",
        "postal_code": "96740"
      },
      "urgent_info": {
        "mandatory_fees": [
          {
            "description": "Resort fee",
            "amount": 25,
            "currency": "USD",
            "frequency": "per night"
          }
        ],
        "policy_restrictions": {
          "pets": "No pets allowed.",
          "smoking": "Non-smoking property. Smoking is prohibited in all rooms and common areas.",
          "minimum_age": 21,
          "resort_fees": "A mandatory resort fee of $25.00 per night is charged at check-in. This fee covers pool access, Wi-Fi, and fitness center."
        }
      }
    }
  }
}

Campos de respuesta

Campos de reserva de nivel superior

tarifa_ruptura

detallesdelviajero

detalles_propiedad

detallespropiedad.infourgente

Esta sección contiene información crítica que se debe comunicar al huésped antes o durante el check-in.

tarifas_obligatorias

Una variedad de tarifas cobradas en la propiedad, no incluidas en la tarifa de reserva.

restricciones_políticas

Casos de uso

• Página de confirmación de reserva: muestra el resumen completo de la reserva después de una reserva exitosa.
• Gestión de reservas: permite a los huéspedes ver los detalles de sus próximas reservas.
• Comunicación previa a la llegada: horarios de check-in en superficie, tarifas obligatorias y restricciones de políticas antes de la llegada del huésped.
• Seguimiento de estado: supervise los cambios de estado de la reserva a lo largo del tiempo.

Mejores prácticas

• Exponga la información urgente de manera destacada: las tarifas obligatorias y las restricciones de la política según urgent_info son fundamentales para las expectativas de los huéspedes. Muéstrelos claramente en los correos electrónicos de confirmación y en las páginas de detalles de la reserva.
• Destacar las tarifas obligatorias: las tarifas del resort y otros cargos obligatorios a menudo no están incluidos en la tarifa de reserva. Asegúrese de que los huéspedes comprendan el costo total de su estadía.
• Mostrar horarios de entrada y salida: muestra la fecha y la hora de entrada y salida para ayudar a los huéspedes a planificar su llegada y salida.

Próximo artículo: Comprensión de los estados y políticas de las reservas