Tempo aproximado para leitura: 02:00:00 min
Dúvida
Como configurar o Web Service para correta integração do ERP Datasul com o SIGAGFE no Protheus?
Ambiente
TOTVS Logística - TOTVS Frete Embarcador (Linha Protheus) - Gestão de Frete Embarcador (SIGAGFE) - Todas as Versões
Solução
O SIGAGFE utiliza o Web Service SOAP e o REST. Ele é responsável integração das informações do Datasul com o SIGAGFE do Protheus e para simulação de fretes dentro do ERP Datasul.
Web Service SOAP
A integração das informações do Datasul com o SIGAGFE do Protheus utiliza o SOAP. Além disso, as rotinas de simulação de frete também utilizam nos seguintes programas:
- PD4000
- FT4001
- FT4003
- CC0300
A configuração do Web Service SOAP ocorre em 3 pontos:
- No appserver.ini do Protheus.
- No CD0089, na pasta Conexão.
- Nos parâmetros do GFE - GFEX000, na aba Integração Datasul.
Segue um detalhamento de cada um deles.
- No appserver.ini do Protheus.
A primeira configuração deve ser feita no appserver.ini do Protheus. Para saber como configurar no .ini você pode avaliar a documentação fornecida pela equipe do Framework Protheus no KCS MP - FRAME - Configuração de Portais e WebServices
Ao configurar o .ini alguns pontos são importantes.
- O endereço do IP, a Porta e o nome da Instância serão usados nas próximas rotinas informadas abaixo desse documento.
- É importante usar GFEPREPAREIN no .ini e não PREPAREIN, para que não haja consumo de licenças na integração do Datasul com GFE. Mais detalhes veja esse link. Além disso, é necessário informar no GFEPREPAREIN os dados de Empresa e Filial com os quais acessam o Protheus, caso contrário ocorrerá erro de integração dos dados com o Web Service.
- Informe um número máximo de instâncias adequado para o volume de integrações de dados que você terá. Pode-se informar (INSTANCES 1,1) por exemplo. O primeiro número representa quantas instâncias irão ao ar ao subir o serviço e o segundo número informa o máximo de instâncias que teremos. Um exemplo de uso limitado é informar 1 com número de instâncias máximas, a tentar integrar 20 notas fiscais ao mesmo tempo. Todas essas notas irão passar pela mesma instância podendo haver uma gargalo e a performance ficar comprometida. Uma sugestão é usar (INSTANCES 1,10). Veja mais detalhes nesse link.
2. No programa CD0089.
A segunda configuração é no CD0089, na aba Conexão.
Nessa tela devemos informar o IP, a Porta e o nome da Instância. Todas essas informações estão disponíveis no .ini do Protheus.
Também será necessário informar o usuário e senha do Protheus, para autenticação do Web Service.
3. No programa de Parâmetros do GFE - GFEX000.
A terceira configuração é no programa de Parâmetros do GFE - GFEX000, na pasta Integração Datasul.
Será necessário informar o IP, a Porta e o nome da Instância.
Observe que nesse parâmetro não devemos informar o HTTP:// na frete do endereço.
Esses são os pontos necessários para o correto funcionamento do Web Service SOAP.
Web Service REST
Algumas rotinas de simulação de frete utilizam o Web Service REST. São elas:
- EQ0506
- Portal Web do Representante
- PD4000 HTML
Para configurar o Rest no Protheus consulte o documento Cross Segmento - TOTVS Backoffice (Linha Protheus) - ADVPL - Configuração básica REST do protheus.
Em seguida, quando o serviço já estiver no ar será necessário informar o endereço e o IP gerados conforme o documento acima. Esse endereço é informado no campo Servidor, programa Parâmetros de Integração do GFE - CD0089.
Também será necessário informar o Usuário e Senha do Protheus, para autenticação do Web Service Rest.
Esses são os pontos necessários para o correto funcionamento do Web Service Rest.
Saiba mais
Logística - Linha Protheus - GFE - Autenticação do Web Service do SIGAGFE
Logística - Linha Protheus - GFE - Consumo de licenças na integração do Datasul x SIGAGFE
Logística - Linha Protheus - GFE - Problemas de performance no SIGAGFE
Logística - Linha Protheus - GFE - Lista de serviços REST disponíveis
0 Comentários