NTEGRAÇÃ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
O modelo com EAI e TOTVS ESB está em desuso.
Atualmente é utilizado o 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 deste documento) 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).
Lista dos pontos de integração de dados do SIGAGFE para o ERP:
| 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 deste documento), 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
- Todas as integrações estão condicionadas ao parâmetro GFE Ativo (MV_INTGFE), na pasta Integração Protheus do programa Parâmetros do Módulo (GFEX000), este deve estar marcado para que a integração esteja ativa;
- A integração direta, está condicionada ao parâmetro:
- Modo Integração (MV_INTGFE2), 1 - Direta indica que a integração entre os módulos do ERP base e o SIGAGFE é direta, ou seja, acontece diretamente no banco de dados.
- Tipo de geração de Log (MV_GFEEDIL), na pasta Integração EDI, deve estar como 2-Normal, para que o detalhamento do log seja completo;
- Diretório LOG (MV_DRTLOG), na pasta Cálculo de Frete, determina o local onde será gerado o arquivo de log da integração, este diretório deve estar abaixo do diretório PROTHEUS_DATA
2. Registros de Cadastros
- 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;
- Os cadastros integrados entre ERP e SIGAGFE permitem inclusão apenas pelo ERP;
- 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;
- 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;
- 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);
- 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;
- 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
- 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;
- A eliminação da Nota Fiscal somente é 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
- Os dados gerados pelo GFE no ERP não permitem 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);
- 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
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), 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. 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 cadastradas no SIGAGFE, sem causar impacto no funcionamento do sistema.
Integrações do PROTHEUS com GFE
7. Cadastro de Cidades (GFEA020) - Tabela GU7
A tabela de Cidades (GU7) recebe as informações do Cadastro de Municípios (FISA010) – Tabela CC2
| Campo | Recebe | Observações |
|---|---|---|
| Cidade (GU7_NRCID) | Código IBGE do CC2_EST + CC2_CODMUN | O campo Cidade (GU7_NRCID) recebe o valor do Código do Estado IBGE - utilizando o campo Estado (CC2_EST) e a tabela do tópico 6. Tabela para obtenção do Código IBGE das Unidades de Federação para realizar a conversão e concatenar com o Código do Município IBGE (CC2_CODMUN). |
| Nome da Cidade (GU7_NMCID) | CC2_MUN | O campo Nome da Cidade (GU7_NMCID) recebe o valor do campo Município (CC2_MUN). |
| Estado (GU7_UF) | CC2_EST | O campo Estado (GU7_UF) recebe o valor do campo Estado (CC2_EST). |
| País (GU7_PAIS) | 105 - Brasil | O campo País (GU7_PAIS) recebe o valor fixo 105 - Brasil. |
8. Cadastro de Emitentes - Clientes - GFEA015 - Tabela GU3
A tabela Emitentes (GU3) recebe as informações dos Cadastros de Cliente (MATA030) – Tabela SA1, Cadastros de Fornecedores (MATA020) - Tabela SA2 e.Cadastros de Transportador (MATA050) - Tabela SA4.
Neste momento iremos descrever o processo de integração de Clientes
| Campo | Recebe | Observações |
|---|---|---|
| Código do Emitente (GU3_CDEMIT) | A1_CGC |
|
| Filial (GU3_FILIAL) | A1_FILIAL | O campo Filial (GU3_FILIAL) recebe a Filial (A1_FILIAL). |
| Nome do Emitente (GU3_NMEMIT) | A1_NOME | O campo Nome do Emitente (GU3_NMEMIT) recebe o Nome do Cliente (A1_NOME). |
| Nome Fantasia (GU3_NMFAN) | A1_NREDUZ | O campo Nome Fantasia (GU3_NMFAN) recebe o Nome Reduzido do cliente (A1_NREDUZ). |
Natureza do Emitente (GU3_NATUR) | A1_PESSOA | O campo Natureza Jurídica do Emitente (GU3_NATUR) recebe Pessoa Física/Jurídica (A1_PESSOA). Quando o campo Pessoa Física/Jurídica (A1_PESSOA) estiver vazio, enviará o valor X - Outros. |
Data de Nascimento/Criação (GU3_DTNASC) | A1_DTNASC | O campo Data de Nascimento/Criação (GU3_DTNASC) recebe a Data de Nascimento/Criação (A1_DTNASC). |
| Origem (GU3_ORIGEM) | 2-ERP | O Campo Origem (GU3_ORIGEM) recebe o valor fixo 2-ERP, pois o registro vem por meio da integração entre os produtos. |
| Situação (GU3_SIT) | A1_MSBLQL | O campo Situação (GU3_SIT) recebe o valor do campo Status (A1_MSBLQL). |
| Filial? (GU3_EMFIL) | A1_CLIFIL | Se o campo CNPJ/CPF (A1_CGC) não for vazio ,o sistema valida o campo CNPJ/CPF (A1_CGC) no Configurador (SIGACFG) > Ambiente > Empresas > Cadastro de Filial (CFGX032), contra o campo CNPJ ou CPF (M0_CGC), verificando se o mesmo está cadastrado. Se estiver cadastrado, o campo Filial? (GU3_EMFIL) é gravado como 1-Sim. |
| Cliente? (GU3_CLIEN) | 1-SIM | O campo Cliente (GU3_CLIEN) tem o valor fixo 1- Sim, pois os dados são carregados a partir da tabela de clientes do PROTHEUS. |
| Endereço (GU3_ENDER) | A1_END | O campo Endereço (GU3_ENDER) recebe o campo Endereço (A1_END). |
| Complemento (GU3_COMPL) | A1_COMPLEM | O campo Complemento (GU3_COMPL) recebe o campo Complemento (A1_COMPLEM). |
| Bairro (GU3_BAIRRO) | A1_BAIRRO | O campo Bairro (GU3_BAIRRO) recebe o campo Bairro (A1_BAIRRO). |
| CEP (GU3_CEP) | A1_CEP | O campo CEP (GU3_CEP) recebe o campo CEP (A1_CEP). |
| Número Cidade (GU3_NRCID) | Código IBGE do A1_EST + A1_COD_MUN | O campo Cidade (GU3_NRCID) recebe o valor do Código do Estado IBGE - utilizando o campo Estado (A1_EST) e a tabela do tópico 6. Tabela para obtenção do Código IBGE das Unidades de Federação para realizar a conversão e concatenar com o Código do Município IBGE (A1_COD_MUN). |
| Nome Cidade (GU3_NMCID) | Este campo é atualizado por meio da chave estrangeira com a tabela cidade (GU7). O relacionamento é feito por meio do campo código da Cidade (A1_NRCID). | |
| Identificação Federal (GU3_IDFED) | A1_CGC | O campo Identificação Federal (GU3_IDFED) recebe o valor do campo CNPJ/CPF (A1_CGC), quando o campo Tipo Cliente (A1_TIPO) for diferente de X - Exportação. |
| Inscrição Estadual (GU3_IE) | A1_INSCR | O campo Inscrição Estadual (GU3_IE) recebe o valor do campo Inscrição Estadual(A1_INSCR). |
| Inscrição Municipal (GU3_IM) | A1_INSCRM | O campo Inscrição Municipal (GU3_IM) recebe o valor do campo Inscrição Municipal (A1_INSCRM). |
| Caixa Postal (GU3_CXPOS) | A1_CXPOSTA | O campo Caixa Postal (GU3_CXPOS) recebe as dez primeiras posições do campo Caixa Postal (A1_CXPOSTA). |
| Email (GU3_EMAIL) | A1_EMAIL | O campo Email (GU3_EMAIL) recebe o valor do campo E-mail (A1_EMAIL). |
| Fone 1 (GU3_FONE1) | A1_TEL | O campo Fone 1 (GU3_FONE1) recebe o valor do campo Fone (A1_TEL). |
| Fax (GU3_FAX) | A1_FAX | O campo Fax (GU3_FAX) recebe o valor do campo Fax (A1_FAX). |
| WEB Site (GU3_WSITE) | A1_HPAGE | O campo WEB Site (GU3_WSITE) recebe o valor do campo Home Page (A1_HPAGE). |
| Código ERP (GU3_CDERP) | A1_COD | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá preencher o campo Código ERP (GU3_CDERP) com o valor do Código do Cliente (A1_COD) para efetuar o relacionamento entre os produtos. |
Cód Comp ERP (GU3_CDCERP) | A1_LOJA | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá preencher o campo Código Comp ERP (GU3_CDCERP) com o valor do Código da Loja (A1_LOJA) para efetuar o relacionamento entre os produtos. |
Cód Tran ERP (GU3_CDTERP) | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá preencher o campo Código Transportador ERP (GU3_CDTERP) com VAZIO. | |
Transportador?(GU3_TRANSP) | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá preencher o campo Transportador (GU3_TRANSP) com 2-Não. | |
Autônomo (GU3_AUTON) | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá preencher o campo Autônomo (GU3_AUTON) com 2-Não. |
Importante
Quando a integração com o GFE estiver ativa, o sistema deverá impedir:
- A Alteração do campo CNPJ/CPF (A1_CGC) e o Tipo do Cliente (Jurídico, Físico,Estrangeiro) - exceto se estiver em branco. Desta forma, evita uma inconsistência na identificação única do Emitente no GFE;
- A modificação do campo Tipo do Cliente (A1_TIPO), quando este for X=Estrangeiro;
- Não haverá tratamento para o campo Status (A1_MSBLQL), seu uso ficará restrito ao ERP.
9. Cadastro de Emitentes - Fornecedores - GFEA015 - Tabela GU3
A tabela Emitentes (GU3) recebe as informações dos Cadastros de Cliente (MATA030) – Tabela SA1, Cadastros de Fornecedores (MATA020) - Tabela SA2 e Cadastros de Transportador (MATA050) - Tabela SA4.
Neste momento, iremos descrever o processo de integração de Fornecedores
| Campo | Recebe | Observações |
|---|---|---|
| Código do Emitente (GU3_CDEMIT) | A2_CGC |
|
| Filial (GU3_FILIAL) | A2_FILIAL | O campo Filial (GU3_FILIAL) recebe a Filial (A2_FILIAL). |
| Nome do Emitente (GU3_NMEMIT) | A2_NOME | O campo Nome do Emitente (GU3_NMEMIT) recebe o Nome do Fornecedor (A2_NOME). |
| Nome Fantasia (GU3_NMFAN) | A2_NREDUZ | O campo Nome Fantasia (GU3_NMFAN) recebe o Nome Reduzido do Fornecedor (A2_NREDUZ). |
Natureza do Emitente (GU3_NATUR) | A2_TIPO | O campo Natureza Jurídica do Emitente (GU3_NATUR) recebe Pessoa Física/Jurídica (A2_TIPO). |
| Origem (GU3_ORIGEM) | 2-ERP | O Campo Origem (GU3_ORIGEM) recebe o valor fixo 2-ERP, pois o registro vem por meio da integração entre os produtos. |
| Situação (GU3_SIT) | A2_MSBLQL | O campo Situação (GU3_SIT) recebe o valor do campo Status (A2_MSBLQL). |
| Fornecedor? (GU3_FORN) | 1-SIM | O campo Fornecedor? (GU3_FORN) tem o valor fixo 1- Sim, pois os dados são carregados a partir da tabela de clientes do PROTHEUS. |
| Endereço (GU3_ENDER) | A2_END | O campo Endereço (GU3_ENDER) recebe o campo Endereço (A2_END). |
| Complemento (GU3_COMPL) | A2_COMPLEM | O campo Complemento (GU3_COMPL) recebe o campo Complemento (A2_COMPLEM). |
| Bairro (GU3_BAIRRO) | A2_BAIRRO | O campo Bairro (GU3_BAIRRO) recebe o campo Bairro (A2_BAIRRO). |
| CEP (GU3_CEP) | A2_CEP | O campo CEP (GU3_CEP) recebe o campo CEP (A2_CEP). |
| Número Cidade (GU3_NRCID) | Código IBGE do A2_EST + A2_COD_MUN | O campo Cidade (GU3_NRCID) recebe o valor do Código do Estado IBGE - utilizando o campo Estado (A2_EST) e a tabela do tópico 6. Tabela para obtenção do Código IBGE das Unidades de Federação para realizar a conversão e concatenar com o Código do Município IBGE (A2_COD_MUN). |
| Nome Cidade (GU3_NMCID) | Este campo é atualizado por meio da chave estrangeira com a tabela cidade (GU7). O relacionamento é feito por meio do campo código da Cidade (A2_NRCID). | |
| Identificação Federal (GU3_IDFED) | A2_CGC | O campo Identificação Federal (GU3_IDFED) recebe o valor do campo CNPJ/CPF (A2_CGC), quando o campo Tipo Cliente (A2_TIPO) for diferente de X - Exportação. |
| Inscrição Estadual (GU3_IE) | A2_INSCR | O campo Inscrição Estadual (GU3_IE) recebe o valor do campo Inscrição Estadual (A2_INSCR). |
| Inscrição Municipal (GU3_IM) | A2_INSCRM | O campo Inscrição Municipal (GU3_IM) recebe o valor do campo Inscrição Municipal (A2_INSCRM). |
| Caixa Postal (GU3_CXPOS) | A2_CXPOST | O campo Caixa Postal (GU3_CXPOS) recebe as dez primeiras posições do campo Caixa Postal (A2_CXPOST). |
| Email (GU3_EMAIL) | A2_EMAIL | O campo Email (GU3_EMAIL) recebe o valor do campo E-mail (A2_EMAIL). |
| Fone 1 (GU3_FONE1) | A2_TEL | O campo Fone 1 (GU3_FONE1) recebe as quinze primeiras posições do campo Fone (A2_TEL). |
| Fax (GU3_FAX) | A2_FAX | O campo Fax (GU3_FAX) recebe o valor do campo Fax (A2_FAX). |
| WEB Site (GU3_WSITE) | A2_HPAGE | O campo WEB Site (GU3_WSITE) recebe o valor do campo Home Page (A2_HPAGE). |
| (GU3_CONICM) | A2_CONTRIB | O campo (GU3_CONICM) recebe o valor do campo Contribuinte do ICMS (A2_CONTRIB). |
| (GU3_TPTRIB) | A2_SIMPNAC | O campo (GU3_TPTRIB) recebe o valor do campo Optante Simples Nacional (A2_SIMPNAC). |
| Código ERP (GU3_CDERP) | A2_COD | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá preencher o campo Código ERP (GU3_CDERP), com o valor do campo Código do Fornecedor (A2_COD) para efetuar o relacionamento entre os produtos. |
Cód Comp ERP (GU3_CDCERP) | A2_LOJA | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá preencher o campo Código Comp ERP (GU3_CDCERP) com o valor do campo Código da Loja (A2_LOJA) para efetuar o relacionamento entre os produtos. |
Cód Tran ERP (GU3_CDTERP) | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá validar as informações do campo CNPJ/CPF (A2_CGC) contra o Cadastro de Transportador (MATA050), caso encontre o registro, irá trazer o Código do Transportador (A4_COD). | |
Transportador? (GU3_TRANSP) | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá validar as informações do campo CNPJ/CPF (A2_CGC) contra o Cadastro de Transportador (MATA050), caso encontre o registro, irá verificar se o campo Tipo do Transportador (A4_TPTRANS) é diferente de 3 - Autônomo . Se não encontrar o registro, irá verificar se o campo Pagamento pelo SIGAGFE (A2_PAGGFE) é 1 - Sim e o Tipo do Fornecedor (A2_TIPO) é J - JURÍDICO, em caso afirmativo, atualizará o campo Transportador? (GU3_TRANSP) com 1 - Sim. | |
Autônomo? (GU3_AUTON) | Quando o parâmetro Código do Emitente (MV_EMITMP) estiver definido como 1 - Numeração Própria, o sistema irá validar as informações do campo CNPJ/CPF (A2_CGC) contra o Cadastro de Transportador (MATA050), caso encontre o registro, irá verificar se o campo Tipo do Transportador (A4_TPTRANS) é igual a 3 - Autônomo. Se não encontrar o registro, irá verificar se o campo Pagamento pelo SIGAGFE (A2_PAGGFE) é 1 - Sim e o Tipo do Fornecedor (A2_TIPO) é F - FÍSICA, em caso afirmativo, atualizará o campo Autônomo? (GU3_AUTON) com 1 - Sim. |
Importante
Quando a integração com o GFE estiver ativa, o sistema deverá impedir:
- A Alteração do campo CNPJ/CPF (A2_CGC) e o Tipo do Cliente (Jurídico, Físico,Estrangeiro) - exceto se estiver em branco, Desta forma, evita uma inconsistência na identificação única do Emitente no GFE;
- A modificação do campo Tipo do Cliente (A2_TIPO), quando este for X=Estrangeiro;
- Não haverá tratamento para o campo Status (A2_MSBLQL), seu uso ficará restrito ao ERP.
10. Cadastro de Emitentes - Transportadores - GFEA015 - Tabela GU3
A tabela Emitentes (GU3) recebe as informações dos Cadastros de Cliente (MATA030) – Tabela SA1, Cadastros de Fornecedores (MATA020) - Tabela SA2 e Cadastros de Transportador (MATA050) - Tabela SA4.
Neste momento, iremos descrever o processo de integração de Transportadores.
| Campo | Recebe | Observações |
|---|---|---|
| Código do Emitente (GU3_CDEMIT) | A4_CGC | O campo Código do Emitente (GU3_CDEMIT) recebe o valor do Código do Fornecedor (A4_COD), quando o Estado do Fornecedor (A4_EST) for igual EX - Exportação. Caso contrario, recebe o valor do campo CNPJ/CPF (A4_CGC). |
| Filial (GU3_FILIAL) | A4_FILIAL | O campo Filial (GU3_FILIAL) recebe a Filial (A4_FILIAL). |
| Nome do Emitente (GU3_NMEMIT) | A4_NOME | O campo Nome do Emitente (GU3_NMEMIT) recebe o Nome do Fornecedor (A4_NOME). |
| Nome Fantasia (GU3_NMFAN) | A4_NREDUZ | O campo Nome Fantasia (GU3_NMFAN) recebe o Nome Reduzido do Fornecedor (A4_NREDUZ). |
Natureza do Emitente (GU3_NATUR) | A4_TPTRANS | Quando o Tipo da Transportadora (A4_TPTRANS) for igual a 3 - Autônomo, o campo Natureza Jurídica do Emitente (GU3_NATUR) recebe o valor F - FÍSICA, caso contrario, recebe o valor J - JURÍDICA. |
| Origem (GU3_ORIGEM) | 2-ERP | O campo Origem (GU3_ORIGEM) recebe o valor fixo 2-ERP, pois o registro vem por meio da integração entre os produtos. |
| Situação (GU3_SIT) | A4_MSBLQL | O campo Situação (GU3_SIT) recebe o valor do campo Status (A4_MSBLQL). |
| Endereço (GU3_ENDER) | A4_END | O campo Endereço (GU3_ENDER) recebe o campo Endereço (A4_END). |
| Complemento (GU3_COMPL) | A4_COMPLEM | O campo Complemento (GU3_COMPL) recebe o campo Complemento (A4_COMPLEM). |
| Bairro (GU3_BAIRRO) | A4_BAIRRO | O campo Bairro (GU3_BAIRRO) recebe o campo Bairro (A4_BAIRRO). |
| CEP (GU3_CEP) | A4_CEP | O campo CEP (GU3_CEP) recebe o campo CEP (A4_CEP). |
| Número Cidade (GU3_NRCID) | Código IBGE do A4_EST + A4_COD_MUN | O campo Cidade (GU3_NRCID) recebe o valor do Código do Estado IBGE - utilizando o campo Estado (A4_EST) e a tabela do tópico 6. Tabela para obtenção do Código IBGE das Unidades de Federação para realizar a conversão e concatenar com o Código do Município IBGE (A4_COD_MUN). |
| Nome Cidade (GU3_NMCID) | Este campo é atualizado por meio da chave estrangeira com a tabela cidade (GU7). O relacionamento é realizado por meio do campo código da Cidade (A4_NRCID). | |
| UF (GU3_UF) | A4_EST | O campo UF (GU3_UF) recebe o campo Estado (A4_EST). |
| Identificação Federal (GU3_IDFED) | A4_CGC | O campo Identificação Federal (GU3_IDFED) recebe o valor do campo CNPJ/CPF (A4_CGC). |
| Inscrição Estadual (GU3_IE) | A4_INSEST | O campo Inscrição Estadual (GU3_IE) recebe o valor do campo Inscrição Estadual (A4_INSCR). |
| Email (GU3_EMAIL) | A4_EMAIL | O campo Email (GU3_EMAIL) recebe o valor do campo E-mail (A4_EMAIL). |
| Fone 1 (GU3_FONE1) | A4_TEL | O campo Fone 1 (GU3_FONE1) recebe o valor do campo Fone (A4_TEL). |
| WEB Site (GU3_WSITE) | A4_HPAGE | O campo WEB Site (GU3_WSITE) recebe o valor do campo Home Page (A4_HPAGE). |
11. Cadastro de Centros de Custos (GFEA089 ) - Tabela GUH
A tabela de Centro de Custo (GUH) recebe os dados do Cadastro de Centro de Custos (CTBA030) - Tabela CTT)
| Campo | Recebe | Observações |
|---|---|---|
| Filial (GUH_FILIAL) | CTT_FILIAL | O campo Filial (GUH_FILIAL) recebe o valor do campo Filial (CTT_FILIAL). |
| Centro de Custo (GUH_CCUSTO) | CTT_CUSTO | O campo Centro de Custo (GUH_CCUSTO) recebe o valor do campo Centro de Custo (CTT_CUSTO). |
| Descrição (GUH_DESC) | CTT_DESC01 | O campo Descrição (GUH_DESC), recebe o valor do campo Descrição (CTT_DESC01). |
| Situação (GUH_SIT) | 1=ATIVO | O valor padrão para o campo Situação (GUH_SIT) é 1 - Ativo. Quando efetuada a eliminação do registro na tela Cadastro de Centro de Custo (CTBA030), o programa atualiza o valor do campo Situação (GUH_SIT) automaticamente para 2 - Inativo. |
12. Cadastro de Contas Contábeis (GFEA090) - Tabela GUE
A tabela Conta Contábil (GUE) recebe os dados do Cadastro de Contas Contábeis (CTBA020) – Tabela CT1
| Campo | Recebe | Observações |
|---|---|---|
| Filial (GUE_FILIAL) | CT1_FILIAL | O campo Filial (GUE_FILIAL) recebe o valor do campo Filial (CT1_FILIAL). |
| Conta Contábil (GUE_CTACTB) | CT1_CONTA | O campo Conta Contábil (GUE_CTACTB) recebe o valor do campo Código da Conta (CT1_CONTA). |
| Título (GUE_TITULO) | CT1_DESC01 | O campo Título (GUE_TITULO) recebe o valor do campo Descrição na Moeda 1 (CT1_DESC01). |
| Situação (GUE_SIT) | 1=ATIVO | O valor padrão para o campo Situação (GUE_SIT) é 1 - Ativo. Quando efetuada a eliminação do registro na tela Cadastro de Contas Contábeis (CTBA020), o programa atualiza o valor do campo Situação (GUE_SIT) automaticamente para 2 - Inativo. |
13. Cadastro de Motoristas/Ajudantes (GFEA012) - Tabela GUU
A tabela Motorista(GUU) recebe os dados do Cadastro de Motoristas (OMSA040) – Tabela DA4
| Campo | Recebe | Observações |
|---|---|---|
| FiIlial (GUU_FILIAL) | DA4_FILIAL | O campo Filial (GUU_FILIAL) recebe o valor do campo Filial (DA4_FILAIL). |
| Código Motorista/Ajudante (GUU_CDMTR) | DA4_COD | O campo Código Motorista/Ajudante (GUU_CDMTR) recebe o valor do campo Motorista (DA4_COD). |
| Nome (GUU_NMMTR) | DA4_NOME | O campo Nome (GUU_NMMTR) recebe o valor do campo Motorista (DA4_NOME). |
| Pseudônimo/Apelido (GUU_PSEUD) | DA4_NREDUZ | O campo Pseudônimo/Apelido (GUU_PSEUD) recebe o valor do campo Nome Reduzido (DA4_NREDUZ). |
| Tipo (GUU_TPMTR) | 1=MOTORISTA | Atribuir o valor fixo 1 -Motorista para o campo Tipo (GUU_TPMTR) apenas quando inclusão. |
| CPF (GUU_IDFED) | DA4_CGC | O campo CPF (GUU_IDFED) recebe o valor do campo CPF (DA4_CGC). |
| RG (GUU_RG) | DA4_RG | O campo RG (GUU_RG) recebe o valor do campo RG (DA4_RG). |
| Órgão Expedidor (GUU_ORGEXP) | DA4_RGORG | O campo Órgão Expedidor (GUU_ORGEXP) recebe o valor do campo Órgão Emissor (DA4_RGORG). |
| Número da CNH (GUU_NUMCNH) | DA4_NUMCNH | O campo Número da CNH (GUU_NUMCNH) recebe o valor do campo Número da CNH (DA4_NUMCNH). |
| Registro da CNH (GUU_REGCNH) | DA4_REGCNH | O campo Registro da CNH (GUU_REGCNH)) recebe o valor do campo Registro da CNH (DA4_REGCNH). |
| Data Expedição CNH (GUU_DTECNH) | DA4_DTECNH | O campo Data Expedição CNH (GUU_DTECNH) recebe o valor do campo Data Expedição CNH (DA4_DTECNH). |
| Data Vencimento CNH (GUU_DTVCNH) | DA4_DTVCNH | O campo Data Vencimento CNH (GUU_DTVCNH) recebe o valor do campo Data Vencimento CNH (DA4_DTVCNH). |
| Município da CNH (GUU_MUNCNH) | DA4_MUNCNH | O campo Município da CNH (GUU_MUNCNH) recebe o valor do campo Município da CNH (DA4_MUNCNH). |
| Estado CNH (GUU_ESTCNH) | DA4_ESTCNH | O campo Estado CNH (GUU_ESTCNH) recebe o valor do campo Estado CNH (DA4_ESTCNH). |
| Categoria CNH (GUU_CATCNH) | DA4_CATCNH | O campo Categoria CNH (GUU_CATCNH) recebe o valor do campo Categoria CNH (DA4_CATCNH). |
| MOPP (GUU_MOPP) | DA4_CARPER | O campo MOPP (GUU_MOPP) recebe o valor do campo MOPP (DA4_CARPER). |
| Situação Motorista/Ajudante (GUU_SIT) | 1- ATIVO | O campo Situação Motorista/Ajudante (GUU_SIT) recebe o valor do campo Bloqueado (DA4_BLQMOT). Na operação de eliminação da DUT, atribuir 2 - INATIVO. |
14. Cadastro de Veículos (GFEA046) - Tabela GU8
A tabela Veículos (GU8) recebe os dados do Cadastro de Veículos (OMSA060) – Tabela DA3
| Campo | Recebe | Observações |
|---|---|---|
| Filial (GU8_FILIAL) | DA3_FILIAL | O campo Filial (GU8_FILIAL) recebe o valor do campo Filial (DA3_FILIAL). |
| Código Veículo (GU8_CDVEIC) | DA3_COD | O campo Código Veículo (GU8_CDVEIC) recebe o valor do campo Veículo (DA3_COD). |
| Tipo Veículo (GU8_CDTPVC) | DA3_TIPVEI | O campo Tipo Veículo (GU8_CDTPVC) recebe o valor do campo Tipo Veículo (DA3_TIPVEI). |
| Placa Veículo (GU8_PLACA) | DA3_PLACA | O campo Placa Veículo (GU8_PLACA) recebe o valor do campo Placa (DA3_PLACA). |
| UF Placa (GU8_UFPLAC) | DA3_ESTPLA | O campo UF Placa (GU8_UFPLAC) recebe o valor do campo Estado Placa (DA3_ESTPLA). |
| Proprietário Veículo (GU8_CDPROP) | DA3_CGCFOR | É utilizado o valor do campo Proprietário Veículo (DA3_CGCFOR), para realizar a pesquisa na tabela Fornecedor (SA2), retornando o CGC/CPF (A2_CGC) do fornecedor e pesquisando na Tabela (GU3). Após a pesquisa, será retornado o Código de Emitente (GU3_CDEMIT) para o campo Proprietário Veículo (GU8_CDPROP). |
| Tipo Proprietário (GU8_TPPROP) | DA3_FROVEI | O campo Tipo Proprietário (GU8_TPPROP) recebe o valor do campo Frota Veiculo (DA3_FROVEI). Quando o campo Frota Veículo (DA3_FROVEI) for 1 - PRÓPRIA, atribuir 2 - PRÓPRIO para o Tipo Proprietário (GU8_TPPROP) e quando o valor Frota Veiculo (DA3_FROVEI) for 2 - TERCEIRO ou 3 - AGREGADO, atribuir 1 - TERCEIRO para Tipo Proprietário (GU8_TPPROP). |
| Altura (GU8_ALTUR) | DA3_ALTEXT | O campo Altura (GU8_ALTUR) recebe o valor do campo Altura Externa (DA3_ALTEXT). |
| Largura (GU8_LARGUR) | DA3_LAREXT | O campo Largura (GU8_LARGUR) recebe o valor do campo Largura Externa (DA3_LAREXT). |
| Comprimento (GU8_COMPRI) | DA3_COMEXT | O campo Comprimento (GU8_COMPRI) recebe o valor do campo Comprimento Externa (DA3_COMEXT). |
| Volume Útil (GU8_VOLUT) | DA3_VOLMAX | O campo Volume Útil (GU8_VOLUT) recebe o valor do campo Volume Máximo (DA3_VOLMAX). |
| Carga Útil (GU8_CARGUT) | DA3_CAPACM | O campo Carga Útil (GU8_CARGUT) recebe o valor do campo Capacidade Máxima (DA3_CAPACM). |
| Peso Bruto Total (GU8_PBT) | DA3_CAPACN | O campo Peso Bruto Total (GU8_PBT) recebe o valor do campo Capacidade Normal (DA3_CAPACN). |
| Tara (GU8_TARA) | DA3_TARA | O campo Tara (GU8_TARA) recebe o valor do campo Tara (DA3_TARA). |
| Marca/Modelo Veículo (GU8_MMOD) | DA3_DESC | O campo Marca/Modelo Veículo (GU8_MMOD) recebe o valor do campo Modelo Veículo (DA3_DESC). |
| Ano Fabricação (GU8_ANOFAB) | DA3_ANOFAB | O campo Ano Fabricação (GU8_ANOFAB) recebe o valor do campo Ano Fabricação (DA3_ANOFAB). |
| Código Renavan (GU8_RENAVA) | DA3_RENAVA | O campo Código Renavan (GU8_RENAVA) recebe o valor do campo Código Renavan (GU8_RENAVA). |
| Certificado de Inspeção Veicular (CIV) (GU8_CIV) | DA3_CIV | O campo Certificado de Inspeção Veicular (CIV) (GU8_CIV) recebe o valor do campo Certificado de Inspeção Veicular (CIV) (DA3_CIV). |
| Certificado de Inspeção para Transporte de Produto Perigoso (CIPP) (GU8_CIPP) | DA3_CIPP | O campo Certificado de Inspeção para Transporte de Produto Perigoso (CIPP) (GU8_CIPP) recebe o valor do campo Certificado de Inspeção para Transporte de Produto Perigoso (CIPP) (DA3_CIPP). |
| Situação (GU8_SIT) | DA3_ATIVO | O campo Situação (GU8_SIT) recebe o valor do campo Veículo Ativo (DA3_ATIVO). Na operação de eliminação do veículo, atribuir para o campo Situação (GU8_SIT) 2 - INATIVO. |
15. Cadastro de Tipos de Veículos (GFEA0 ) - Tabela GV3
A tabela tipo de Veículos (GV3) recebe os dados do Cadastro de Tipos de Veículos (TMSA530) – Tabela DUT
| Campo | Recebe | Observações |
|---|---|---|
| Filial (GV3_FILIAL) | DUT_FILIAL | O campo Filial (GV3_FILIAL) recebe o valor do campo Filial (DUT_FILIAL). |
| Tipo Veículo (GV3_CDTPVC) | DUT_TIPVEI | O campo Tipo Veículo (GV3_CDTPVC) recebe o valor do campo Tipo Veículo (DUT_TIPVEI). |
| Descrição (GV3_DSTPVC) | DUT_DESCRI | O campo Descrição (GV3_DSTPVC) recebe o valor do campo Descrição (DUT_DESCRI). |
| Situação (GV3_SIT) | 1 - ATIVO | O campo Situação (GV3_SIT) recebe o valor fixo 1- ATIVO. Na operação de eliminação do Tipo de Veículo (DUT), atribuir 2 - INATIVO. |
16. Notas Fiscais de Saída (MATA460 – tabelas SF2, SD2)
Cabeçalho do Documento de Carga
| Campo | Recebe | Observações |
|---|---|---|
Código Tipo Documento (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. |
| Emissor do Documento (GW1_EMISDC) | A1_CGC | |
| Série do Documento (GW1_SERDC) | F2_SERIE | |
| Número do Documento (GW1_NRDC) | F2_DOC | |
| Data de Emissão (GW1_DTEMIS) | F2_EMISSAO | |
| Origem (GW1_ORIGEM) | “2=ERP” | |
| Remetente (GW1_CDREM) | A1_CGC | |
| Destinatário (GW1_CDDEST) | A2_CGC | Quando F2_TIPO diferente de B e D, atribuir A1_CGC. |
| Situação Faturamento (GW1_SIT) | “3=LIBERADO” | |
| Espécie (GW1_DSESP) | F2_ESPECIE | |
| Data de Liberação (GW1_DTLIB) | dDATA | |
| Hora da Liberação (GW1_HRLIB) | TIME() | |
| Número do Docto de Origem (GW1_ORINR) | F2_NFORI | |
| Série Documento de Origem (GW1_ORISER) | F2_SERIORI | |
| Número do Romaneio (GW1_NRROM) | F2_CARGA + F2_SEQCAR | Concatenar os dois campos. |
| Mercadoria com ICMS?(GW1_ICMSDC) | “1=SIM” | Quando F2_VALICM = 0 atribuir 2 - NÃO. |
| Tipo de Frete (GW1_TPFRET) | Quando F2_TPFRETE = C - CIF, atribuir: Quando F2_TPFRETE = F - FOB, atribuir: | |
| Situação Doc. SEFAZ (GW1_AUTSEF) | Se F2_FIMP não-preenchido atribuir 0 - Não informado. Se F2_FIMP “T=transmitida”, atribuir 0 - Não informado. Se F2_FIMP “S=NF Autorizada”, atribuir 1 - Autorizado. Se F2_FIMP “D=NF Uso Denegado”, atribuir 2 - Não-autorizado. Se F2_FIMP “N=NF Não-autorizada”, atribuir 2 - Não-autorizado. | |
| Chave de validação NF-e (GW1_DANFE) | F2_CHVFE |
Itens do Documento de Carga
| Tipo de Documento (GW8_CDTPDC) | GW1_CDTPDC | |
| Emissor do Documento (GW8_EMISDC) | GW1_EMISDC | |
| Série do Documento (GW8_SERDC) | GW1_SERDC | |
| Número do Documento (GW8_NRDC) | GW1_NRDC | |
| Sequência (GW8_SEQ) | D2_ITEM | |
| Item (GW8_ITEM) | D2_COD | |
| Descrição do Item (GW8_DSITEM) | D2_DESCRI | |
| Quantidade do Item (GW8_QTDE) | D2_QUANT | |
| Valor do Item (GW8_VALOR) | D2_VALBRUT | |
| Volume em m3 (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). |
| Peso Real (GW8_PESOR) | D2_PBRUTO | |
| Quantidade ou Peso Altern (GW8_QTDALT) | D2_PESO | |
| Informação Contábil 1 (GW8_INFO1) | D2_TP | |
| Informação Contábil 2 (GW8_INFO2) | D2_GRUPO | |
| Informação Contábil 3 (GW8_INFO3) | D2_TES | |
| Informação Contábil 4 (GW8_INFO4) | D2_CLVL | |
| Informação Contábil 5 (GW8_INFO5) | D2_CCUSTO | |
| Valor Líquido (GW8_VLLIQ) | D2_TOTAL |
Trecho do 1º Redespacho (Transportador Redespachante)
Criar quando F2_CGCRDP preenchido
| Tipo do Documento (GWU_CDTPDC) | GW1_CDTPDC | |
| Emissor do Documento (GWU_EMISDC) | GW1_EMISDC | |
| Série do Documento (GWU_SERDC) | GW1_SERDC | |
| Número do Documento (GWU_NRDC) | GW1_NRDC | |
| Sequência do trecho (GWU_SEQ) | 02 | |
| Transportador (GWU_CDTRP) | F2_CGCRDP | FIELDREL_2 |
| Número Cidade Destino (GWU_NRCIDD) | A2_CDIBGE | Quando F2_CGCRDP preenchido, atribuir A4_CDIBGE |
| Trecho pago (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.
17. 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 escolhida no parâmetro Impede Faturamento? (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.
18. Montagem de Cargas (OMSA200 – tabela DAK)
| Campo | Recebe | Observações |
|---|---|---|
| Número do Romaneio (GWN_NRROM) | DAK_COD e DAK_SEQCAR | Concatenar os campos. |
| Tipo de Operação (GWN_CDTPOP) | MV_CDTPOP | |
| Classificação de Frete (GWN_CDCLFR) | DAK_CDCLFR | |
| Transportador (GWN_CDTRP) | DAK_CGCTRA | |
| Código do Motorista (GWN_CDMTR) | DAK_MOTORI | |
| Tipo de Veículo (GWN_CDTPVC) | DAK_ CDTPVC | |
| Placa Veiculo Dianteiro (GWN_PLACAD) | DAK_PLACA | |
| Placa Veículo Meio (GWN_PLACAM) | DAK_VEIC2 | |
| Placa Veículo Traseira (GWN_PLACAT) | DAK_VEIC3 | |
| Data da Criação Romaneio (GWN_DTIMPL) | DAK_DATA | |
| Horário Criação Romaneio (GWN_HRIMPL) | DAK_HORA | |
| Origem (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.
19. Manutenção de Documentos de Entrada (MATA103 – tabelas SF1, SD1)
| Campo | Recebe | Observações |
|---|---|---|
| Cabeçalho do Documento de Carga | ||
| Código Tipo Documento (GW1_CDTPDC) | X5_DESCRI | Concatenar o campo F1_TIPO à 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. |
| Emissor do Documento (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”. |
| Série do Documento (GW1_SERDC) | F1_SERIE | |
| Número do Documento (GW1_NRDC) | F1_DOC | |
| Data de Emissão (GW1_DTEMIS) | F1_EMISSAO | |
| Origem (GW1_ORIGEM) | “2=ERP” | |
| Remetente (GW1_CDREM) | A2_CGC | Quando F1_TIPO = “D”, atribuir A1_CGC |
| Destinatário (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”. |
| Situação Faturamento (GW1_SIT) | “3=LIBERADO” | |
| Espécie (GW1_DSESP) | F1_ESPECIE | |
| Data de Liberação (GW1_DTLIB) | dDATA | |
| Hora da Liberação (GW1_HRLIB) | TIME() | |
| Número do Romaneio (GW1_NRROM) | F1_CARGA + F1_SEQCAR | Concatenar os dois campos. |
| Mercadoria com ICMS?(GW1_ICMSDC) | “1=SIM” | Quando F1_VALICM = 0, atribuir 2 - NÃO. |
| Quantidade de Volumes (GW1_QTVOL) | F1_VOLUME1 | |
| Tipo de Frete (GW1_TPFRET) | “3=FOB” | Quando F1_TPFRETE = “C=CIF”, atribuir 1 - CIF. |
| Itens do Documento de Carga | ||
| Tipo de Documento (GW8_CDTPDC) | GW1_CDTPDC | |
| *Emissor do Documento (GW8_EMISDC) | GW1_EMISDC | |
| Série do Documento (GW8_SERDC) | GW1_SERDC | |
| Número do Documento (GW8_NRDC) | GW1_NRDC | |
| Sequência (GW8_SEQ) | D1_ITEM | |
| Item (GW8_ITEM) | D1_COD | |
| Descrição do item (GW8_DSITEM) | D1_DESCRI | |
| Quantidade do item (GW8_QTDE) | D1_QUANT | |
| Valor do item (GW8_VALOR) | D1_TOTAL | |
| Volume em m3 (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). |
| Peso Real (GW8_PESOR) | D1_PBRUTO | |
| Quantidade ou Peso Altern (GW8_QTDALT) | D1_PESO | |
| Define item como um ativo (GW8_ATUATF) | D1_ATUATF | |
| Trecho do Despacho (Transportador Principal) Criar sempre | ||
| Tipo do Documento (GWU_CDTPDC) | GW1_CDTPDC | |
| Emissor do Documento (GWU_EMISDC) | GW1_EMISDC | |
| Série do Documento (GWU_SERDC) | GW1_SERDC | |
| Número do Documento (GWU_NRDC) | GW1_NRDC | |
| Sequência do trecho (GWU_SEQ) | 01 | |
| Transportador (GWU_CDTRP) | F1_CGCTRP | |
| Número Cidade Destino (GWU_NRCIDD) | A1_CDIBGE | |
| Trecho pago (GWU_PAGAR) | “1=SIM” | Quando F1_TPFRETE <> “F=FOB”,atribuir 2 - NÃO. |
20. 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 GFE Ativo (MV_INTGFE) e Modo Integração (MV_INTGFE2) não estiverem parametrizados para integração direta entre o ERP e o SIGAGFE, será emitida mensagem de inconsistência, informando o usuário das condições necessárias e impedindo a execução da rotina.
21. Integração de Pré-faturas como Título a Pagar (GFEA055 – tabelas GWJ, GWK)
| Campo | Recebe | Observações |
|---|---|---|
| Título a Pagar | ||
| Prefixo do Título (E2_PREFIXO) | “” | |
| Número do Título (E2_NUM) | GWJ_NRPF | |
| Parcela do Título (E2_PARCELA) | “1” | |
| Tipo do Título (E2_TIPO) | “PR” | |
| Código da Natureza (E2_NATUREZ) | MV_NTFGFE | |
| Data de Emissão do Titulo (E2_EMISSAO) | GWJ_DTIMPL | |
| Vencimento do Título (E2_VENCTO) | GWJ_DTVCTO | |
| Vencimento real do Título (E2_VENCREA) | GWJ_DTVCTO | |
| Valor do Título (E2_VALOR) | GWJ_VLPF | |
| Valor na Moeda Nacional (E2_VLCRUZ) | GWJ_VLPF | |
| E2_CGCFOR | GWJ_CDTRP | |
| Origem do Título (E2_ORIGEM) | “TOTVSGFE” | |
| Rateio Contábil | Criar 1 para cada registro da GWK com GWK_LANCTO = “1=DB” | |
| Conta Contábil Débito (CTJ_DEBITO) | GWK_CTACTB | |
| Valor Ratear (CTJ_VALOR) | GWK_VLMOV | |
| Centro de Custo Débito (CTJ_CCD) | GWK_CCUSTO | |
22. Integração de Faturas como Título a Pagar (GFEA070 – tabelas GW6, GW7, GWJ)
| Campo | Recebe | Observações |
|---|---|---|
| Título a Pagar | ||
| Prefixo do Título (E2_PREFIXO) | GW6_SERFAT | |
| Numero do Borderô (E2_NUM) | GW6_NRFAT | |
| Parcela do Título (E2_PARCELA) | “1” | |
| Tipo do Título (E2_TIPO) | “FT” | |
| Código da Natureza (E2_NATUREZ) | MV_NTFGFE | |
| Data de Emissão do Titulo (E2_EMISSAO) | GW6_DTEMIS | |
| Vencimento do Título (E2_VENCTO) | GW6_DTVENC | |
| Vencimento Real do Título (E2_VENCREA) | GW6_DTVENC | |
| Valor do Título (E2_VALOR) | GW6_VLFATU | |
| Valor na Moeda Nacional (E2_VLCRUZ) | GW6_VLFATU | |
| Código do Fornecedor (E2_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW6_EMIFAT. Quando não localizar A2 ou A2_CGC em branco, atribuir GW6_EMIFAT. |
| Loja do Fornecedor (E2_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW6_EMIFAT. Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Taxa permanência diária (E2_VLJURO) | GW6_VLJURO | |
| Valor de Decréscimo (E2_DECRESC) | GW6_VLDESC | |
| Origem do Título (E2_ORIGEM) | “TOTVSGFE” | |
| Valor do ISS (E2_ISS) | GW6_VLISRE | |
| Rateio Contábil | Criar para cada registro da GW7 com GW7_LANCTO = “1=DB”. | |
| Conta Contábil Debito (CTJ_DEBITO) | GW7_CTACTB | |
| Valor Ratear (CTJ_VALOR) | GW7_VLMOV | |
| Centro de Custo Débito (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” | |
Importante
Quando houver Pré-Fatura relacionada na Fatura e esta será baixada no momento da atualização com o Financeiro, é imprescindível que o usuário tenha acesso a operação 23-Substituição de Títulos, no cadastro de acessos do usuário e/ou grupo de usuários.
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. |
23. 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. |
Integrações do GFE com PROTHEUS
24. Parâmetros do Módulo (GFEX000)
No programa Parâmetros do Módulo (GFEX000), disponibilizar na pasta Integrações Protheus, os seguintes parâmetros: GFE Ativo (MV_INTGFE), Modo Integração (MV_INTGFE2), Impede Faturamento? (MV_FATGFE), Natureza Título a Pagar (MV_NTFGFE), Cond. Pagto. Padrão (MV_CPDGFE) e Tipo Operação Padrão (MV_CDTPOP), com opções definidas em forma de lista para seleção (combo-box).
No programa Parâmetros do Módulo (GFEX000), na pasta Integrações Protheus na seção SIGACOM foi criado o parâmetro TES Doc. Frete (MV_TESGFE), com as opções: Atribuído Sistema (Padrão) e Informado Usuário. Na opção Atribuído Sistema, após a digitação do documento, o campo será automaticamente preenchido com a informação da TES inteligente, conforme já realizado hoje no GFE.
Na opção Informado Usuário, o campo TES deverá ser preenchido manualmente, porém, será sugerida a TES vinculada ao produto (campo TE Padrão). Caso a integração automática estiver ativa, será utilizado o TES do produto.
Depois do retorno da função usada para integração, gravar os seguintes campos:
| Campo | Recebe | Observações |
|---|---|---|
| Título a Pagar | ||
| Prefixo do Titulo (E2_PREFIXO) | “” | |
| Número do Título (E2_NUM) | GW2_NRCONT | |
| Parcela do Titulo (E2_PARCELA) | “1” | |
| Tipo do Título (E2_TIPO) | “RPA” | |
| Código da Natureza (E2_NATUREZ) | MV_NTFGFE | |
| Data de Emissão do Titulo (E2_EMISSAO) | GW2_DTCRIA | |
| Vencimento do Título (E2_VENCTO) | GW2_DTVENC | |
| Vencimento real do Título (E2_VENCREA) | GW2_DTVENC | |
| Valor do Título (E2_VALOR) | GW2_VLFRET | |
| Valor na Moeda Nacional (E2_VLCRUZ) | GW2_VLFRET | |
| Código do Fornecedor (E2_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW2_CDPROP. Quando não localizar A2 ou A2_CGC em branco, atribuir GW2_CDPROP. |
| Loja do Fornecedor (E2_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW2_CDPROP. Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Origem do Título (E2_ORIGEM) | “TOTVSGFE” | |
| Valor do ISS (E2_ISS) | GW2_VLISS | |
| Valor do INSS (E2_INSS) | GW2_VLINSS | |
| Valor do IRRF (E2_IRRF) | GW2_VLIRRF | |
| SEST/SENAT (E2_SEST) | GW2_VLSEST | |
| Rateio Contábil | Criar para cada registro da GW9 com GW9_LANCTO = “1=DB”. | |
| Conta Contábil Debito (CTJ_DEBITO) | GW9_CTACTB | |
| Valor Ratear (CTJ_VALOR) | GW9_VLMOV | |
| Centro de Custo Débito (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. |
25. Integração de Documentos de Frete como Documento de Entrada (GFEA065 – tabela GW3)
| Campo | Recebe | Observações |
|---|---|---|
| Documento de Entrada | ||
| Número do Documento (F1_DOC) | GW3_NRDF | |
| Série do Documento (F1_SERIE) | GW3_SERDF | |
| Código do Fornecedor (F1_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW3_EMISDF. Quando não localizar A2 ou A2_CGC em branco, atribuir GW3_EMISDF. |
| Loja do Fornecedor (F1_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW3_EMISDF. Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Data de Emissão da NF (F1_EMISSAO) | GW3_DTEMIS | |
| Código da Condic. de Pgto (F1_COND) | MV_CPDGFE | |
| Nota/Consumidor/Ticket (F1_TIPO) | “N=NORMAL” | |
| Formulário Próprio (F1_FORMUL) | “N=NÃO” | |
| Espécie do Documento (F1_ESPECIE) | GW3_CDESP | |
| Estado de Emissão da NF (F1_EST) | GU3_UF | Localizar GU3 com GU3_CDEMIT = GW3_CDDEST. |
| Data de Recebimento (F1_RECBMTO) | GW3_DTFIS | |
| Chave da NFe SEFAZ (F1_CHVNFE) | GW3_CTE | |
| Item do Documento de Entrada | Criar sempre (apenas 1 registro) | |
| Numero do Documento/Nota (D1_DOC) | GW3_NRDF | |
| Serie da Nota Fiscal (D1_SERIE) | GW3_SERDF | |
| Código do Forn/Cliente (D1_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW3_EMISDF. Quando não localizar A2 ou A2_CGC em branco, atribuir GW3_EMISDF. |
| Loja do Forn/Cliente (D1_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW3_EMISDF. Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Data de Emissão (D1_EMISSAO) | GW3_DTEMIS | |
| Item da Nota Fiscal (D1_ITEM) | “0001” | |
| Código do Produto (D1_COD) | MV_PRITDF | |
| Unidade de Medida (D1_UM) | “UN” | |
| Quantidade do Produto (D1_QUANT) | 1 | |
| Valor Unitário (D1_VUNIT) | GW3_VLDF | |
| Valor Total (D1_TOTAL) | GW3_VLDF | |
| Tipo de Operação (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 GW3_TPIMP = 2 - ISS. |
| Tipo de Entrada da Nota (D1_TES) | FM_TE | Localizar FM com FM_TIPO = D1_OPER. |
| Valor do ICM do Item (D1_VALICM) | GW3_VLIMP quando GW3_TPIMP = 1 - ICMS. | |
| Alíquota de ICMS (D1_PICM) | GW3_PCIMP quando GW3_TPIMP = 1 - ICMS. | |
| Valor Base do Icms (D1_BASEICM) | GW3_BASIMP quando GW3_TPIMP = 1 - ICMS. | |
| Valor do ICMS (D1_ICMSRET) | GW3_IMPRET quando GW3_TPIMP = 1 - ICMS. | |
| Valor do ISS (D1_VALISS) | GW3_VLIMP quando GW3_TPIMP = 2 - ISS. | |
| Alíquota de ISS (D1_ALIQISS) | GW3_PCIMP quando GW3_TPIMP = 2 - ISS. | |
| Base de Cálculo do ISS (D1_BASEISS) | GW3_BASIMP quando GW3_TPIMP = 2 - ISS. | |
| Base do Cofins (D1_BASECOF) | GW3_BASCOF | |
| Alíquota do Cofins (D1_ALQCOF) | MV_PCPIS | |
| Valor do Cofins (D1_VALCOF) | GW3_VLCOF | |
| Base do Pis (D1_BASEPIS) | GW3_BASPIS | |
| Alíquota do PIS (D1_ALQPIS) | MV_PCCOFI | |
| Valor do PIS (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. |
26. Integração de Documentos de Frete como Nota de Conhecimento (GFEA065 – tabelas GW3, GW4)
| Campo | Recebe | Observações |
|---|---|---|
| Conhecimento de Frete (Documento de Entrada) | ||
| Número do Documento (F1_DOC) | GW3_NRDF | |
| Série do Documento (F1_SERIE) | GW3_SERDF | |
| Código do Fornecedor (F1_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW3_EMISDF. Quando não localizar A2 ou A2_CGC em branco, atribuir GW3_EMISDF |
| Loja do Fornecedor (F1_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW3_EMISDF. Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Data de Emissão da NF (F1_EMISSAO) | GW3_DTEMIS | |
| Nota/Consumidor/Ticket (F1_TIPO) | “N=Normal” | Se opção de integração for pré-Ct recebe valor C=CONHECIMENTO. |
| Formulário Próprio (F1_FORMUL) | “N=NÃO” | |
| Espécie do Documento (F1_ESPECIE) | GW3_CDESP | |
| Valor Bruto da NF (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. | |
| Base de Cálculo para ICM (F1_BASEICM) | GW3_BASIMP quando GW3_TPIMP = 1 - ICMS. | |
| Valor do ISS (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. | |
| Base COFINS (F1_BASCOFI) | GW3_BASCOF | |
| F1_ALQCOF | MV_PCPIS | |
| Vlr. Retenção do COFINS (F1_VALCOFI) | GW3_VLCOF | |
| Base do PIS (F1_BASPIS ) | GW3_BASPIS | |
| F1_ALQPIS | MV_PCCOFI | |
| PIS Retenção (F1_VALPIS) | GW3_VLPIS | |
| Notas Fiscais do Conhecimento de Frete | Criar 1 para cada registro da GW4 relacionada à GW3. | |
| Código da Transportadora (F8_TRANSP) | F1_FORNECE | |
| Loja da Transportadora (F8_LOJTRAN) | F1_LOJA | |
| NF Importaçäo / Frete (F8_NFDIFRE) | F1_DOC | |
| Serie da NF Importa/Frete (F8_SEDIFRE) | F1_SERIE | |
| Fornecedor da NF (F8_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW3_EMISDC. Quando não localizar A2 ou A2_CGC em branco, atribuir GW3_EMISDC. |
| Loja do Fornecedor (F8_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW3_EMISDC; Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Nota Fiscal Original (F8_NFORIG) | GW4_NRDC | |
| Serie da NF Original (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:
"Com a integração ativa entre o ERP Protheus e o TOTVS GFE, os documentos de Transporte devem ser lançados pelo TOTVS GFE! Confirma o lançamento?
Essa mensagem já é apresentada pelo sistema, independente do modelo de integração.
27. Integração de Contratos como Nota de Conhecimento (GFEA100 – tabela GW2)
| Campo | Recebe | Observações |
|---|---|---|
| Numero do Documento (F1_DOC) | GW2_NRCONT | |
| Serie do Documento (F1_SERIE) | “” | |
| Código do Fornecedor (F1_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW2_CDPROP. Quando não localizar A2 ou A2_CGC em branco, atribuir GW2_CDPROP. |
| Loja do Fornecedor (F1_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW2_CDPROP. Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Data de Emissão da NF (F1_EMISSAO) | GW2_DTCRIA | |
| Nota/Consumidor/Ticket (F1_TIPO) | “C=CONHECIMENTO” | |
| Formulário Próprio (F1_FORMUL) | “N=NÃO” | |
| Espécie do Documento (F1_ESPECIE) | “CTR” | |
| Valor Bruto da NF (F1_VALBRUT) | GW2_VLFRET | |
| F1_OPER | “TT” | |
| Notas Fiscais do Conhecimento de Frete | Criar 1 para cada registro da GW4 relacionada à GW8. | |
| Código da Transportadora (F8_TRANSP) | F1_FORNECE | |
| Loja da Transportadora (F8_LOJTRAN) | F1_LOJA | |
| NF Importação / Frete (F8_NFDIFRE) | F1_DOC | |
| Série da NF Importa/Frete (F8_SEDIFRE) | F1_SERIE | |
| Fornecedor da NF (F8_FORNECE) | A2_COD | Localizar A2 com A2_CGC = GW8_EMISDC. Quando não localizar A2 ou A2_CGC em branco, atribuir GW8_EMISDC. |
| Loja do Fornecedor (F8_LOJA) | A2_LOJA | Localizar A2 com A2_CGC = GW8_EMISDC. Quando não localizar A2 ou A2_CGC em branco, atribuir 01. |
| Nota Fiscal Original (F8_NFORIG) | GW1_NRDC | |
| Série da NF Original (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:
"Com a integração ativa entre o ERP Protheus e o TOTVS GFE, os documentos de Transporte devem ser lançados pelo TOTVS GFE! Confirma o lançamento?
Essa mensagem já é apresentada pelo sistema, independente do modelo de integração.
28. 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