--- title: Integração com o sistema de gestão hoteleira (PMS) url: https://doc2.pstreamer.tv/pt/manual/planning/hotels/pms.html lang: pt-BR product: Perfect Streamer version: 2.0.2.423 --- # Integração com o sistema de gestão hoteleira (PMS) > **Importante** > > **Versão beta 2.1.** O que está descrito aqui existe apenas na versão beta 2.1: ela é instalada a partir do repositório beta e somente com uma licença; a versão estável 2.0.2 e a versão de demonstração não têm isso. A versão beta é fornecida sem garantias, e o suporte é prestado na medida do possível ([Programa de testes beta](../../extras/beta.md#extras-beta)). Desde a versão 2.1.0.471, o nó aceita eventos do sistema de gestão hoteleira (PMS): check-in, check-out, mudança de quarto e sincronização. O check-in libera os canais para os televisores do quarto até a hora do check-out; o check-out os bloqueia e encerra as sessões em andamento. A integração com o PMS normalmente passa pela interface do seu fornecedor (pelo protocolo FIAS do lado do PMS); é essa interface que chama o nó. Na versão de demonstração esse recurso não existe. ## Quartos são logins Um quarto de hotel são logins locais com o mesmo campo «Quarto» no editor de login ([Usuário: adicionar e alterar](../../webui/configure.md#webui-user-editor)). Opções: - um login por televisor — login pelo endereço IP do televisor; - um login por faixa de endereços por quarto, se os televisores do quarto estiverem em sub-rede própria. Em um login com «Quarto» vazio, o PMS não altera nada. Nos logins do quarto, ele define a «Data de expiração» (a hora do check-out), o nome do hóspede e, se houver pacotes configurados, os «Fluxos permitidos». O nome do hóspede é visível apenas para a função Admin e não é gravado no log. ## O que os eventos fazem - O **check-in** libera os logins do quarto até a hora do check-out, grava o nome do hóspede e, se o PMS indicar um pacote, os fluxos desse pacote. Com o mesmo evento, o PMS prolonga ou encurta a estadia. - O **check-out** bloqueia os logins do quarto, apaga o nome do hóspede e, em poucos segundos, encerra as sessões PS1, SRT e HTTP/HLS deles. - A **mudança de quarto** é o check-out de um quarto e o check-in em outro com a mesma hora de check-out, o mesmo hóspede e os mesmos fluxos. - A **sincronização** — o PMS envia a lista de todos os quartos ocupados: os listados recebem check-in, e os demais quartos ocupados com o campo «Quarto» são liberados. Se o PMS enviar a data de check-out sem a hora, o quarto é bloqueado na «Hora de saída» (no fuso horário do nó; por padrão, 12). ## No console As funções de hotel funcionam enquanto a «TV hoteleira» está ligada no nó ([TV hoteleira](../../webui/administration.md#webui-hotel-tv)). Num nó que ainda não tem dados de hotel ela está desligada: ligue-a antes de configurar a integração com o PMS. - aba **«Quartos»** da tela «Usuários / Logins» ([Usuários / Logins](../../webui/configure.md#webui-users)) — os quartos, o seu estado («Ocupado», «Livre», «Pausado»), a hora do check-out, os logins do quarto, a integração com o PMS (último evento, última sincronização, erros, quartos desconhecidos) e avisos sobre logins pelos quais um quarto bloqueado ainda poderá assistir; - tela **«Administração ▸ TV hoteleira»** — «Aceitar eventos PMS», «Token de API», «Endereços permitidos», «Hora de saída» e pacotes. Antes da versão 2.1.0.477 essas configurações ficavam na aba «PMS» da tela de logins. Um **pacote** associa um código de pacote do PMS (direitos de TV) aos fluxos que o quarto recebe. O código é informado exatamente como o PMS o envia. O pacote com o código `default` é aplicado quando o PMS não indica pacote; sem ele, o check-in não altera os fluxos dos logins. ## Acesso da interface do PMS A interface do PMS não entra por uma conta da interface web, e sim por token e endereço: - «Token de API» — um segredo compartilhado que a interface envia no cabeçalho `X-PMS-Token`. Sem o token, qualquer requisição é rejeitada. Informe-o somente ao fornecedor da interface; o botão «Gerar um token» cria um novo. - «Endereços permitidos» — endereços ou faixas IPv4 a partir dos quais a interface acessa o nó. Vazio — somente o próprio host. - Recomenda-se acessar o nó por HTTPS. Para o fornecedor da interface: o nó aceita eventos pela requisição `POST /pms/v1/events` (com `?dry-run=1` — verificação sem alterações) e retorna o estado dos quartos pela requisição `GET /pms/v1/status`. O formato dos eventos e das respostas está na referência da HTTP API ([Gerenciamento pela API HTTP](../../extras/api.md#extras-api)). ## Limitações - **Outros logins podem liberar um quarto bloqueado.** Um login anônimo ativo ou um login por faixa de endereços mais ampla que abranja os televisores do quarto continua a atendê-los. Restrinja esses logins ou coloque-os em pausa; a aba «Quartos» mostra os encontrados. - **Um fluxo de eventos próprio para cada nó.** Os logins não são transmitidos pelo Meshwork: cada nó precisa do seu próprio fluxo de eventos do PMS. - **Não para logins por prefixo nem RIST.** Não atribua quarto a um login por prefixo: no check-out ele não é desativado. As sessões RIST não são encerradas no check-out. - Na versão de demonstração não há integração com o PMS.