Este documento se refere à configuração dos seguintes aplicativos: 

Para utilizar os aplicativos móveis Protheus listados acima, é necessário: 

• Possuir licenças TOTVS i disponíveis (os apps utilizam esta licença para integração). → Os aplicativos Analytics e Meu Coletor de dados possuem licenciamento específico, consulte seu Executivo de Soluções de Negócios.
• Protheus na versão mínima 12.1.17 (alguns apps exigem fontes mais atualizados, verificar Guia de Uso de cada app).
• Ter o módulo correspondente implantado e funcional via SmartClient.
• Possuir o REST configurado no ambiente Protheus.

Você pode consultar como configurar o REST em seu ambiente através dos seguintes links: 

• REST com ERP Microsiga Protheus
• Configuração REST
• Dicas Configuração REST Microsiga Protheus®

Algumas premissas devem ser observadas ao configurar o REST para uso dos aplicativos TOTVS:

1. Os serviços devem ser expostos com autenticação. 
   1. A configuração do REST do Protheus com a chave SECURITY desabilitada (valor 0) deve ser utilizada apenas para pequenos testes, pois além de representar um risco à segurança, faz com que os aplicativos não sejam compatíveis.
2. A chave URL configurada deve ser a mesma informada para o cadastro de HOST do TOTVS Mingle.
   1. Para saber mais acesse: Como obter um ALIAS no TOTVS Mingle?
3. A chave PrepareIn deve ser configurada de acordo com a empresa/filial que o REST irá atender. Estas informações devem estar de acordo com o configurado no SET do TOTVS Mingle.
   1. Para saber mais acesse:Como obter um ALIAS no TOTVS Mingle?
   2. O formato como o PrepareIn é configurado impacta diretamente no consumo de licenças do ambiente.
4. É preciso habilitar o CORS do seu ambiente para utilização dos aplicativos. O CORS pode ser habilitado através da chave: CORSEnable.
   1. Quando se habilita o CORS, é necessário informar quais endereços terão acesso aos recursos servidos por aquele servidor. Para utilização dos aplicativos, é preciso habilitar o acesso pelo TOTVS Mingle, que fará um gateway entre os dispositivos móveis e o Protheus, aumentando assim o nível de segurança. Você pode definir os servidores com acesso ao ambiente através da chave AllowOrigin
      1. Exemplo: AllowOrigin=https://mingle.totvs.com.br
   2. Não é recomendável liberar o acesso à todos os clientes utilizando AllowOrigin=*, esta opção deve ser utilizada apenas para testes enquanto no desenvolvimento. 
   3. A configuração AllowOrigin apenas previne acesso via browser das APIs disponibilizadas, sendo recomendado restringir, via configurações de redes e firewall, o acesso ao endereço exposto.

Após a liberação ao Mingle, o acesso ao aplicativo se dá através do "ALIAS" na autenticação do APP.

Os aplicativos móveis podem ser instalados nas versões de sistema operacional Android (4.4.1 ou superior) e iOS (7 ou superior), entretanto, as funcionalidades são homologadas sempre na última versão, sendo esta necessária para uso total de todos os recursos.

Em caso de dúvidas, você poderá abrir um ticket para o time de atendimento dos aplicativos móveis no portal de Suporte. As informações utilizadas para abertura de tickets com dúvidas são:

Caso o aplicativo não esteja listado entre as opções, o ticket deve ser direcionado diretamente para o módulo do Protheus correspondente.