Logística - Linha Protheus - GFE - Simulação do cálculo de frete do SIGAGFE no PD4000

[JOB_WS_P12.1.7]
TYPE=WEBEX
ENVIRONMENT=totvs12.1.7
INSTANCES=1,3
SIGAWEB=WS
INSTANCENAME=ws_p12.1.7
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
GFEPREPAREIN=99,01

Após a configuração e reinicialização do APP Server do TOTVS SIGAGFE, pode-se verificar a disponibilidade do serviço e do método de comunicação do Web Service pelo navegador de internet: abra uma página do tipo http informando o caminho parametrizado para o Web Service; verifique se o método WSGFE está habilitado. Exemplo: localhost:3456/ws_p12.1.7
WSGFE • Serviço de integração do Frete Embarcador SIGAGFE
No caso do link WSGFE não ser mostrado, certifique-se de ter atualizado o RPO - Recruitment Process Outsourcing do ambiente até o patch mais recente do ambiente Protheus e ao persistir essa situação, solicite uma atualização de programas abrindo um chamado para a TOTVS.
Após acionar o link WSGFE deve ser apresentada uma página com os seguintes métodos:

CD0101 - Parâmetros Globais
Ativar o parâmetro Frete Embarcador Multiplataforma (TotvsGFE) dos Parâmetros Globais, Pasta Módulos II deve estar marcado.

Vamos entrar no programa de parâmetros de integração CD0089 - Parâmetros de Integração GFE  e assinalar o parâmetro Pedidos de Venda. Desta forma habilitamos a simulação do cálculo de PD4000.

Através do botão Matrizes de Tradução podemos parametrizar o De/Para de Filial, usado quando temos vários estabelecimentos no ERP linha Datasul integrando com a mesma Filial no SIGAGFE.

Informe a Filial e acione o botão Confirmar para Salvar o De/Para.
Agora vamos entrar no programa CD0602 - Manutenção Estabelecimentos na aba Fiscal, parametrizar o Fornecedor informando a Filial do Protheus que será usado na integração.

Parametrizando a URL - Uniform Resource Locator do Web Service usado pelo serviço de integração do Protheus com ERP linha Datasul. Esta URL é a mesma que parametrizamos no appservice.ini.
A URL informada é a mesma que consta na entrada configurada para o Web Service no arquivo appserver.ini da instalação do TOTVS SIGAGFE.
Por intermédio do botão Testar Conexão é possível verificar se o Datasul consegue estabelecer uma conexão válida com o Web Service de integração do TOTVS SIGAGFE.

Por intermédio do botão Histórico é possível consultar as eventuais falhas de conexão com o Web Service registradas pelas diversas rotinas de envio de dados do Datasul para o TOTVS SIGAGFE, após o início da utilização da integração via Web Service.

A opção Integração Temporariamente Suspensa pode ser usada para indicar ao Datasul que o Web Service de integração com o TOTVS SIGAGFE está intencionalmente fora do ar, nesse caso o Datasul irá registrar as pendências de integração para posterior processamento sem realizar tentativas de conexão com o Web Service, poupando recursos de processamento das rotinas.
Não é necessário reiniciar os Agentes de integração ao marcar esse parâmetro.
A opção Aviso Eletrônico, quando marcada, enviará um e-mail para os destinatários informados.
O aviso informará que houve uma falha de conexão do Datasul com o Web Service durante a integração com o TOTVS SIGAGFE, situação na qual deve-se verificar se o Web Service sofreu alguma queda imprevista.

O botão Configurar dá acesso aos programas do Datasul no qual são informados os parâmetros de envio de e-mail e o botão Testar E-mail oferece um teste de envio para confirmar a efetividade das configurações.
O envio de e-mail e suas configurações são funcionalidades nativas do Framework Datasul.
No registro de histórico de falhas de conexão é possível consultar se foi enviado o aviso eletrônico sobre a falha e quais os destinatários do aviso; se o envio do aviso falhar, os motivos da falha também serão registrados.
Pré-requisitos para o cálculo do Frete no SIGAGFE:

• Tabela de Frete cadastrada e dependendo do parâmetro considera negociação, serão retornadas tabelas em negociação ou apenas liberadas.
• Tipo de Documento parametrizado. 

Pré-requisitos para o cálculo do Frete no Pedido de Venda:

• Pedido de Venda deve estar com a Situação Completo.
• O tipo de frete no Pedido de Venda precisa ser a pagar. Logo, no pedido deve ser informada uma Cidade CIF, na pasta Complementos.

Integração na prática:
Vamos abrir o programa de cadastro de PD4000.
Podemos observar que ao abrir o programa de implantação de Pedidos de Venda o botão de Simular Cálculo do Frete já está disponível.

Após  incluir e completar o Pedido de Venda é possível calcular o Frete para este Pedido.

Ao clicar sob o botão Simular Cálculo Frete, é apresentada uma nova janela CDF003A - Simulação de Frete, onde o usuário poderá inicialmente informar ou não o Tipo de Veículo, Tipo  de Operação, Classificação de Frete E/Ou Considera Negociações.
O parâmetro Considera Negociações, visa definir se serão utilizadas as tabelas que ainda estejam em negociação para esta simulação, caso esteja desmarcado, retornará apenas as tabelas liberadas que atendam este pedido, estando marcado serão retornadas também as tabelas que estejam em negociação para aquela rota. Este parâmetro estará habilitado somente se nos Parâmetros Integração EMS X SIGAGFE CD0089, a opção Manter Frete Simulado ERP no GFE, da aba Faturamento, esteja desmarcado, caso este parâmetro esteja marcado, o parâmetro Considera Negociações ficará desmarcado e desabilitado, sendo possível utilizar na simulação apenas tabelas que estejam como liberadas. Este parâmetro quando habilitado, estará inicialmente marcado.

Campo/Descrição
GW1_ROMTV - Tipo de veículo do Romaneio
GW1_ROMCF - Classificação de frete do Romaneio
GW1_ROMTO - Tipo de operação do Romaneio

Com estas informações a simulação de Cálculo do Frete é executada, apresentando na rotina de Pedido de Venda o Valor do Frete, transportadora e rota.
Desta forma aprendemos como parametrizar, os pré-requisitos da função Simular Cálculo do Frete no PD4000.

Como analisar o processo em caso de inconsistências:
Durante a integração com o SIGAGFE, no diretório temporário da sessão Progress são gerados três arquivos que auxiliam no diagnóstico de alguma não-conformidade. 
Para identificar este diretório, abra a janela do Editor Progress e execute o seguinte comando: 

• MESSAGE SESSION:TEMP-DIRECTORY VIEW-AS ALERT-BOX INFORMATION. 

Os arquivos gerados pela simulação são: 

• simulacao.xml - dados de envio para o SIGAGFE
• xmlsimulation.xml - dados de envio para o SIGAGFE
• xmlsimulation_result.xml - dados de retorno para o ERP Datasul

Quando o incidente encontra-se na etapa de cálculo da simulação, ou seja, até a execução do programa GFEXFUNB, é possível gerar a memória de cálculo em arquivo. 
A parametrização da geração deste arquivo é realizada no SIGAGFE, através do programa de GFEX000 -Parâmetros do Módulo, pasta Cálculo de Frete, parâmetros Gerar Log de Cálculo MV_LOGCALC e Diretório Log MV_DRTLOG.
O conteúdo do campo Diretório Log deve ser um diretório que esteja abaixo da variável de ambiente ROOTPATH informada no arquivo appserver.ini. 

Exemplo:
ROOTPATH=C:\P11 no Diretório Log informado \LOG\ o arquivo será gerado abaixo do caminho C:\P11\LOG.
Também é possível fazer a simulação diretamente pelo SIGAGFE, através da execução do programa GFEX011 - Simulação Simplificada. Neste programa tem-se também o recurso de gerar a memória de cálculo em arquivo.
Com isso apresentamos como usar a Integração da Simulação do Cálculo do Frete no Pedido de Venda do ERP linha Datasul.

Saiba mais
Para mais informações acesse: Logística - Linha Protheus - GFE - Log de detalhes na simulação do PD4000.