0 - Pré-Requisitos Versão Protheus e Configuração INI

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!

• Recomendamos que o ambiente esteja atualizado e em release vigente, conforme ciclo de vida do ERP (https://suporte.totvs.com/portal/p/10098/ciclodevidacalendarios);

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:

• Atualização da Lib;
• Atualização do Binário;
• Atualização do AppServer;
• Atualização dos Fontes;
• Atualização do DBAccess;

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.

1.  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:
   1. [HTTPV11]
      Enable=1
      Sockets=HTTPREST,HTTPRESTSFA
2. No rest.ini incluir uma nova seção chamada [HTTPRESTSFA] a qual deve ser configurada conforme exemplo abaixo:
   1. [HTTPRESTSFA]
      Port=8406
      URIs=HTTPURISFA
      SECURITY=1
3. 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:
   1. [HTTPURISFA]
      URL=/rest_sfa
      PrepareIn=[EMPRESA]  Ex: PrepareIn=01
      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=01  ;  Grupo de empresas
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.

Fontes de consulta genérica:

passo 1: Dentro da pasta /system/ do Protheus, criar uma nova pasta “tcrmsfa_ngc” (Exemplo: system/tcrmsfa_ngc)

passo 2: Inserir os arquivos .ngc na a pasta /system/tcrmsfa_ngc do Protheus:

• Arquivos NGC
• Documentação da API que utiliza as consultas NGC

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)
• Diretório/Caminho onde estão armazenadas as consultas .ngc: (exemplo: /system/consultas_ngc/)
• Empresas que serão integradas: (exemplo:01,04)

Referências das documentações:

• Configurar REST Protheus;
• Como manipular API de importação de dados;
• Ponto de Entrada Utilizados na integração Protheus x TOTVS CRM