Consumos Externos

Consultar reservas activas por documento

Consulta las reservas activas de un huésped en un hotel, como paso previo para registrarle un consumo externo. Se autentica con el API Key de integración externa (header X-Api-Key).

Solo retorna reservas no canceladas en checkin_registered (huésped actualmente hospedado): no aparecen las confirmadas sin check-in ni las que ya hicieron check-out. Un huésped puede tener varias reservas activas en el mismo hotel; vienen ordenadas de la llegada más reciente a la más antigua.

get/api/v1/reservations/find_by

Request

  • Base URL
    https://aos.ayenda.co
  • URL
    https://aos.ayenda.co/api/v1/reservations/find_by
  • Auth
    none required

Query parameters

hotel_idinteger required
Example:1

ID del hotel al que pertenece la reserva. Se obtiene de GET /api/v1/hotels/find_by.

identification_numberstring required
Example:123456789

Número de documento del huésped. Puede ser cualquiera de los huéspedes registrados en la reserva.

Headers

X-Api-Keystring required
Example:external_integration_api_key

API Key de integración externa. X-Api-Key.

Response

ok

Example response

{
  "data": [
    {
      "reservation_id": 1001,
      "start_at": "2024-03-15",
      "end_at": "2024-03-18",
      "guest_name": "Juan Pérez",
      "identification_number": "123456789",
      "room_names": [
        "HAB-101"
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.