Boletim Tcnico

Nova Integrao entre Protheus e SIGAGFE

Produto

: Microsiga Protheus SIGAGFE, Gesto de Frete Embarcador 11.5

Projeto/Requisito

P12.0GFE01/1668

Data da publicao

: 02/10/13

Pas(es)

Todos

Banco(s) de Dados

: Todos

Esta melhoria possibilita a integrao de dados entre rotinas do ERP Microsiga Protheus e o ambiente do Gesto de
Frete Embarcador (SIGAGFE) utilizando comunicao direta entre as rotinas, sem aplicativos intermedirios e sem
trfego de dados no formato XML, com o objetivo de aperfeioar a comunicao entre os mdulos.
So mantidas as regras de negcio atuais da integrao, alterando-se apenas o modelo de troca de dados.

Procedimento para Implementao

O sistema atualizado logo aps a aplicao do pacote de atualizaes (Patch) desta melhoria.
O compatibilizador U_GFE11I17 server para aumentar o tamanho do campo GUJ_VALOR que campo que contm a
expresso do filtro de documentos de carga (GFEA048), deve ser aplicado caso necessrio.

Antes de executar o compatibilizador U_GFE11I07 e U_GFE11I17 imprescindvel:

a) Realizar o backup da base de dados do produto que ser executado o compatibilizador (diretrio
\PROTHEUS11_DATA\DATA) e dos dicionrios de dados "SXs" (diretrio \PROTHEUS11_DATA\ SYSTEM).
b) Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser
alterados conforme o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema.
d) Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o
compatibilizador, certifique-se de que esto identificados pelo nickname. Caso o compatibilizador necessite
criar ndices, ir adicion-los a partir da ordem original instalada pelo Protheus, o que poder sobrescrever
ndices personalizados, caso no estejam identificados pelo nickname.
e)

O compatibilizador deve ser executado com a Integridade Referencial desativada*.

SIGAGFE Nota Integrao entre Protheus e SIGAGFE

Ttulo do documento

O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador
de Banco de Dados (DBA) ou equivalente!
A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento
entre tabelas no banco de dados. Portanto, antes de utiliz-la, observe atentamente os
procedimentos a seguir:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial,
selecionando a opo Integridade/Verificao (APCFG60A).
ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as
empresas e filiais cadastradas para o sistema e nenhuma delas estar selecionada. Neste
caso, E SOMENTE NESTE, no necessrio qualquer outro procedimento de ativao ou
desativao de integridade, basta finalizar a verificao e aplicar normalmente o
compatibilizador, conforme instrues.
iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma
mensagem na janela Verificao de relacionamento entre tabelas. Confirme a mensagem
para que a verificao seja concluda, ou;
iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua
totalidade, so relacionadas em uma nova janela todas as empresas e filiais cadastradas
para o sistema e, somente, a(s) que possui(em) integridade est(aro) selecionada(s).
Anote qual(is) empresa(s) e/ou filial(is) possui(em) a integridade ativada e reserve esta
anotao para posterior consulta na reativao (ou ainda, contate nosso Help Desk
Framework para informaes quanto a um arquivo que contm essa informao).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio
desativar tal integridade, selecionando a opo Integridade/ Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme
instrues.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE
SE tiver sido desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha
em mos as informaes da(s) empresa(s) e/ou filial(is) que possua(m) ativao da
integridade, selecione-a(s) novamente e confirme a ativao.
Contate o Help Desk Framework EM CASO DE DVIDAS!

SIGAGFE Nova Integrao entre Protheus e SIGAGFE

Boletim Tcnico

1.

Em Microsiga Protheus TOTVS Smart Client (se verso 10) ou ByYou Smart Client (se verso 11), digite U_GFEUMAN no
campo Programa Inicial.

Para a correta atualizao do dicionrio de dados, certifique-se que a data do compatibilizador seja
igual ou superior a 26/06/2013.
2.

Clique em OK para continuar.

3.

Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser modificado ou
apresentada a janela para seleo do compatibilizador. Selecione o programa U_GFE11I07 e U_GFE11I17.

4.

Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo
exclusivo.

5.

Clique em Sim para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos. apresentada uma
mensagem explicativa na tela.

6.

Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes processadas. Nesse log
de atualizao, so apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que
ainda no existem no dicionrio de dados.

7.

Clique em Gravar para salvar o histrico (log) apresentado.

8.

Clique em OK para encerrar o processamento.

1. Criao e Alterao no arquivo SX6 Parmetros:

Nome da Varivel

MV_INTGFE2

Tipo

Caracter

Descrio

Integrao direta com GFE, sem uso de EAI e ESB (1=Sim;2=No).

Valor Padro

Nome da Varivel

MV_FATGFE

Tipo

Caracter

Descrio

Indica se a gerao de Nota Fiscal interrompida quando ocorre

erro de validao na integrao com o GFE (1=Sim;2=No).

Valor Padro

Nome da Varivel

MV_GFEI10

Tipo

Caracter

Descrio

Integrao de Nota Fiscal de Entrada (1=Sim;2=No).

Valor Padro

SIGAGFE Nota Integrao entre Protheus e SIGAGFE

Ttulo do documento

Nome da Varivel

MV_GFEI11

Tipo

Caracter

Descrio

Integrao de Nota Fiscal de Sada (1=Sim;2=No).

Valor Padro

Nome da Varivel

MV_GFEI12

Tipo

Caracter

Descrio

Integrao da Carga (1=Sim;2=No).

Valor Padro

2. Alterao de campos no arquivo SX3 Campos:

GU3_TPTRIB:

Ordem

25

Tipo

Caracter

Tamanho

Decimal

Ttulo

Reg Tribut

Descrio

Regime Tributrio

Picture

@!

Valor Padro

GW8_CDCLFR:

Ordem

09

Tipo

Caracter

Tamanho

Decimal

Ttulo

Clas Frete

Descrio

Classificao de frete

Picture

@!

Valor Padro

IF(!INCLUI,GetNewPar("MV_CDCLFR",""),"")

SIGAGFE Nova Integrao entre Protheus e SIGAGFE

Boletim Tcnico

GUE_TITULO:

Ordem

03

Tipo

Caracter

Tamanho

50

Decimal

Ttulo

Titulo

Descrio

Titulo Conta Contabil

Picture

@!

Validao

NaoVazio()

GUJ_VALOR:

Ordem

04

Tipo

Caracter

Tamanho

250

Decimal

Ttulo

Valor

Descrio

Valor do Campo

Picture

@!

Validao

GFEA048FTM()

GW2_SITRH:

Ordem

42

Tipo

Caracter

Tamanho

Decimal

Ttulo

Situacao RH

Descrio

Situacao Recursos Humanos

Picture

@!

Validao

Pertence("123456")

SIGAGFE Nota Integrao entre Protheus e SIGAGFE

Ttulo do documento

Procedimentos para Configurao

No se aplica.

Procedimentos para Utilizao

Para que a integrao direta sem uso de EAI e TOTVSESB seja utilizada o parmetro MV_INTGFE deve estar ativado e
o parmetro MV_INTGFE2 estar como 1=Direito. Com isso todo cadastro dos programas do Protheus afetados com
esta melhoria, sero sincronizados com o SIGAGFE.

Para fazer a relao entre Tipos de Notas Fiscais e os Tipos de Documentos de Carga, necessrio criar a
tabela genrica MQ, definindo a chave como o Tipo de Nota Fiscal e a descrio como o Tipo de Documento de
Carga que ser convertido.
Alm disso, para diferenciar as notas de entrada e sada, ser incluso um ps-fixo na chave da tabela de
acordo com a rotina:
Nota Fiscal de Entrada

Nota Fiscal de Sada

Criao da tabela genrica do Protheus:

Tabela

MQ

Chave

Cdigo do Tipo de Nota Fiscal + Ps Fixo

Descrio

Tipo de Documento de Carga a ser Relacionado

Exemplo de uma tabela de relao:

Nota Fiscal de Sada

Nota Fiscal de Entrada

Tabela

Chave

Descrio

Tabela

Chave

Descrio

MQ

NS

NFS

MQ

NE

NFS

MQ

DS

NFS

MQ

DE

NFS

MQ

BS

NFS

MQ

BE

NFS

SIGAGFE Nova Integrao entre Protheus e SIGAGFE

Boletim Tcnico

Mais detalhes sobre o uso das Tabelas Genricas (SX5) pode ser encontrado no TDN:
Tecnologia TOTVS > Linguagens de programao AdvPL > SDK Microsiga Protheus > Guia do dicionrio de
dados > SX5 - Tabelas Genricas.
Na integrao dos documentos do GFE para o Protheus (opo do GFE de atualizao ou desatualizao nos
mdulos) utilizado o tipo de entrada e sada da tabela SFM (MATA089 TES Inteligente). Os tipos de operao
devem ser devidamente cadastrados na tabela genrica SX5, X5_TABELA = DJ, pelo configurador (SIGACFG), caso
necessrio:
Integrao de Documentos de Frete como Documento de Entrada:
Tipo de Operao

Descrio

T1

ICMS Tributado

T2

ICMS Inserido

T3

ICMS Substituio Tributria

T4

ISS

T7

ICMS Tributao sem Direito a Crdito de PIS/COFINS

Integrao de Documentos de Frete como Nota de Conhecimento:

Tipo de Operao

Descrio

T7

PIS/COFINS

T8

ICMS Inserido

T9

ICMS Substituio Tributria

Integrao de Contratos como Nota de Conhecimento:

Tipo de Operao

Descrio

TT

ICMS No Tributado

Na mudana da integrao usando EAI/ESB para a integrao direta a eliminao do cadastramento dos
Adapters EAI deve ser efetuada manualmente pelo mdulo SIGACFG.

SIGAGFE Nota Integrao entre Protheus e SIGAGFE

Ttulo do documento

Informaes Tcnicas

SA1 Clientes
SA2 Fornecedores
DA3 Veculos
DA4 Motoristas
SA4 Transportadores
CC2 Municpios
DUT Tipo de Veculos
CTT Centro de Custo
CT1 Plano de Contas
SF2 Notas Fiscais de Sada
SF1 Documentos de Entrada
SD1 Itens das Nf de Entrada
SD2 Itens de Venda da Nf
DAK Cargas1
GU3 Emitentes
GV3 Tipos de Veculo
GU7 Municpios
Tabelas Utilizadas

GUH Centros de Custo

GUE Contas Contbeis
GUU Motoristas
GU8 Veculos
GW1 Documentos de Carga
GW8 Itens do Documento de Carga
GWU Trechos do Itinerrio
GWN Romaneio
GW0 Tabela Genrica Movimentao
GW2 Contrato com Autnomos
GW3 Documentos de Frete
GW4 Doctos Carga dos Doctos Frete
GW6 Fatura de Frete
GW7 Rateio Contbil Fatura
GW9 Rateio Contbil Contrato
GWJ Pr-faturas de Frete
GWK Rateio Contbil Pr-fatura

SIGAGFE Nova Integrao entre Protheus e SIGAGFE

Boletim Tcnico

FISA010 Cadastro de Municpios

MATA020 Cadastro de Fornecedores
MATA030 Cadastro de Clientes
MATA050 Cadastro de Transportadores
CTBA020 Cadastro de Plano de Contas
CTBA180 Cadastro de Centros de Custo
OMSA040 Cadastro de Motoristas
OMSA060 Cadastro de Veculos
TMSA530 Cadastro de Tipos de Veculo
MATA460 Emisso de Documentos de Sada
MATA521 Excluso de Documentos de Sada
Rotinas Envolvidas

MATA103 Manuteno de Documentos de Entrada

OMSA200 Montagem de Carga
OMSM011 Carga Inicial GFE
OMSM012 Notas Fiscais de Sada Pendentes
GFEA055 Gerar Pr-faturas de Frete
GFEA099 Integrar Pr-faturas de Frete
GFEA065 Manuteno de Documentos de Frete
GFEA067 Integrar Documentos de Frete
GFEA070 Manuteno de Faturas de Frete
GFEA097 Integrar Faturas de Frete
GFEA100 Gerao de Contratos com Autnomos
GFEA098 Integrar Contratos com Autnomos
GFEX000 Parmetros do Mdulo

Sistemas Operacionais

Windows/Linux

SIGAGFE Nota Integrao entre Protheus e SIGAGFE