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).

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). 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). 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) — 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).

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.