TOTVS Hospitalidade

Árvore de páginas

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




  • Sem rótulos