CONTEÚDO

1. Visão Geral
2. Pontos de Integração
3. Parametrização

01. VISÃO GERAL

A documentação e orientações técnicas descritas a seguir tem o objetivo de identificar os pontos de integração entre os produtos TOTVS Hospitalidade PMS - Linha Hotal (VHF) e o sistema BMS (BOOKING MANAGEMENT SYSTEM - sistema próprio do cliente Gramado Parks).

Essa integração foi desenvolvida visando atender uma necessidade identificada no início do projeto de aderência de produto e utilizaremos a aplicação VHF_API para tratar as integrações descritas abaixo.

A aplicação VHF_API foi desenvolvida pela TOTVS Hospitalidade para atuar como facilitar de integrações entre sistemas utilizados por nossos clientes e que não se adequem aos padrões já utilizados pelas soluções HIGS e CMNET Reservas.

Especificamente para a integração com o sistema BMS, do cliente Gramado Parks, os pontos de integração são:

• Liberação de UH para o pool hoteleiro pelo proprietário da UH;
• Consulta de status da UH antes de inserir reserva;
• Integração de reservas em UH fora do Pool;
• Cancelamento de reserva de UH fora do Pool;

02. PONTOS DE INTEGRAÇÃO

1. Liberação de UH para o Pool
   1. O proprietário da UH, através do sistema BMS, poderá disponibilizar a UH contratada para o pool hoteleiro e essa poderá ser vendida, pelo hotel, em canais digitais ou central de reservas;
   2. Para realizar essa liberação para o pool, o sistema BMS deverá enviar a UH e um range de datas para entrada e saída do pool hoteleiro (pool flutuante) e fará alteração no cadastro da UH;
   3. Após o fim do período a UH deverá ficar fora do pool hoteleiro.
2. Consulta de Status da UH
   1. Possibilidade de consulta do Status da UH antes da inserção de reserva;
   2. Sistema BMS poderá consultar o status da UH antes de realizar a integração da reserva;
   3. A consulta em questão deverá ser feita pelo operador do sistema BMS.

3. Integração de Reservas

   1. O sistema BMS fará inserção de reservas no sistema TOTVS Hospitalidade PMS - Linha Hotal (VHF) utilizando a a aplicação VHF_API para essa integração;

   2. Reservas integradas serão identificadas com cliente reservante específico;
   3. Reservas integradas terão o campo Localizador preenchido com o número/identificação da reserva origem do sistema BMS;

   4. O sistema BMS enviará as informações da reserva com datas de check-in, check-out, quantidade de hóspedes, dados do hóspede principal, pensão, número da UH, cliente reservante padrão e observações diversas;

   5. As reservas inseridas pelo sistema BMS não deverão ter valores de diárias lançados em conta pelo processo automático de auditoria (diária zerada);
   6. Para reservas com mais de um hóspede, a recepção do hotel deverá preencher os dados dos outros hóspedes manualmente. A reserva integrada apresentará os outros hóspedes identificados como acompanhantes;

   7. O sistema BMS poderá enviar solicitação de cancelamento de reservas;

   8. O sistema TOTVS Hospitalidade PMS - Linha Hotal (VHF) do hotel deverá retornar, ao sistema BMS, o número de reserva que foi atribuído à reserva integrada;
   9. Consumos e pagamento de extras serão lançados e cobrados pelo sistemas TOTVS (VHF ou POS) do hotel. Essas informações não são integradas ao sistema BMS.

      
      

03. PARAMETRIZAÇÃO

• CONFIGURANDO O FRONTOFFICE_API
• Abrir o executável (VHF_API_APP.exe) para acessar a tela de configuração da API.
  • Configuração do Serviço
    • Nesta parte devemos configurar a porta em que a API ficará disponível;
  • Configuração de acesso ao banco de dados
    • Nesta parte devemos configurar os dados de acesso ao banco, colocando qual o banco,
      usuário, senha, schema.
  • Parâmetros de Serviço
    • Nestes parâmetros devemos configurar se o sistema vai usar o PCI do VHF e a Validação de
      parceiros.
• Configuração do VHF 
  • Para integração utilizada no cliente Gramado Parks com o sistema BMS deverá ser criado um "proprietário" padrão e este deverá se inserido no cadastro de todas as UH's. Este cadastro é necessário para o correto funcionamento de liberação de UH para o Pool (item 1) via integração.

• Criando um proprietário
  •  Acesse o menu Cadastros → UH → Proprietário de UH e preencha os dados solicitados;

• Inclusão de Proprietário na UH
  • Acesse o menu Cadastros → UH → UH pesquise pela UH que deseja incluir o proprietário, selecione a UH e clique em Editar. Acessa a aba Proprietário e clique em incluir  e selecione o proprietário cadastrado anteriormente.

• Na tela de cadastro de UH, desmarcar o flag (UH do Pool) e marcar o flag (Pool flutuante)
  conforme imagem abaixo.

• Procedência de Reserva
  • Para que a reserva seja incluída no PMS (VHF) é necessário criar uma procedência de reserva, associá-la ao cliente que será cadastrado como proprietário da UH;
  • Acessar o menu CMNET → Procedência de Reserva e incluir uma procedência;

• Parâmetros de importação de Reserva
  • Para que a reserva seja incluída no PMS (VHF) precisamos definir alguns parâmetros default, que estão na tela (Cmnet/Parâmetros para Importar Reservas), preencha a tela com os parâmetros que deseja que as reservas sejam incluídas ou canceladas.

• Configurando um cliente
  • Para fazer uma reserva no PMS (VHF), já que todas as UH´s irão ficar fora do pool, precisamos informar qual o proprietário da UH no momento da reserva. Para isso precisamos incluir um cliente, que seja o proprietário da UH.
• Criando um cliente
  • Acessar a tela de cadastro de cliente em (Cadastro/Cliente/Cliente), selecione incluir, digite o número do documento cadastrado no proprietário, o sistema irá informar que já existe um cliente com este documento, clique em (ok), depois será mostrado uma nova tela, com o documento e nome, selecione o cliente, e clique em confirmar, assim os dados serão importados para a tela do cliente.
  • Acessar o menu Cadastro → Cliente → Cliente e clique em Incluir, digite o número do documento cadastrado no proprietário (tópico 3). O sistema irá informar que já existe um cliente com este documento, clique em OK, depois será mostrado uma nova tela, com o documento e nome, selecione o cliente e clique em confirmar. Dessa forma os dados serão importados para a tela do cliente.
  • Na aba Dados do Cliente clique em Distribuição e selecione o botão de incluir, selecione o Source Of Business, cadastrado anteriormente, e no campo Código Distribuição, coloque o mesmo código do Source Of Business.

• Observação: Para que a reserva seja incluída no VHF, o Json de reservas deve vir com o campo ("SourceOfBusiness": "SOURCECODE") preenchido, e o no lugar de “SOURCECODE” deve ser o código cadastrado na parte de “Cadastro de Procedência de Reserva”.