CONTEÚDO

  1. Visão geral

  2. Exemplo de utilização

    1. Modelo de Parâmetros com Estabelecimento Terceiros
    2. Modelo de Parâmetros sem Estabelecimento Terceiros

01. VISÃO GERAL

Menu do sistema onde ficam as configurações para comunicação/integração do VHF com o Thex POS.


02. EXEMPLO DE UTILIZAÇÃO


Para visualizar a maneira de acessar a tela de parâmetros, você pode consultar a página "Interface BT VHF POS - Parâmetros".

1.Tela de Parâmetros.

Guia "Parâmetros":

Modelo com Estabelecimentos Terceiros 

Quando houver cadastro de Estabelecimento de Terceiros e houver cadastro cadastro de Grupo no POS e o usuário principal não estiver vinculado a Chave de Grupo ( CHAINID), será exibido a notificação com a orientação para solicitar as credenciais de acesso a equipe do suporte do POS.

GIF de Demonstração:



Modelo sem Estabelecimento Terceiros

Os dados gravados nos campos " Integração ( IntegrationID)" na aba Parâmetros e no campo "Token" na aba AWS - Mensageria, ficam esmaecidos para evitar que haja alteração dos dados de integração:

Ao realizar a alteração das credenciais de Login os campos sinalizados acima são apagados para que o usuário revalide as informações:

Campos apagados após alteração

 

Caso ocorra tentativa de salvar a parametrização sem a revalidação será exibida a mensagem de erro abaixo:



Os seguintes campos devem estar obrigatoriamente preenchidos:

Guia Parâmetros:

  • Login;
  • Senha;
  • CNPJ;
  • Usuário Integração Lançamento e Estorno;
  • Grupo para Recebimento de Mensagens.


Guia Dados Almoxarifado \ Fiscal:

  • Grupo de Produtos padrão;
  • Grupo de Item padrão;
  • Imposto padrão para Item;
  • Motivo de Cancelamento padrão.


GIF de Demonstração:






  • URL BASE: Indica o endereço de comunicação entre as bases do Thex e Hotal. Essa URL é preenchida automaticamente ao clicar no botão "ENDPOINT".
  • TOKEN: Indica o endereço para validar a relação entre "usuário", "senha" e "Código de integração". A URL é preenchida automaticamente ao clicar no botão "ENDPOINT".
  • LOGIN: Insira o nome de usuário do POS SaaS com o perfil de Administrador.
  • SENHA: Digite a senha de acesso do usuário mencionado no campo "Login".
  • VISUALIZAR SENHA : Ao acionar este botão, você poderá visualizar os dados inseridos no campo "Senha".
  • CNPJ: Insira o número de CNPJ da empresa. O CNPJ deve ser idêntico ao cadastrado no estabelecimento no POS.
  • Integração (IntegartionID): Essa informação é fornecida automaticamente quando o Token é validado. 
  • Chave de Grupo (ChainID): Campo é preenchido de forma automática quando o Token é autenticado | Preenchimento deste campo não é obrigatório. 


GIF Demonstração | Autenticação Token.



Integração - Validação do Grupo de Recebimentos de Mensagens

Sistema valida se os usuários do Grupo de Acesso indicado para o recebimento de mensagens possui ao menos um e-mail cadastrado.

Quando não houver ao menos um e-mail cadastrado será exibida a mensagem abaixo:


Se houver ao menos um e-mail a mensagem exibida será:

GIF Demonstração | Validação:


CÓDIGO DE INTEGRAÇÃO

1. Tela do POS.

Para localizar o código de integração e a chave de grupo. Acesse o POS, siga estas etapas:


1.2 Tela do POS.

No cadastro correspondente ao hotel que realizará a integração com o VHF, clique no botão e selecione a opção "Editar".


1.3 Tela do POS.

O POS abrirá a tela para edição do cadastro do estabelecimento. Observe a URL apresentada no navegador. O código de integração/chave de grupo consiste nas informações apresentadas após "edit/".



1.4 Tela do POS.

Flag "ENVIA RESERVA CONFIRMADA": Com essa flag marcada, o plugin BT VHF enviará para o POS as reservas com status "Confirmada". Ao lado da descrição da flag, indique o número de dias que o sistema considerará para enviar as reservas ao POS. Por exemplo, se indicar 5 dias, o sistema considerará as reservas confirmadas do "dia atual + 5 dias". Se a flag estiver desmarcada, apenas as reservas em "Check-in" serão enviadas.

OBSERVAÇÃO:

Para visualizar as reservas confirmadas no Thex, o parâmetro do estabelecimento no POS deve ter a flag "Permitir buscar por hóspedes confirmados" marcada.



1.5 Tela do POS.

Flag "ENVIA RESERVA PENDENTE": Com essa flag marcada, o plugin BT VHF enviará para o POS as reservas com status "Pendente". Ao lado da descrição da flag, indique o número de dias que o sistema considerará para o envio. Por exemplo, se indicar 5 dias, o sistema considerará as reservas pendentes do "dia atual + 5 dias".

OBSERVAÇÃO:

Para visualizar as reservas confirmadas no Thex, o parâmetro do estabelecimento no POS deve ter a flag "Permitir buscar contas pendentes" marcada.



  • ENVIA CONTA AVULSA: O envio de contas avulsas é padrão do sistema e não pode ser desativado. Ao lado da descrição da flag, indique o número de dias que o sistema considerará para enviar as contas ao POS. Por exemplo, se indicar 5 dias, o sistema considerará as contas do "dia atual + 5 dias".
  • USUÁRIO INTEGRAÇÃO LANÇAMENTO E ESTORNO: Insira o usuário da base HOTAL que será identificado nos lançamentos e estornos ao processar as integrações.
  • GRUPO PARA RECEBIMENTO DE MENSAGENS: Esse grupo de usuários do sistema HOTAL receberá e-mails de notificação quando ocorrer um erro na integração (fluxo de exceção).