Cadastro de Usuário:
Possuir um usuário no Protheus para a integração.
Este usuário deverá possuir permissão de Administrador para ter acesso total às rotinas e módulos.
Importante!
Caso possua seu ambiente em Cloud da TOTVS, é possível verificar as atualizações através da Central de Atualizações
Caso possua ambiente local é necessite atualizar, listamos abaixo os links úteis:
ATENÇÃO!
É imprescindível efetuar a configuração do Appserver, para suportar mensagens com até 100MB. (A ausência dessa configuração pode gerar o erro de "String size overflow" para mensagens com muitos itens.);
Configurar conforme exemplo abaixo:
No arquivo AppServer.ini
- Na seção General do arquivo Appserver.ini informe a chave MaxStringSize e sugerimos informar no mínimo 100 em seu valor:
[General]
maxStringSize=100
- Na seção General do arquivo Appserver.ini informe a chave TOPMemoMega e o seu valor como mostra o exemplo:
[General]
topmemomega=100
Sugestão para habilitar o REST por empresa:
- Necessário possuir o REST em funcionamento Configuração REST, Atenção: considerar os próximos pontos no momento de realizar a configuração.
- No rest.ini incluir na seção [HTTPV11] no parâmetro (Sockets=) um socket especifico nomeado HTTPRESTSFA. Se já tiver um Parâmetro definido, adicionar o novo separando-os por virgula, exemplo abaixo:
- [HTTPV11]
Enable=1
Sockets=HTTPREST,HTTPRESTSFA
- No rest.ini incluir uma nova seção chamada [HTTPRESTSFA] a qual deve ser configurada conforme exemplo abaixo:
- [HTTPRESTSFA]
Port=8406
URIs=HTTPURISFA
SECURITY=1
- Por fim, no rest.ini incluir uma nova seção chamada [HTTPURISFA] a qual deve ser configurada conforme exemplo abaixo, considerando os dados do ambiente do cliente:
- [HTTPURISFA]
URL=/rest_sfa
PrepareIn=All
Instances=1,5,1
AllowOrigin=*
Stateless=1
- Note que uma seção chamada a outra para formar a configuração final. exemplo:
[HTTPV11]
Enable=1
Sockets=HTTPREST,HTTPRESTSFA
[HTTPRESTSFA]
Port=8406
URIs=HTTPURISFA
SECURITY=1
[HTTPURISFA]
URL=/rest_sfa ;
PrepareIn=All ;
Instances=1,5,1; Threads
AllowOrigin=*
Stateless=1
- A chave SECURITY do REST precisa ser configurada como 1.
- Caso haja mais de uma empresa, devera ser criado um serviço/porta para cada empresa.
Envie ao Coordenador do Projeto as informações a seguir por ambiente, HOMOLOGAÇÃO E PRODUÇÃO:
- TES em uso: (exemplo: Inteligente ou Padrão)
- URL Ambiente REST: (exemplo: http://192.168.0.3:8080/rest)
- Nome e Senha do usuário Cadastrados no Protheus (exemplo - usuário: admin senha:123456)
- Empresas que serão integradas: (exemplo:01,04)
Providenciar campos STAMP:
PROTHEUS - API Nativa - Trabalhando com campos S_T_A_M_P_
Referências das documentações: