Páginas filhas
  • DI Integração Datasul 12 x Protheus SIGAGFE

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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:


Datasul

SIGAGFE

Cadastros

Fornecedores

Emitentes

Grupo de Clientes

Grupo de Emitentes

Clientes

Emitentes

Cidades

Cidades

Embalagens

Unitizadores

Contas Contábeis Integração

Contas Contábeis

Centro de Custo

Centro de Custo

Processos

Notas Fiscais de Saída

Documento de Carga

Embarques

Romaneios

Documento de Entrada

Documento de Carga

Contrato de CompraContrato de Transporte


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

Processos

Pré-faturas de Frete

Títulos de Provisão

Documentos de Frete

Documentos Fiscais

Documentos de Frete

Notas de Rateio

Faturas de Frete

Títulos a Pagar

Contratos com Autônomos

Títulos a Pagar

Contratos com Autônomos

Notas de Rateio

Contratos com Autônomos

Movimentos de Prestação de Serviço

Liberação de Romaneio de cargaAtualização da data de saída da Nota Fiscal de saída
Registro de EntregaAtualização da data de entrega da Nota Fiscal de saída
Aprovação de tabelas de fretePendência de aprovação - MLA - Doc. 29
Auditoria de documentos de fretePendência de aprovação - MLA - Doc. 30
Auditoria de faturas de fretePendência de aprovação - MLA - Doc. 31
Estorno em Lote

Estorno de Título no Contas a Pagar

Medição de ContratoMedição de Contrato


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

Consulta

Notas Fiscais 

Dados relacionados aos transportes de documentos de carga.

Pedido de Venda

Pedido de Compra

Cotação de Compra

Nota Fiscal de Entrada

Nota Fiscal de Saída

Retorna os valores referente a uma simulação de frete.


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
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
  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):

Executando no Datasul TOTVS 12, acesse o programa Monitor

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


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

CD0433

CD0089)

  • Acione o botão Agendar execuções via RPW;
  • Será apresentada a tela Criação de Pedidos de Execução (BTB911ZB);
  • Selecione o servidor preparado para executar a tarefa e acione o botão Cria Pedidos Periódicos; 
  • Será apresentada a tela Repetir Pedido de Execução (BTB911ZC);
  • Informe a periodicidade desejada para as integrações dos processos do GFE; 
  • Acione OK para confirmar.
  • 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 Multiplatavorma (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 de Integração (CD0089)

    Pasta Conexão

    Nessa pasta são informados os Modos de Integração e os dados da conexão com 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.

    A opção 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.

    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 GFE, 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 Totvs 12 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 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 aba 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 aba do programa é habilitada quando, na aba Integrações, é marcado o parâmetro Notas fiscais de Saída da seção Processos (Datasul para GFE), ou o parâmetro de simulação de fretes para Nota Fiscal de Saída (seção Simulação de Frete, parâmetro Nota Fiscal de Saída).

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

    Pasta Recebimento

    Esta aba do programa é habilitada quando, na aba Integrações, é marcado o parâmetro Notas fiscais de Entrada da seção Processos (Datasul para GFE), ou o parâmetro de simulação de fretes para Nota Fiscal de Entrada (seção ‘Simulação de Frete’, parâmetro Nota Fiscal de Entrada).

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

    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 Recebimento do Datasul, uma eliminação de Nota Fiscal de Rateio originada a partir de um Documento de Fretes ou de um Contrato com Autônomo do SIGAGFE.

    Selecionando a opção Nenhuma, a eliminação da Nota Fiscal de Rateio é efetuada normalmente e nenhuma solicitação é enviada ao respectivo Documento de Fretes 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):

  • 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.
  • Verificar Sincronismo de 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” 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 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 abas, uma onde relacionamos os estabelecimentos dos módulos fiscal, faturamento e recebimento com o GFE e outra 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 através 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. 
    Na mesma funcionalidade podem ser verificadas 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 (através de customização) para atender necessidades específicas de integração.

    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çãoSolução

    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.
    Cadastrar, no programa Manutenção Permissões Usuar APB x Módulo (APB048AA), 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.
    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 programa Parâmetros de Integração - EMS X GFE (CD0089).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.

    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.

    Solução:

    1. Verificar se o registro encontra-se na lista de
    ‘Contingencias
    1. "Contingencias de
    integração’
    1. integração", no
    programa CD0089. Em
    1. programa Parâmetros de Integração - EMS X GFE (CD0089). Em caso positivo, verificar o motivo e solicitar a integração do registro
    através do botão ‘Integrar’
    1. , por meio do botão Integrar.
    2. Verificar se as APPC’s referentes a cálculo e manutenção de notas fiscais estão acionadas
    (programa
    1. , programa Parâmetros de Integração - EMS X GFE (CD0089).
    Em
    1.  Em caso negativo, revisar os parâmetros da
    aba integração
    1. pasta Integração e confirmar.
    2. Verificar no
    programa de Engine de regras, CD0024, se
    1. programa Configurador de Regras (CD0024), se há alguma regra de filtro de notas fiscais de
    entrada (conforme tópico FILTRO DE NOTAS FISCAIS E CONVERSÃO DA NATUREZA DE OPERAÇÃO).
  • Executar o programa CD9125, informando os dados da nota fiscal em questão.
  • Confirmar se a nota fiscal atualizou o estoque (RE0701a, aba integ. Sist., campo ‘CE atualizado’).
    1. saída, conforme tópico REGRAS PARA FILTRO E CONVERSÃO (ENGINE DE REGRA).
    2. Executar o programa CD9125, informando os dados da nota fiscal.
    4 – Nota fiscal de entrada não integrou com o GFE.
    1. Verificar se o registro encontra-se na lista de "Contingencias de integração", no programa Parâmetros de Integração - EMS X GFE (CD0089). Em caso positivo, verificar o motivo e solicitar a integração do registro, por meio do botão Integrar.
    2. Verificar se as APPC’s referentes a cálculo e manutenção de notas fiscais estão acionadas, programa Parâmetros de Integração - EMS X GFE (CD0089). Em caso negativo, revisar os parâmetros da pasta Integração e confirmar.
    3. Verificar no programa Configurador de Regras (CD0024), se há alguma regra de filtro de notas fiscais de entrada, conforme tópico REGRAS PARA FILTRO E CONVERSÃO (ENGINE DE REGRAS).
    4. Executar o programa CD9125, informando os dados da nota fiscal.
    5. Confirmar se a nota fiscal atualizou o estoque, programa Detalhes Documento (RE0701a), pasta Integ Sist, campo CE Atualizado.
    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, por meio do navegador de internet.Finalizar todas as sessões do GFE e reiniciar o serviço appserver no servidor da aplicação

    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). 

    Devem ser cadastradas também as permissões do usuário com o estabelecimento 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

    Datasul Totvs 12

    TOTVSGFE

    Grupos de Clientes

    Grupos de Emitentes

    Clientes/Fornecedores

    Emitentes

    Contatos dos Clientes/Fornecedores

    Contatos dos Emitentes

    Cidades

    Cidades

    Embalagens

    Unitizadores

    Contas Contábeis Integração

    Contas Contábeis

    Centros de Custo

    Centros de Custo

    DOCUMENTOS (Datasul para GFE)

    Datasul Totvs 12

    TOTVSGFE

    Nota Fiscais de Saída

    Documentos de Carga

    Embarques

    Romaneios

    Documentos de Entrada

    Documentos de Entrada

    Contrato de CompraContrato de Transporte

    DOCUMENTOS (GFE para Datasul) 

    Datasul Totvs 12

    TOTVSGFE

    Documentos Fiscais

    Documentos de Frete

    Títulos a Pagar

    Pré-faturas de Frete

    Títulos a Pagar

    Faturas de Frete

    Títulos a Pagar

    Contratos com Autônomos

    Nota de Rateio

    Faturas Documentos de Frete

    Nota de Rateio

    Contratos com Autônomos

    Prestações de Serviço de Terceiros

    Contratos com Autônomos

    Medição de CompraMedição de Compra


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

    EQ0506 CDAPI650

    Programa

    Código do Programa

    Eventos

    APPCs

    Cadastro de Grupos de Emitentes CD0701

    Trigger write, Trigger delete

    CDAPI622 / CDAPI623 

    Cadastro de Clientes

    CD0704

    Trigger write, Trigger delete

    CDAPI600 / CDAPI606

    Importação de Clientes

    CD1302

    Trigger write, Trigger delete

    CDAPI600 / CDAPI606

    Cadastro de Fornecedores

    CD0401

    Trigger write, Trigger delete

    CDAPI600 / CDAPI606

    Importação de Fornecedores

    CD1608

    Trigger write, Trigger delete

    CDAPI600 / CDAPI606

    Cadastro de Cidades

    CD0330

    Trigger write, Trigger delete

    CDAPI609 / CDAPI602

    Cadastro de Embalagens

    CD1117

    Trigger write, Trigger delete

    CDAPI624 / CDAPI625

    Contas Contábeis Integração

    UTB033AA

    Trigger write, Trigger delete

     PRGINT/UTB/UTB600GF.P

     PRGINT/UTB/UTB601GF.P

    Centros de Custo

    UTB066AA

    Trigger write, Trigger delete

     PRGINT/UTB/UTB602GF.P

     PRGINT/UTB/UTB603GF.P

    Notas Manuais

    FT4003

    EndEfetivaNota

    CDAPI655

    Faturamento de Pedidos

    FT4002

    EndEfetivaNota

    CDAPI655

    Cálculo de Embarques

    FT4001

    EndEfetivaNota

    CDAPI655

    Cancelamento de Notas Fiscais de Saída

    FT2200

    Fim_cancelanotafiscal 

    CDAPI652

    Simulação de Embarques

    EQ0503

     

    CDAPI630 

     Geração de Pré-faturamento

    EQ0504

     

    Geração de Embarques

    EQ0504


     

    Geração de Embarques

    EQ0506

    Trigger write, Trigger delete

     
    Atualização de Documentos de Entrada

    E1001/RE1005

    fim-atualizacao

    CDAPI651

    Desatualização de Documentos de Entrada

    RE0402

    RE0402RP 

    CDAPI650

    Manutenção Permissões Usuar APB x MóduloAPB048AA
    PRGFIN/APB/APB048AA.P
    Manutenções Usuários Financeiros EstabelecimentoAPB004AA
    PRGFIN/APB/APB004AA.P
    Manutenção Centros CustoCD0110

    Emissão de ContratoCN0401Trigger write, Trigger delete CDAPI698 / CDAPI699
    Geração Aditivo de ContratoCN0402Trigger writeCDAPI675Atualização de Documentos de Entrada

    E1001/RE1005

    fim-atualizacao

    CDAPI651

    Desatualização de Documentos de Entrada

    RE0402

    RE0402RP 


    Anexo III – Programas sem correspondente no SIGAGFE e justificativa

    Programa

    Código do Programa

    Justificativa

    Cadastro de Transportadores

    CD0402

    Os Transportadores devem ser obrigatoriamente cadastrados como Fornecedores para a integração com o GFE.

    Cadastro de Representantes

    CD0708

    No GFE o nome abreviado do Representante do Documento de Carga tem relevância restrita e não possui tabela estrangeira relacionada.

    Cadastro de Grupos de Estoque

    CD0201

    No GFE o código do Grupo de Estoque dos Itens do Documento de Carga tem relevância restrita e não possui tabela estrangeira relacionada.

    Cadastro de Famílias Comerciais

    CD0206

    No GFE o código da Família Comercial dos Itens do Documento de Carga tem relevância restrita e não possui tabela estrangeira relacionada.

    Cadastro de Famílias de Materiais

    CD0202

    No GFE o código do Grupo da Família de Material dos Itens do Documento de Carga tem relevância restrita e não possui tabela estrangeira relacionada.

    Cadastro de Canais de Venda

    CD1517

    No GFE o código do Canal de Venda do Documento de Carga tem relevância restrita e não possui tabela estrangeira relacionada.

    Cadastro de Unidades de Negócio

    CD9762

    No GFE o código da Unidade de Negócio dos Itens do Documento de Carga tem relevância restrita e não possui tabela estrangeira relacionada.

    Cadastro de Naturezas de Operação

    CD0606

    A Natureza de Operação é uma entidade própria do Datasul e no GFE não é utilizada como entidade agregadora da parametrização tributária como no Datasul.

    Cadastro de CFOPs

    CD0620

    Quantidade de registros varia pouco. O CFOP é um dado informativo no GFE por isso não é validado contra uma tabela previamente cadastrada.

    Cadastro de Itens (e relacionados)

    CD0204/

    CD0205/

    ...

    No GFE o código dos Itens dos Documentos de Carga tem relevância restrita e não possuem tabela estrangeira relacionada.

    Cadastro de Estabelecimentos

    CD0403

    As Filiais requerem um processo próprio de autorização na plataforma Protheus.

    Cadastro de Empresas

    CD0104

    As Empresas fazem parte do layput de Filiais na plataforma Protheus.

    Cadastro de Países

    CD0181

    Quantidade de registros varia pouco.

    Cadastro de Unidades de Federação

    CD0904

    Poucas ocorrências na tabela. Quantidade de registros varia pouco.

    Cadastro de Unidades de Medida

    CD0203

    No GFE a Unidade de Medida é utilizada apenas em rotinas e entiades entidades do próprio módulo, sem relação com os registros recebidos ou enviados para o ERP. 

    Cadastro de Séries Fiscais

    CD0905

    Número de registros varia pouco. A Série Fiscal não é uma informação relevante para o GFE, é utilizada apenas para compor a identificação única de certos documentos.

    Calendário Comercial

    CD0211

    O GFE possui um calendário próprio e independente, restrito às informações utilizadas nas operações relacionadas ao transporte de cargas.


    Anexo IV -  Lista de APPCs

    re0701b

    APPC

    Programa ou tabela relacionada

    Finalidade

    cdapi600

    mgadm.emitente

    Sincronização da inclusão e alteração de clientes e fornecedores

    cdapi601



    cdapi602

    mgdis.cidade

    Sincronização da eliminação de cidades

    cdapi603



    cdapi604



    cdapi605

    movind.docum-est

    Sincronização da eliminação de Nota de Rateio gerada pela integração com GFE

    cdapi606

    mgadm.emitente

    Sincronização da eliminação de clientes e fornecedores

    cdapi607



    cdapi608



    cdapi609

    mgdis.cidade

    Sincronização da inclusão e alteração de cidades

    cdapi610



    cdapi618

    movdis.wt-docto

    Eliminar os registros da tabela de extensão wt-docto-redesp

    cdapi619

    movdis.nota-fiscal

    Eliminar os registros das tabelas de extensão nota-fisc-redesp e simul-nota-fisc

    cdapi620

    pd4000

    Disponibilizar lista de campos para os Redespachantes e o botão para Simulação de Fretes

    cdapi621

    pd4050

    Disponibilizar o botão para Simulação de Fretes

    cdapi622

    mgadm.gr-cli

    Sincronizar da inclusão e alteração de Grupos de Clientes

    cdapi623

    mgadm.gr-cli

    Sincronizar da eliminação de grupos de clientes

    cdapi624

    mgdis.embalag

    Sincronizar da inclusão e alteração de Embalagens

    cdapi625

    mgdis.embalag

    Sincronizar da eliminação de Embalagens

    cdapi630 mgdis.embarqueSincronizar da inclusão e alteração de Embarques
    cdapi631

    mgdis.embarque

    Sincronizar da eliminação de Embarques

    cdapi632

    mgadm.cont-emit

    Sincronizar a inclusão e alteração de Contatos dos Emitentes

    cdapi633

    mgadm.cont-emit

    Sincronizar da eliminação de Contatos dos Emitentes

    cdapi634

    movdis.doc-fiscal

    Sincronizar a eliminação de Documento Fiscal gerado pela integração com GFE

    cdapi650

    re0402rp

    Sincronizar a desatualização de Documentos de Entrada

    cdapi651

    re1005rp; reapi190

    Sincronizar da inclusão de Documentos de Entrada

    cdapi652

    bodi135cancel

    Sincronizar o cancelamento de Notas Fiscais de Saída

    cdapi653

    ft0502

    Emitir mensagem, informando que não há integração dos dados alterados para o GFE

    cdapi654



    cdapi655

    bodi317ef; bodi317ef

    Sincronizar da inclusão de Notas Fiscais de Saída

    cdapi656

    boin090

    Criar registro da tabela de extensão da docum-est

    cdapi657

    boin176

    Criar registro da tabela de extensão da item-doc-est

    cdapi658


    Em desuso.

    cdapi659

    cdapi660

    re1001a1

    Disponibilizar o botão "Outros Totais" , que solicita os campos Peso Bruto total, Peso Cubado total e Volume total do Documento de Entrada e o botão "Fretes" , que solicita os Redespachantes, Embalagens e campos para o cálculo de frete automático.

    cdapi661

    re1001b2

    Disponibilizar os campos Peso Bruto, Peso Cubado e Volume na alteração de Itens do Documento de Entrada

    cdapi662

    re1001b

    Disponibilizar os campos Peso Bruto, Peso Cubado e Volume na navegação de Itens do Documento de Entrada

    cdapi663

    cdapi664

    re0501ra


    cdapi665

    re0501rb


    cdapi666

    re0501rc


    cdapi667

    re0501rd


    cdapi668

    re0701


    cdapi669



    cdapi670

    re2001a

    Criar registro da tabela de extensão da docum-est

    cdapi671

    re2001z

    Criar registro da tabela de extensão da item-doc-est

    cdapi673

    re2001b

    Disponibilizar os campos Peso Bruto, Peso Cubado e Volume na manutenção de Itens do Recebimento Físico.

    cdapi674

    ft4003b

    Solicitar os Redespachantes da Nota Fiscal de Saída no programa de Faturamento de Notas Manuais

    cdapi675

    ft4060b

    Em desuso. Emissão de Nota Manual (versão internacional) está fora do escopo do GFE.

    cdapi676



    cdapi677

    pd1001

    Disponibilizar os Redespachantes e dados da Simulação de Frete da Nota Fiscal para consulta

    cdapi678

    pd4050a

    Solicitar os Redespachantes no programa de Manutenção de Pedidos de Venda

    cdapi679

    ft0904

    Disponibilizar os Redespachantes e dados da Simulação de Frete do Pedidos de Venda para consulta

    cdapi680

    bodi159

    Gravar o registro com os Redespachantes na tabela de extensão do Pedido de Venda

    cdapi681

    bodi317sd

    Redespachantes da Nota Fiscal de Saída

    cdapi682

    ft4001

    Disponibilizar o botão de Simulação de Frete no programa de Cálculo de Embarques

    cdapi683

    ft4003

    Disponibilizar campos para o cálculo de frete automático no programa de Emissão de Notas Manuais

    cdapi684

    ft4005

    Disponibilizar o botão de Simulação de Frete no programa de Emissão de Notas Manuais

    cdapi685

    ft4001a

    Disponibilizar o botão de Simulação de Frete no programa de Faturamento por Embarque

    cdapi686



    cdapi687



    cdapi688

    ft4002

    Disponibilizar o botão de Simulação de Frete no programa de Faturamento de Pedidos de Venda

    cdapi689

    bodi159cpy

    Realiza a cópia do registro da tabela de extensão com os Redespachantes do Pedido de Venda

    cdapi805

    boin295


    cdapi806

    cc0300a


    cdapi807

    cc0300b


    cdapi808

    cc0311rp


    cdapi809

    cc0506


    cdapi810

    cc0509


    cdapi811

    oc0201a

    Em desuso

    utb600gf

    emsuni.cta_ctbl_integr

    Sincronização da inclusão e alteração de Contas Contábeis de Integração

    utb601gf

    emsuni.cta_ctbl_integr

    Sincronização da eliminação de Contas Contábeis de Integração

    utb602gf

    emsuni.ccusto

    Sincronização da inclusão e alteração de Centros de Custo

    utb603gf

    emsuni.ccusto

    Sincronização da eliminação de Centros de Custo

    utb607gf

    movfin.tit_ap

    Sincronização da eliminação de Título a Pagar gerado pela integração com GFE

    utb612gfmovfin.tit_apRealiza a integração do data de liquidação do Título a Pagar.