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

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

• Possuir licenças TOTVS i disponíveis (os apps utilizam esta licença para integração).
• 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

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.

Dúvidas, entrar em contato com [email protected].