Conteúdo
- Habilitar o plug-in
- Serviços
- Teste de funcionamento da API
- 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 STAFF 4.0 Mobile, 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ço
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 STAFF 4.0 Mobile 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 STAFF 4.0. 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:900/hotal/auth/v1/ping
URL: http://ip:porta/hotal/staff/v1/ping - Ex: 192.168.0.99:900/hotal/staff/v1/ping
O vídeo a seguir mostrará como realizar os testes com esses dois comandos:
- Considere para a gravação, a execução das APIs como serviço do Windows. Logo, durante o vídeo, as APIs não estarão abertas em tela.
- Garantimos que os serviços estavam em execução, em um segundo plano.
- Evidenciamos como pegar o IP do servidor de aplicação.
- Executamos os comandos em um navegador.
- Testamos com IP correto, IP errado, Porta correta e Porta errada.
- Evidenciamos com textos o 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 do STAFF 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 STAFF 4.0.
Garanta que o APP esteja instalado no equipamento, acesse-o e execute a configuração de acordo com o vídeo a seguir.
O vídeo a seguir mostrará como realizar os testes com esses dois comandos:
- A abertura do APP.
- Acesso a opção de configuração.
- Apontamento do IP e Porta liberados para uso no APP.
- Retorno positivo e negativo.
