Ранний заезд/поздний выезд

Ранний заезд/поздний выезд: получение информации о доступности опций Early Check-in/Late Check-out для конкретного размещения для указанного типа номера и тарифа с учетом состава гостей и интервала проживания.

1. Получение списка вариантов размещения по конкретному средству размещения

Запрос:

GET /api/search/v1/properties/{{property_id}}/room-stays?arrivalDate=2025-09-21&departureDate=2025-09-22&adults=1&includeExtraStays=false&includeExtraServices=false HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

Параметры:

Параметр	Тип	Обязательный	Описание
arrivalDate	string	Да	Дата заезда
departureDate	string	Да	Дата выезда
adults	int	Да	Количество взрослых
childAges	array[int]	Нет	Список возрастов детей
corporateIds	array[string]	Нет	Идентификаторы корпоративных клиентов
includeExtraStays	boolean	Нет	Признак включения возможности раннего заезда/позднего выезда в результат поиска
includeExtraServices	boolean	Нет	Признак включения дополнительных услуг в результат поиска

Ответ:

{
  "roomStays": [
    {
      "extraServicesAvailable": true,
      "extraStays": null,
      "extraServices": null,
      "propertyId": "6639",
      "roomType": {
        "placements": [
          {
            "code": "AdultBed-1",
            "count": 1,
            "kind": "Adult",
            "minAge": null,
            "maxAge": null
          }
        ],
        "id": "394546"
      },
      "ratePlan": {
        "id": "440534",
        "corporateIds": null
      },
      "guestCount": {
        "adultCount": 1,
        "childAges": []
      },
      "stayDates": {
        "arrivalDateTime": "2025-09-21T08:00",
        "departureDateTime": "2025-09-22T20:00"
      },
      "availability": 75,
      "currencyCode": "RUB",
      "total": {
        "priceBeforeTax": 4100,
        "taxAmount": 410,
        "taxes": [
          {
            "amount": 410,
            "name": "Динамический",
            "description": "Описание динамического налога"
          }
        ]
      },
      "cancellationPolicy": {
        "freeCancellationPossible": false,
        "freeCancellationDeadlineLocal": null,
        "freeCancellationDeadlineUtc": null,
        "penaltyAmount": 410
      },
      "includedServices": [],
      "mealPlanCode": "RoomOnly",
      "checksum": "eyJDaGVja3N1bVdpdGhPdXRFeHRyYXMiOnsiVG90YWxBbW91bnRBZnRlclRheCI6IjQ1MTAuMDAiLCJDdXJyZW5jeUNvZGUiOiJSVUIiLCJTdGFydFBlbmFsdHlBbW91bnQiOiI0MTAuMDAifSwiQ2hlY2tzdW1XaXRoRXh0cmFzIjp7IlRvdGFsQW1vdW50QWZ0ZXJUYXgiOiI0NTEwLjAwIiwiQ3VycmVuY3lDb2RlIjoiUlVCIiwiU3RhcnRQZW5hbHR5QW1vdW50IjoiNDEwLjAwIn19",
      "fullPlacementsName": "1 взрослый на основном месте.",
      "bookingFormLink": "Booking form link"
    },
    {
      "extraServicesAvailable": true,
      "extraStays": null,
      "extraServices": null,
      "propertyId": "6639",
      "roomType": {
        "placements": [
          {
            "code": "AdultBed-1",
            "count": 1,
            "kind": "Adult",
            "minAge": null,
            "maxAge": null
          }
        ],
        "id": "394547"
      },
      "ratePlan": {
        "id": "440534",
        "corporateIds": null
      },
      "guestCount": {
        "adultCount": 1,
        "childAges": []
      },
      "stayDates": {
        "arrivalDateTime": "2025-09-21T08:00",
        "departureDateTime": "2025-09-22T20:00"
      },
      "availability": 75,
      "currencyCode": "RUB",
      "total": {
        "priceBeforeTax": 10000,
        "taxAmount": 2000,
        "taxes": [
          {
            "amount": 2000,
            "name": "Динамический",
            "description": "Описание динамического налога"
          }
        ]
      },
      "cancellationPolicy": {
        "freeCancellationPossible": false,
        "freeCancellationDeadlineLocal": null,
        "freeCancellationDeadlineUtc": null,
        "penaltyAmount": 1000
      },
      "includedServices": [],
      "mealPlanCode": "RoomOnly",
      "checksum": "eyJDaGVja3N1bVdpdGhPdXRFeHRyYXMiOnsiVG90YWxBbW91bnRBZnRlclRheCI6IjEyMDAwLjAwIiwiQ3VycmVuY3lDb2RlIjoiUlVCIiwiU3RhcnRQZW5hbHR5QW1vdW50IjoiMTAwMC4wMCJ9LCJDaGVja3N1bVdpdGhFeHRyYXMiOnsiVG90YWxBbW91bnRBZnRlclRheCI6IjEyMDAwLjAwIiwiQ3VycmVuY3lDb2RlIjoiUlVCIiwiU3RhcnRQZW5hbHR5QW1vdW50IjoiMTAwMC4wMCJ9fQ==",
      "fullPlacementsName": "1 взрослый на основном месте.",
      "bookingFormLink": "Booking form link"
    }
  ],
  "services": [],
  "content": null,
  "warnings": [
    null
  ]
}

2. Получение информации о доступности опций Early Check-in/Late Check-out

Запрос:

POST /api/search/v1/properties/{{property_id}}/services HTTP/1.1
Host: partner.tlintegration.com
Authorization: Bearer {{access_token}}

{
  "roomType": {
  "placements": [
    {
      "code": "AdultBed-1",
      "count": 1,
      "kind": "Adult",
      "minAge": null,
      "maxAge": null
    }
  ],
  "id": "394546"
  },
  "ratePlan": {
    "id": "440534",
    "corporateIds": null
  },
  "guestCount": {
    "adultCount": 1,
    "childAges": []
  },
  "stayDates": {
    "arrivalDateTime": "2025-09-21T08:00",
    "departureDateTime": "2025-09-22T20:00"
  }
}

Ответ:

{
  "extraStays": {
    "earlyCheckIn": [
      {
        "total": {
          "priceBeforeTax": 410,
          "taxAmount": 41,
          "taxes": [
            {
              "amount": 41,
              "name": "Динамический",
              "description": "Описание динамического налога"
            }
          ]
        },
        "currencyCode": "RUB",
        "dateTimeLocal": "2025-09-21T07:30",
        "isOccupyQuota": false
      },
      {
        "total": {
          "priceBeforeTax": 410,
          "taxAmount": 41,
          "taxes": [
            {
              "amount": 41,
              "name": "Динамический",
              "description": "Описание динамического налога"
            }
          ]
        },
        "currencyCode": "RUB",
        "dateTimeLocal": "2025-09-21T07:00",
        "isOccupyQuota": false
      },
      {
        "total": {
          "priceBeforeTax": 410,
          "taxAmount": 41,
          "taxes": [
            {
              "amount": 41,
              "name": "Динамический",
              "description": "Описание динамического налога"
            }
          ]
        },
        "currencyCode": "RUB",
        "dateTimeLocal": "2025-09-21T06:30",
        "isOccupyQuota": false
      }
    ],
    "lateCheckOut": [
      {
        "total": {
          "priceBeforeTax": 200,
          "taxAmount": 20,
          "taxes": [
            {
              "amount": 20,
              "name": "Динамический",
              "description": "Описание динамического налога"
            }
          ]
        },
        "currencyCode": "RUB",
        "dateTimeLocal": "2025-09-22T23:59",
        "isOccupyQuota": false
      },
      {
        "total": {
          "priceBeforeTax": 200,
          "taxAmount": 20,
          "taxes": [
            {
              "amount": 20,
              "name": "Динамический",
              "description": "Описание динамического налога"
            }
          ]
        },
        "currencyCode": "RUB",
        "dateTimeLocal": "2025-09-22T23:30",
        "isOccupyQuota": false
      },
      {
        "total": {
          "priceBeforeTax": 200,
          "taxAmount": 20,
          "taxes": [
            {
              "amount": 20,
              "name": "Динамический",
              "description": "Описание динамического налога"
            }
          ]
        },
        "currencyCode": "RUB",
        "dateTimeLocal": "2025-09-22T23:00",
        "isOccupyQuota": false
      }
    ]
  }
}