Reservas

Tabla de Contenidos¶

• Introducción
• Casos de uso
• Métodos disponibles
• Tabla de parámetros
• Booking
• Stay
• Extra
• Guest
• Ejemplos

Introducción¶

En este artículo hablamos sobre las peticiones de la API relacionadas con los Bookings.

Procesar un booking¶

El endpoint se encarga de verificar la creación/actualización de la reserva en cuestión, así como de las estancias, contactos asociados.

Es necesario que el apiuser posea el permiso "bookings" para la utilización de este endpoint.

• Endpoint: https://app.hoteldatahub.io/api/v1/bookings/
• Swagger: https://app.hoteldatahub.io/swagger/#/bookings

Casos de uso¶

El endpoint para la gestión de reservas resulta de gran utilidad para incorporar nuevas reservas en Fideltour procedentes de distintas fuentes. Para el caso de reservas ya existentes, permite ampliar la información contenida en su ficha enriqueciendo así la calidad de la base de datos. Múltiples orígenes de datos permiten obtener distinta información que después se centraliza en Fideltour.

Métodos disponibles¶

Tabla de parámetros¶

Booking¶

Stay¶

Nota: Para temas de comodidad, campos ya presentes en el booking con el mismo valor en el stay se pueden omitir, de esta forma el stay inferirá dichos valores del booking.

Extra¶

Guest¶

Ejemplos¶

A continuación mostramos un ejemplo de procesamiento de reserva:

Petición (POST)¶

Protocolo: HTTP/1.1 Método: POST Endpoint: https://app.hoteldatahub.io/api/v1/bookings/

Headers:

Content-Type: application/json
Authorization: Token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Body:

{
  "hotel": 2293,
  "hotel_chain": "6NOK",
  "date": "2025-11-27T10:08:08",
  "entrance": "2026-10-02",
  "departure": "2026-10-04",
  "localizer": "91764088833/6",
  "external_object_id": "12345726",
  "agency": "Empresa de prueba",
  "offer": "Black Friday",
  "category": "Adultos consumistas",
  "amount": 280,
  "currency": "EUR",
  "input_channel": 4,
  "status": 2,
  "stays": [
    {
      "entrance": "2026-10-02",
      "departure": "2026-10-04",
      "localizer": "91764088833/6",
      "external_object_id": "123456112",
      "amount": 280,
      "currency": "EUR",
      "room": "0A Doble 2 camas",
      "room_type": "Habitación Doble",
      "regime": "Alojamiento",
      "adults": 2,
      "children": 0,
      "status": 2,
      "guests": [
        {
          "id": "3183465",
          "name": "BETTINA",
          "is_owner": true,
          "surname": "STROBEL",
          "email": "bettinastrobel@web.de",
          "phone": "0049772691980",
          "gender": 2,
          "language": "es",
          "birthday": "1990-12-12",
          "post_code": "07009",
          "notes": "",
          "country": "DE",
          "custom_tags": [],
          "subscribed": false
        }
      ]
    }
  ]
}