Histórico da Página
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
Modelo alterado
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 – Cadastro de Cidades |
| MATA030 – Cadastro de Clientes | Incluir, Alterar, Eliminar | GFEA015 – Cadastro de Emitentes |
| MATA050 – Cadastro de Transportadores | Incluir, Alterar, Eliminar | GFEA015 – Cadastro de Emitentes |
| MATA020 – Cadastro de Fornecedores | Incluir, Alterar, Eliminar | GFEA015 – Cadastro de Emitentes |
| CTBA180 – Cadastro de Centros de Custo | Incluir, Alterar, Eliminar | GFEA089 – Cadastro de Centro de Custo |
| CTBA020 – Cadastro de Contas Contábeis | Incluir, Alterar, Eliminar | GFEA090 – Cadastro de Contas Contábeis |
| TMSA530 – Cadastro de Tipos de Veículo | Incluir, Alterar, Eliminar | GFEA090 – Cadastro de Contas Contábeis |
| OMSA060 – Cadastro de Veículos | Incluir, Alterar, Eliminar | GFEA046 – Cadastro de Veículos |
| OMSA040 – Cadastro de Motoristas | Incluir, Alterar, Eliminar | GFEA012 – Cadastro de Motoristas e Ajudantes |
| OMSA200 – Montagem de Cargas | Incluir, Alterar, Eliminar | GFEA050 – Romaneios de Carga |
| 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 GFE Ativo (MV_INTGFE) e Modo Integração (MV_INTGFE2).
| Model SIGAGFE | Evento(s) | MSExecAuto |
|---|---|---|
| GFEA055 – Geração Pré-faturas | Envio para ERP | FINA050 – Título a Pagar (Provisão) |
| GFEA065 – Digitação de Documentos de Frete | Envio para ERP | MATA103 – Documento de Entrada |
| GFEA065 – Digitação de Documentos de Frete | Envio para ERP | MATA140 – Pré-nota |
| GFEA065 – Digitação de Documentos de Frete | Envio para ERP | MATA116 – Nota de Conhecimento de Frete |
| GFEA065 – Digitação de Documentos de Frete | Envio para ERP | MATA116 - Pré-nota de Conhecimento |
| GFEA070 – Faturas de Frete | Envio para ERP | FINA050 – Título a Pagar |
| GFEA100 – Geração de Contratos com Autônomos | Envio para ERP | FINA050 – Título a Pagar |
| GFEA100 – Geração de Contratos com Autônomos | 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 GFE Ativo (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 Modo Integração (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): Origem dos Cadastros (MV_CADERP) Municípios, Emitentes, Contas Contábeis e Centros de Custo e Origem dos Cadastros OMS (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 Origem dos Cadastros (MV_CADERP) = 1 - ERP ou Origem dos Cadastros OMS (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 Origem dos Cadastros (MV_CADERP) = 1 - ERP ou Origem dos Cadastros OMS (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 Origem dos Cadastros (MV_CADERP) = 1 - ERP ou Origem dos Cadastros OMS (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 para assim avaliar como proceder corretamente com a operação.
3. Registros de Processos enviados pelo ERP
a. O parâmetro Impede Faturamento? (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 expedidas, 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; caso necessário quaisquer alterações, deve-se acionar a ação Desatualizar ERP no SIGAGFE sobre o respectivo registro, assim poderá 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=Não Enviado; 2=Pendente; 3=Rejeitado; 4=Atualizado; 5=Pendente Desatualização; 6=Não 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 Modo Integração (MV_INTGFE2) = 1 =- Sim; nas rotinas em que há a alteração da situação de 4=Atualizado para 5=Pendente Desatualização, o sistema deve executar a integração via MSExecAuto, com a operação Eliminação, quando o parâmetro Modo Integração (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, parâmetro Pré-fatura Financeiro (MV_GFEI15) = 2 =- Automático. | Atualizar | |
| GFEA057 | Ação relacionada Confirmar, quando o modo de integração for automático, parâmetro Pré-fatura Financeiro (MV_GFEI15) = 2 =- Automático. | 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, parâmetro Doc. Frete Fiscal (MV_GFEI13) = 2 =- Automático. | Atualizar | |
| GFEA066 | Confirmação da ação Aprovar, quando o modo de integração for automático, parâmetro Doc. Frete Fiscal (MV_GFEI13) = 2 =- Automático. | 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, parâmetro Doc. Frete Fiscal (MV_GFEI13) = 2 =- Automático. | 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, parâmetro Doc. Frete Fiscal (MV_GFEI13) = 2 =- Automático. | 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, parâmetro Fatura Financeiro (MV_GFEI16) = 2 =- Automático. | 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, parâmetro Fatura Financeiro (MV_GFEI16) = 2 =- Automático. | Atualizar | |
| GFEA071 | Confirmação da ação Aprovar, quando o modo de integração for automático, parâmetro Fatura Financeiro (MV_GFEI16) = 2 =- Automático. | 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 for Aprovada Sistema (GW6_SITAPR = 3) e o modo de integração for automático, parâmetro Fatura Financeiro (MV_GFEI16) = 2 =- Automático. | 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“3), e o modo de integração for automático, parâmetro Fatura Financeiro (MV_GFEI16) = 2 =- Automático. | 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, parâmetro Doc. Frete Custo (MV_GFEI14) = 2 =- Automático. | Atualizar | |
| GFEA066 | Confirmação da ação Aprovar, quando o modo de integração for automático, parâmetro Doc. Frete Custo (MV_GFEI14) =2 =- Automático. | 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, parâmetro Doc. Frete Custo (MV_GFEI14) = 2 =- Automático. | 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, parâmetro Doc. Frete Custo (MV_GFEI14) = 2 =- Automático. | 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, parâmetro Contrato Financeiro (MV_GFEI17) = 2 =- Automático. | 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, parâmetro Contrato Financeiro (MV_GFEI17) = 2 =- Automático. | 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 Quando F2_TPFRETE = “F=FOB” atribuir | |
| 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 | |
| GW8_INFO1 | D2_TP | |
| GW8_INFO2 | D2_GRUPO | |
| GW8_INFO3 | D2_TES | |
| GW8_INFO4 | D2_CLVL | |
| GW8_INFO5 | D2_CCUSTO | |
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.
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.
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).
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas