---
title: Связь с системой управления гостиницей (PMS)
url: https://doc2.pstreamer.tv/ru/manual/planning/hotels/pms.html
lang: ru
product: Perfect Streamer
version: 2.0.2.423
---

# Связь с системой управления гостиницей (PMS)

> **Важно**
>
> **Бета-версия 2.1.** Описанное здесь есть только в бета-версии 2.1: она ставится из бета-репозитория и только с лицензией, в стабильной версии 2.0.2 и в демоверсии этого нет. Бета-версия поставляется без гарантий, поддержка — по возможности ([Программа бета-тестирования](../../extras/beta.md#extras-beta)).

С версии 2.1.0.471 узел принимает события системы управления гостиницей (PMS): заселение, выезд, переезд и сверку. Заселение открывает телевизорам номера каналы до времени выезда, выезд блокирует их и завершает идущие сеансы. Связь с PMS обычно идёт через интерфейс её поставщика (по протоколу FIAS на стороне PMS); этот интерфейс и вызывает узел. В демоверсии этой возможности нет.

## Номера — это логины

Гостиничный номер — это локальные логины с одинаковым полем «Номер» в редакторе логина ([Пользователь: добавление и изменение](../../webui/configure.md#webui-user-editor)). Варианты:

- по логину на телевизор — логин по IP-адресу телевизора;
- один логин-диапазон адресов на номер, если телевизоры номера в своей подсети.

У логина с пустым «Номером» PMS ничего не меняет. У логинов номера она задаёт «Дату окончания» (время выезда), имя гостя и, если настроены пакеты, «Разрешённые потоки». Имя гостя видит только роль Admin, в журнал оно не пишется.

## Что делают события

- **Заселение** открывает логины номера до времени выезда, записывает имя гостя и, если PMS назвала пакет, потоки этого пакета. Тем же событием PMS продлевает или сокращает проживание.
- **Выезд** блокирует логины номера, стирает имя гостя и в течение нескольких секунд завершает их сеансы PS1, SRT и HTTP/HLS.
- **Переезд** — выезд из одного номера и заселение другого с тем же временем выезда, гостем и потоками.
- **Сверка** — PMS присылает список всех заселённых номеров: перечисленные заселяются, а остальные заселённые номера с полем «Номер» освобождаются.

Если PMS передаёт дату выезда без времени, номер блокируется в «Час выезда» (по часовому поясу узла, по умолчанию 12).

## В консоли

Гостиничные функции работают, пока на узле включено «Гостиничное ТВ» ([Гостиничное ТВ](../../webui/administration.md#webui-hotel-tv)). На узле, где гостиничных данных ещё нет, оно выключено: включите его, прежде чем настраивать связь с PMS.

- Вкладка **«Номера»** экрана «Пользователи / Логины» ([Пользователи / Логины](../../webui/configure.md#webui-users)) — номера, их состояние («Заселён», «Свободен», «На паузе»), время выезда, логины номера, связь с PMS (последнее событие, последняя сверка, ошибки, неизвестные номера) и предупреждения о логинах, через которые заблокированный номер всё равно сможет смотреть;
- экран **«Администрирование ▸ Гостиничное ТВ»** — «Принимать события PMS», «Токен API», «Разрешённые адреса», «Час выезда» и пакеты. До версии 2.1.0.477 эти настройки были на вкладке «PMS» экрана логинов.

**Пакет** связывает код пакета PMS (права на ТВ) с потоками, которые получает номер. Код задаётся в точности как его присылает PMS. Пакет с кодом `default` применяется, когда PMS пакет не называет; без него заселение потоков логинов не меняет.

## Доступ интерфейса PMS

Интерфейс PMS входит не по учётной записи веб-интерфейса, а по токену и адресу:

- «Токен API» — общий секрет, который интерфейс передаёт в заголовке `X-PMS-Token`. Без токена любой запрос отклоняется. Сообщайте его только поставщику интерфейса; кнопка «Создать токен» создаёт новый.
- «Разрешённые адреса» — адреса или диапазоны IPv4, с которых интерфейс обращается к узлу. Пусто — только сам хост.
- Рекомендуется обращаться к узлу по HTTPS.

Для поставщика интерфейса: узел принимает события запросом `POST /pms/v1/events` (с `?dry-run=1` — проверка без изменений) и отдаёт состояние номеров запросом `GET /pms/v1/status`. Формат событий и ответов — в справочнике HTTP API ([Управление через HTTP API](../../extras/api.md#extras-api)).

## Ограничения

- **Другие логины могут открыть заблокированный номер.** Активный анонимный логин или более широкий логин-диапазон адресов, который покрывает телевизоры номера, продолжает их обслуживать. Ограничьте такие логины или поставьте на паузу; вкладка «Номера» показывает найденные.
- **Свой поток событий на каждый узел.** Логины не передаются по Meshwork: каждому узлу нужен свой поток событий PMS.
- **Не для префиксных логинов и RIST.** Префиксному логину номер не назначайте: при выезде он не отключается. Сеансы RIST при выезде не завершаются.
- В демоверсии связи с PMS нет.