Histórico da Página

INTEGRAÇÃO LOGIX X GFE

Índice

1. 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 de cargas; 
• 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.

A integração do ERP Logix com o GFE visa manter os dados cadastrais do ERP, quando necessário, sincronizados ao GFE; manter os dados relacionados a documentos, custos e despesas com transporte, integrados aos demais módulos do ERP e possibilitar a simulação do preço do frete durante os processos do ERP (pedidos de venda, pedidos de compra, faturamento etc.) nos quais essa informação possa ser necessária.

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

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

2. Sistemas Envolvidos

•  Protheus Protheus / Gestão de Frete Embarcador 
  • Cadastros;
  • Expedição e Recebimento;
  • Doc Frete/Faturas.
• Logix:
  • Cadastros Gerais; 
  • Faturamento; 
  • Recebimento de Materiais; 
  • Financeiro; .

3. Integração (Fluxograma)

Desenvolvida integração que tem por objetivo permitir aos clientes Logix (BackOffice) o uso do sistema especialista para Gestão de Frete Embarcador (SIGAGFE).

A arquitetura utlizada utilizada para a integração é a mensageria únicamensagem única/EAI2, na maioria das integrações, e REST especificamente na integração do cálculo da simulação do frete pelo GFE no , na rotina de Pedidos e Faturamento Logix.

Image Added

4. Escopo

Envio de dados do Logix para o GFE

Para a sincronização de cadastros e movimentos originados no ERP são associados os Adapters da Mensagem Única nas interfaces do cadastro no ERP.

As principais ações (inclusão, alteração, eliminação) permitindo assim replicação permitem a integração para a base de dados do TOTVS SIGAGFE e , ficando os cadastros iguais em ambos os lados.

Também é possível uma carga inicial de dados através , por meio de rotina que permite o envio de toda a massa de dados, ou através por meio de filtros (FIN00000).

Recebimento de dados do GFE no Logix

Para a integração dos documentos registrados no TOTVS GFE para o ERP, é utilizada uma rotina de execução contínua do próprio EAI2, essa . Essa rotina monitora a entrada de XMLs das mensagens únicas mapeadas para recebimento no ERP Logix.

O controle dos dados que estão aptos para integração é efetuado pelo Monitor de integração (EAI10000). 

Cada Adapter utiliza as rotinas de negócio do Logix para processar os dados; ao final de cada processamento interage novamente com o TOTVS SIGAGFE para atribuir o retorno: Sucesso ou Erro.

5. Pré-requisitos instalação

5.1 Logix

• Liberação oficial: release 12.1.19 e posteriores.

• EAI2/

  Mensageria única

  Mensagem única instalado e configurado.

5.2 Protheus

• Liberação oficial: release 12.1.19 e posteriores.

• Atualização da Build 131227a a partir da versão 13.2.3.6.

• Adapter EAI configurado no Configurador (SIGACFG).

6.

Insira aqui as informações pertinentes ao Protheus.

Instalação/Atualização

6.1 Logix

6.1.1 Configuração das transações do EAI Logix:

 Executar  Execute o programa EAI10000 (Monitor EAI).

•  Acesse o menu Configuração > Aplicativo Hospedeiro. Clicar Clique no botão ‘Buscar Buscar novos adapters’ para adapters para recarregar os adapter adapters existentes no RPO, de acordo com as novas configurações.

• Acesse o menu Configuração > Aplicativos Externos. Clicar Clique em ‘Incluir’ e Incluir e depois no botão ‘Configurar’Configurar. Selecionar a ‘Classe canal’ correspondente Selecione a Classe canal correspondente ao produto com o qual queira se comunicar. 
  
  
• No quadro ‘Propriedades’ preencher Propriedades, preencha as informações solicitadas e clicar clique em ‘Confirmar’. Após isso serão exibidas Confirmar. Em seguida, serão apresentadas na tela principal, as transações que o aplicativo externo possui e com o qual pode-se trocar informações.

• Acesse novamente o menu Configuração > Aplicativo Hospedeiro. Clicar Clique no botão ‘Modificar’ Modificar, em seguida, dê dois cliques na coluna ‘Rotas’ de Rotas de cada mensagem envolvida nesta integração, para indicar para qual aplicativo externo/contexto a mesma esta será enviada.

• As mensagens abaixo

  deveram

  deverão estar habilitadas para o funcionamento da integração:

  Mensagem\Transação	Versão
  City	1.000
  CustomerVendor	2.000
  ListOfAccountantAccount	2.002
  Invoice	3.011
  ListOfAccountPayableDocument	1.000

6.1.2 Parâmetros Gerais (LOG00087)

• Aplicar Aplique os conversores de parâmetros: sup01869sup01878.cnv, sup01876.cnv, sup01864.cnv, sup01879sup01868.cnv, sup01877sup01908.cnv e sup01878, sup01909.cnv.
  , sup01913.cnv, vdp02564.cnv, vdp02603.cnv, fin00179.cnv e fin00180.cnv.
  
• Execute Executar o programa LOG00086 (Administração de Parâmetros) e liberar permissão no libere permissão para os seguintes caminhos:
  • PROCESSO ENTRADAS / FRETES
  /INTEGRACOES e INTEGRACOES/ADMINISTRACAO LOGIX/GERAL.
  
• Executar o programa LOG00087 e informar os seguintes parâmetros:
  • Parâmetro: Trabalha com integração com GFE-Gestão de Frete embarcador? (integra_logix_gfe)

                         Objetivo: Indica se a empresa trabalha com integração do Logix com o GFE (Gestão de frete embarcador).

                         OBS: Sim/Não (Alterar para S para habilitar a integração).

• • Parâmetro: CT-e sobre NF de vendas será tratado pelo GFE? (gfe_cte_venda)

• • / INTEGRAÇÕES; 
  • PROCESSO SAÍDAS / FRETE / FRETE - GFE.
  • LOGIX FINANCEIRO / CONTAS A PAGAR / TRANSFERÊNCIAS/INTEGRAÇÕES

Os parâmetros abaixo fazem parte desta integração e devem ser devidamente atualizados antes da utilização:

2- Ou se o primeiro não tiver sido informado considera o grupo de despesa padrão para frete de venda. LOG00087: 'Grupo de despesa a ser utilizado nos fretes de venda incluídos pelo SUP0580, SUP9220 e SUP0552.(grp_desp_frete_venda).

• •  Parâmetro: Assume automaticamente erros do frete recebido via integração GFE? (assu_auto_erro_integ_fret_gfe)

                     Objetivo: Indica se assume automaticamente os erros na consistência do frete, recebido via integração GFE.

                     OBS: Sim/Não (Alterar para S para habilitar a integração).

• • Parâmetro: Diretório XML Frete/Venda quando empresa trabalha com integração GFE (diretorio_gfe_cte_v)
    Objetivo: Caso empresa trabalhar com integração do Logix com GFE (Gestão do Frete Embarcador) e os fretes de venda são tratados pelo GFE, então no JOB de Recebimento de XML de Nota/Frete no TOTVS Colaboração irão mover os XML's que forem de frete relacionado a nota fiscal de venda para este diretório. Posteriormente o Gfe irá buscar estes XMLs deste diretório e importar no módulo para cálculos e tratamentos do frete.

 Relacionamento De/Para de Empresa/Filial:

Para que uma mensagem de integração possa ser recebida, é necessário informar o código da empresa e/ou filial do sistema de origem.

Quando uma mensagem é recebida pelo Logix, a partir da “Empresa Externa” e “Filial Externa” existentes na TOTVSMessage o sistema identificará qual é a “Empresa Logix” para atualização dos dados. Estas informações são registradas no LOG00083 (Cadastro de Empresas).

Nota: Para que estes campos possam ser informados é necessário ativar o parametro “Permite informar empresa/filial externa no cadastro de empresas?”, no LOG00087.

Totvs Colaboração

Como a recepção do frete de venda é realizada diretamente no GFE o mesmo é desviado da recepção via Totvs Colaboração no Suprimentos/Logix. 

Tratamentos no ERP

• • Conforme parametrização nos Parâmetros Gerais Logix "Conhecimento venda integrado GFE pode sofrer modificações no Logix?" permitirá incluir, alterar ou excluir um frete de vendas no Logix.
    Se parâmetro igual a "1" no sup0580 ao tentar incluir um conhecimento de nota de venda irá alertar que trabalha com integração com GFE e inclusão deveria ser realizada no GFE.
    Ainda no sup0580, ao tentar modificar ou excluir um conhecimento de notas ficais de venda, alerta o usuário que o frete foi integrador via GFE e a alteração ou exclusão deveria ser realizada no GFE).
    Se parâmetro igual a "2" no sup0580 ao tentar incluir um conhecimento de nota de venda irá bloquear a inclusão, avisando que existe a integração com GFE e inclusão deve ser realizada no GFE. Ainda no sup0580, ao tentar modificar ou excluir um conhecimento de notas ficais de venda, bloqueia a transação, e avisa ao usuário que o frete foi integrado via GFE e a alteração ou exclusão deverá ser realizada no GFE).
    E se parâmetro igual a "3" permitirá Incluir Modificar ou Excluir Conhecimento normalmente no sup0580 mesmo que esteja com a integração GFE ligada.

Protheus

Insira aqui as informações pertinentes ao Protheus.

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

6.1.3 Relacionamento De/Para de Empresa/Filial:

Para que uma mensagem de integração possa ser recebida/enviada, é necessário identificar o código da empresa e/ou filial do sistema de origem/destino.

EAI:

• Acessar o programa EAI10000 (Monitor EAI)
• Selecionar o menu Configuração > Aplicativos Externos
• Consultar o aplicativo externo do Protheus e clicar no botão "De/Para Empresas"
• Na tela de De/Para, informar a empresa Logix no campo "cod_empresa" e empresa e filial do Protheus nos campos "Empresa" e "Filial"
  

API Rest (Simulação de Frete / Validação de Cancelamento de Nota):

• Ativar o parâmetro "Permite informar empresa/filial externa no cadastro de empresas?" no LOG00086 (Administração de Parâmetros)
• Acessar o programa LOG00083 (Cadastro de Empresas)
• Consultar empresa do Logix que deseja relacionar
• Iniciar a modificação da empresa e informar a empresa e filial do Protheus, correspondente à do Logix, nos campos "Empresa Externa" e "Filial Externa" no final do formulário

6.1.4 Totvs Colaboração

Como a recepção do frete de venda é realizada diretamente no GFE, este é desviado da recepção via Totvs Colaboração no Suprimentos/Logix. 

Para isso, é realizado um desvio, e são movidos os XMLs do frete de venda para o diretório parametrizado no LOG00087: "Diretório XML Frete/Venda quando empresa trabalha com integração GFE".
Posteriormente, o GFE irá buscar estes XMLs deste diretório e importar no Protheus SIGAGFE para cálculos e tratamentos do frete. Após, o Conhecimento é enviado e integrado ao Logix.

6.1.5 Tratamentos no ERP

• • Conforme a parametrização nos Parâmetros Gerais Logix, Conhecimento venda integrado GFE pode sofrer modificações no Logix?, permitirá incluir um frete de vendas no Logix.
    Se o parâmetro estiver igual a "1", no sup0580, ao tentar incluir um conhecimento de nota de venda, este irá alertar que trabalha com integração com GFE, e a inclusão deveria ser realizada no GFE.
    Se o parâmetro estiver igual a "2", no sup0580, ao tentar incluir um conhecimento de nota de venda, este irá bloquear a inclusão, avisando que existe a integração com o GFE, e informando que a inclusão deve ser realizada no GFE. 
    E se o parâmetro estiver igual a "3", permitirá incluir conhecimento normalmente no sup0580, mesmo se estiver com a integração GFE ligada.
    
    

Apropriações de Despesas originadas do sistema Protheus GFE não poderão ser excluídas diretamente pelo Logix - FIN30058 (Manutenção de ADs). Os títulos devem ser excluídos diretamente no sistema origem quando necessário. 

6.1.6 Ajuste dos transportadores no Logix

• Existe uma condição para integração que os transportadores precisam estar cadastrado no Logix como tipo "5"-Fornecedor/Transportador. 
  Então para facilitar a implantação criamos um conversor chamado SUCA_TRANSP de base que atualiza os transportadores que estiverem como tipo "2"-Apenas Transportador para "5"-Fornecedor/Transportador.
  Para executá-lo cadastrar o mesmo no menu (Men0050) e liberar permissão (Log05050). Executar então através do menu e processar conversão.

  Importante: Os novos transportadores que vierem a ser cadastrados após a implantação devem ser cadastrados como tipo  "5"-Fornecedor/Transportador.

6.1.7 Cadastro de grupos de despesa de frete no Logix

• Caso não seja informado grupo de despesa único para frete venda no parâmetro 'grupo_desp_frete_gfe'. deve criar e cadastrar grupos de despesa de frete no Logix (SUP0650 - ICMS), ordenado com o menor número de grupo de despesa disponível, necessário para a busca automática de grupo de despesa com base na alíquota / UF / incidência gerada na Invoice. 
• Cadastrar no VDP0696 / VDP10068 (configurador Fiscal), PIS_REC e COFINS_REC para os novos grupos de despesa, mais informações consultar LRECNF0123 - Como parametrizar o CST das notas fiscais de entrada?
  

6.1.8 Contabilização do CTe de Venda no Logix

         Como os fretes de venda que são recebidos no Logix (Sup0580) entram com condição de pagamento sem pagamento (para que sejam integrados os títulos posteriormente consolidados diretamente no Financeiro) então é necessário que sejam parametrizados os CFOP´s no Sup0294 (Códigos fiscais contabilizados) com a opção "Com e sem pagamento" marcado. 

         Com isso ao receber o conhecimento de frete é efetuada contabilização automática do mesmo, a qual já irá gerar lançamento contábil também para o valor cheio do frete à Crédito na  "Conta contábil a débito" do tipo de despesa (Fin30058/Informações Contábeis), que seria a conta transitória do fornecedor. 

         Na contabilização da AD(Adiantamento de despesa) no financeiro do Logix (recebe os lançamentos consolidados via título do GFe para o Logix via integração) este lançamento à Crédito terá a contrapartida com um lançamento a Débito na mesma  "Conta contábil a débito" do tipo de despesa (Fin30058/Informações Contábeis). E um lançamento a Débito na conta definitiva do fornecedor, o qual será baixado lançamento com a contrapartida posteriormente na AP-Apropriação de pagamento do mesmo.

Observação:

6.2 Protheus

6.2.1 Configuração do Adapter EAI:

• Para realizar o cadastro das mensagens únicas que serão utilizadas na integração, é necessário acessar Configurador (SIGACFG) > Ambiente > Schedule > Adapter EAI.
  Image Added
  
  

• As mensagens deverão ser cadastradas conforme a tabela abaixo:

  Mensagem	Rotina	Descrição	Envia	Recebe	Método	Versão
  City	GFEA020	Cidades	Não	Sim	Síncrono	1.000
  CustomerVendor	GFEA015	Emitentes	Não	Sim	Síncrono	2.000
  ListOfAccountantAccount	GFEA090	Contas Contábeis	Não	Sim	Sincrono	2.002
  Invoice	GFEA044	Notas Fiscais de Saída	Não	Sim	Assíncrono	3.011
  Invoice	GFEA065	Documentos de Frete	Sim	Não	Assíncrono	3.011
  ListOfAccountPayableDocument	GFEA070	Fatura de Frete	Sim	Não	Assincrono	2.002

  
  

  
  

6.2.2 Relacionamento De/Para de Empresa/Filial:

Para realizar a configuração do De/Para de Empresa/Filial, é necessário acessar Configurador (SIGACFG) > Ambiente > Schedule > Empresa Filial Mensagem Única.

Os campos necessários para o cadastro são:

Referência: Informe uma referência para o cadastro.

Empresa: Informe o código da empresa do Logix.

Filial: Informe o código da filial do Logix.

Grupo de Empresa Protheus: Informe o grupo de empresa do Protheus.

Filial Protheus: Informe a filial do Protheus.

Image Added

6.2.3 Configuração do Schedule do Adapter EAI:

Para configurar o Schedule do Adapter EAI, acesse Configurador (SIGACFG) > Ambiente > Schedule > Schedule e inicie o serviço Task Manager e o Qeue Manager.
Image Added

Em Agent, inclua um cadastro para o ambiente Protheus.
Image Added

Em Agendamentos, inclua um cadastro da rotina FWEAI para realizar o processamentos das integrações Assíncronas.

Image Added

Em EAI, é possível consultar as mensagens enviadas e recebidas pelo EAI.
Image Added

6.2.4 Configuração do REST:

Para realizar a configuração do REST no Protheus, é necessário adicionar a configuração no arquivo Appserver.ini, conforme o documento: http://tdn.totvs.com.br/pages/viewpage.action?pageId=185748193.

Após realizar a configuração, o serviço será inicializado e apresentado no console:

Image Added

6.2.5 Configuração do De/Para do Tipo de Documento de Carga:

Os tipos de documentos do ERP Logix são classificados de acordo com o campo NAT_OPERACAO.ies_tip_controle, sendo este, enviado por meio da tag TypeOfDocument da mensagem única Invoice.
O campo correspondente ao tipo da nota fiscal é o GW1_CDTPDC, portanto, para que o módulo SIGAGFE consiga identificar e diferenciar o tipo de documento enviado pelo ERP Logix, é necessário cadastrar o De/Para na tabela genérica MQ.
Para realizar o cadastro, acesse Configurador (SIGACFG) > Base de Dados > Dicionário > Base de Dados.  

Pesquise pela tabela genérica MQ:

Image Added

Em itens, realize a inclusão de um tipo de documento de carga, correspondente ao enviado na mensagem única:

Image Added

6.2.6 Configurações de Negócio

Outras configurações de negócio são realizadas nos Parâmetros do Módulo do Frete Embarcador. Por exemplo, ERP Integrado = "Logix".  

Image Added

6.2.7 Ajuste do tamanho dos campos de Código do Emitente (Protheus) X Código Cliente/Fornecedor (Logix)

O produto Logix  envia as informações de Clientes e Fornecedores para o SIGAGFE. Por padrão, o campo GU3_CDEMIT tem 14 caracteres sendo que no Logix o campo código tem 15 caracteres.

Desta forma é necessário alterar o tamanho do campo GU3_CDEMIT e TODOS outros campos relacionados para 15 caracteres. Estes campos estão vinculados a um grupo de campos chamado "Código do Emitente"

No módulo SIGAGFE (Protheus) acesse Base de dados > Dicionário > Bases de Dados na tela aberta, acesse Grupo de Campos e procure o grupo "Código do Emitente". Altere o registro e em tamanho informe o valor 15. Salve o registro de depois clique no botão "Atualizar Base de Dados" (Disquete) para alterar o tamanho no banco de dados.

Image Added

Image Added

Image Added

6.2.8 Ajuste do tamanho dos campos de Unidade de Negócio (Protheus) X Área e Linha (Logix)

O produto Logix trabalha com Área e Linha e ao realizar a integração das Notas Fiscais do Logix com o SIGAGFE, esta informação será gravada no campo GW8_UNINEG da tabela dos itens.

Por padrão, o campo GW8_UNINEG tem 3 caracteres sendo que no Logix o campo área a linha tem 8 caracteres.

Desta forma é necessário alterar o tamanho do campo GW8_UNINEG e outros campos relacionados para 8 caracteres. Estes campos estão vinculados a um grupo de campos chamado "Unidade de Negócio"

No módulo SIGAGFE (Protheus) acesse Base de dados > Dicionário > Bases de Dados na tela aberta, acesse Grupo de Campos e procure o grupo "Unidade de Negócio". Altere o registro e em tamanho informe o valor 8. Salve o registro de depois clique no botão "Atualizar Base de Dados" (Disquete) para alterar o tamanho no banco de dados.

Image Added

Image Added

Image Added

7. Conceitos da Integração

7.1 Contabilização

Image Added

8. Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Logix 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.

9. Transações/Entidades/Mensagens Únicas

9.1 Cadastros

A seguir, temos as rotinas responsáveis pelos cadastros das informações da integração:

Ao executar o programa FIN00000 (Programas conversores), o usuário poderá fazer a carga inicial dos cadastros:

• Fornecedor/Transportador;
• Cliente;
• Cidades;
• Plano de contas.

Fornecedor/Transportador - CustomerVendor

Identificador da Mensagem: CustomerVendor

Versão: 2

Tipo de Envio: Síncrona

Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de Cliente/Fornecedor no programa VDP10000, irá gerar mensagem única, enviada para o GFE.

Limitações/Restrições

• Para esta integração, não indica-se trabalhar com Transportador cadastrado no VDP10000 como tipo 2 - Apenas transportadora. Alterar o tipo para 5 - Fornecedor/Transportador. A configuração do tipo 2- Apenas transportadora não será integrada com o GFE e a configuração do tipo 5- Fornecedor/Transportador irá gerar um cadastro de Fornecedor e Transportador no GFE.
  
• Para esta integração, é necessário trabalhar com TSS 2.000. Somente nesta versão foi possível a implementação para realizar o desvio e desconsiderar os Conhecimentos de Venda para que sejam tratados pelo GFE.
• VDP10000 – Fornecedor – Informações Bancárias: Parâmetro “Gera ordem de pagamento?” deve estar marcado como “NF’s e conhecimento” para as transportadoras.

Cliente - CustomerVendor

Identificador da Mensagem: CustomerVendor

Versão: 2

Tipo de Envio: Síncrona

Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de Cliente/Fornecedor no programa VDP10000, irá gerar mensagem única, enviada para o GFE.

Limitações / Restrições Gerais

• Para que uma Transportadora no Logix seja considerada uma Transportadora para o Protheus, é necessário que no VDP10000 (Cadastro de Cliente e Fornecedor) a transportadora esteja cadastrada como tipo "Ambos", e que o tipo do fornecedor, na aba "3 - Fornecedor", esteja como "Fornecedor/Transportadora"
• Caso ocorra algum erro durante a integração do Cliente/Fornecedor no programa VDP10000 (Cadastro de Cliente e Fornecedor), os campos em tela ficarão desativados e a operação deverá ser cancelada. Esse problema já foi corrigido, e a correção será expedida na Versão 12.1.21 do Logix
• VDP10000 – Fornecedor – Informações Bancárias: Parâmetro “Gera ordem de pagamento?” deve estar marcado como “NF’s e conhecimento” para as transportadoras.

Cidade - City

Identificador da Mensagem: City

Versão: 1

Tipo de Envio: Síncrona

Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de UF e Cidades (VDP10022), irá gerar mensagem única, enviada para o GFE.

Plano de Contas - AccountantAccount

Identificador da Mensagem: AccountantAccount

Versão: 2.002

Tipo de Envio: Síncrona

Gatilho: Ao executar inclusão, modificação e exclusão do cadastro de Plano de Contas (CON0010), irá gerar mensagem única, enviada para o GFE.

9.2 Processos 

A seguir temos os processos que transitam entre os produtos na integração:

Conhecimento de Frete de Venda - Invoice

Identificador da Mensagem: Invoice

Versão: 3

Tipo de Envio: Assíncrona

No GFE, a mensagem de Invoice é gerada e enviada para o Logix quando se realiza o processo de "Atualizar Fiscal" do Documento de Frete. O documento de frete fica com situação "Pendente" até que o Logix retorne a mensagem de resposta, indicando o status do processamento, que pode ser: "Rejeitada" ou "Atualizada".

No Logix, ao receber a Invoice com tag indicando que trata-se de um conhecimento de venda (TypeofDocument = "COV"), é acionado Adapter EaiAdapterInvoice3. Este irá incluir ou excluir (de acordo com o tipo de processamento enviado), por meio de métodos padrões do ERP, o conhecimento de frete de venda no Logix.

Para conferir se a integração ocorreu com sucesso, pode-se utilizar a consulta do Status e Passo-a-passo no Monitor de integração do EAI: EAI100000. 

Para validar o documento no ERP utilizar o programa Sup0580.

• Consistência
  Após a inclusão do conhecimento, é automaticamente processada a consistência do documento.
  Os valores da integração são carregados no declarado, para manter o histórico e acusar erro de diferença entre declarado e calculado, caso algum parâmetro do Logix precise ser revisto.
  Pode ocorrer inconsistência no frete entre declarado e calculado, devido aos cadastros que precisam ser arrumados no ERP. Se não forem revistos não há problema, visto que o valor declarado prevalece sobre o calculado. O único inconveniente é que a cada próxima nota que entrar, continuará acusando diferença entre declarado e calculado.
  Se o parâmetro do Log00087 Assume automaticamente erros dos conhecimentos recebidos via integração Gfe? estiver igual a S, então após realizar a consistência, já assume os erros do frete automaticamente. Irá cadastrar, automaticamente, o usuário que está integrando (usuário integrador) no Sup34698-Usuários responsáveis por assumir erros de frete.
  Conforme padrão do Recebimento, caso esteja parametrizado para contabilização online, já irá gerar os lançamentos contábeis automaticamente na integração, assim como a integração com o fiscal. 
  Não integra com o Financeiro, visto que a condição de pagamento é sem pagamento. E o Financeiro é tratado diretamente do GFE, que envia os dados ao Módulo financeiro do Logix via integração.
  Também integra automaticamente com o GAO-Gestão de Aprovação de Orçamento, caso a empresa trabalhe com este conceito.
  
  

Limitações / Restrições Gerais

• Percentual de ICMS - Busca alíquota do Logix da tabela de ICMS por grupo de despesa e estado de acordo com a cidade destino enviada (ou cidade do transportador caso não envie a cidade destino).
• Somente grava a dest_frete_sup4, quando trabalha com 4 níveis de AEN, caso contrário, grava apenas a dest_frete_sup.
• Cidade é opcional - se informada busca a alíquota de ICMS dessa cidade no cálculo do ICMS no frete, ao invés do padrão, que é buscar de acordo com a UF do transportador.
• PaymentConditionCode é opcional - Se informado parâmetro no Log00087 - Condição de pagamento sem pagamento para recebimento de CTE, irá assumir esta condição de pagamento para o frete.
  

Nota Fiscal de Saída - Invoice

Identificador da Mensagem: Invoice

Versão: 3

Tipo de Envio: Assíncrona

Gatilho: Sempre que realizado o envio de uma nota fiscal de saída para a SEFAZ, após a geração da chave de acesso, será feito o envio da nota fiscal via mensagem única (EAI2) para o GFE.

Quando a nota fiscal possuir tipo de frete diferente de 3 (FOB), será adicionado o contexto "gfe" na mensagem. Dessa forma, é possível parametrizar no EAI10000 (EAI) apenas o envio de notas fiscais com frete para o GFE, utilizando-se do conceito de "rotas".

Limitações / Restrições Gerais

• As notas fiscais integradas com o GFE não deverão possuir subsérie informada, pois corre-se o risco de gerar duplicidade de numeração durante a integração.
• É obrigatório a utilização do painel da NFE (Parâmetro Utilizar painel da NF-e e NFS-e? ativado).

Simulação de Frete de Venda - FREIGHTSIMULATION

Identificador da Mensagem: FREIGHTSIMULATION

Versão: 1

Tipo de Envio: API REST

Gatilho: Por meio do botão Simular frete GFE, localizado na aba 3 - Frete, do programa VDP20000 (Manutenção de Pedidos), ou do botão Simular GFE, localizado na tela de transportes dos programas VDP0742 (Faturamento Automático) e VDP0746 (Faturamento Manual), é possível realizar a simulação de frete para o pedido/nota fiscal em questão, obtendo informações de transportadoras, valor de frete e imposto, prazo de entrega, rotas, etc, diretamente do GFE. É possível realizar filtros por "Transportador", "Tipo de veículo", "Classificação de frete" e "Tipo de operação".

A Simulação do Faturamento no programa VDP20000 realiza automaticamente a Simulação de Frete para buscar o valor de frete da nota. Caso for encontrada mais e uma rota/transportadora, será escolhida automaticamente a rota com o menor valor de frete. Atenção: Apenas será realizada a busca do valor de frete no GFE caso o pedido possui tipo de frete CIF Pago ou CIF Cobrado.

Abaixo exemplo da tela de simulação no VDP20000:

Image Added

Exemplo da tela de simulação utilizada no VDP0742 e VDP0746:

Image Added

Os registros serão apresentados em ordem crescente de valor de frete, sendo que o primeiro registro (menor valor) sempre será selecionado automaticamente.

Apropriação de Despesa - ListOfAccountPayableDocument

Identificador da Mensagem: ListOfAccountPayableDocument

Versão: 1

Tipo de Envio: Assíncrona

No GFE, a mensagem de ListOfAccountPayableDocument é gerada e enviada para o Logix no momento que se realiza o processo de "Atualizar Financeiro" da Fatura de Frete. A fatura fica com situação "Pendente" até que o Logix retorne a mensagem de resposta, indicando o status do processamento, que pode ser: "Rejeitada" ou "Atualizada".

No Logix, ao receber a Fatura de frete, é acionado Adapter EAIAdapterListOfAccountPayableDocument1. Este irá incluir ou excluir (de acordo com o tipo de processamento enviado), por meio de métodos padrões do ERP, a Apropriação de Despesa no Logix.

Para conferir se a integração ocorreu com sucesso, pode-se utilizar a consulta do Status e Passo-a-passo no Monitor de integração do EAI: EAI100000. 

Para validar o documento no ERP utilizar o programa FIN30058.

Limitações / Restrições Gerais

• O Logix está preparado para receber somente a informação de "ISS". 
  Para fazer uso da retenção do ISS originando o título do Protheus GFE, é necessário trabalhar com o ISS aberto por município.
  Parâmetro no CAP2360 / 6. Param. Tributos / INFORMACOES REFERENTE A PAGAMENTO DE IMPOSTOS. / Gerar Ads Pgto ISS por prefeitura igual a "T" 
  
  FIN30030 - Deve existir um tipo de valor de retenção de ISS, que no botão "ISS Prefeitura" tenha o relacionamento do município com o tipo de despesa da integração GFE, pois vai ser deste relacionamento que o tipo de valor será encontrado para fazer a retenção do ISS na inclusão da AD originada do sistema Protheus GFE.

• VDP10000 – Fornecedor – Informações Bancárias: Parâmetro “Gera ordem de pagamento?” deve estar marcado como “NF’s e conhecimento” para as transportadoras.

• Retenção de INSS: é sempre destacada na AD a retenção do INSS, salvo nos casos em que o tipo de despesa (FIN30056) estiver com o parâmetro “Reter INSS de tributos de importação/Trade Easy?” desmarcado na pasta de informações tributárias.

• Número da NF (FIN30058): Número sequencial conforme parâmetro “ult_num_nf_exportacao” do LOG00087.

Limitações / Restrições Gerais

• InvoiceSubSerie -

Como fazer (opcional)

Os passos para viabilizar a integração são:

Situações comuns (opcional)

• Quando uma mensagem é enviada do Logix para o Protheus, podem ocorrer situações em que o WebService não estará totalmente funcional. Nestes casos uma mensagem de erro genérica irá aparecer na tela:

Exemplo:

Erro ao enviar a mensagem de Cidade via Integração

Se o arquivo de log for analisado, poderemos ver a falha na comunicação com o sistema destino:

-------------------------------------------------------------------------------

WSCERR044 / Não foi possível POST : URL http://172.16.31.57:8011/ws/FWWSEAI.apw

ADVPL WSDL Client 1.080707 / tst on 20120315 08:49:51

-------------------------------------------------------------------------------

Para resolver este problema, verifique as configurações do sistema de destino, analisando o funcionamento do servidor utilizado para esta comunicação e a habilitação do endereço do WebService. 

Checklist de suporte da aplicação