Integrar os módulos Gestão de Transportes (SIGATMS) e Gestão de Frete Embarcador (SIGAGFE) de forma que seja permitido
controlar o movimento e o pagamento relativo à carga transferida da Transportadora para um Parceiro.
Objetivos funcionais da integração:
Os Cadastros e Processos que são realizados no SIGATMS e que são integrados ao módulo SIGAGFE são:
SIGATMS | SIGAGFE | |
---|---|---|
Cadastros | Municípios | Cidades |
Clientes | Emitentes | |
Transportadoras | Emitentes | |
Fornecedores | Emitentes | |
Tipo de Veículo | Tipo de Veículo | |
Contas Contábeis | Contas Contábeis | |
Centros de Custo | Centros de Custo | |
Processos | Redespacho x Documentos | Documento de Carga Romaneios |
Os Processos realizados no SIGAGFE e que são integrados ao módulo SIGATMS são:
SIGAGFE | SIGATMS | |
---|---|---|
Processos | Ocorrência de Transporte | Registro de ocorrências |
Documento de Frete | Documento de Entrada (Conhecimento de Transporte) | |
Pré-fatura de Frete | Contas a Pagar | |
Fatura de Frete | Contas a Pagar |
A integração SIGATMS x SIGAGFE utiliza comunicação direta entre as rotinas Gestão de Transporte e Gestão de Frete Embarcador.
Nas rotinas há uma função para integração a ser executada por cada evento listado, tem a finalidade de montar a lista de informações a ser enviada para o objeto de negócio (model) indicado. São utilizadas operações padrões de manutenção de registros da técnica MVC com o respectivo tratamento do retorno de mensagens inconsistentes.
Nesta integração, o SIGATMS gera os documentos de transporte e os agrupa em um Redespacho. Este Redespacho gera um Romaneio no SIGAGFE. É possível auditar os documentos de frete recebidos do respectivo Parceiro.
Esta integração também contempla as Ocorrências apontadas no SIGAGFE para que sejam automaticamente inclusas no SIGATMS respeitando suas características e funcionalidades.
Integração entre os Cadastros Básicos do ERP com o SIGAGFE
1º Trecho: Referente a Região do Destino do Redespacho.
(Pagar se configurado com S -> Trecho pago pela Transportadora)
2º Trecho: Referente a Região do Cliente Destinatário.
(Pagar se configurado com N -> Trecho não pago pela Transportadora)
Observação:
Para cada Redespacho, podem ser gerados diversos Romaneios de Carga. Em um Romaneio de carga todos os documentos devem possuir o mesmo Tipo de Operação, a mesma Cliassificação de Frete e a mesma Cidade de Origem.
Exemplo
Redespacho | Fornecedor/Loja | Documento | Tp.Oper | Clas.Frt. | UF | Município | Romaneio GFE |
---|---|---|---|---|---|---|---|
100001 | 000001/01 | 01000002UNI | 01 | 001 | SP | São Paulo | 00000005 |
100001 | 000001/01 | 01000003UNI | 01 | 001 | SP | São Paulo | 00000005 |
100001 | 000001/01 | 01000004UNI | 02 | 002 | SP | São Paulo | 00000006 |
100001 | 000001/01 | 01000004UNI | 02 | 002 | RJ | Rio de Janeiro | 00000007 |
100001 | 000001/01 | 01000005UNI | 02 | 001 | RJ | Rio de Janeiro | 00000008 |
100001 | 000050/01 | 01000005UNI | 02 | 001 | MG | Minas Gerais | 00000009 |
Visualização dos Documentos e seus respectivos valores
Em Manutenção de Documentos (TMSA500), através da opção Visualizar, é possível visualizar os valores do frete (Provisão e Devido) calculados pelo SIGAGFE (Tabela GWM), com a disponibilização da pasta denominada GFE – Frete a Pagar.
Registro de Ocorrências
O apontamento da ocorrência é realizado através do módulo SIGAGFE, que faz o envio ao SIGATMS por intermédio da ação do usuário identificado no campo Origem do Registro com o conteúdo SIGAGFE.
Desta forma, se a origem do registro da ocorrência estiver com conteúdo igual ao SIGAGFE, será permitido apenas o apontamento de ocorrência pelo SIGATMS do tipo Informativa, desde que não seja o código de ocorrência configurado no parâmetro MV_OCORRDP.
Para que o envio da Ocorrência do SIGAGFE para o SIGATMS possa ser realizado, a Ocorrência deve estar sob situação Aprovada. Todos os Documentos de Carga (GW1) do Documento de Transporte (GWE) relacionados ao Documentos de Carga da Ocorrência (GWL) devem possuir ocorrências aprovadas. O Tipo de Ocorrência deve indicar que há integração com o SIGATMS (Integrar TMS). A situação de integração é controlada pelo campo Situação Int. com o SIGATMS e o motivo de eventuais rejeições da integração são registrados no campo Motivo Rejeição SIGATMS.
Ao estornar uma ocorrência originada pela rotina Baixa do Redespacho (parâmetro MV_OCORRDP), é acionada a rotina do SIGAGFE para a reabertura do Romaneio (GFEA050REA):
1- Caso o documento possua apenas um trecho, o sistema retira o documento de carga do romaneio e faz a exclusão do documento de carga.
Realizado o estorno, caso não haja documentos de carga vinculados ao Romaneio, ocorre exclusão do Romaneio.
2- Caso o documento possua mais de um trecho, ocorre a exclusão da última sequência do trecho (GWU).
Em seguida, é realizada a liberação automática do romaneio, conforme configuração do campo Libera Romaneio Automatic.
Documentos de Entrada (Notas de Conhecimentos de Transporte) e Títulos a Pagar
Para possibilitar a administração Fiscal, Contábil e Financeira da contratação de serviços de transporte de outros transportadores o SIGAGFE permite a integração de Documentos de Frete, Pré-faturas e Faturas com os módulos do backoffice Protheus®, quando utilizados pela empresa. Os pré-requisitos e condições dessas integrações seguem as mesmas regras da integração já existentes entre o módulo SIGAGFE e o restante do ERP Protheus®.
Liberação oficial: Versão 12
Liberação controlada: Release 11.8.
Deve-se solicitar o pacote de atualizações via chamado e executar os procedimentos para Implementação conforme Boletim Técnico.
Atualização do SIGAGFE até o último pacote e, em caso de liberação controlada, aplicar o pacote com as alterações referentes à Integração SIGATMS x SIGAGFE.
Parâmetros para configuração:
Parâmetro | Descrição | Conteúdo | |
---|---|---|---|
SIGATMS | MV_TMSGFE | Ativa integração SIGATMS x SIGAGFE | .T. |
MV_TPDCTMS | Informe o tipo de documento de carga que será utilizado na integração do SIGAGFE. | ||
MV_CDTPOP | Indica qual o código de operação será enviada ao GFE | ||
MV_CDCLFR | Código da Classificação de frete padrão | ||
MV_OCORRDP | Código da Ocorrência (Informativa) utilizada na Baixa do Redespacho | ||
MV_TMS2GFE | Ativa integração de Ocorrências com o SIGATMS | .T. | |
SIGAGFE | MV_INTGFE | Ativa integração do ERP Protheus com SIGAGFE | .T. |
MV_INTGFE2 | Modo de integração entre ERP Protheus e GFE | 1 | |
MV_CADERP | Origem dos Cadastros | 1 | |
MV_CADOMS | Origem dos Cadastros Tipos Veículo, Veículos e Motoristas | 1 | |
MV_REGOCO | Informar se o sistema deve registrar Ocorrências de Entrada nas importações de arquivos EDI | 1 | |
MV_CDTIPOE | Código do Tipo de Ocorrência de Entrada para EDI |
O grupo TOTVS representado por suas marcas irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.
Todas as evoluções programadas devem ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.
O suporte aos recursos da Integração são de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos SIGATMS e SIGAGFE estão aptas a realizar a primeira análise e, se necessário, repassar cada caso para a equipe mais adequada.
Observação: Este modelo de suporte está sendo revisado pela TOTVS.
Observe nos itens abaixo, sempre que houver uma manipulação nos dados (Inclusão, Alteração e Exclusão) realizada no módulo SIGATMS, o sistema replicará a manipulação automaticamente para os respectivos cadastros no SIGAGFE, respeitando as regras de integridade referencial.
Descrição | Rotina SIGATMS | Rotina SIGAGFE |
---|---|---|
Cadastro de Clientes | MATA030 | GFEA015 |
Cadastro de Fornecedores | MATA020 | GFEA015 |
Cadastro de Transportadoras | MATA050 | GFEA015 |
Cadastro de Municípios | FISA010 | GFEA020 |
Cadastro de Tipos de Veículo | TMSA530 | GFEA045 |
Cadastro de Contas Contábeis | CTBA020 | GFEA090 |
Cadastro de Centros de Custo | CTBA180 | GFEA089 |
Redespachante x Doctos | TMSAR05 | GFEA050 GFEA044 |
Carga Inicial – GFE | OMSM011 |
A transportadora faz a emissão de seus documentos de transporte e a contratação de um Parceiro para realizar o transporte Total ou Parcial da respectiva mercadoria.
O Parceiro, emite seus documentos de frete e respectivas faturas. Estes documentos são lançados no SIGAGFE.
Segue abaixo o mapeamento entre as estruturas SIGATMS e SIGAGFE:
Documento de Carga (GW1) - GFEA044:
De (SIGATMS) | Para (SIGAGFE) | Observação |
---|---|---|
MV_TPDCTMS | GW1_CDTPDC | Conteúdo do parâmetro MV_TPDCTMS |
A1_CGC | GW1_EMISDC | CNPJ do Cliente Remetente (DTC_CLIREM+DTC_LOJREM) |
DTC_EMINFC | GW1_DTEMIS | |
DTC_SERNFC | GW1_SERDC | |
DTC_NUMNFC | GW1_NRDC | |
A1_CGC | GW1_CDREM | CNPJ do Cliente Remetente (DTC_CLIREM+DTC_LOJREM) |
A1_CGC | GW1_CDDEST | CNPJ do Cliente Destinatario (DTC_CLIDES+DTC_LOJDES) |
‘3’ | GW1_SIT | 3= Liberado |
1 | GW1_TPFRET | |
3 | GW1_ORIGEM | 3=SIGATMS |
Data do Sistema | GW1_DTIMPL | |
Hora do Sistema | GW1_HRIMPL | |
1 | GW1_USO | |
DT6_QTDVOL | GW1_QTVOL | |
DTC_EMINFC | GW1_DTLIB | |
GW1_HRLIB | ||
2 | GW1_ENVEDI | |
Nro Sequencial da rotina | GW1_NRROM | |
DTC_VALICM | GW1_ICMSDC | 1 OU 2 (F1_VALICM <> 0 = 1) |
Itens Documentos de Carga (GW8):
De (SIGATMS) | Para (SIGAGFE) | Observação |
---|---|---|
DTC_CODPRO | GW8_ITEM | |
B1_DESC | GW8_DSITEM | Descrição do produto |
DFV_CDCLFR | GW8_CDCLFR | Classificação do Frete informado na rotina Redespacho x Documento (DFV) |
DTC_QTDVOL | GW8_QTDE | |
DTC_PESO | GW8_PESOR | |
DTC_PESOM3 | GW8_PESOC | |
DTC_VALOR | GW8_VALOR | |
MV_TPDCTMS | GW8_CDTPDC | |
A2_CGC | GW8_EMISDC | CNPJ do Redespachante (DFT_CODFOR+DFT_LOJFOR) |
DTC_SERNFC | GW8_SERDC | |
DTC_NUMNFC | GW8_NRDC | |
Nro Sequencial (DTC) | GW8_SEQ | |
1 | GW8_RATEIO | 1 |
1 | GW8_TRIBP | 1 |
DTC_PESO | GW8_QTDALT |
Trechos do Itinerário (GWU):
De (SIGATMS) | Para (SIGAGFE) | Observação |
---|---|---|
A4_CGC | GWU_CDTRP | CNPJ do Redespachante (DFT_CODFOR+DFT_LOJFOR) |
DFV_ESTDES+DFV_CDMUND | GWU_NRCIDD | Cidade de Destino informado na rotina Redespacho x Documento (DFV) |
MV_TPDCTMS | GWU_CDTPDC | |
A1_CGC | GWU_EMISDC | CNPJ do Redespachante (DFT_CODFOR+DFT_LOJFOR) |
Nro Sequencial | GWU_SEQ | |
DTC_SERNFC | GWU_SERDC | |
DTC_NUMNFC | GWU_NRDC | |
1 | GWU_PAGAR |
Romaneio de Carga (GWN) – GFEA050:
De (SIGATMS) | Para (SIGAGFE) | Observação |
---|---|---|
A2_CGC | GWN_CDTRP | CNPJ do Redespachante (DFT_CODFOR+DFT_LOJFOR) |
DFV_CDTPOP | GWN_CDTPOP | Tipo de operação informado na inclusão do Redespacho x Documento (DFV) |
DFV_CDCLFR | GWN_CDCLFR | Classificação de frete informado na inclusão do Redespacho x Documento (DFV) |
DFV_ESTDES+DFV_CDMUND | GWN_NRCIDD | Cidade de Destino informado na rotina Redespacho x Documento (DFV) |
DFV_ESTORI+DFV_CDMUNO | GWN_NRCIDO | Cidade de Destino informado na rotina Redespacho x Documento (DFV) |
3 | GWN_SIT | 3= Liberado |
Data do Sistema | GWN_DTIMPL | |
Hora do Sistema | GWN_HRIMPL | |
2 | GWN_CALC | |
3 | GWN_ORI | 3=SIGATMS |
Nro gerado pela rotina do GFE | GWN_NRROM |
GWE (Relacionamento GW1 x DT6):
De (SIGATMS) | Para (SIGAGFE) | Observação |
---|---|---|
GW1_CDTPDC | GWE_CDTPDC | |
GW1_EMISDC | GWE_EMISDC | |
GW1_SERDC | GWE_SERDC | |
GW1_NRDC | GWE_NRDC | |
DT6_FILDOC | GWE_FILDT | |
DT6_DOC | GWE_NRDT | |
DT6_SERIE | GWE_SERDT |
Ocorrência de Transporte – GWD (DUA – Registro de Ocorrência):
De (SIGAGFE) | Para (SIGATMS) | Observação |
---|---|---|
DUA_FILORI | Não atribuído | |
DUA_VIAGEM | Não atribuído | |
0001 | DUA_SEQOCO | |
GWD_DTOCOR | DUA_DATOCO | |
GWD_HROCOR | DUA_HOROCO | |
GU5_OCOTMS | DUA_CODOCO | GU5 com GU5_CDTIPO == GWD_CDTIPO |
GU6_DESC | DUA_MOTIVO | GU6 com GU6_CODMOT == GWD_CDMOT |
DUA_RECEBE | Não atribuído | |
DUA_SERTMS | Não atribuído | |
GWE_FILDT | DUA_FILDOC | |
GWE_NRDT | DUA_DOC | |
GWE_SERDT | DUA_SERIE | |
GWD_QTDVOL | DUA_QTDOCO | |
GW8_PESOR | DUA_PESOCO | GWD->GWL->GW8 (somar todos os GW8 de todos os GWL) |
GWD_FILIAL + “;” + GWD_NROCO | DUA_CHVEXT | |
“SIGAGFE” | DUA_ORIGEM | |
GWL_NRDC | DTC_NUMNFC | Número da nota fiscal (documento de carga) |
GW8_PESOR | DTC_PESO | Peso da nota GWD->GWL->GW8 (somar todos os GW8 do GWL correspondente) |
GW1_QTVOL | DTC_QTDVOL | Quantidade de volumes da nota |
GWL_NRDC | DV4_NUMNFC | Número da nota fiscal (documento de carga |
GWL_SERDC | DV4_SERFNC | Série da nota fiscal |
GWD_QTDVOL | DV4_QTDPND | Quantidade de volumes da pendência |
1- Cadastros básicos do SIGATMS que não são integrados com o SIGAGFE.
Solução:
2- Redespachante x Documentos não integrados com o SIGAGFE.
Solução:
3- Ocorrência do SIGAGFE não integrados com o SIGATMS.
Solução:
Instalação/Configuração
Checklist de Verificações:
Identificar o funcionamento da integração:
Compare as informações do mesmo registro no SIGATMS e SIGAGFE.
Execute a baixa do Redespacho e verifique nas rotinas Romaneio (GFEA050) e Documento de Carga (GFEA044) do SIGAGFE se as informações estão de acordo com a Nota Fiscal do Cliente (DTC).
Na visualização do Documento de Transporte (TMSA500 - SIGATMS) verifique se os valores Provisão e Devido estão de acordo com os valores calculados no SIGAGFE.
Verifique se os Tipos de Ocorrências integram com o SIGATMS e possuem Código de Ocorrência informado.
Tabelas Utilizadas: