Escolar Documentos
Profissional Documentos
Cultura Documentos
Maro/2014
SIGATMS x SIGAGFE
Ttulo do documento
Sumrio
1
Integrao ............................................................................................................................................... 4
Escopo .................................................................................................................................................... 5
5.1
SIGATMS ................................................................................................................................................ 7
5.2
SIGAGFE ................................................................................................................................................ 8
Suporte ................................................................................................................................................... 8
10
11
12
13
Anexos .................................................................................................................................................. 15
SIGATMS x SIGAGFE
1. Contexto de negcio
Integrar os mdulos Gesto de Transportes (SIGATMS) e Gesto 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 integrao:
Auxiliar no controle dos processos operacionais de recepo e despacho de cargas.
Registrar, Provisionar e Conferir as despesas decorrentes da contratao de Servios de Transporte realizados por
terceiros.
Suportar a troca de informaes entre o contratante e os prestadores de Servio de Transporte.
Manter os dados relacionados a Documentos, Custos e Despesas com transporte, sincronizados e integrados aos demais
mdulos do software ERP.
Os Cadastros e Processos que so realizados no SIGATMS e que so integrados ao mdulo SIGAGFE so:
Cadastros
Processos
SIGATMS
Municpios
Clientes
Transportadoras
Fornecedores
Tipo de Veculo
Contas Contbeis
Centros de Custo
Redespacho x Documentos
SIGAGFE
Cidades
Emitentes
Emitentes
Emitentes
Tipo de Veculo
Contas Contbeis
Centros de Custo
Documento de Carga
Romaneios
Processos
SIGAGFE
Ocorrncia de Transporte
Documento de Frete
SIGATMS
Registro de ocorrncias
Documento de Entrada (Conhecimento de
Transporte)
Contas a Pagar
Contas a Pagar
Pr-fatura de Frete
Fatura de Frete
mos MoOProcevimentos de Prestao de Servio
2. Sistemas Envolvidos
Gesto de Transportes.
Gesto de Frete Embarcador.
SIGATMS x SIGAGFE
Ttulo do documento
3. Integrao
A integrao SIGATMS x SIGAGFE utiliza comunicao direta entre as rotinas Gesto de Transporte e Gesto de Frete
Embarcador.
Functions
MVC
Functions
MVC
Dados
TMS
Dados
GFE
Nas rotinas h uma funo para integrao a ser executada por cada evento listado, tem a finalidade de montar a lista de informaes
a ser enviada para o objeto de negcio (model) indicado. So utilizadas operaes padres de manuteno de registros da tcnica
MVC com o respectivo tratamento do retorno de mensagens inconsistentes.
INTEGRAES
SIGATMS
SIGAGFE
Clientes
PROTHEUS
Fornecedores
Emitentes
Ocorrncias
Transportadoras
Tipos de Veiculo
PROTHEUS
Tipos de Veiculo
PROTHEUS
Municipios
PROTHEUS
Plano de Contas
Custos
PROTHEUS
PROTHEUS
Cidades
PROTHEUS
Contas Contbeis
Centros de Custo
PROTHEUS
PROTHEUS
Redespachante x Doctos
PROTHEUS
Romaneio
Documento de Carga
Registro de
Ocorrncias
PROTHEUS
Documentos de
Entrada (CTR)
Ocorrncias
Documentos de Frete
Pr-faturas de Frete
Ttulo a Pagar
Faturas de Frete
SIGATMS x SIGAGFE
4. Escopo
Nesta integrao, o SIGATMS gera os documentos de transporte e os agrupa em um Redespacho. Este Redespacho gera um
Romaneio no SIGAGFE. possvel auditar os documentos de frete recebidos do respectivo Parceiro.
Esta integrao tambm contempla as Ocorrncias apontadas no SIGAGFE para que sejam automaticamente inclusas no
SIGATMS respeitando suas caractersticas e funcionalidades.
Integrao entre os Cadastros Bsicos do ERP com o SIGAGFE
Cadastro de Municpios
O cadastro de municpios utilizado em diversos pontos do sistema com as opes: Identificao da localidade dos
Emitentes, Registro de Preos por Cidade, entre outros.
Cadastro de Clientes
Todos os clientes (Remetentes, Destinatrios, Consignatrios e Despachantes) devem ser cadastrados no Cadastro de
Clientes. Os campos Cd.Municipio e Estado devem estar obrigatoriamente preenchidos para que a integrao com o
SIGAGFE gere o Nr.Cidade corretamente.
Cadastro de Transportadoras
Para o SIGAGFE todos os Fornecedores devem estar cadastrados como Transportadoras.
Cadastro de Fornecedores
No cadastro de fornecedores do SIGATMS, na pasta TMS foi disponibilizado o campo Pagto pelo GFE, para que seja
informado se os Redespachos gerados devam ser controlados pelo SIGAGFE. Esta parametrizao permite que existam
Parceiros controlados somente pelo SIGATMS ou somente pelo SIGAGFE.
Uma vez que o campo Pagto pelo GFE esteja selecionado como Sim, o campo Transp na pasta Compras se torna
obrigatrio, pois para o SIGAGFE h a obrigatoriedade de cadastrar o Fornecedor como Transportadora.
Redespachante x Documentos
No momento em que a Transportadora decide transferir uma carga e o respectivo documento de transporte para um
parceiro, possvel acessar a rotina Redespachante x Documentos, a fim de registrar as informaes.
A partir do relacionamento do Redespachante com o Documento (TMSAR05 - Redespachante x Doctos), se o
Fornecedor estiver selecionado como Pagto pelo GFE, necessrio informar novos campos a serem utilizados no
SIGAGFE (Classificao de Frete, Tipo de Operao e Trechos).
Na execuo do processo da Baixa Redespacho localizado na rotina Redespachante x Documentos (TMSAR05), ocorre
a gerao automtica do Documento de Carga vinculado ao Romaneio no SIGAGFE e aps as informaes:
SIGATMS x SIGAGFE
Ttulo do documento
Caso o Documento de Transporte retorne transportadora para ser incluso em novo Redespacho, ao realizar a baixa
do Redespacho feita verificao se consta no mdulo SIGAGFE (Documento de Carga), caso conste incluso um novo
trecho para o Documento de Carga.
Nos casos em que a Regio de Destino do Cliente Destinatrio do Documento (Cdigo do Municpio) for diferente da Regio
de Destino do Redespacho (Cdigo Municpio Destino), so disponibilizados dois Trechos no Documento de Carga com
as opes:
1 Trecho: Referente a Regio do Destino do Redespacho.
(Pagar se configurado com S -> Trecho pago pela Transportadora)
2 Trecho: Referente a Regio do Cliente Destinatrio.
(Pagar se configurado com N -> Trecho no pago pela Transportadora)
Observao:
Para cada Redespacho, podem ser gerados diversos Romaneios de Carga. Em um Romaneio de carga todos os
documentos devem possuir o mesmo Tipo de Operao, a mesma Cliassificao de Frete e a mesma Cidade de
Origem.
Exemplo
Redespacho Fornecedor/Loja
Documento
Tp.Oper
Clas.Frt.
UF
Municipio
100001
000001/01
01000002UNI
01
001
SP
So Paulo
Romaneio
GFE
00000005
100001
000001/01
01000003UNI
01
001
SP
So Paulo
00000005
100001
000001/01
01000004UNI
02
002
SP
So 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
Contrato de Redespachante
Uma vez que ocorra a integrao com o GFE, no ser permitido gerar o contrato de redespachante pelo SIGATMS para os
respectivos documentos.
SIGATMS x SIGAGFE
Registro de Ocorrncias
O apontamento da ocorrncia realizado atravs do mdulo SIGAGFE, que faz o envio ao SIGATMS por intermdio da
ao do usurio identificado no campo Origem do Registro com o contedo SIGAGFE.
Desta forma, se a origem do registro da ocorrncia estiver com contedo igual ao SIGAGFE, ser permitido apenas o
apontamento de ocorrncia pelo SIGATMS do tipo Informativa, desde que no seja o cdigo de ocorrncia configurado
no parmetro MV_OCORRDP.
Para que o envio da Ocorrncia do SIGAGFE para o SIGATMS possa ser realizado, a Ocorrncia deve estar sob situao
Aprovada. Todos os Documentos de Carga (GW1) do Documento de Transporte (GWE) relacionados ao Documentos
de Carga da Ocorrncia (GWL) devem possuir ocorrncias aprovadas. O Tipo de Ocorrncia deve indicar que h
integrao com o SIGATMS (Integrar TMS). A situao de integrao controlada pelo campo Situao Int. com o
SIGATMS e o motivo de eventuais rejeies da integrao so registrados no campo Motivo Rejeio SIGATMS.
Ao estornar uma ocorrncia originada pela rotina Baixa do Redespacho (parmetro 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
excluso do documento de carga.
Realizado o estorno, caso no haja documentos de carga vinculados ao Romaneio, ocorre excluso do
Romaneio.
2- Caso o documento possua mais de um trecho, ocorre a excluso da ltima sequncia do trecho (GWU).
Em seguida, realizada a liberao automtica do romaneio, conforme configurao do campo Libera
Romaneio Automatic.
5. Pr-requisitos Instalao/Implantao/Utilizao
5.1.
SIGATMS
Devem ser realizados os cadastros e configuraes bsicas para que seja possvel emitir um Documento de
Transporte e gerar um Redespacho.
SIGATMS x SIGAGFE
Ttulo do documento
5.2.
SIGAGFE
Atualizao do SIGAGFE at o ltimo pacote e, em caso de liberao controlada, aplicar o pacote com as alteraes referentes
Integrao SIGATMS x SIGAGFE.
Devem ser realizados os cadastros e configuraes bsicas para que seja possvel calcular um Romaneio, Incluir
e Aprovar Documentos de Frete e Faturas.
Nos releases iguais ou anteriores a verso 11.8, deve-se executar o compatibilizador U_GFE11I27 (ou o GF11I27
pelo programa U_GFEUDES).
6. Instalao/Atualizao
Parmetros para configurao:
SIGATMS
Parmetro
MV_TMSGFE
MV_TPDCTMS
MV_CDTPOP
MV_CDCLFR
MV_OCORRDP
SIGAGFE
MV_TMS2GFE
MV_INTGFE
MV_INTGFE2
MV_CADERP
MV_CADOMS
MV_REGOCO
MV_CDTIPOE
Descrio
Contedo
Ativa integrao SIGATMS x SIGAGFE
.T.
Informe o tipo de documento de carga que ser utilizado na
integrao do SIGAGFE.
Indica qual o cdigo de operao ser enviada ao GFE
Codigo da Classificao de frete padro
Codigo da Ocorrencia (Informativa) utilizada na Baixa do
Redespacho
Ativa integrao de Ocorrncias com o SIGATMS
.T.
Ativa integrao do ERP Protheus com SIGAGFE
.T.
Modo de integrao entre ERP Protheus e GFE
1
Origem dos Cadastros
1
Origem dos Cadastros Tipos Veculo, Veculos e Motoristas
1
Informar se o sistema deve registrar Ocorrncias de Entrada nas
1
importaes de arquivos EDI
Cdigo do Tipo de Ocorrncia de Entrada para EDI
7. Controle de Verso
O grupo TOTVS representado por suas marcas ir administrar as demandas de evoluo dos layouts e demais ajustes, acordando
junto aos solicitantes o prazo de liberao de release.
Todas as evolues programadas devem ser discutidas e aprovadas pelas marcas antes do incio do desenvolvimento e somente
sero desenvolvidas em caso de concordncia das marcas e alinhamento com as diretivas definidas pelo Comit de Integrao
TOTVS.
8. Suporte
O suporte aos recursos da Integrao so de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos
SIGATMS e SIGAGFE esto aptas a realizar a primeira anlise e, se necessrio, repassar cada caso para a equipe mais adequada.
Observao: Este modelo de suporte est sendo revisado pela TOTVS.
SIGATMS x SIGAGFE
9. Transaes/Entidades/Mensagens nicas
Observe nos itens abaixo, sempre que houver uma manipulao nos dados (Incluso, Alterao e Excluso) realizada no mdulo
SIGATMS, o sistema replicar a manipulao automaticamente para os respectivos cadastros no SIGAGFE, respeitando as regras
de integridade referencial.
Descrio
Rotina SIGATMS
Rotina SIGAGFE
Cadastro de Clientes
MATA030
GFEA015
Cadastro de Fornecedores
MATA020
GFEA015
Cadastro de Transportadoras
MATA050
GFEA015
Cadastro de Municpios
FISA010
GFEA020
TMSA530
GFEA045
CTBA020
GFEA090
CTBA180
GFEA089
GFEA050
GFEA044
Redespachante x Doctos
Carga Inicial GFE
TMSAR05
OMSM011
SIGATMS x SIGAGFE
Ttulo do documento
10. Fluxo das Informaes
A transportadora faz a emisso de seus documentos de transporte e a contratao 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 so lanados no SIGAGFE.
10
SIGATMS x SIGAGFE
Para (SIGAGFE)
Observao
MV_TPDCTMS
GW1_CDTPDC
A1_CGC
GW1_EMISDC
CNPJ
do
Cliente
(DTC_CLIREM+DTC_LOJREM)
Remetente
DTC_EMINFC
GW1_DTEMIS
DTC_SERNFC
GW1_SERDC
DTC_NUMNFC
GW1_NRDC
A1_CGC
GW1_CDREM
Remetente
A1_CGC
GW1_CDDEST
CNPJ
do
Cliente
(DTC_CLIREM+DTC_LOJREM)
CNPJ
do
Cliente
(DTC_CLIDES+DTC_LOJDES)
GW1_SIT
GW1_TPFRET
GW1_ORIGEM
Data do Sistema
GW1_DTIMPL
Hora do Sistema
GW1_HRIMPL
GW1_USO
DT6_QTDVOL
GW1_QTVOL
DTC_EMINFC
GW1_DTLIB
Destinatario
3= Liberado
3=SIGATMS
GW1_HRLIB
2
Nro Sequencial
rotina
DTC_VALICM
GW1_ENVEDI
da
GW1_NRROM
GW1_ICMSDC
1 OU 2 (F1_VALICM <> 0 = 1)
Para (SIGAGFE)
DTC_CODPRO
GW8_ITEM
B1_DESC
GW8_DSITEM
Descrio do produto
DFV_CDCLFR
GW8_CDCLFR
DTC_QTDVOL
GW8_QTDE
DTC_PESO
GW8_PESOR
Observao
11
SIGATMS x SIGAGFE
Ttulo do documento
DTC_PESOM3
GW8_PESOC
DTC_VALOR
GW8_VALOR
MV_TPDCTMS
GW8_CDTPDC
A2_CGC
GW8_EMISDC
DTC_SERNFC
GW8_SERDC
DTC_NUMNFC
GW8_NRDC
GW8_SEQ
GW8_RATEIO
GW8_TRIBP
DTC_PESO
GW8_QTDALT
CNPJ
do
Redespachante
(DFT_CODFOR+DFT_LOJFOR)
Para (SIGAGFE)
A4_CGC
GWU_CDTRP
Observao
CNPJ
do
Redespachante
(DFT_CODFOR+DFT_LOJFOR)
Cidade de Destino informado na rotina
Redespacho x Documento (DFV)
DFV_ESTDES+DFV_CDMUND GWU_NRCIDD
MV_TPDCTMS
GWU_CDTPDC
A1_CGC
GWU_EMISDC
Nro Sequencial
GWU_SEQ
DTC_SERNFC
GWU_SERDC
DTC_NUMNFC
GWU_NRDC
GWU_PAGAR
CNPJ
do
Redespachante
(DFT_CODFOR+DFT_LOJFOR)
Para (SIGAGFE)
A2_CGC
GWN_CDTRP
DFV_CDTPOP
GWN_CDTPOP
DFV_CDCLFR
GWN_CDCLFR
Observao
CNPJ
do
Redespachante
(DFT_CODFOR+DFT_LOJFOR)
Tipo de operao informado na incluso
do Redespacho x Documento (DFV)
Classificao de frete informado na
incluso do Redespacho x Documento
(DFV)
Cidade de Destino informado na rotina
Redespacho x Documento (DFV)
DFV_ESTDES+DFV_CDMUND GWN_NRCIDD
12
SIGATMS x SIGAGFE
DFV_ESTORI+DFV_CDMUNO GWN_NRCIDO
GWN_SIT
3= Liberado
Data do Sistema
GWN_DTIMPL
Hora do Sistema
GWN_HRIMPL
GWN_CALC
GWN_ORI
GWN_NRROM
3=SIGATMS
Para (SIGAGFE)
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
Observao
Para (SIGATMS)
Observao
DUA_FILORI
No atribudo
DUA_VIAGEM
No atribudo
0001
DUA_SEQOCO
GWD_DTOCOR
DUA_DATOCO
GWD_HROCOR
DUA_HOROCO
GU5_OCOTMS
DUA_CODOCO
GU6_DESC
DUA_MOTIVO
GWE_FILDT
GWE_NRDT
DUA_RECEBE
GU5
com
GWD_CDTIPO
GU6
com
GWD_CDMOT
No atribudo
DUA_SERTMS
No atribudo
DUA_FILDOC
DUA_DOC
13
GU5_CDTIPO
==
GU6_CODMOT
==
SIGATMS x SIGAGFE
Ttulo do documento
GWE_SERDT
DUA_SERIE
GWD_QTDVOL
DUA_QTDOCO
DUA_PESOCO
GW8_PESOR
GWD_FILIAL
GWD_NROCO
SIGAGFE
+ DUA_CHVEXT
DUA_ORIGEM
GWL_NRDC
DTC_NUMNFC
GW8_PESOR
DTC_PESO
GW1_QTVOL
DTC_QTDVOL
GWL_NRDC
DV4_NUMNFC
GWL_SERDC
DV4_SERFNC
GWD_QTDVOL
DV4_QTDPND
14
SIGATMS x SIGAGFE
13. Anexos
Tabelas Utilizadas:
15