Integração Protheus x GFE

Contexto de negócio (Introdução)

A integração de dados entre rotinas do ERP Microsiga Protheus e o módulo SIGAGFE utilizando comunicação direta entre as rotinas, sem aplicativos intermediários e sem tráfego de dados no formato XML. O ponto de integração para Simulação de Fretes no Pedido de Venda já utiliza comunicação direta, por isso não necessitará intervenção. Serão mantidas as regras de negócio atuais da integração, alterando-se apenas o modelo de troca de dados.

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

Sistemas Envolvidos

ERP Microsiga Protheus;
Módulo de Gestão de Frete Embarcado.

Integração

Modelo com EAI e TOTVS ESB

Integrações > DI Integração Protheus x GFE > Protheus_GFE_Integ_1.png

Modelo alterado

Integrações > DI Integração Protheus x GFE > Protheus_GFE_Integ_2.png

Lista dos pontos de integração de dados do ERP para o SIGAGFE

Rotina ERP (MS Protheus)	Eventos	Model SIGAGFE
FISA010 – Cadastro de Municípios	Incluir, Alterar, Eliminar	GFEA020 – Cidades
MATA030 – Cadastro de Clientes	Incluir, Alterar, Eliminar	GFEA015 – Emitentes de Transporte
MATA050 – Cadastro de Transportadores	Incluir, Alterar, Eliminar	GFEA015 – Emitentes de Transporte
MATA020 – Cadastro de Fornecedores	Incluir, Alterar, Eliminar	GFEA015 – Emitentes de Transporte
CTBA180 – Cadastro de Centros de Custo	Incluir, Alterar, Eliminar	GFEA089 – Centros de Custo
CTBA020 – Cadastro de Contas Contábeis	Incluir, Alterar, Eliminar	GFEA090 – Contas Contábeis
TMSA530 – Cadastro de Tipos de Veículo	Incluir, Alterar, Eliminar	GFEA090 – Contas Contábeis
OMSA060 – Cadastro de Veículos	Incluir, Alterar, Eliminar	GFEA046 – Veículos
OMSA040 – Cadastro de Motoristas	Incluir, Alterar, Eliminar	GFEA012 – Motoristas
OMSA200 – Montagem de Cargas	Incluir, Alterar, Eliminar	GFEA050 – Romaneios
MATA460 – Notas Fiscais de Saída	Incluir	GFEA044 – Documentos de Carga
MATA521 – Cancelamento de Notas Fiscais	Eliminar	GFEA044 – Documentos de Carga
MATA103 – Documentos de Entrada	Incluir, Eliminar	GFEA044 – Documentos de Carga

Em cada um dos programas haverá uma função para integração, a ser executada por cada evento listado, com a finalidade de montar a lista de informações a serem enviadas (vide de-para de campos na sequência desta especificação) para o objeto de negócio (model) indicado. Serão utilizadas as operações padrões de manutenção de registros da técnica MVC com o respectivo tratamento do retorno de mensagens de erro. A execução da função será condicionada aos parâmetros MV_INTGFE e MV_INTGFE2.

Model SIGAGFE	Evento(s)	MSExecAuto
GFEA055 – Pré-fatura	Envio para ERP	FINA050 – Título a Pagar (Provisão)
GFEA065 – Documento de Frete	Envio para ERP	MATA103 – Documento de Entrada
GFEA065 – Documento de Frete	Envio para ERP	MATA140 – Pré-nota
GFEA065 – Documento de Frete	Envio para ERP	MATA116 – Nota de Conhecimento de Frete
GFEA065 – Documento de Frete	Envio para ERP	MATA116 - Pré-nota de Conhecimento
GFEA070 – Fatura de Frete	Envio para ERP	FINA050 – Título a Pagar
GFEA100 – Contrato com Autônomo	Envio para ERP	FINA050 – Título a Pagar
GFEA100 – Contrato com Autônomo	Envio para ERP	MATA116 – Nota de Conhecimento de Frete

Em cada um dos programas será implementada a execução (MSEXECAUTO) do objeto de negócio correspondente do ERP, enviando a lista de informações (vide de-para de campos na sequência desta especificação) necessárias à inclusão ou eliminação de registros com o respectivo tratamento do retorno de mensagens de erro. As mensagens de erro ficarão registradas em campo descritivo dos próprios registros do SIGAGFE e para cada integração há um campo de controle indicando o estado: Não-integrado, Pendente, Rejeitado, Atualizado e Pendente de Cancelamento. Com a alteração do modelo de integração os estados “Pendente” e “Pendente Cancelamento” tornam-se obsoletos pois o resultado da integração será conhecido logo após o evento de “Envio para ERP”.

Entidades do ERP utilizadas diretamente pelo SIGAGFE (não precisam de integração)

Rotina/Entidade
01 (SX5) – Séries de Notas Fiscais
EICA100 – Países
12 (SX5) – Unidades de Federação
QIEA030 – Unidades de Medida (SAH)

Regras Gerais

1. Integração em Geral

a. Todas as integrações estão condicionadas ao parâmetro MV_INTGFE; o conteúdo “.T.” indica que a integração está ativa;
b. A integração direta, sem o uso de EAI e TOTVSESB está condicionada ao parâmetro MV_INTGFE2; os conteúdos “1” ou “S” indicam que a integração entre os módulos do ERP base e o SIGAGFE é direta;

2. Registros de Cadastros

a. No SIGAGFE há dois parâmetros que indicam a origem dos cadastros (ERP ou SIGAGFE): MV_CADERP (Municípios, Emitentes, Contas Contábeis e Centros de Custo) e MV_CADOMS (Tipos de Veículo, Veículos e Motoristas); o controle é separado porque algumas empresas não utilizam o SIGAOMS;
b. Os cadastros integrados entre ERP e SIGAGFE permitem inclusão apenas pelo ERP;
c. O SIGAGFE não permite eliminar os registros de cadastros recebidos do ERP; esse comportamento é condicionado ao parâmetro MV_CADERP = “1=ERP” (ou MV_CADOMS = “1=OMS”);
d. O SIGAGFE restringe a alteração dos registros de cadastros recebidos do ERP apenas aos campos próprios do SIGAGFE (que complementam os dados recebidos do ERP e são utilizados apenas pelo SIGAGFE); esse comportamento é condicionado ao parâmetro MV_CADERP = “1=ERP” (ou MV_CADOMS = “1=OMS”);
e. A eliminação de registros de cadastros no ERP altera a situação do registro no SIGAGFE para “Inativo”, sem eliminá-lo. Dessa forma não há impedimento para eliminação no ERP mesmo que o registro possua relacionamentos ativos com outras entidades do SIGAGFE. Ao incluir novamente um registro anteriormente eliminado (com a mesma identificação única), a integração retorna o registro no SIGAGFE para a situação “Ativo”. A situação “Inativo” impede que o registro seja relacionado a novos processos no SIGAGFE (um motorista “Inativo” não pode ser informado em uma nova montagem de Romaneio, por exemplo);
f. Apenas o evento de eliminação altera a situação (Ativo/Inativo) dos registros dos cadastros integrados; esse comportamento é condicionado ao parâmetro MV_CADERP = “1=ERP” (ou MV_CADOMS = “1=OMS”);
g. As operações de inclusão e alteração, dos cadastros integrados, não são completadas se houver erro de validação na integração com GFE; o usuário recebe uma mensagem informando quais são as inconsistências e assim avaliar como proceder corretamente com a operação.

3. Registros de Processos enviados pelo ERP

a. O parâmetro MV_FATGFE permite configurar se a conclusão da emissão de Notas Fiscais depende do êxito da integração com o SIGAGFE; a rotina de integração das Notas Fiscais com Erro de Integração permite realizar a integração posteriormente, amparando a existência desta opção;
b. A eliminação da Nota Fiscal só é concluída com sucesso se não houver erro de validação na integração com o SIGAGFE; podem ser requeridos ao usuário procedimentos no SIGAGFE para que não hajam restrições no SIGAGFE (a fim de impedir que sejam canceladas Notas Fiscais que já foram expedida, por exemplo) e a eliminação ocorra com êxito.

4. Registros de Processos enviados pelo SIGAGFE

a. Os dados gerados pelo GFE no ERP não pemitem eliminação pelo ERP, somente alteração. A eliminação deve ser solicitada pelo SIGAGFE (que executa a integração para eliminar o registro no ERP e retorna o registro da entidade de origem no SIGAGFE para a situação “Não-integrado”);
b. O SIGAGFE não envia alteração de dados, apenas inclusão e eliminação; no caso de necessidade de quaisquer alterações deve-se acionar a ação “Desatualizar ERP” no SIGAGFE sobre o respectivo registro que dessa forma pode ser alterado e posteriormente enviado novamente para o ERP.

5. Regras Particulares e Correspondência entre os Dados

Os campos que compõem a identificação única do registro estão destacados com asterisco. Os campos não indicados na tabela de correspondência devem assumir (na operação de inclusão) o valor inicial indicado no dicionário de dados (ação executada automaticamente pelo model). Nas alterações de registros os dados que não são atribuídos pela integração devem ser preservados. A correspondência entre os campo se baseia no mapeamento já existente da integração via XML, conforme a tabela abaixo:

Integração	Arquivo de Mapeameto
FISA010 (Municípios) para GFEA020 (Cidades)	ProtheustoGFE_Munici_Cidade.xsl
MATA030 (Clientes) para GFEA015 (Emitentes)	ProtheustoGFE_Client_Emitente.xsl
MATA050 (Transportadores) para GFEA015 (Emitentes)	ProtheustoGFE_Transp_Emitente.xsl
MATA020 (Fornecedores) para GFEA015 (Emitentes)	ProtheustoGFE_Fornec_Emitente.xsl
CTBA180 (Centros Custo) para GFEA089 (Centros Custo)	ProtheustoGFE_Centro_Custo.xsl
CTBA020 (Plano Contas) para GFEA090 (Contas Contábeis)	ProtheustoGFE_Plano_Contas.xsl
TMSA530 (Tipos Veículo) para GFEA045 (Tipos Veículo)	ProtheustoGFE_TipoVeiculo.xsl
OMSA060 (Veículos) para GFEA046 (Veículos)	ProtheustoGFE_Veiculo.xsl
OMSA040 (Motoristas) para GFEA012 (Motoristas)	ProtheustoGFE_Motorista.xsl
OMSA200 (Cargas) para GFEA050 (Romaneios)	ProtheustoGFE_Carga_Romaneio.xsl
MATA460 (NF Saída) para GFEA044 (Doc Carga)	ProtheustoGFE_NfSaida_DoctoCarga.xsl ProtheustoGFE_CancelNfSaida_DoctoCarga.xsl
MATA103 (Doc Entrada) para GFEA044 (Doc Carga)	ProtheustoGFE_NfEntrada_DoctoCarga.xsl
GFEA055 (Pré-fatura) para FINA050 (Título a Pagar)	GFEtoProtheus_Financeiro-PreFat.xsl ProtheusToGfe_Ret_Fatura.xsl
GFEA065 (Doc Frete) para MATA103 (Doc Entrada)	GFEtoProtheus_DoctoEntrada.xsl ProtheusToGFE_Ret_DoctoEntrada.xsl (retorno)
GFEA065 (Doc Frete) para MATA116 (Nota Conhecimento)	GFEtoProtheus_NFRateio-CTRC.xsl ProtheusToGFE_Ret_DoctoFrete.xsl (retorno)
GFEA070 (Fatura) para FINA050 (Título a Pagar)	GFEtoProtheus_Financeiro-Fatura.xsl ProtheusToGfe_Ret_Fatura.xsl
GFEA100 (Contrato) para FINA050 (Título a Pagar)	GFEtoProtheus_Financeiro-Contrato.xsl ProtheusToGfe_Ret_Fatura.xsl
GFEA100 (Contrato) para MATA116 (Nota Conhecimento)	GFEtoProtheus_NFRateio-Contrato.xsl

Nas integrações realizadas no sentido GFE para o ERP há duas operações “Atualizar” e “Desatualizar”, correspondendo à Inclusão e Eliminação. Para cada integração há um campo de controle na tabela de origem com a seguinte lista de opções: “1=Nao Enviado;2=Pendente;3=Rejeitado;4=Atualizado;5=Pendente Desatualizacao;6=Nao se Aplica”. Nas rotinas em que há a alteração da situação de “1=Não Enviado” para “2=Pendente”, o sistema deve executar a integração via MSExecAuto, com a operação Inclusão, quando o parâmetro MV_INTGFE2 = “1=Sim”; nas rotinas em que há a alteração da situação de “4=Atualizado” para “5=Pendente Desatualizacao”, o sistema deve executar a integração via MSExecAuto, com a operação Eliminação, quando o parâmetro MV_INTGFE2 = “1=Sim”. Abaixo a lista de programas com os quais é possível acionar as integrações:

Integração	Rotina	Opção	Operação
Pré-fatura –> Financeiro	GFEA055	Ação relacionada “Atualizar Financeiro ERP”	Atualizar
	GFEA055	Ação relacionada “Desatualiz Financeiro ERP”	Desatualizar
	GFEA055	Ação relacionada “Gerar” quando o Transportador está configurado para confirmar pré-faturas automaticamente (GU3_CAUTPF = “1”) e o modo de integração for automático (MV_GFEI15 = “2”)	Atualizar
	GFEA057	Ação relacionada “Confirmar” quando o modo de integração for automático (MV_GFEI15 = “2”)	Atualizar
	GFEA099	Execução com o parâmetro “Ação” na opção “Atualizar” ou “Atu Rejeitado”	Atualizar
	GFEA099	Execução com o parâmetro “Ação” na opção “Desatualizar”	Desatualizar
	GFEX100	Ação relacionada “Enviar Financeiro”	Atualizar
Doc Frete –> Fiscal	GFEA065	Ação relacionada “Atualizar Fiscal ERP”	Atualizar
	GFEA065	Ação relacionada “Atualizar Pré nota”	Atualizar
	GFEA065	Ação relacionada “Desatualiz Fiscal ERP”	Desatualizar
	GFEA065	Confirmação da ação “Incluir” quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“) e o modo de integração for automático (MV_GFEI13 = “2”)	Atualizar
	GFEA066	Confirmação da ação “Aprovar” quando o modo de integração for automático (MV_GFEI13 = “2”)	Atualizar
	GFEA067	Execução com os parâmetros “Tipo de Integração” na opção “Fiscal” e “Ação” na opção “Atualizar” ou “Atu Rejeitado”	Atualizar
	GFEA067	Execução com os parâmetros “Tipo de Integração” na opção “Fiscal” e “Ação” na opção “Desatualizar”	Desatualizar
	GFEA070	Ação relacionada “Atualizar Doc Frete Fiscal ERP”	Atualizar
	GFEA115	Ação “Processar” após importação do Documento de Frete do arquivo CONEMB quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“) e o modo de integração for automático (MV_GFEI13 = “2”)	Atualizar
	GFEA118	Ação “Processar” após importação do Documento de Frete do arquivo CT-e quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“) e o modo de integração for automático (MV_GFEI13 = “2”)	Atualizar
	GFEX100	Ação relacionada “Enviar Fiscal”	Atualizar
Fatura –> Financeiro	GFEA065	Confirmação da ação “Incluir” quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“), o Transportador estiver configurado para gerar Fatura Automaticamente (GU3_FATAUT = “1”), o resultado da conferência “Aprovada Sistema” (GW6_SITAPR = 3“) e o modo de integração for automático (MV_GFEI16 = “2”)	Atualizar
	GFEA070	Ação relacionada “Atualizar Fiscal ERP”	Atualizar
	GFEA070	Ação relacionada “Desatualiz Fiscal ERP”	Desatualizar
	GFEA070	Ação relacionada “Conferir” com o resultado da conferência “Aprovada Sistema” (GW6_SIT = 3“) e o modo de integração for automático (MV_GFEI16 = “2”)	Atualizar
	GFEA071	Confirmação da ação “Aprovar” quando o modo de integração for automático (MV_GFEI16 = “2”)	Atualizar
	GFEA097	Execução com o parâmetro “Ação” na opção “Atualizar” ou “Atu Rejeitado”	Atualizar
	GFEA097	Execução com o parâmetro “Ação” na opção “Desatualizar”	Desatualizar
	GFEA115	Ação “Processar” após importação do Documento de Frete do arquivo CONEMB, quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“), o Transportador estiver configurado para gerar Fatura Automaticamente (GU3_FATAUT = “1”), o resultado da conferência “Aprovada Sistema” (GW6_SITAPR = 3“) e o modo de integração for automático (MV_GFEI16 = “2”)	Atualizar
	GFEA116	Ação “Processar” após importação da Fatura de Frete do arquivo DOCCOB, quando o resultado da conferência for “Aprovada Sistema” (GW6_SITAPR = 3“) e o modo de integração for automático (MV_GFEI16 = “2”)	Atualizar
	GFEA118
	GFEX100	Ação relacionada “Enviar Financeiro”	Atualizar
Doc Frete –> Recebimento/Compras	GFEA065	Ação relacionada “Atualizar Aprop Desp ERP”	Atualizar
	GFEA065	Ação relacionada “Atualizar Pré CT”	Atualizar
	GFEA065	Ação relacionada “Desatualiz Aprop Desp ERP”	Desatualizar
	GFEA065	Confirmação da ação “Incluir” quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“) e o modo de integração for automático (MV_GFEI14 = “2”)	Atualizar
	GFEA066	Confirmação da ação “Aprovar” quando o modo de integração for automático (MV_GFEI14 = “2”)	Atualizar
	GFEA067	Execução com os parâmetros “Tipo de Integração” na opção “Aprop Despesas” e “Ação” na opção “Atualizar” ou “Atu. Rejeitados”	Atualizar
	GFEA067	Execução com os parâmetros “Tipo de Integração” na opção “Aprop Despesas” e “Ação” na opção “Desatualizar”	Desatualizar
	GFEA115	Ação “Processar” após importação do Documento de Frete do arquivo CONEMB quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“) e o modo de integração for automático (MV_GFEI14 = “2”)	Atualizar
	GFEA118	Ação “Processar” após importação do Documento de Frete do arquivo CT-e quando o resultado da conferência for “Aprovado Sistema” (GW3_SIT = 3“) e o modo de integração for automático (MV_GFEI14 = “2”)	Atualizar
	GFEX100	Ação relacionada “Enviar Materiais”	Atualizar
Contrato -> Financeiro	GFEA098	Execução com os parâmetros “Tipo de Integração” na opção “Financeiro” e “Ação” na opção “Atualizar” ou “Atu Rejeitado”	Atualizar
	GFEA098	Execução com os parâmetros “Tipo de Integração” na opção “Financeiro” e “Ação” na opção “Desatualizar”	Desatualizar
	GFEA100	Ação relacionada “Enviar ERP Financeiro”	Atualizar
	GFEA102	Confirmação da ação “Imprimir” quando o modo de integração for automático (MV_GFEI17 = “2”)	Atualizar
	GFEX100	Ação relacionada “Enviar Financeiro”	Atualizar
Contrato -> Recebimento/Compras	GFEA098	Execução com os parâmetros “Tipo de Integração” na opção “Aprop Despesas” e “Ação” na opção “Atualizar” ou “Atu Rejeitado”	Atualizar
	GFEA098	Execução com os parâmetros “Tipo de Integração” na opção “Aprop Despesas” e “Ação” na opção “Desatualizar”	Desatualizar
	GFEA100	Ação relacionada “Apropriação Despesa”	Atualizar
	GFEA102	Confirmação da ação “Imprimir” quando o modo de integração for automático (MV_GFEI17 = “2”)	Atualizar
	GFEX100	Ação relacionada “Enviar Materiais”	Atualizar

6. Cadastro de Municípios (FISA010 – tabela CC2)

Campo	Recebe	Observações
GU7_NRCID*	Código IBGE do CC2_EST + CC2_CODMUN	Utilizar a tabela de códigos IBGE x UF (abaixo)
GU7_NMCID	CC2_MUN
GU7_UF	CC2_EST
GU7_PAIS	105

7. Tabela para obtenção do Código IBGE das Unidades de Federação (função TMS120CdUf)

UF	AC	AL	AM	AP	BA	CE	DF	ES	GO	MA	MG	MT	MS	PA
IBGE	12	27	13	16	29	23	53	32	52	21	31	50	51	15

UF	PB	PE	PI	PR	RJ	RN	RO	RR	RS	SC	SE	SP	TO	EX
IBGE	25	26	22	41	33	24	11	14	43	42	28	35	17	99

Todas as cidades serão criadas pela integração com o país 105 (Brasil), as cidades de outros países devem ser alteradas manualmente pelo usuário, procedimento que é necessário apenas se houver Tabelas de Frete com rotas com tipo de origem e/ou tipo de destino “País/UF”, do contrário, pode-se manter o país Brasil em todas as cidades cadastras no SIGAGFE sem causar impacto no funcionamento do sistema.

8. Cadastro de Clientes (MATA030 – tabela SA1)

Campo	Recebe	Observações
GU3_CDEMIT*	A1_CGC	Utilizar A1_COD + A1_LOJA quando o campo A1_CGC não possuir conteúdo
GU3_NMEMIT	A1_NOME
GU3_NMFAN	A1_NREDUZ
GU3_NATUR	A1_PESSOA
GU3_DTNASC	A1_DTNASC
GU3_ORIGEM	“2=ERP”
GU3_SIT	“1=ATIVO”	Na operação de eliminação atribuir “2=INATIVO” se GU3_FORN == “2=NÃO” e GU3_EMFIL == “2=NÃO” e GU3_TRANSP == “2=NÃO” e GU3_AUTON = “2=NÃO”
GU3_EMFIL	A1_CLIFIL
GU3_CLIEN	“1=SIM”
GU3_ENDER	A1_END
GU3_COMPL	A1_COMPLEM
GU3_BAIRRO	A1_BAIRRO
GU3_CEP	A1_CEP
GU3_NRCID	Código IBGE do A1_EST + A1_CDIBGE	Utilizar a tabela de códigos IBGE x UF (executar a função TMS120CdUf)
GU3_NMCID	A1_MUN
GU3_UF	A1_EST
GU3_IDFED	A1_CGC	Não atribuir quando A1_TIPO = “X”
GU3_IE	A1_INSCR
GU3_IM	A1_INSCRM
GU3_CXPOS	A1_CXPOSTA
GU3_EMAIL	A1_EMAIL
GU3_FONE1	A1_TEL
GU3_FAX	A1_FAX
GU3_WSITE	A1_HPAGE

Quando a integração com o GFE estiver ativa o sistema deve impedir que o CNPJ/CPF e o Tipo (Jurídico, Físico,Estrangeiro) do Cliente seja alterado (exceto se estiver em branco), evitando que haja inconsistência na identificação única do Transportador no GFE; também deve impedir que se altere o tipo do cliente quando “X=Estrangeiro”.
Não haverá tratamento para o campo A1_MSBLQL, seu uso ficará restrito ao ERP.

9. Cadastro de Fornecedores (MATA020 – tabela SA2)

Campo	Recebe	Observações
GU3_CDEMIT*	A2_CGC	Utilizar A2_COD + A2_LOJA quando o campo A2_CGC não possuir conteúdo
GU3_NMEMIT	A2_NOME
GU3_NMFAN	A2_NREDUZ
GU3_NATUR	A2_TIPO
GU3_ORIGEM	“2=ERP”
GU3_SIT	“1=ATIVO”	Na operação de eliminação atribuir “2=INATIVO” se GU3_FORN == “2=NÃO” e GU3_EMFIL == “2=NÃO” e GU3_TRANSP == “2=NÃO” e GU3_AUTON = “2=NÃO”
GU3_EMFIL	A2_CLIFIL
GU3_CLIEN	“1=SIM”
GU3_ENDER	A2_END
GU3_COMPL	A2_COMPLEM
GU3_BAIRRO	A2_BAIRRO
GU3_CEP	A2_CEP
GU3_NRCID	Código IBGE do A2_EST + A2_CDIBGE	Utilizar a tabela de códigos IBGE x UF (executar a função TMS120CdUf)
GU3_NMCID	A2_MUN
GU3_UF	A2_EST
GU3_IDFED	A2_CGC	Não atribuir quando A2_TIPO = “X”
GU3_IE	A2_INSCR
GU3_IM	A2_INSCRM
GU3_CXPOS	A2_CXPOSTA
GU3_EMAIL	A2_EMAIL
GU3_FONE1	A2_TEL
GU3_FAX	A2_FAX
GU3_WSITE	A2_HPAGE

Quando a integração com o GFE estiver ativa o sistema deve impedir que o CNPJ/CPF e o Tipo (Jurídico, Físico,Estrangeiro) do Fornecedor seja alterado, evitando que haja inconsistência na identificação única do Transportador no GFE.

Não haverá tratamento para o campo A2_MSBLQL, seu uso ficará restrito ao ERP.

10. Cadastro de Transportadores (MATA050 – tabela SA4)

Campo	Recebe	Observações
GUH_CCUSTO*	CTT_CUSTO
GUH_DESC	CTT_DESC01
GUH_SIT	“1=ATIVO”	Na operação de eliminação da CTT atribuir “2=INATIVO”

11. Cadastro de Contas Contábeis (CTBA020 – tabela CT1)

Campo	Recebe	Observações
GUE_CTACTB *	CT1_CONTA
GUE_TITULO	CT1_DESC01
GUE_SIT	“1=ATIVO”	Na operação de eliminação da CT1 atribuir “2=INATIVO”

12. Cadastro de Motoristas (OMSA040 – tabela DA4)

Campo	Recebe	Observações
GUU_CDMTR*	DA4_COD
GUU_NMMTR	DA4_NOME
GUU_PSEUD	DA4_NREDUZ
GUU_TPMTR	“1=MOTORISTA”	Atribuir apenas quando inclusão
GUU_IDFED	DA4_CGC
GUU_RG	DA4_RG
GUU_ORGEXP	DA4_RGORG
GUU_CDTRP	DA4_CGCFOR
GUU_SIT	“1=ATIVO”	Quando DA4_BLQMOT = “1=Sim” atribuir “3=Ent Proib” Na operação de eliminação da DUT atribuir “2=INATIVO”

13. Cadastro de Veículos (OMSA060 – tabela DA3)

Campo	Recebe	Observações
GU8_CDVEIC*	DA3_COD
GU8_CDTPVC	DA3_TIPVEI
GU8_PLACA	DA3_PLACA
GU8_UFPLAC	DA3_ESTPLA
GU8_CDPROP	DA3_CGCFOR
GU8_TPPROP	DA3_FROVEI	Quando DA3_FROVEI = “1=PROPRIA” atribuir “2=PRÓPRIO” Quando DA3_FROVEI = “2=TERCEIRO” ou “3=AGREGADO” atribuir “1=TERCEIRO”
GU8_ALTUR	DA3_ALTEXT
GU8_LARGUR	DA3_LAREXT
GU8_COMPRI	DA3_COMEXT
GU8_VOLUT	DA3_VOLMAX
GU8_CARGUT	DA3_CAPACM
GU8_SIT	“1=ATIVO”	Quando DA3_ATIVO = “” atribuir “2=INATIVO” Na operação de eliminação da DA3 atribuir “2=INATIVO”

14. Cadastro de Tipos de Veículos (TMSA530 – tabela DUT)

Campo	Recebe	Observações
GV3_CDTPVC*	DUT_TIPVEI
GV3_DSTPVC	DUT_DESCRI
GV3_SIT	“1=ATIVO”	Na operação de eliminação da DUT atribuir “2=INATIVO”

15. Notas Fiscais de Saída (MATA460 – tabelas SF2, SD2)

Campo	Recebe	Observações
Cabeçalho do Documento de Carga
*GW1_CDTPDC	X5_DESCRI	Concatenar o campo F2_CDTPDC à letra “S” e localizar o registro correspondente na tabela genérica “MQ” (no SX5). Se não encontrar repetir o procedimento sem concatenar a letra “S”.
*GW1_EMISDC	A1_CGC
*GW1_SERDC	F2_SERIE
*GW1_NRDC	F2_DOC
GW1_DTEMIS	F2_EMISSAO
GW1_ORIGEM	“2=ERP”
GW1_CDREM	A1_CGC
GW1_CDDEST	A2_CGC	Quando F2_TIPO diferente de “B” e “D” atribuir A1_CGC
GW1_SIT	“3=LIBERADO”
GW1_DSESP	F2_ESPECIE
GW1_DTLIB	dDATA
GW1_HRLIB	TIME()
GW1_ORINR	F2_NFORI
GW1_ORISER	F2_SERIORI
GW1_NRROM	F2_CARGA + F2_SEQCAR	Concatenar os dois campos
GW1_ICMSDC	“1=SIM”	Quando F2_VALICM = 0 atribuir “2=NÃO”
GW1_TPFRET		Quando F2_TPFRETE = “C=CIF” atribuir “1=CIF” quando F2_CGCRDP em branco “2=CIF REDESP” quando F2_CGCRDP preenchido Quando F2_TPFRETE = “F=FOB” atribuir “3=FOB” quando F2_CGCRDP em branco “4=FOB REDESP” quando F2_CGCRDP preenchido
GW1_AUTSEF		Se F2_FIMP não-preenchido atribuir “0=Nao informado” Se F2_FIMP “T=transmitida” atribuir “0=Nao informado” Se F2_FIMP “S=NF Autorizada” atribuir “1=Autorizado” Se F2_FIMP “D=NF Uso Denegado” atribuir “2=Nao-autorizado” Se F2_FIMP “N=NF Não-autorizada” atribuir “2=Nao-autorizado”
GW1_DANFE	F2_CHVFE
Itens do Documento de Carga
*GW8_CDTPDC	GW1_CDTPDC
*GW8_EMISDC	GW1_EMISDC
*GW8_SERDC	GW1_SERDC
*GW8_NRDC	GW1_NRDC
*GW8_SEQ	D2_ITEM
GW8_ITEM	D2_COD
GW8_DSITEM	D2_DESCRI
GW8_QTDE	D2_QUANT
GW8_VALOR	D2_VALBRUT
GW8_VOLUME	B5_ALTURA * B5_LARG * B5_COMPR * D2_QUANT	Localizar a SB5 com B%_COD = D2_COD e se não encontrar B5 atribuir 0 (zero)
GW8_PESOR	D2_PBRUTO
GW8_QTDALT	D2_PESO
Trecho do 1º Redespacho (Transportador Redespachante) Criar quando F2_CGCRDP preenchido
*GWU_CDTPDC	GW1_CDTPDC
*GWU_EMISDC	GW1_EMISDC
*GWU_SERDC	GW1_SERDC
*GWU_NRDC	GW1_NRDC
*GWU_SEQ	02
GWU_CDTRP	F2_CGCRDP	FIELDREL_2
GWU_NRCIDD	A2_CDIBGE	Quando F2_CGCRDP preenchido atribuir A4_CDIBGE
GWU_PAGAR	“1=SIM”	Quando F2_TFRDP1 <> “C=CIF”atribuir “2=NÃO”

Os campos relativos ao local de entrega diferenciado não serão preenchidos pois o Protheus não permite informar um local de entrega distinto do endereço do destinatário. Na versão da integração com XML os campos eram sempre preenchidos com o endereço do cadastro do destinatário (cliente ou fornecedor).

Devem ser considerados os campos customizados FIELDREL_3 a FIELDREL_5 (verificar antes se existem no SX3) para formar os demais trechos de redespacho.

Importante:

A integração ocorre independentemente da situação da Nota Fiscal em relação à transmissão e autorização da Sefaz.

16. Cancelamento de Notas Fiscais de Saída (MATA521 – tabela SF2)

Ao confirmar o cancelamento da Nota Fiscal no Protheus, a rotina deve acionar a eliminação do Documento de Carga correspondente no GFE. Essa operação não deve estar condicionada à opção escohida no parâmetro MV_FATGFE, por isso se a eliminação do Documento de Carga no GFE não for concluída com sucesso, a mensagem de validação deve ser apresentada para o usuário e o processo de cancelamento no ERP interrompido.

17. Montagem de Cargas (OMSA200 – tabela DAK)

Campo	Recebe	Observações
GWN_NRROM*	DAK_COD e DAK_SEQCAR	Concatenar os campos.
GWN_CDTPOP	MV_CDTPOP
GWN_CDTRP	DAK_CGCTRA
GWN_CDMTR	DAK_MOTORI
GWN_CDTPVC	DAK_ CDTPVC
GWN_PLACAD	DAK_PLACA
GWN_DTIMPL	DAK_DATA
GWN_HRIMPL	DAK_HORA
GWN_ORI	“2=ERP”

Na ação de eliminação da Carga deve-se realizar a tentativa de eliminação do Romaneio no GFE, tratando o registro para que a validação que impede a eliminação de Romaneios com origem no ERP seja contornada; quaisquer outros impedimentos devem ser apresentados para o usuário impedindo o prosseguimento da operação no ERP.

A ação de Alteração não gera integração com o GFE, pois os dados que podem ser alterados na Carga não têm correspondentes no Romaneio.

18. Manutenção de Documentos de Entrada (MATA103 – tabelas SF1, SD1)

Campo	Recebe	Observações
Cabeçalho do Documento de Carga
*GW1_CDTPDC	X5_DESCRI	Concatenar o campo F2_CDTPDC à letra “E” e localizar o registro correspondente na tabela genérica “MQ” (no SX5). Se não encontrar repetir o procedimento sem concatenar a letra “E”.
*GW1_EMISDC	A2_CGC	Quando F1_TIPO = “D” atribuir A1_CGC da SM0 quando F1_FORMUL = “S” A1_CGC da SA1 quando F1_FORMUL <> “S”
*GW1_SERDC	F1_SERIE
*GW1_NRDC	F1_DOC
GW1_DTEMIS	F1_EMISSAO
GW1_ORIGEM	“2=ERP”
GW1_CDREM	A2_CGC	Quando F1_TIPO = “D” atribuir A1_CGC
GW1_CDDEST	A1_CGC	Quando F1_TIPO = “D” atribuir A1_CGC da SM0 quando F1_FORMUL = “S” A1_CGC da SA1 quando F1_FORMUL <> “S”
GW1_SIT	“3=LIBERADO”
GW1_DSESP	F1_ESPECIE
GW1_DTLIB	dDATA
GW1_HRLIB	TIME()
GW1_NRROM	F1_CARGA + F1_SEQCAR	Concatenar os dois campos
GW1_ICMSDC	“1=SIM”	Quando F1_VALICM = 0 atribuir “2=NÃO”
GW1_QTVOL	F1_VOLUME1
GW1_TPFRET	“3=FOB”	Quando F1_TPFRETE = “C=CIF” atribuir “1=CIF”
Itens do Documento de Carga
*GW8_CDTPDC	GW1_CDTPDC
*GW8_EMISDC	GW1_EMISDC
*GW8_SERDC	GW1_SERDC
*GW8_NRDC	GW1_NRDC
*GW8_SEQ	D1_ITEM
GW8_ITEM	D1_COD
GW8_DSITEM	D1_DESCRI
GW8_QTDE	D1_QUANT
GW8_VALOR	D1_TOTAL
GW8_VOLUME	B5_ALTURA * B5_LARG * B5_COMPR * D2_QUANT	Localizar a SB5 com B%_COD = D1_COD e se não encontrar B5 atribuir 0 (zero)
GW8_PESOR	D1_PBRUTO
GW8_QTDALT	D1_PESO
GW8_ATUATF	D1_ATUATF
Trecho do Despacho (Transportador Principal) Criar sempre
*GWU_CDTPDC	GW1_CDTPDC
*GWU_EMISDC	GW1_EMISDC
*GWU_SERDC	GW1_SERDC
*GWU_NRDC	GW1_NRDC
*GWU_SEQ	01
GWU_CDTRP	F1_CGCTRP
GWU_NRCIDD	A1_CDIBGE
GWU_PAGAR	“1=SIM”	Quando F1_TPFRETE <> “F=FOB”atribuir “2=NÃO”

19. Carga de Dados (OMSM011 – tabelas CT1, CTT, DA3, DA4, DUT, SA1, SA2, SA4, SF2, SF1)

Em substituição à rotina OMSM010 que faz a geração do XML para carga inicial de dados das tabelas do ERP Protheus para outros sistemas, será disponibilizada a rotina OMSM011 exclusivamente para a integração com o SIGAGFE; a rotina cria apenas os registros cujo correspondente no GFE ainda não exista, por isso recomenda-se usá-la quando inicia-se a utilização do SIGAGFE em uma base de dados já existente do ERP. As tabelas CC2 (Municípios), SA1 (Clientes), SA2 (Fornecedores), SA4 (Transportadores), DA3 (Veículos), DA4 (Motoristas), DUT (Tipos de Veículos), CTT (Centros de Custo), CT1 (Plano de Contas), SF1 (Documentos de Entrada) e SF2 (Notas Fiscais de Saída) serão disponibilizadas na rotina OMSM011; caso os parâmetros MV_INTGFE e MV_INTGFE2 não estiverem parametrizados para integração direta entre o ERP e o SIGAGFE será emitida mensagem de erro informando o usuário das condições necessárias e impedindo a execução da rotina.

20. Integração de Pré-faturas como Título a Pagar (GFEA055 – tabelas GWJ, GWK)

Campo	Recebe	Observações
Título a Pagar
E2_PREFIXO	“”
E2_NUM	GWJ_NRPF
E2_PARCELA	“1”
E2_TIPO	“PR”
E2_NATUREZ	MV_NTFGFE
E2_EMISSAO	GWJ_DTIMPL
E2_VENCTO	GWJ_DTVCTO
E2_VENCREA	GWJ_DTVCTO
E2_VALOR	GWJ_VLPF
E2_VLCRUZ	GWJ_VLPF
E2_CGCFOR	GWJ_CDTRP
E2_ORIGEM	“TOTVSGFE”
Rateio Contábil		Criar 1 para cada registro da GWK com GWK_LANCTO = “1=DB”
CTJ_DEBITO	GWK_CTACTB
CTJ_VALOR	GWK_VLMOV
CTJ_CCD	GWK_CCUSTO

21. Integração de Faturas como Título a Pagar (GFEA070 – tabelas GW6, GW7, GWJ)

Campo	Recebe	Observações
Título a Pagar
E2_PREFIXO	GW6_SERFAT
E2_NUM	GW6_NRFAT
E2_PARCELA	“1”
E2_TIPO	“FT”
E2_NATUREZ	MV_NTFGFE
E2_EMISSAO	GW6_DTEMIS
E2_VENCTO	GW6_DTVENC
E2_VENCREA	GW6_DTVENC
E2_VALOR	GW6_VLFATU
E2_VLCRUZ	GW6_VLFATU
E2_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW6_EMIFAT Quando não localizar A2 ou A2_CGC em branco atribuir GW6_EMIFAT
E2_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW6_EMIFAT Quando não localizar A2 ou A2_CGC em branco atribuir “01”
E2_ACRESC	GW6_VLJURO
E2_DECRESC	GW6_VLDESC
E2_ORIGEM	“TOTVSGFE”
E2_ISS	GW6_VLISRE
Rateio Contábil		Criar para cada registro da GW7 com GW7_LANCTO = “1=DB”
CTJ_DEBITO	GW7_CTACTB
CTJ_VALOR	GW7_VLMOV
CTJ_CCD	GW7_CCUSTO
Títulos de Provisão a Baixar		Criar para cada registro da GWJ (quando houver)
PRVSE2_NUM	GWJ_NRPF
PRVSE2_PACELA	“1”
PRVSE2_TIPO	“PR”

Depois do retorno da função usada para integração, gravar os seguintes campos:

Campo	Recebe	Observações
GW6_SITFIN		Na operação de inclusão (Atualizar ERP), quando o retorno indicar que a inclusão foi realizada com sucesso atribuir “4=ATUALIZADA”, em caso contrário atribuir “3=REJEITADA” Na operação de eliminação (Desatualizar ERP), quando o retorno indicar que houve sucesso na operação atribuir “1=NÃO ENVIADA”, em caso contrário atribuir “4=ATUALIZADA”
GW6_MOTFIN		Mensagens de erro quando o retorno indicar que a inclusão ou a eliminação não foi realizada com sucesso.

22. Integração de Contratos como Título a Pagar (GFEA100 – tabelas GW2, GW9)

Campo	Recebe	Observações
GW6_SITFIN		Na operação de inclusão (Atualizar ERP), quando o retorno indicar que a inclusão foi realizada com sucesso atribuir “4=ATUALIZADA”, em caso contrário atribuir “3=REJEITADA” Na operação de eliminação (Desatualizar ERP), quando o retorno indicar que houve sucesso na operação atribuir “1=NÃO ENVIADA”, em caso contrário atribuir “4=ATUALIZADA”
GW6_MOTFIN		Mensagens de erro quando o retorno indicar que a inclusão ou a eliminação não foi realizada com sucesso.

Depois do retorno da função usada para integração, gravar os seguintes campos:

Campo	Recebe	Observações
Título a Pagar
E2_PREFIXO	“”
E2_NUM	GW2_NRCONT
E2_PARCELA	“1”
E2_TIPO	“RPA”
E2_NATUREZ	MV_NTFGFE
E2_EMISSAO	GW2_DTCRIA
E2_VENCTO	GW2_DTVENC
E2_VENCREA	GW2_DTVENC
E2_VALOR	GW2_VLFRET
E2_VLCRUZ	GW2_VLFRET
E2_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW2_CDPROP Quando não localizar A2 ou A2_CGC em branco atribuir GW2_CDPROP
E2_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW2_CDPROP Quando não localizar A2 ou A2_CGC em branco atribuir “01”
E2_ORIGEM	“TOTVSGFE”
E2_ISS	GW2_VLISS
E2_INSS	GW2_VLINSS
E2_IRRF	GW2_VLIRRF
E2_SEST	GW2_VLSEST
Rateio Contábil		Criar para cada registro da GW9 com GW9_LANCTO = “1=DB”
CTJ_DEBITO	GW9_CTACTB
CTJ_VALOR	GW9_VLMOV
CTJ_CCD	GW9_CCUSTO

Depois do retorno da função usada para integração, gravar os seguintes campos:

Campo	Recebe	Observações
GW2_SITFIN		Na operação de inclusão (Atualizar ERP), quando o retorno indicar que a inclusão foi realizada com sucesso atribuir “4=ATUALIZADO”, em caso contrário atribuir “3=REJEITADO” Na operação de eliminação (Desatualizar ERP), quando o retorno indicar que houve sucesso na operação atribuir “1=NÃO ENVIADO”, em caso contrário atribuir “4=ATUALIZADO”
GW2_MOTFIN		Mensagens de erro quando o retorno indicar que a inclusão ou a eliminação não foi realizada com sucesso.

23. Integração de Documentos de Frete como Documento de Entrada (GFEA065 – tabela GW3)

Campo	Recebe	Observações
Documento de Entrada
F1_DOC	GW3_NRDF
F1_SERIE	GW3_SERDF
F1_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW3_EMISDF Quando não localizar A2 ou A2_CGC em branco atribuir GW3_EMISDF
F1_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW3_EMISDF Quando não localizar A2 ou A2_CGC em branco atribuir “01”
F1_EMISSAO	GW3_DTEMIS
F1_COND	MV_CPDGFE
F1_TIPO	“N=NORMAL”
F1_FORMUL	“N=NÃO”
F1_ESPECIE	GW3_CDESP
F1_EST	GU3_UF	Localizar GU3 com GU3_CDEMIT = GW3_CDDEST
F1_RECBMTO	GW3_DTFIS
F1_CHVNFE	GW3_CTE
Item do Documento de Entrada	Criar sempre (apenas 1 registro)
D1_DOC	GW3_NRDF
D1_SERIE	GW3_SERDF
D1_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW3_EMISDF Quando não localizar A2 ou A2_CGC em branco atribuir GW3_EMISDF
D1_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW3_EMISDF Quando não localizar A2 ou A2_CGC em branco atribuir “01”
D1_EMISSAO	GW3_DTEMIS
D1_ITEM	“0001”
D1_COD	MV_PRITDF
D1_UM	“UN”
D1_QUANT	1
D1_VUNIT	GW3_VLDF
D1_TOTAL	GW3_VLDF
D1_OPER	“T1”	“T2” quando GW3_TPIMP = "1=ICMS" e GW3_TPTRIB = “2=ISENTO” “T3” quando GW3_TPIMP = "1=ICMS" e GW3_TPTRIB = “3=SUBS. TRIB.” “T7” quando GW3_TPIMP = "1=ICMS" e GW3_TPTRIB = “1=TRIBUTADO” e GW3_CRDPC = “2=NÃO” “T4” quando quando GW3_TPIMP = "2=ISS"
D1_TES	FM_TE	Localizar FM com FM_TIPO = D1_OPER
D1_VALICM		GW3_VLIMP quando GW3_TPIMP = "1=ICMS"
D1_PICM		GW3_PCIMP quando GW3_TPIMP = "1=ICMS"
D1_BASEICM		GW3_BASIMP quando GW3_TPIMP = "1=ICMS"
D1_ICMSRET		GW3_IMPRET quando GW3_TPIMP = "1=ICMS"
D1_VALISS		GW3_VLIMP quando GW3_TPIMP = "2=ISS"
D1_ALIQISS		GW3_PCIMP quando GW3_TPIMP = "2=ISS"
D1_BASEISS		GW3_BASIMP quando GW3_TPIMP = "2=ISS"
D1_BASECOF	GW3_BASCOF
D1_ALQCOF	MV_PCPIS
D1_VALCOF	GW3_VLCOF
D1_BASEPIS	GW3_BASPIS
D1_ALQPIS	MV_PCCOFI
D1_VALPIS	GW3_VLPIS

Depois do retorno da função usada para integração, gravar os seguintes campos:

Campo	Recebe	Observações
GW2_SITFIS		Na operação de inclusão (Atualizar ERP), quando o retorno indicar que a inclusão foi realizada com sucesso atribuir “4=ATUALIZADO”, em caso contrário atribuir “3=REJEITADO” Na operação de eliminação (Desatualizar ERP), quando o retorno indicar que houve sucesso na operação atribuir “1=NÃO ENVIADO”, em caso contrário atribuir “4=ATUALIZADO”
GW2_MOTFIS		Mensagens de erro quando o retorno indicar que a inclusão ou a eliminação não foi realizada com sucesso.

24. Integração de Documentos de Frete como Nota de Conhecimento (GFEA065 – tabelas GW3, GW4)

Campo	Recebe	Observações
Conhecimento de Frete (Documento de Entrada)
F1_DOC	GW3_NRDF
F1_SERIE	GW3_SERDF
F1_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW3_EMISDF Quando não localizar A2 ou A2_CGC em branco atribuir GW3_EMISDF
F1_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW3_EMISDF Quando não localizar A2 ou A2_CGC em branco atribuir “01”
F1_EMISSAO	GW3_DTEMIS
F1_TIPO	“N=Normal”	Se opção de integração for pré-Ct recebe valor “C=CONHECIMENTO”
F1_FORMUL	“N=NÃO”
F1_ESPECIE	GW3_CDESP
F1_VALBRUT	GW3_VLDF
F1_OPER		“T7” “T8” quando GW3_TPIMP = "1=ICMS" e GW3_TPTRIB = “2=ISENTO” “T9” quando GW3_TPIMP = "1=ICMS" e GW3_TPTRIB = “3=SUBS. TRIB.”
F1_TES	FM_TE	Localizar FM com FM_TIPO = F1_OPER F1_VALICM GW3_VLIMP quando GW3_TPIMP = "1=ICMS"
F1_PICM		GW3_PCIMP quando GW3_TPIMP = "1=ICMS"
F1_BASEICM		GW3_BASIMP quando GW3_TPIMP = "1=ICMS"
F1_ISS		GW3_VLIMP quando GW3_TPIMP = "2=ISS"
F1_ALIQISS		GW3_PCIMP quando GW3_TPIMP = "2=ISS"
F1_BASEISS		GW3_BASIMP quando GW3_TPIMP = "2=ISS"
F1_BASCOFI	GW3_BASCOF
F1_ALQCOF	MV_PCPIS
F1_VALCOFI	GW3_VLCOF
F1_BASPIS	GW3_BASPIS
F1_ALQPIS	MV_PCCOFI
F1_VALPIS	GW3_VLPIS
Notas Fiscais do Conhecimento de Frete		Criar 1 para cada registro da GW4 relacionada à GW3
F8_TRANSP	F1_FORNECE
F8_LOJTRAN	F1_LOJA
F8_NFDIFRE	F1_DOC
F8_SEDIFRE	F1_SERIE
F8_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW3_EMISDC Quando não localizar A2 ou A2_CGC em branco atribuir GW3_EMISDC
F8_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW3_EMISDC Quando não localizar A2 ou A2_CGC em branco atribuir “01”
F8_NFORIG	GW4_NRDC
F8_SERORIG	GW4_SERDC

Depois do retorno da função usada para integração, gravar os seguintes campos:

Campo	Recebe	Observações
GW2_SITREC		Na operação de inclusão (Atualizar ERP), quando o retorno indicar que a inclusão foi realizada com sucesso atribuir “4=ATUALIZADO”, em caso contrário atribuir “3=REJEITADO” Na operação de eliminação (Desatualizar ERP), quando o retorno indicar que houve sucesso na operação atribuir “1=NÃO ENVIADO”, em caso contrário atribuir “4=ATUALIZADO”.
GW2_MOTREC		Mensagens de erro quando o retorno indicar que a inclusão ou a eliminação não foi realizada com sucesso.

Ao acessar o programa MATA116 (Nt Conhec Frete), usado para digitação dos Conhecimentos de Frete, o usuário recebe a seguinte mensagem de informação quando o GFE está implantado.

Integrações > DI Integração Protheus x GFE > Protheus_GFE_MATA116.png

Essa mensagem já é emitida pelo sistema independente do modelo de integração.

25. Integração de Contratos como Nota de Conhecimento (GFEA100 – tabela GW2)

Campo	Recebe	Observações
F1_DOC	GW2_NRCONT
F1_SERIE	“”
F1_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW2_CDPROP Quando não localizar A2 ou A2_CGC em branco atribuir GW2_CDPROP
F1_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW2_CDPROP Quando não localizar A2 ou A2_CGC em branco atribuir “01”
F1_EMISSAO	GW2_DTCRIA
F1_TIPO	“C=CONHECIMENTO”
F1_FORMUL	“N=NÃO”
F1_ESPECIE	“CTR”
F1_VALBRUT	GW2_VLFRET
F1_OPER	“TT”
Notas Fiscais do Conhecimento de Frete		Criar 1 para cada registro da GW4 relacionada à GW8
F8_TRANSP	F1_FORNECE
F8_LOJTRAN	F1_LOJA
F8_NFDIFRE	F1_DOC
F8_SEDIFRE	F1_SERIE
F8_FORNECE	A2_COD	Localizar A2 com A2_CGC = GW8_EMISDC Quando não localizar A2 ou A2_CGC em branco atribuir GW8_EMISDC
F8_LOJA	A2_LOJA	Localizar A2 com A2_CGC = GW8_EMISDC Quando não localizar A2 ou A2_CGC em branco atribuir “01”
F8_NFORIG	GW1_NRDC
F8_SERORIG	GW1_SERDC

Depois do retorno da função usada para integração, gravar os seguintes campos:

Campo	Recebe	Observações
GW2_SITREC		Na operação de inclusão (Atualizar ERP), quando o retorno indicar que a inclusão foi realizada com sucesso atribuir “4=ATUALIZADO”, em caso contrário atribuir “3=REJEITADO” Na operação de eliminação (Desatualizar ERP), quando o retorno indicar que houve sucesso na operação atribuir “1=NÃO ENVIADO”, em caso contrário atribuir “4=ATUALIZADO”.
GW2_MOTREC		Mensagens de erro quando o retorno indicar que a inclusão ou a eliminação não foi realizada com sucesso.

Ao acessar o programa MATA116 (Nt Conhec Frete), usado para digitação dos Conhecimentos de Frete, o usuário recebe a seguinte mensagem de informação quando o GFE está implantado.

Integrações > DI Integração Protheus x GFE > Protheus_GFE_MATA116.png

Essa mensagem já é emitida pelo sistema independente do modelo de integração.

26. Parâmetros do Módulo (GFEX000)

Disponibilizar na pasta “Integrações Protheus” os seguintes parâmetros: MV_INTGFE, MV_INTGFE2, MV_FATGFE, MV_NTFGFE, MV_CPDGFE e MV_CDTPOP, com opções definidas em forma de lista para seleção (combo-box).
Alterar o programa para que na ação de confirmação não sejam cadastrados os Adapters EAI quando a integração for direta (MV_INTGFE2 = “1” ou “S”).
No programa Parâmetros do Frete Embarcador (GFEX000) na aba Integrações Protheus no “SIGACOM foi criado o parâmetro TES Doc. Frete (MV_TESGFE) com as opções: Atribuído pelo Sistema (Padrão) e Informado pelo Usuário: Na opção Atribuído pelo Sistema após a digitação do documento, o campo será automaticamente preenchido com a informação da TES inteligente conforme já feito hoje no GFE.
E na opção Informado pelo Usuário, o campo TES deverá ser preenchido manualmente, porém, será sugerida o TES vinculada ao produto (campo TE Padrão). Caso a integração automática esteja ativa será utilizado o TES do produto.

Importante:
Na mudança da integração usando EAI/ESB para a integração direta a eliminação do cadastramento dos Adapters EAI deve ser efetuada manualmente pelo módulo SIGACFG.

27. Carga de Notas Fiscais com Erro de Integração (OMSM012)

Quando o parâmetro “Impede Faturamento” indicar que a geração das Notas Fiscais de Saída não depende do sucesso da integração com o GFE os seguintes procedimento complementarão a integração:

a. As Notas Fiscais de Saída não integradas ficarão registradas para que posteriormente os usuários acionem novamente a integração para o GFE pelo programa OMSM012 (pode ser acessado pelo menu ou por um botão na barra inferior do OMSM011). Esse programa lista todas as Notas Fiscais de Saída que não integraram com o GFE por algum erro de validação ocorrido (a mensagem fica registrada e pode ser consultada nesse mesmo programa);
b. Assim que nova ação de integração ocorrer com os registros de controle são descartados;
c. Se a Nota Fiscal de Saída com pendência de integração for cancelada no ERP o registro de controle é descartado;
d. A carga de dados pelo OMSM011 também gera esses registros para as Notas Fiscais de Saída não integradas com sucesso;
e. Se o motivo da não integração for uma restrição intencionalmente cadastrada (Filtro de Documentos de Carga) o sistema não grava o registro de controle;
f. Essa rotina não se aplica à integração de Notas Fiscais de Entrada (Documentos de Entrada).