Saltar a contenido

Catálogo básico de alojamiento

Este método nos permite obtener la información mínima e indispensable sobre los distintos alojamientos. Puede utilizarse, por ejemplo, para crear una página inicial de búsqueda.

El resultado será un listado de los distintos alojamientos disponibles según los filtros de búsqueda.

Método de acceso

POST /Accommodation/BasicCatalog

Estructura de la petición

  • People: (list) Requerido. Listado de personas que componen el paquete. El orden en el cual se añaden las personas en este listado repercute, posteriormente, en el índice a usar en la propiedad Room

    • Person: (object) Requerido. Información de la persona.

      • Type: (int) Requerido. Tipo de persona.

        Posibles valores
        • 0: Bebé
        • 1: Niño
        • 2: Adulto
        • 3: Senior
        • 4: Genérico
      • Age: (int) Opcional. Edad de la persona. Obligatorio, únicamente, si se trata de un niño o bebé (tipo 1 y 2).

  • AccommodationIds: (list) Opcional. Listado que permite obtener únicamente paquetes de un conjunto de alojamientos.

    • (string): Opcional. Identificador del alojamiento.
  • Destination: (object) Requerido. Geolocalización a partir de la cual se realizará la búsqueda de alojamientos. Ver SuggestedLocation.
    • Latitude: (decimal) Requerido. Latitud de la geolocalización.
    • Longitude: (decimal) Requerido. Longitud de la geolocalización.
  • CheckIn: (date) Requerido. Fecha de entrada al alojamiento. Formato ISO 8601 (YYYY-MM-DD).
  • CheckOut: (date) Requerido. Fecha de salida del alojamiento. Formato ISO 8601 (YYYY-MM-DD).
  • RoomDistribution: (list) Requerido. Listado habitaciones que compondrán el paquete.

    • Room: (list) Requerido. Información de las Personas que componen esta habitación.
      • (int): Requerido. Índice correspondiente a la posición de la persona en el listado de Personas (People).
  • Sort: (object) Opcional. Ordenación de los resultados.

    • Criteria: (int) Opcional. Tipo de ordenación.

      Posibles valores
      • 1: Más baratos primero.
      • 2: Más caros primero.
      • 3: Más cercanos primero.
  • Paging: (object) Opcional. Información de la paginación.

    • Number: (int) Opcional. Número de página solicitada.
    • Size: (int) Opcional. Número de elementos por página.

Ejemplos de llamadas

Ejemplo: 2 habitaciones: "1 adulto + 1 niño" y "1 adulto"
{
    "People": [
        {
            "Type": 2
        },
        {
            "Type": 2
        },
        {
            "Type": 1,
            "Age": 5
        },
        {
            "Type": 2
        }
    ],
    "Destination": {           
        "Latitude": 42.3446912,
        "Longitude": 1.9566978000000
    },
    "CheckIn": "2023-01-25",
    "CheckOut": "2023-01-28",
    "RoomDistribution": [
        [
            0,
            1,
            2
        ],
        [
            3
        ]
    ],
    "Sort": {
        "Criteria": 1 
    },
    "Paging" : {
        "Number" : 1,
        "Size" : 10
    }
}
Ejemplo: 1 habitación: "1 adulto + 1 niño" en alojamiento 3*
{
    "People": [
        {
            "Type": 2
        },
        {
            "Type": 1,
            "Age": 5
        }
    ],
    "Destination": {           
        "Latitude": 42.3446912,
        "Longitude": 1.9566978000000
    },
    "CheckIn": "2023-01-25",
    "CheckOut": "2023-01-28",
    "RoomDistribution": [
        [
            0,
            1
        ]
    ]
    "Filter": {
        "AccommodationCategories": [
            3
        ]
    },
    "Sort": {
        "Criteria": 1 
    },
    "Paging" : {
        "Number" : 1,
        "Size" : 10
    }
}

Estructura de la respuesta

  • TotalPages: (int). Número total de páginas.
  • Accommodations: (list). Listado de alojamientos.
    • MainImageUrl: (string). Url de la imagen principal del alojamiento.
    • Name: (string). Nombre del alojamiento.
    • Description: (string). Descripción del alojamiento.
    • Address: (string). Dirección del alojamiento.
    • City: (string). Ciudad donde se ubica el alojamiento.
    • PostalCode: (string). Código postal del alojamiento.
    • Country: (string). País donde está ubicado el alojamiento.
    • Type: (string). Tipo de alojamiento.

      Posibles valores
      • 0: Sin clasificar
      • 1: Hotel
      • 2: Hostal
      • 3: Camping
      • 4: Apartamento
    • Category: (string). Categoría del alojamiento.

      Posibles valores
      • 0: Desconocida.
      • 1: 1 Estrella.
      • 2: 2 Estrellas.
      • 3: 3 Estrellas.
      • 4: 4 Estrellas.
      • 5: 5 Estrellas.
  • AvailableFilters: (list). Da información de los filtros disponibles según el criterio de búsqueda. Por ejemplo para afinar futuras búsquedas usando el parámetro de llamada "Filter". En todos los casos se devuelve un array de objetos con las propiedades "Value" (coincidente con los valores definidos en "Filter") y "Count" indicando cuántas coincidencias de cada filtro. Se devuelve información sobre (ver definición en parámetro de llamada "Filter"):

    • AccommodationBoards: (list)
    • AccommodationCategories: (list)
    • AccommodationCities: (list)
    • AccommodationRateClasses: (list)
    • AccommodationTypes: (list)
  • Success: (boolean). Valor que indica si la llamada ha sido procesada correctamente o no.

  • Errors: (list). Array de errores.
    • Error: (object).
      • ErrorMessage: (string). Mensaje de error explicando por qué la petición no ha sido correcta. En caso que haya sido correcta, devolverá null.
      • ErrorCode: (int). Código que identifica al error.
  • ErrorEntityBreakDown (list): Lista que contiene objetos con el nombre e ID en caso de error.
    • Id (string): Identificador
    • Name (string): Nombre relacionado del identificador.

Ejemplos de respuesta

Example
{
    "TotalPages": 1,
    "AvailableFilters": {
        "AccommodationBoards": [
            {
                "Value": 10,
                "Count": 19
            },
            {
                "Value": 20,
                "Count": 16
            },
            {
                "Value": 30,
                "Count": 12
            }
        ],
        "AccommodationCategories": [
            {
                "Value": 0,
                "Count": 1
            },
            {
                "Value": 1,
                "Count": 1
            },
            {
                "Value": 2,
                "Count": 4
            },
            {
                "Value": 3,
                "Count": 10
            },
            {
                "Value": 4,
                "Count": 8
            },
            {
                "Value": 5,
                "Count": 2
            }
        ],
        "AccommodationCities": [
            {
                "Value": "Andorra La Vella",
                "Count": 6
            },
            {
                "Value": "Camprodon",
                "Count": 1
            },
            {
                "Value": "Canillo",
                "Count": 3
            },
            {
                "Value": "Encamp",
                "Count": 2
            },
            {
                "Value": "Escaldes Engordany",
                "Count": 1
            },
            {
                "Value": "Escaldes Engordany - Andorra La Vella",
                "Count": 1
            },
            {
                "Value": "Font Romeu",
                "Count": 1
            },
            {
                "Value": "La Molina",
                "Count": 2
            },
            {
                "Value": "Les Angles",
                "Count": 1
            },
            {
                "Value": "Meritxell",
                "Count": 1
            },
            {
                "Value": "Mollo",
                "Count": 1
            },
            {
                "Value": "Pas De La Casa",
                "Count": 1
            },
            {
                "Value": "Ransol - Canillo",
                "Count": 1
            },
            {
                "Value": "Ribes De Freser",
                "Count": 1
            },
            {
                "Value": "Soldeu",
                "Count": 3
            }
        ],
        "AccommodationRateClasses": [
            {
                "Value": 1,
                "Count": 7
            },
            {
                "Value": 2,
                "Count": 25
            }
        ],
        "AccommodationTypes": [
            {
                "Value": 0,
                "Count": 1
            },
            {
                "Value": 1,
                "Count": 18
            },
            {
                "Value": 2,
                "Count": 1
            },
            {
                "Value": 4,
                "Count": 6
            }
        ]
    },
    "Accommodations": [
        {
            "Distance": 26601.1617431278,
            "Price": 82.18,
            "MainImageUrl": "https://some.url.com/giata/29/291641/291641a_hb_a_004.jpg",
            "Id": "291641/weqn6yqht5bfw",
            "Name": "Chalets de l'Isard - Vacanceole",
            "Description": "Esta sencilla residencia se encuentra en Les Angles. Ubicada a 300 metros del centro del pueblo, la propiedad brinda un fácil acceso a todo lo que este destino tiene para ofrecer. El establecimiento está a 10 metros de las pistas. El alojamiento se encuentra a 13. 0 km de las principales conexiones con el transporte público. Chalets de l'Isard - Vacanceole tiene un total de 81 dormitorios disponibles para sus huéspedes. Asimismo, el alojamiento cuenta con Wi-Fi gratuito. Chalets de l'Isard - Vacanceole no ofrece servicio de recepción 24 horas. Desafortunadamente, no hay habitaciones en las que las personas que se hospeden en este alojamiento puedan pedir una cuna para los más pequeños. Las zonas comunes de la propiedad están adaptadas a personas con discapacidad. El establecimiento también dispone de una habitación accesible. Este establecimiento es ecológicamente sostenible. Los huéspedes de este establecimiento podrán aprovechar sus múltiples servicios de salud y bienestar. La residencia puede cobrar el importe de algunos de estos servicios. ",
            "Address": "Route du Pla del Mir",
            "City": "Les Angles",
            "PostalCode": "66210",
            "Country": "France",
            "Type": 0,
            "Category": 0            
        },
        {
            "Distance": 19014.6253644023,
            "Price": 99.24,
            "MainImageUrl": "https://some.url.com/giata/14/145242/145242a_hb_a_002.jpg",
            "Id": "145242/weqn6yqht5bfw",
            "Name": "The Catalogne",
            "Description": "Este maravilloso hotel está convenientemente ubicado en el corazón de Font Romeu, a sólo 200 metros del a telecabina de esquí y de un campo de golf. Entre otros servicios, el establecimiento ofrece alquiler de material de esquí y venta de forfaits en el hotel. Hay acceso a Internet disponible en todo el edificio y los huéspedes que lleguen en coche podrán dejar su vehículo en el aparcamiento del hotel. Este establecimiento consta de un total de 42 apartamentos, todos ellos con vistas espléndidas a la cordillera de los Pirineos. Los huéspedes seguramente disfrutarán de pasar el rato en la acogedora sala de estar con TV, o de relajarse con un buen libro o un refresco en la zona de estar y comedor.",
            "Address": "Avenue D'Espagne, 9 BP49",
            "City": "Font Romeu",
            "PostalCode": "66120",
            "Country": "France",
            "Type": 4,
            "Category": 1            
        }
    ],
    "Success": true
}