INTEGRAÇÃO DATASUL 12 X PROTHEUS

SIGAGFE 12

Contexto de negócio (Introdução)

Gestão de Frete Embarcador (SIGAGFE) é um aplicativo desenvolvido sobre a plataforma TOTVS. Utiliza o framework de funcionalidades do Microsiga Protheus e tem como objetivos funcionais:

• Auxiliar no controle dos processos operacionais de recepção e despacho remessa de cargasmercadorias;
• Registrar, provisionar e conferir as despesas decorrentes da contratação de serviços de transporte realizados por terceiros;
• Suportar a troca de informações entre o contratante e os prestadores de Serviço de Transporte;
• Manter os dados relacionados a documentos, custos e despesas com transporte, sincronizados e integrados aos demais módulos do software ERP.

Os Cadastros e Processos que são sincronizados e integrados entre os sistemas, na direção do Datasul Totvs 12 para o SIGAGFE são:

Os Processos realizados dentro do SIGAGFE e que tem informações enviadas aos módulos do Datasul Totvs 12 são:

As Consultas realizadas a partir do Datasul e que tem informações enviadas ao módulo do SIGAGFE são:

Sistemas Envolvidos

• Protheus / Gestão de Frete Embarcador
• Totvs 12 (Datasul): 
  • Cadastros Gerais;
  • Faturamento;
  • Recebimento;
  • Fiscal;
  • Financeiro;

Sistemas Envolvidos

• Protheus / Gestão de Frete Embarcador
• Totvs 12 (Datasul): 
  • Cadastros Gerais;
  • Faturamento;
  • Recebimento;
  • Fiscal;
  • Financeiro;
  • RH;
  • MLA.

Integração

Escopo

Envio de dados do Datasul para o GFE

Para a sincronização de cadastros e movimentos originados no ERP, são associadas APPCs (Application Partner Program Call) às rotinas do Datasul, cujas principais ações (inclusão, alteração, eliminação, cancelamento, etc.) serão replicadas para a base de dados do TOTVS SIGAGFE.

Recebimento de dados do GFE no Datasul

Para a integração dos documentos registrados no TOTVS GFE para o ERP, é utilizada uma rotina de execução contínua (Agente Listener), essa . Essa rotina monitora a base de dados do TOTVS GFE, utilizando como canal de comunicação o mesmo WS (Web Service) do modelo de envio de dados do ERP para o TOTVS GFE. O controle dos dados que estão aptos para integração é efetuado pelo TOTVS SIGAGFE.

O Agent Listener utiliza as rotinas de negócio do Datasul para processar os dados; ao final de cada processamento interage novamente com o TOTVS SIGAGFE (utilizando o WS) para atribuir o resultado: Atualizado ou Rejeitado.

Pelo TOTVS SIGAGFE também é possível solicitar a eliminação de dados anteriormente processados pela integração, situação na qual o resultado do processamento, quando executado com sucesso, retorna a situação do documento para Não enviado no TOTVS SIGAGFE.

Quando o WS não estiver disponível para conexão, ou houver algum erro de exceção no envio dos dados, é mantido um histórico de falhas na base de dados do Datasul para análise. A cada intervalo de execução parametrizado, o Agent Listener faz uma nova tentativa de conexão com o WS.

O Agent Listener possui três formas de execução e fica a critério do cliente e/ou consultor de implantação definir qual a forma de execução mais adequada. As formas disponíveis são:

• Rotina com interface;
• Agendamento via RPW;
• Sessão em background.

Rotina com Interface – Monitor de Integração - EMS X GFE (CD0433):

1. Executando no TOTVS 12, acesse o programa Monitor Integração - EMS X GFE (CD0433);
2. Selecione os processos a serem considerados para integração. As integrações disponíveis para execução são:
   Documento Frete (Fiscal);
   Documento Frete (Nota Rateio);
   Pré-fatura/Lote Provisão (Financeiro);
   Fatura (Financeiro);
   Dt Sai/Dt Ent/Dados Frete (Nota Fiscal);
   Aprovação Logística (MLA);
   Negociação de Frete (MLA/Consulta);
   Contrato (Financeiro);
   Contrato (Nota Rateio);
   Contrato (Prestação Serviço).
3. Acione o botão Iniciar (Play).

Instalação/Atualização

Datasul

Atualização Parâmetro Global (CD0101)

Indique a utilização do TOTVS GFE, marcando o campo correspondente no programa Atualização Parâmetro Global (CD0101) do Datasul. Sem este parâmetro marcado, as integrações com o TOTVS GFE não executarão nenhuma ação.

1. Executando no Datasul, acesse o programa Atualização Parâmetro Global (CD0101);
2. Acione a pasta Módulos II e assinale o campo Frete Embarcador Multiplataforma (TotvsGFE);
3. Acione OK para confirmar.

Para mais detalhes, consulte o documento de referência do programa Atualização Parâmetro Global (CD0101).

Parâmetros do módulo financeiro

1. Cadastrar o módulo Gestão de Frete Embarcador no APB (programa BAS_MODUL_DTSUL Manutenção de Módulos).
2. Em seguida, no programa Manutenção Permissões Usuar APB x Módulo (APB048AA), é necessário cadastrar as permissões (implantar, alterar, excluir e atualizar) por usuário para o módulo contas a pagar.
3. Após, no programa Manutenções Usuários Financeiros Estabelecimento (APB004AA), é necessário estabelecer o relacionamento entre o usuário financeiro e os estabelecimentos com os quais este está autorizado a operar, estabelecendo certas atribuições

1. .

Para mais detalhes, consulte o documento de referência do programa Monitor de Integração (CD0433).Agendamento via RPW – Monitor de Integração - EMS X GFE (CD0433):

os documentos de referência dos programas Manutenção Permissões Usuar APB x Módulo (APB048AA) e Manutenções Usuários Financeiros Estabelecimento (APB004AA).

Parâmetros de Integração - EMS X GFE (

CD0089)

Execução em Background:

1. Inclua os dados de execução do programa CDF433 na inicialização do Windows.
   Exemplo de execução por intermédio de arquivo “.BAT”:
   c:cd %temp%
   start C:\dlc102b\bin\prowin32.exe -pf "\\costao\di-flex-tabatinga-8180\scripts\DIFlex.pf" -ininame "\\costao\di-flex-tabatinga-8180\scripts\DIFlex.ini" -param "10;super;super@123;SSSSSSS;;Y;GFE" -p "c:\fndlm\alias.p"
   Deve conter a chamada para o arquivo Alias.pf, que contém os bancos do Datasul Totvs 12, os dados de conexão (login e senha) e parâmetros de inicialização da base Progress.
2. Outra forma é a criação de um atalho contendo estes parâmetros e execução do CDF433, que pode ser acionado dentro do servidor ou da estação de trabalho que desejar.

Instalação/Atualização

Pasta Conexão

Nesta pasta são informados os Modos de Integração e os dados da conexão com o Web Service.
Para integração utilizando Web Service, deve-se obrigatoriamente indicar que os canais de saída e entrada são Web Service.

Deve-se informar a URL do WS no campo Servidor e opcionalmente um usuário (e sua senha) da instalação do TOTVS GFE. A URL informada é a mesma que consta na entrada configurada para o WS, no arquivo appserver.ini da instalação do TOTVS GFE.

Por intermédio do botão Testar Conexão é possível verificar se o Datasul Totvs 12 consegue estabelecer uma conexão válida com o Web Service de integração do TOTVS GFE.
Por intermédio do botão Histórico é possível consultar as eventuais falhas de conexão com o WS, registradas pelas diversas rotinas de envio de dados do Datasul Totvs 12 para o TOTVS GFE, após o início da utilização da integração via Web Service.

O parâmetro Integração temporariamente suspensa pode ser usado para indicar ao Datasul Totvs 12 que o Web Service de integração com o TOTVS GFE está intencionalmente fora do ar, nesse caso, o Datasul Totvs 12 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.

O parâmetro Enviar e-mail nas falhas de Conexão, quando marcado, 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 GFE, situação na qual deve-se verificar se o Web Service sofreu alguma queda imprevista.

O botão Configurar possibilita o acesso aos programas do Datasul Totvs 12, no qual são informados os parâmetros de envio de e-mail.

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 Totvs 12.

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.

Pasta Integrações

Nesta pasta devem ser marcados os cadastros e processos que são integrados com o SIGAGFE.

Internamente, cada parâmetro marcado (e confirmado) nas seções desta pasta, gera a inclusão de um programa APPC nos gatilhos de Criação e eliminação do dicionário de dados do Datasul Totvs 12.

Nessa pasta é possível determinar também a integração do MLA, em vez de usar a aprovação de documentos dentro do GFE. Para a utilização do MLA, é necessário a configuração dos documentos. 

Pasta Faturamento

Esta pasta é habilitada quando, na pasta Integrações, na seção Processos (Datasul para GFE) é marcado o parâmetro Notas Fiscais de Saída, ou na seção Simulação de Frete é marcado o parâmetro Notas Fiscais de Saída.

Esta pasta contém parâmetros importantes que devem ser considerados pelo SIGAGFE na integração das notas fiscais de saída.

A seção Funcionalidades determina as regras do processo.

A seção Integração determina as regras de integração entre os dois produtos (SIGAGFE e Datasul). É possível determinar também se a integração do documento de carga será de forma automática (síncrona) ou manual (assíncrona), por meio do parâmetro Liberação Síncrona de Doc Carga. 

Pasta Recebimento

Esta pasta é habilitada quando, na pasta Integrações, na seção Processos (Datasul para GFE) é marcado o parâmetro Notas Fiscais de Entrada, ou na seção Simulação de Frete é marcado o parâmetro Notas Fiscais de Entrada, ou na seção Processos (GFE para Datasul) é marcado o parâmetro Notas de Rateio (Docto Frete) ou Notas de Rateio (Contratos).

Esta pasta contém parâmetros importantes que devem ser considerados pelo SIGAGFE na integração das notas fiscais de entrada.

Na seção Integração, o campo Ação eliminação define qual será o tratamento que o sistema deverá executar, quando solicitado no módulo de Recebimento do Datasul, uma eliminação de Nota Fiscal de Rateio, originada a partir de um Documento de Frete ou de um Contrato com Autônomo do SIGAGFE.

Ao selecionar a opção Nenhuma, a eliminação da Nota Fiscal de Rateio é efetuada normalmente e nenhuma solicitação é enviada ao respectivo Documento de Frete ou Contrato no SIGAGFE.

A opção Impedir bloqueia a tentativa do usuário de eliminação da Nota Fiscal de Rateio de Frete.

Quando selecionada a opção Integrar, a eliminação da Nota Fiscal envia ao SIGAGFE a informação para que a situação do Documento de frete ou Contrato com Autônomo passe para Pendente Desatualização.

Pasta Fiscal

Esta pasta é habilitada quando, na pasta Integrações, na seção Processos (GFE para Datasul), é marcado o parâmetro Docto Fiscal (Docto Frete).

Nesta pasta, deve ser informado um código de Item válido, que será vinculado ao documento fiscal criado.
O campo Ação eliminação, da seção Integração, define qual será o tratamento que o sistema deverá executar quando solicitado, no módulo de Obrigações Fiscais do Datasul, uma eliminação de Documento Fiscal, originado a partir de um Documento de Frete do SIGAGFE.

Selecionando a opção Nenhuma, a eliminação do Documento fiscal é efetuada normalmente e nenhuma solicitação é enviada ao respectivo Documento de Frete no SIGAGFE.

A opção Impedir bloqueia a tentativa do usuário de eliminação do Documento.

Quando selecionada a opção Integrar, a eliminação do Documento Fiscal envia ao SIGAGFE a informação para que a situação do Documento de frete passe para Pendente Desatualização.

Pasta Financeiro

Esta pasta é habilitada quando, na pasta Integrações, na seção Processos (GFE para Datasul), algum parâmetro de integração com o módulo financeiro for selecionado.

Os campos desta pasta são utilizados para a criação do título no módulo de Contas a Pagar do sistema financeiro do Datasul.

Os campos Espécie de Pré-faturas, Faturas e Contrato são obrigatórios para que o documento seja gerado.

Para pré-faturas, a espécie informada deve ser do tipo Provisão.

O campo Ação eliminação, da seção Integração, define qual será o tratamento que o sistema deverá executar quando solicitado, no módulo Financeiro do Datasul, uma eliminação de Título, originado a partir de um Documento do SIGAGFE (Pré-fatura, fatura ou contrato).

Selecionando a opção Nenhuma, a eliminação do Título é efetuada normalmente e nenhuma solicitação é enviada ao respectivo Documento no SIGAGFE.

A opção Impedir bloqueia a tentativa do usuário de eliminação do Documento.

Quando selecionada a opção Integrar, a eliminação do Título envia ao SIGAGFE a informação para que a situação do Documento passe para Pendente Desatualização.

Pasta HCM

Nessa pasta é possível determinar qual a unidade de negócio HCM. Essa informação é utilizada apenas para autônomos. 

Outras Funcionalidades

Todas as funcionalidades chamadas pelos botões mencionados abaixo, também podem ser executadas separadamente, por meio do menu do Datasul ou pelas teclas de atalho (Ctrl+Alt+x):

• Sincronização com GFE: Este botão abre o programa de sincronização Batch dos dados de cadastro e notas fiscais do Faturamento e Recebimento do Datasul Totvs 12 para o GFE (CD9125).
• Verificar Sincronismo dos Dados: Este botão abre a função Verificar Sincronismo de Dados (CD0084), onde é possível visualizar os percentuais de registros dos cadastros do Datasul Totvs 12 integrados ao GFE.
  Após aberto o programa, deve-se clicar no botão Atualizar dados para iniciar a contagem de registros na base de dados do Datasul Totvs 12 e a comparação com os registros existentes na base do GFE.
• Contingência de Integração: Registros que deixam de integrar do Datasul para o GFE, por falha na comunicação com o WebService, poderão ser visualizados na função Contingencia de Integração (CD0082), executados a partir deste botão.
  No programa também é possível reenviar os registros para integração após o reestabelecimento da comunicação, ou descartá-los.
  Nos botões da régua superior do programa, pode-se testar a conexão com o WebService e agendar a execução da integração via servidor RPW.
• Matrizes de Tradução: na função Matriz de Tradução (CD0089B) deve-se criar a relação entre os estabelecimentos do Datasul Totvs 12 com os estabelecimentos do GFE.
  O programa é composto por duas pastas, uma onde relacionamos os estabelecimentos dos módulos fiscal, faturamento e recebimento com o GFE, e outra pasta relacionando os estabelecimentos do módulo financeiro com o GFE.
  Quando não houver diferença nos códigos entre os sistemas, mantenha a coluna Filial GFE em branco.
• APPCs de Integração: esta opção apresenta os programas de integração que são vinculados aos gatilhos de dicionário ou à interface do Datasul Totvs 12.
  Para ativar os gatilhos do dicionário de dados, deve ser executado o Otimizador de performance. Por contingência, é possível retirar algum programa de integração do ar, por meio do botão Retirar APPC. Para voltar o cadastro da APPC retirada, pode-se utilizar o botão Atribuir APPCs conforme configuração de Integração, que atribui os programas APPC’s conforme configurações de integração. 
  É possível verificar também as UPC’s e DPC’s ativas no sistema Datasul.
  No sistema de integração padrão, não são cadastrados programas UPC’s ou DPC’s. Porém, eles podem ser criados sob demanda (por meio de customização) para atender necessidades específicas de integração.

Para mais detalhes, consulte o documento de referência do programa Parâmetros de Integração (CD0089).

Monitor de Integração - EMS X GFE (CD0433)

Esse programa permite monitorar o processo Web Service de integração entre o Datasul e o Gestão de Frete Embarcador. 

As integrações disponíveis para execução são:

• Documento Frete (Fiscal);
• Documento Frete (Nota Rateio);
• Pré-fatura/Lote Provisão (Financeiro);
• Fatura (Financeiro);
  
• Dt Sai/Dt Ent/Dados Frete (Nota Fiscal);
• Aprovação Logística (MLA);
• Negociação de Frete (MLA/Consulta);
• Contrato (Financeiro);
• Contrato (Nota Rateio);
• Contrato (Prestação Serviço).

Para mais detalhes, consulte o documento de referência do programa Monitor de Integração (CD0433).

Configuração com interface Monitor de Integração - EMS X GFE (CD0433):

1. Executando no TOTVS 12, acesse o programa Monitor Integração - EMS X GFE (CD0433);
2. Selecione os processos a serem considerados para integração. 
3. Acione o botão Iniciar (Play). 
   Os documentos serão validados e integrados, quando não houver impedimento no ERP. Em caso de rejeição do documento, o monitor irá apresentar o motivo retornado pelo ERP.

Configuração com agendamento via RPW – Monitor de Integração - EMS X GFE (CD0433):

1. Executando no Datasul TOTVS 12, acesse o programa Monitor Integração - EMS X GFE (CD0433); 
2. Acione o botão Agendar execuções via RPW;
3. Será apresentada a tela Criação de Pedidos de Execução (BTB911ZB);
4. Selecione o servidor preparado para executar a tarefa e acione o botão Cria Pedidos Periódicos;
5. Será apresentada a tela Repetir Pedido de Execução (BTB911ZC);
6. Informe a periodicidade desejada para as integrações dos processos do GFE;
7. Acione OK para confirmar.

Configuração com Execução em Background:

1. Inclua os dados de execução do programa CDF433 na inicialização do Windows. 
   Exemplo de execução, por intermédio de arquivo “.BAT”:
   c:cd %temp%
   start C:\dlc102b\bin\prowin32.exe -pf "\\costao\di-flex-tabatinga-8180\scripts\DIFlex.pf" -ininame "\\costao\di-flex-tabatinga-8180\scripts\DIFlex.ini" -param "10;super;super@123;SSSSSSS;;Y;GFE" -p "c:\fndlm\alias.p"
   Deve conter a chamada para o arquivo Alias.pf, que contém os bancos do Datasul Totvs 12, os dados de conexão (login e senha) e parâmetros de inicialização da base Progress.
2. Outra forma é a criação de um atalho contendo estes parâmetros e execução do CDF433, que pode ser acionado dentro do servidor ou da estação de trabalho que desejar.

REGRAS PARA FILTRO E CONVERSÃO (ENGINE DE REGRAS)

Para filtrar notas fiscais do faturamento e recebimento, que não necessitam ser enviadas para o GFE (exemplo: notas fiscais de saída com tipo de frete FOB), utilize o programa Configurador de Regras (CD0024), cadastrando antecipadamente o tipo de operação no programa Tipo de Operação (CD0025) e posteriormente utilizando-o para o cadastro da regra no programa Configurador de Regras (CD0024), com a utilização das respectivas variáveis para manipulação:

Faturamento (Nota fiscal de saída):

Cadastrar o tipo de operação GFE-NFS e utilizar as variáveis:

variáveis de condições:

• cod-estabel
• serie
• nome-ab-cli
• cod-emitente
• ind-sit-nota
• cod-cond-pag
• esp-docto
• ind-tip-frete
• cidade-cif
• nome-transp
• nat-operacao
• canal-venda
• estado
• cidade
• cod-modalid-frt
• it-codigo
• ind-tip-nota

variáveis de retorno:

• I-rateio
• Icrdicm
• envia-simulcao

Exemplo: Não integrando notas fiscais do tipo FOB (IND-TP-FRETE = 2).

Para manipular o tipo de documento de carga gerado no GFE pelo faturamento:

Cadastrar o tipo de operação GFE-ESP-DC e utilizar as variáveis:

variáveis de condições:

• esp-docto 
• nat-oper 
• cfop 

variáveis de retorno:

• tipo-dc 
• cdtpdc

Recebimento (Nota fiscal de entrada):

Cadastrar o tipo de operação GFE-NFE e utilizar as variáveis:

• cod-emitente
• tipo-frete
• ind-tip-nota
• nat-oper (nat-operacao)
• nome-transp
• esp-docto
• cod-modalid-frete
• cod-cfop
• it-codigo

variáveis de retorno:

• I-rateio
• Icrdicm
• envia-simulcao

Exemplo: Não integrando notas fiscais de exportação (NAT-OPER = 711).

Para manipular o tipo de documento de carga gerado no GFE pelo Recebimento:

Cadastrar o tipo de operação GFE-TIPO-DC e utilizar as variáveis:

variáveis de condições:

• esp-docto 
• nat-oper  
• cfop  
• tipo-docto
• cod-observa
• ge-codigo

variáveis de retorno:

• tipo-dc 
• cdtpdc

FISCAL:

Cadastrar o tipo de operação GFE-FISCAL e utilizar as variáveis:

• cod-estabel
• cod-emitente
• cidade
• estado
• nat-operacao
• cod-acesso-cte
• I-cte
• it-cd-trib-iss
• it-aliquota-iss
• it-cd-trib-icm
• it-aliquota-icm
• vl-cofins
• vl-pis
• tipo
• trib-imp-gfe
• esp-docto-frete
• trib-pis-cofins
• trib-IPI
• NatOperNf (Disponível somente na integração fiscal via recebimento)

variáveis de retorno:

• nat-operacao
• item

Exemplo: Alterar a natureza de operação, quando a alíquota do ICM (IT-ALIQUOTA-ICM) for 12%, a tributação do ICM (IT-CD-TRIB-ICM) for 1 e a natureza de operação (NAT-OPERACAO) for 2353, alterar para natureza de operação (NAT-OPERACAO) 235305.

Nota Fiscal de Rateio:

Cadastrar o tipo de operação GFE-RE e utilizar as variáveis:

• nat-operacao
• cod-servico
• cd-trib-icm
• aliquota-icm
• nf-nat-oper
• l-iss
• l-ativo
• l-cons-final
• l-crdicms
• l-difaliq
• l-nat-entrada
• uforigem
• ufdestino
• l-trib-pc
• UFtransp

variáveis de retorno:

• nat-operacao (natur-oper ou natureza)
• cod-servico
• l-nat-entrada

Contrato RPA no RH:

Cadastrar o tipo de operação GFE-RH e utilizar as variáveis:

• transaction
• cod-estabel
• cod-emitente
• esp-docto-frete
• cod-sentido ( Disponível à partir da versão do programa GFEXWSFUN de 19/11/2019 )

variáveis de retorno:

• cdn-plano-lotac
• cod-tipo-mdo
• cod-espec-docto (implementação futura)
• cod-fluxo-financ (implementação futura)
• cdn-tip-serv-ext
• cod-rh-cta-ctbl

Fatura de Fretes no Contas a Pagar: ( Disponível à partir da versão do programa GFEXWSFUN de 29/11/2019 )

Cadastrar o tipo de operação GFE-AP e utilizar as variáveis:

• transaction
• cod-estabel
• emitente
• cod-impto
• cidade
• estado
• cod-ibge

variáveis de retorno:

• cod_imposto
• cod_classif_impto

Para mais informações, acesse o documento Engine de Regras (CD0024) no SIGAGFE.

Protheus

Web Service

Deve-se parametrizar os dados para execução do WebService no arquivo appserver.ini da instalação do TOTVS GFE.

Exemplo:

[localhost:8064/ws]
ENABLE=1
PATH=C:\Protheus\Protheus12\web\WS
ENVIRONMENT=P12_01_17
INSTANCENAME=WS
RESPONSEJOB=JOB_WS_9901
DEFAULTPAGE=wsindex.apw
PREPAREIN=99,01

Datasul

Atualização Parâmetro Global (CD0101)

Indique a utilização do TOTVS GFE, marcando o campo correspondente no programa Atualização Parâmetro Global (CD0101) do Datasul. Sem este parâmetro marcado, as integrações com o TOTVS GFE não executarão nenhuma ação.

1. Executando no Datasul, acesse o programa Atualização Parâmetro Global (CD0101);
2. Aciona a pasta Módulos II e assinale o campo Frete Embarcador Multiplataforma (TotvsGFE);
3. Acione OK para confirmar.

Para mais detalhes, consulte o documento de referência do programa Atualização Parâmetro Global (CD0101).

Pasta Conexão

Nesta pasta são informados os Modos de Integração e os dados da conexão com o Web Service.
Para integração utilizando Web Service, deve-se obrigatoriamente indicar que os canais de saída e entrada são Web Service.

Deve-se informar a URL do WS no campo Servidor e opcionalmente um usuário (e sua senha) da instalação do TOTVS GFE. A URL informada é a mesma que consta na entrada configurada para o WS, no arquivo appserver.ini da instalação do TOTVS GFE.

Por intermédio do botão Testar Conexão é possível verificar se o Datasul Totvs 12 consegue estabelecer uma conexão válida com o Web Service de integração do TOTVS GFE.
Por intermédio do botão Histórico é possível consultar as eventuais falhas de conexão com o WS, registradas pelas diversas rotinas de envio de dados do Datasul Totvs 12 para o TOTVS GFE, após o início da utilização da integração via Web Service.

O parâmetro Integração temporariamente suspensa pode ser usada para indicar ao Datasul Totvs 12 que o Web Service de integração com o TOTVS GFE está intencionalmente fora do ar, nesse caso, o Datasul Totvs 12 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.

O parâmetro Enviar e-mail nas falhas de Conexão, quando marcado, 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 GFE, situação na qual deve-se verificar se o Web Service sofreu alguma queda imprevista.

O botão Configurar possibilita o acesso aos programas do Datasul Totvs 12, no qual são informados os parâmetros de envio de e-mail.                                                                                                                                                 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 Totvs 12.                                                                                                                                                                                                        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ário do aviso; se o envio do aviso falhar, os motivos da falha também serão registrados.

Pasta Integrações

Nesta pasta devem ser marcados os cadastros e processos que são integrados com o SIGAGFE.

Internamente, cada parâmetro marcado (e confirmado) nas seções desta pasta, gera a inclusão de um programa APPC nos gatilhos de Criação e eliminação do dicionário de dados do Datasul Totvs 12.

Pasta Faturamento

Esta pasta do programa é habilitada quando, na pasta Integrações, na seção Processos (Datasul para GFE) é marcado o parâmetro Notas Fiscais de Saída, ou na seção Simulação de Frete é marcado o parâmetro Notas Fiscais de Saída.

Esta pasta contém parâmetros importantes que devem ser considerados pelo SIGAGFE na integração das notas fiscais de saída.

Pasta Recebimento

Esta pasta do programa é habilitada quando, na pasta Integrações, na seção Processos (Datasul para GFE) é marcado o parâmetro Notas Fiscais de Entrada, ou na seção Simulação de Frete é marcado o parâmetro Notas Fiscais de Entrada.

Esta pasta contém parâmetros importantes que devem ser considerados pelo SIGAGFE na integração das notas fiscais de entrada.

Na seção Integração, o campo Ação eliminação define qual será o tratamento que o sistema deverá executar, quando solicitada no módulo de Recebimento do Datasul, uma eliminação de Nota Fiscal de Rateio, originada a partir de um Documento de Frete ou de um Contrato com Autônomo do SIGAGFE.

Ao selecionar a opção Nenhuma, a eliminação da Nota Fiscal de Rateio é efetuada normalmente e nenhuma solicitação é enviada ao respectivo Documento de Frete ou Contrato no SIGAGFE.

A opção Impedir bloqueia a tentativa do usuário de eliminação da Nota Fiscal de Rateio de Frete.

Quando selecionada a opção Integrar, a eliminação da Nota Fiscal envia ao SIGAGFE a informação para que a situação do Documento de frete ou Contrato com Autônomo passe para “Pendente Desatualização”.

Pasta Fiscal

Esta aba é habilitada quando marcado o parâmetro de integração do processo de Documento Fiscal do GFE com o Datasul, na aba Integrações ( seção Processos (GFE para Datasul), parâmetro Docto Fiscal (Docto Frete) ).

Nesta pasta, deve ser informado um código de Item válido, que será vinculado ao documento fiscal criado.
No campo Ação Eliminação, da seção Integração, define-se qual será o tratamento que o sistema deverá executar quando solicitada, no módulo de Obrigações Fiscais do Datasul, uma eliminação de Documento Fiscal originado a partir de um Documento de Fretes do SIGAGFE.

Selecionando a opção Nenhuma, a eliminação do Documento fiscal é efetuada normalmente e nenhuma solicitação é enviada ao respectivo Documento de Fretes no SIGAGFE.

A opção Impedir bloqueia a tentativa do usuário de eliminação do Documento.

Quando selecionada a opção Integrar, a eliminação do Documento Fiscal envia ao SIGAGFE a informação para que a situação do Documento de frete passe para Pendente Desatualização.

Pasta Financeiro

Esta pasta é habilitada quando algum parâmetro de integração com o módulo financeiro é selecionado na pasta Integrações, seção Processos (GFE para Datasul).

Os campos desta pasta são utilizados para a criação do título no módulo de Contas a Pagar do sistema financeiro do Datasul.

Os campos de Espécie de Pré-faturas, Faturas e Contrato são obrigatórios para que o documento seja gerado.
Para pré-faturas, a espécie informada deve ser do tipo PROVISÃO.

No campo Ação Eliminação, da seção Integração, define-se qual será o tratamento que o sistema deverá executar quando solicitada, no módulo Financeiro do Datasul, uma eliminação de Título originado a partir de um Documento do SIGAGFE (Pré-fatura, fatura ou contrato).

Selecionando a opção Nenhuma, a eliminação do Título é efetuada normalmente e nenhuma solicitação é enviada ao respectivo Documento no SIGAGFE.

A opção Impedir bloqueia a tentativa do usuário de eliminação do Documento.

Quando selecionada a opção Integrar, a eliminação do Título envia ao SIGAGFE a informação para que a situação do Documento passe para Pendente Desatualização.

Outras Funcionalidades

Todas as funcionalidades chamados pelos botões mencionados abaixo também podem ser executados separadamente, através do menu do Datasul ou pelas teclas de atalho (Ctrl+Alt+x):

Parâmetros do módulo de finanças

Cadastrar o módulo “GFE” no APB (programa BAS_MODUL_DTSUL).

FILTRO DE NOTAS FISCAIS E CONVERSÃO DA NATUREZA DE OPERAÇÃO

Para filtrar notas fiscais do faturamento e recebimento, que não necessitam ser enviadas para o GFE (exemplo: notas fiscais de saída com tipo de frete FOB), utilize o programa de Engine de regras, cadastrando antecipadamente o tipo de operação no programa CD0025 e posteriormente utilizando-o para o cadastro da regra no programa CD0024, com a utilização das respectivas variáveis para manipulação:

Faturamento (Nota fiscal de saída):

Cadastrar o tipo de operação “GFE-NFS” e utilizar as variáveis:

• cod-estabel
• serie
• nome-ab-cli
• cod-emitente
• cod-cond-pag
• nome-transp
• nat-operacao
• ind-tip-nota
• esp-docto
• ind-tp-frete
• cidade-cif

Recebimento (Nota fiscal de entrada):

Cadastrar o tipo de operação “GFE-NFE” e utilizar as variáveis:

• cod-emitente
• tipo-frete
• ind-tip-nota
• nat-oper

Exemplo de cadastro de regras.

Este exemplo visa bloquear notas fiscais de entrada com tipo de frete CIF:

1. Cadastrar o tipo de operação no CD0025;
   Image Removed
2. Cadastrar o cabeçalho da Regra no CD0024;
3. Incluir variável que terá a condição avaliada;
   Image Removed
4. Incluir um nome para a Regra;
   Image Removed
5. Informar a condição para atribuição da regra; 
   Image Removed
6. Incluir o retorno para o campo “GFE-NFE” (mesmo nome do tipo de operação) igual a “NO”.
   Image Removed

Para o processo de integração de processos do GFE com módulos do Datasul, utilize da mesma forma os cadastros de tipo de operação e regra de negócios para a adequação de campos, como por exemplo, alteração de natureza de operação na integração do documento de fretes com o fiscal. Utilize os tipos de operação e variáveis abaixo para conversões de dados nas integrações com os módulos:

FISCAL:

Cadastrar o tipo de operação GFE-FISCAL e utilizar as variáveis:

• cod-estabel
• cod-emitente
• cidade
• estado
• nat-operacao
• cod-acesso-cte
• it-cd-trib-iss
• it-aliquota-ISS
• it-cd-trib-icm
• it-aliquota-icm

Nota Fiscal de Rateio:

Cadastrar o tipo de operação GFE-RE e utilizar as variáveis:

• nat-operacao
• cod-servico
• aliquota-icm

Protheus

Web Service

Deve-se parametrizar os dados para execução do WebService no arquivo appserver.ini da instalação do TOTVS GFE.

Image Removed

Deve-se criar uma entrada como a do exemplo acima, informado o IP ou Host do servidor no qual o AppServer está instalado e uma porta de comunicação exclusiva para o Web Service. Como PATH deve-se informar o caminho no qual os arquivos de Web Service estão localizados (diretório de instalação do TOTVS GFE + "\web\ws"). Como ENVIRONMENT deve-se informar o ambiente parametrizado para acesso às bases de dados do TOTVS GFE. Os demais parâmetros podem ser mantidos como os do exemplo.
Também se deve inserir a cláusula PREPAREIN nos parâmetros do JOB_WS do arquivo, contendo a empresa do SIGAGFE e um estabelecimento padrão.

Image Removed

Após a configuração e reinicialização do APP Server do TOTVS GFE, pode-se verificar a disponibilidade do serviço e do método de comunicação do WS pelo navegador de internet: abra uma página do tipo http informando o caminho parametrizado para o WS; verifique se o método WSGFE está habilitado.

No caso do link WSGFE não ser mostrado, certifique-se de ter atualizado o RPO 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.

Image Removed

Após acionar o link WSGFE deve ser apresentada uma página com os seguintes métodos. No caso algum desses métodos não ser mostrado, certifique-se de ter atualizado o RPO 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.

Image Removed

Parametrizar, nos Parâmetros do frete embarcador (GFEX000), aba 'Integrações Datasul', a configuração da URL do WebService com a porta e o nome da instância.

Especificamente nos casos da integração de Notas Fiscais de Saída e Notas Fiscais de Entrada, os dados integrados diretamente na base de dados do TOTVS SIGAGFE passarão por uma validação de consistência, aplicada pela rotina Agent Releaser, mantida em execução por intermédio do Scheduler na instalação do TOTVS GFE.

Image Removed

Image Removed

Image Removed

O programa CD9125 permite a integração em lote dos dados existentes na base de dados do Datasul Totvs 12 anteriores à implantação do TOTVS GFE. (Ver seção Sincronização com GFE, programa CD9125).

Quando o WS não estiver disponível para conexão ou houver algum erro de exceção no envio dos dados, será mantido um histórico de falhas na base de dados do Datasul Totvs 12 para análise e reprocessamento.

Image Removed

Controle de Versão

O grupo TOTVS representado por suas marcas irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Datasul Totvs 12 e Protheus SIGAGFE estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Fluxo das Informações

Image Removed

Image Removed 

* Para as pré-faturas, o título a pagar é de espécie Provisória.

.
Também se deve inserir a cláusula PREPAREIN nos parâmetros do JOB_WS do arquivo, contendo a empresa do SIGAGFE e um estabelecimento padrão.

Para a execução do Web Service, são necessárias as seções FWSCHDMANAG_P12, FWSCHDQUEUE_P12 e ONSTART.

Exemplo:

[JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=P12_01_17
INSTANCES=1,10
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01

[FWSCHDMANAG_P12]
Main=FWSCHDMANAG
Environment=P12_01_17

[FWSCHDQUEUE_P12]
Main=FWSCHDQUEUE
Environment=P12_01_17

[ONSTART]
REFRESHRATE=10
JOBS=FWSCHDMANAG_P12,FWSCHDQUEUE_P12

Para mais informações sobre a parametrização dos dados, acesse o documento Configurar Portais e Web services.

Após a configuração e reinicialização do APP Server do TOTVS GFE, pode-se verificar a disponibilidade do serviço e do método de comunicação do WS, pelo navegador de internet: abra uma página do tipo http, informando o caminho parametrizado para o WS; verifique se o método WSGFE está habilitado.

No caso do link WSGFE não ser apresentado, certifique-se de ter atualizado o RPO 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.

Image Added

Após acionar o link WSGFE deve ser apresentada uma página com os seguintes métodos. No caso algum desses métodos não ser mostrado, certifique-se de ter atualizado o RPO 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.

Image Added

Parametrizar, no programa Parâmetros do Módulo (GFEX000), pasta Integração Datasul, a configuração da URL do WebService com a porta e o nome da instância.

Exemplo: 10.1.1.1:8090 e WS.

Especificamente nos casos da integração de Notas Fiscais de Saída e Notas Fiscais de Entrada, os dados integrados diretamente na base de dados do TOTVS SIGAGFE passarão por uma validação de consistência, aplicada pela rotina Agent Releaser, mantida em execução por intermédio do Scheduler na instalação do TOTVS GFE.

Image Added

Image Added

Image Added

O programa CD9125 (Integação por Lote) permite a integração em lote dos dados existentes na base de dados do Datasul Totvs 12. 

Quando o WS não estiver disponível para conexão, ou houver algum erro de exceção no envio dos dados, será mantido um histórico de falhas na base de dados do Datasul Totvs 12 para análise e reprocessamento.

Image Added

Controle de Versão

O grupo TOTVS representado por suas marcas irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Datasul Totvs 12 e Protheus SIGAGFE estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Fluxo das Informações

Image Added

Image Added

* Para as pré-faturas, o título a pagar é de espécie Provisória.

Situações comuns

Integração com módulo financeiro:

Situações comuns

Integração com módulo financeiro:

1 – Ao integrar com o financeiro, ocorrem os erros:

8437 - Usuário financeiro <nome usuário> não habilitado para estabelecimento <Cod. Estab.>
20639 - Atualização não permitida para o usuário !
20636 - Implantação não permitida para o usuário !
8437 - Usuário financeiro <nome usuário> não habilitado para estabelecimento.

Solução:
Cadastrar, no programa de manutenção de permissões do usuário no módulo APB, a relação entre o Usuário de criação do título e o módulo GFE (o módulo GFE deve estar previamente cadastrado no financeiro).
Devem ser cadastradas também as permissões do usuário com o estabelecimento financeiro.

Image RemovedImage Removed

Image Removed

2 – Cadastros do Datasul Totvs 12 não são integrados com GFE, mesmo com os parâmetros de integração de cadastros marcados no CD0089.

Solução:
Executar o programa Otimizador de Performance de Produto do Datasul e reiniciar a sessão.
Caso a ação anterior não tenha efeito, verifique se o seu usuário do ERP tem permissões para gravação no dicionário de dados.

3 – Nota fiscal de saída não integrou com o GFE.

Solução:

1. Verificar se o registro encontra-se na lista de ‘Contingencias de integração’, no programa CD0089. Em caso positivo, verificar o motivo e solicitar a integração do registro através do botão ‘Integrar’.
2. Verificar se as APPC’s referentes a cálculo e manutenção de notas fiscais estão acionadas (programa CD0089). Em caso negativo, revisar os parâmetros da aba integração e confirmar.
3. Verificar no programa de Engine de regras, CD0024, se há alguma regra de filtro de notas fiscais de saída (conforme tópico FILTRO DE NOTAS FISCAIS E CONVERSÃO DA NATUREZA DE OPERAÇÃO).
4. Executar o programa CD9125, informando os dados da nota fiscal em questão.

4 – Nota fiscal de entrada não integrou com o GFE.

5 – Após aplicação do pacote de atualização do GFE, não aparece o método WSGFE na consulta da URL + porta + instancia através do navegador de internet.

Solução:
Finalizar todas as sessões do GFE e reiniciar o serviço appserver no servidor da aplicação.

Integração com módulo financeiro:

1 – Ao integrar com o financeiro, ocorrem os erros:

8437 - Usuário financeiro <nome usuário> não habilitado para estabelecimento <Cod. Estab.>

20639 - Atualização não permitida para o usuário !

20636 - Implantação não permitida para o usuário !

8437 - Usuário financeiro <nome usuário> não habilitado para estabelecimento .

Solução:

Cadastrar, no programa de manutenção de permissões do usuário no módulo APB, a relação entre o Usuário de criação do título e o módulo GFE (o módulo GFE deve estar previamente cadastrado no financeiro). 

Checklist de suporte da aplicação

Instalação/Configuração

1. Verificar se o método WSGFE é apresentado na consulta da URL+porta+instancia pelo navegador de internet.
2. Testar a conexão com o WebService, por meio do programa CD0089do programa Parâmetros de Integração - EMS X GFE (CD0089).
3. Verificar se as transações EAI, referente ao frete foram retiradas (botão “Configuração EAI”, programa CD0089), programa Parâmetros de Integração - EMS X GFE (CD0089), botão Configurações do EAI.
4. Confirmar se a lista de APPC’s, referente ao módulo de gestão de frete embarcador, estão acionadas (botão “APPC’s de integração”, programa Parâmetros de Integração - EMS X GFE (CD0089), botão APPCs de Integração.

Checklist de Verificações:

• Identificar o funcionamento da integração:
  - Para integração de informações do Datasul para o GFE:
        - Verificar existência de registros em “Contingências de integração” e a causa descrita.
        - Solicitar a integração do registro pelo botão “Integrar” e Integrar e confirmar a integração ou erro.
  - Para integração de processos do GFE para o Datasul Totvs 12:
        - Executar novo pedido de atualização do processo no GFE e acompanhar a integração através do monitor CD0433, por meio do programa Monitor Integração - EMS X GFE (CD0433).
• Coletar evidências do mau funcionamento relatado pelo cliente:
  - Para cadastros e notas fiscais, comparar as imagens de telas de consultas do mesmo registro no Datasul Totvs 12 e no GFE.
  - Para processos, solicitar o arquivo de log do CD0433 gravado programa Monitor Integração - EMS X GFE (CD0433), gravado no diretório temporário da sessão. Em caso de execução via RPW, solicitar o arquivo de log do CD0433rp gravado no servidor de execução.

Anexos

Anexo I – Relação entre o Datasul Totvs 12 e o SIGAGFE 

CADASTROS

DOCUMENTOS (Datasul para GFE)

DOCUMENTOS (GFE para Datasul) 

ANEXO II - Lista de Programas evolvidos na integração

Anexo III – Programas sem correspondente no SIGAGFE e justificativa

Anexo IV -  Lista de APPCs