TOTVS Hospitalidade

Árvore de páginas

Conteúdo

  1. Habilitar o plug-in
  2. Serviços
  3. Teste de funcionamento da API
  4. Configurando de acesso no aplicativo

1. Habilitar o plug-in

  • Instalar o Plug-in do “Staff 4.0 Mobile”, pelo módulo “Global”.
  • Não é preciso realizar a autorização o plug-in, somente instalar. 
  • Como realizar a instalação. → Mais informações ← O passo 04. AUTORIZAÇÃO DE EXECUÇÃO DE PLUG-INS. Não precisa ser executado.

2. Serviços

  • A aplicação está disponível no pacote de Serviços disponível na Central de Downloads da TOTVS.

2.1. Serviços de Aplicação - APIs

Para que o APP Minha Governança funcione nos smartphones ou tablets, será necessária à instalação dos serviços abaixo:

  • HotalAuth_api.exe - Serviço responsável pela regra de autenticação da TOTVS. Ex: Validação do usuário e senha digitado, listar hoteis e empresas disponíveis para uso do APP.
  • Staff_api.exe - Serviço responsável por toda a regra de negócio do APP. Ex: Lista de Quartos, ações de liberação de quarto, bloqueio, dentre outras.

Mais informações de como configurar

3. Teste de funcionamento da API

Com a instalação e configuração das APIs mencionadas no item 2 e 2.1, o próximo passo será a realização dos testes de conexão com a API.

Existem dois comandos que devem ser executados, em um navegador de internet, para garantir que outros ambientes consigam consumir a API.

São eles:

URL: http://ip:porta/hotal/auth/v1/ping - Ex: 192.168.0.99:9000/hotal/auth/v1/ping

URL: http://ip:porta/hotal/staff/v1/ping - Ex: 192.168.0.99:9001/hotal/staff/v1/ping


Será exibido no vídeo, a seguir, como realizar os testes com os dois comandos disponibilizados acima:

O que será exibido?

  • Execução das URLs pelo navegador Google Chrome.
  • Um ambiente em que as executáveis das APIs foram instaladas como serviço do Windows. Logo, durante o vídeo, as APIs não estarão abertas em tela.
  • Evidência de que ambos os serviços estão sendo executados em segundo plano.
  • Explicação de onde buscar o IP do servidor de aplicação.
  • Execução das URLs no navegador.
    • Teste em um IP correto e porta incorreta. 
    • Teste em um IP + Porta corretos, tentando acessar o serviço incorreto.
    • Teste em um IP + Porta corretos, com o serviço parado no serviço do Windows.
    • Retorno positivo e um negativo.


  • Caso o retorno do teste seja negativo, faz-se necessário validar com o time de TI do hotel, as regras de segurança do firewall, liberação das portas, liberações de MAC, dentre outras regras. 
  • Enquanto o retorno no navegador não for positivo, o APP não funcionará.
  • Após o retorno for positivo, o APP pode ser configurado. 

4. Configuração de acesso no aplicativo

  • Com a execução dos itens 2, 2.1 e 3 o próximo passo será o apontamento das configurações dentro do APP. 
  • Garanta que o APP esteja instalado no equipamento, acesse-o e execute a configuração.
  • Tenha em mãos o IP + Porta validados no item 3.
  • Acesse as configurações que estão na tela inicial do APP e informe o IP:PORTA - Ex: 192.168.0.158:9000


Será exibido no vídeo, a seguir, como realizar o apontamento do IP e Porta no APP:

O que será exibido?

  • APP aberto no emulador.
  • Acesso a opção de configuração.
  • Apontamento do IP e Porta no APP.
  • Retorno positivo - Serviço do Windows em execução.
    • Mensagem - Tempo de retorno rápido.
    • Mensagem de sucesso.
  • Retorno negativo - Serviço do Windows parado.
    • Mensagem - Tempo de retorno de até 20 segundos. 
    • Crítica informando falha na autenticação.
  • Retorno negativo - IP informado incorretamente.
    • Mensagem - Tempo de retorno de até 40 segundos. 
    • Crítica informando falha na autenticação.

     


  • Sem rótulos