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 remessa de mercadorias;
  • 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;
    • 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 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.


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.

Para mais detalhes, consulte 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 (CD0089)

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


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

Cadastrar o tipo de operação GFE-TIPO-FISCAL e 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-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
  • -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

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.

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.

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.

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.

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.

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


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

  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 saída, conforme tópico REGRAS PARA FILTRO E CONVERSÃO (ENGINE DE REGRA).
  4. 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.


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 Parâmetros de Integração - EMS X GFE (CD0089).
  3. Verificar se as transações EAI, referente ao frete foram retiradas, 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, 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 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, 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 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

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

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

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 deleteCDAPI698 / CDAPI699
Geração Aditivo de ContratoCN0402Trigger writeCDAPI675


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 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 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 Simulação de Frete no programa 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 Simulação de Frete no programa Emissão de Notas Manuais

cdapi685

ft4001a

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

cdapi686



cdapi687



cdapi688

ft4002

Disponibilizar o botão Simulação de Frete no programa 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.