Manual de Integração - GFE X Datasul

Integrao Datasul 11 x Protheus / SIGAGFE
04/10/2013
Datasul 11 x Protheus / SIGAGFE
Sumrio
1
Contexto de negcio .................................................................................................................. 3
Sistemas Envolvidos ................................................................................................................... 4
Integrao .................................................................................................................................. 4
Escopo ........................................................................................................................................ 5
Pr-requisitos instalao/implantao/utilizao ..................................................................... 7
5.1
Datasul ....................................................................................................................................... 7
5.2
Protheus ..................................................................................................................................... 7
Instalao/Atualizao ............................................................................................................... 7
6.1
Datasul ....................................................................................................................................... 7
6.2
Protheus ..................................................................................................................................... 13
Controle de Verso .................................................................................................................... 18
Suporte ....................................................................................................................................... 18
Fluxo das Informaes ............................................................................................................... 18
10
Situaes comuns (opcional) ..................................................................................................... 19
11
Checklist de suporte da aplicao .............................................................................................. 21
12
Anexos ........................................................................................................................................ 22
Verso 1.0
Datasul 11 x Protheus / SIGAGFE>
Contexto de negcio
Gesto de Frete Embarcador (SIGAGFE) um aplicativo desenvolvido sobre a plataforma TOTVS. Utiliza o framework
de funcionalidades do Microsiga Protheus e tem como objetivos funcionais:
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 sincronizados e integrados entre os sistemas, na direo do Datasul 11 para o
SIGAGFE so:
Cadastros
Processos
Datasul
Fornecedores
Grupo de Clientes
Clientes
Cidades
Embalagens
Contas Contbeis Integrao
Centro de Custo
Notas Fiscais de Sada
Embarques
Documento de Entrada
SIGAGFE
Emitentes
Grupo de Emitentes
Emitentes
Cidades
Unitizadores
Contas Contbeis
Centro de Custo
Documento de Carga
Romaneios
Documento de Carga
Os Processos realizados dentro do SIGAGFE e que tem informaes enviadas aos mdulos do Datasul 11 so:
Processos
Verso 1.0
Datasul
Pr-faturas de Frete
Documentos de Frete
Documentos de Frete
Faturas de Frete
Contratos com Autnomos
SIGAGFE
Ttulos de Proviso
Documentos Fiscais
Notas de Rateio
Ttulos a Pagar
Ttulos a Pagar
Notas de Rateio
Movimentos de Prestao de Servio
Sistemas Envolvidos
Protheus / Gesto de Frete Embarcador
Datasul 11.
o Cadastros Gerais;
o Faturamento;
o Recebimento;
o Fiscal;
o Financeiro;
o RH.
Integrao
No processo anterior de integrao entre o Datasul 11 e o TOTVS SIGAGFE, havia a interveno do sistema ESB, que
intermediava os registros por intermdio de arquivos .xml e de formatao de mapas contendo a estrutura de
campos a ser convertidos entre os sistemas:
Tendo em vista a simplificao do processo e minimizando a possibilidade de erros de integrao, foi desenvolvida
uma nova forma de integrao entre os sistemas Datasul e TOTVS SIGAGFE, eliminando o agente intermedirio.
Verso 1.0
Escopo
Envio de dados do Datasul para o GFE
Para a sincronizao de cadastros e movimentos originados no ERP, so associadas APPCs (Application Partner
Program Call) s rotinas do Datasul 11, cujas principais aes (incluso, alterao, eliminao, cancelamento, etc.)
sero replicadas para a base de dados do TOTVS SIGAGFE.
Recebimento de dados do GFE no Datasul
Para a integrao dos documentos registrados no TOTVS GFE para o ERP utilizada uma rotina de execuo contnua
(Agente Listener), essa rotina monitora a base de dados do TOTVS GFE utilizando como canal de comunicao o
mesmo WS (Web Service) do modelo de envio de dados do ERP para o TOTVS GFE. O controle dos dados que esto
aptos para integrao efetuado pelo TOTVS SIGAGFE.
O Agent Listener utiliza as rotinas de negcio do Datasul 11 para processar os dados; ao final de cada processamento
interage novamente com o TOTVS SIGAGFE (utilizando o WS) para atribuir o resultado: Atualizado ou Rejeitado.
Verso 1.0
Pelo TOTVS SIGAGFE tambm possvel solicitar a eliminao de dados anteriormente processados pela integrao,
situao na qual o resultado do processamento, quando executado com sucesso, retorna a situao do documento
para No enviado no TOTVS SIGAGFE.
Quando o WS no estiver disponvel para conexo, ou houver algum erro de exceo no envio dos dados, mantido
um histrico de falhas na base de dados do Datasul 11 para anlise. A cada intervalo de execuo parametrizado, o
Agent Listener faz uma nova tentativa de conexo com o WS.
O Agent Listener possui 3 formas de execuo e fica a critrio do cliente e/ou consultor de implantao definir qual a
forma de execuo mais adequada. As formas disponveis so:
Rotina com interface
Agendamento via RPW
Sesso em background
Rotina com Interface Monitor de Integrao (CD0433):
1. Executando no TOTVS 11, acesse a rotina Monitor de Inetgrao (CD0433);
2. Selecione os documentos que devem ser integrados e acione o boto Iniciar (Play).
Os documentos sero validados e integrados, quando no houver impedimento no ERP. Em caso de rejeio do
documento, o monitor ir apresentar o motivo retornado pelo ERP.
Para mais detalhes, consulte o manual de referncia da funo Monitor de Integrao (CD0433).
Agendamento via RPW Monitor de Integrao (CD0433):

1. Executando no Datasul 11, acesse a rotina Monitor de Inetgrao (CD0433);
2. Acione o boto Agendar execues via RPW, ser apresentada a janela Criao de Pedidos de Execuo
(BTB911ZB);
3. Selecione o servidor preparado para executar a tarefa e acione a opo Cria pedidos Peridicos, ser
apresentada a janela Repedir Pedido de Execuo (BTB911ZC);
4. Informe a periodicidade desejada para as integraes dos processos do GFE e acione OK para confirmar.
Execuo em Background:
Inclua os dados de execuo do programa CDF433 na inicializao do Windows.
Exemplo de execuo por intermdio de arquivo .BAT:
c:
cd %temp%
start C:\dlc102b\bin\prowin32.exe -pf "\\costao\di-flex-tabatinga-8180\scripts\DIFlex.pf" -ininame
"\\costao\di-flex-tabatinga-8180\scripts\DIFlex.ini" -param "10;super;super@123;SSSSSSS;;Y;GFE" -p
"c:\fndlm\alias.p"
Deve conter a chamada para o arquivo Alias.pf que contm os bancos do Datasul 11, os dados de conexo (login e
senha) e parmetros de inicializao da base Progress.
Outra forma a criao de um atalho contendo estes parmetros e execuo do CDF433, que pode ser acionado
dentro do servidor ou da estao de trabalho que se desejar.
Verso 1.0
5.1
Pr-requisitos instalao/implantao/utilizao
Datasul
Liberao oficial: release 11.5.5 e posteriores.

Liberao controlada: releases 11.5.4 e 11.5.3. Deve-se solicitar liberao especial de pacote de atualizaes via
chamado.
Liberao restrita: releases 11.5.2 e anteriores. Deve-se realizar pelo menos o upgrade para o release 11.5.3.
5.2
Protheus
Atualizao do SIGAGFE at o ltimo pacote e, em caso de liberao controlada, aplicar o pacote com as alteraes
referentes integrao via WebService.
6.1
Instalao/Atualizao
Datasul
Parmetros Globais (CD0101)

Indique a utilizao do TOTVS GFE marcando o campo correspondente no programa Parmetros Globais (CD0101) do
Datasul 11. Sem este parmetro marcado as integraes com o TOTVS GFE no executaro nenhuma ao.
1. Executando no Datasul 11, acesse a rotina Parmetros Globais (CD0101);
2. Aciona a aba Mdulos II e assinale o campo Frete Embarcador Multiplatavorma (TotvsGFE);
3. Acione OK para confirmar.
Para mais detalhes, consulte o manual de referncia da funo Parmetros Globais (CD0101).
Parmetros de Integrao (CD0089)
Pasta Conexo
Nessa pasta so informados os Modos de Integrao e os dados da conexo com Web Service.
Verso 1.0
Para integrao utilizando Web Service deve-se obrigatoriamente indicar que os canais de sada e entrada so Web
Service.
Deve-se informar a URL do WS no campo Servidor e opcionalmente um usurio (e sua senha) da instalao do TOTVS
GFE. A URL informada a mesma que consta na entrada configurada para o WS no arquivo appserver.ini da
instalao do TOTVS GFE.
Por intermdio do boto Testar Conexo possvel verificar se o Datasul 11 consegue estabelecer uma conexo
vlida com o Web Service de integrao do TOTVS GFE.
Por intermdio do boto Histrico possvel consultar as eventuais falhas de conexo com o WS registradas pelas
diversas rotinas de envio de dados do Datasul 11 para o TOTVS GFE, aps o incio da utilizao da integrao via Web
Service.
A opo Integrao temporariamente suspensa pode ser usada para indicar ao Datasul 11 que o Web Service de
integrao com o TOTVS GFE est intencionalmente fora do ar, nesse caso o Datasul 11 ir registrar as pendncias de
integrao para posterior processamento sem realizar tentativas de conexo com o Web Service, poupando recursos
de processamento das rotinas. No necessrio reiniciar os Agentes de integrao ao marcar esse parmetro.
A opo Aviso Eletrnico, quando marcada, enviar um e-mail para os destinatrios informados. O aviso informar
que houve uma falha de conexo do Datasul com o Web Service durante a integrao com o TOTVS GFE, situao na
qual deve-se verificar se o Web Service sofreu alguma queda imprevista.
O boto Configurar d acesso aos programas do Datasul 11 no qual so informados os parmetros de envio de e-mail
e o boto Testar E-mail oferece um teste de envio para confirmar a efetividade das configuraes.
O envio de e-mail e suas configuraes so funcionalidades nativas do framework Datasul 11.
No registro de histrico de falhas de conexo possvel consultar se foi enviado o aviso eletrnico sobre a falha e
quais os destinatrio do aviso; se o envio do aviso falhar, os motivos da falha tambm sero registrados.
Pasta Integraes
Nesta pasta devem ser marcados os cadastros e processos que so integrados com o SIGAGFE.
Internamente, cada parmetro marcado (e confirmado) nas sees desta aba gera a incluso de um programa APPC
nos gatilhos de Criao e eliminao do dicionrio de dados do Datasul 11.
Pasta Faturamento
Esta aba do programa habilitada quando, na aba Integraes, marcado o parmetro Notas fiscais de Sada da
seo Processos (Datasul para GFE), ou o parmetro de simulao de fretes para Nota Fiscal de Sada (seo
Simulao de Frete, parmetro Nota Fiscal de Sada).
Contm parmetros importantes que devem ser considerados pelo SIGAGFE na integrao das notas fiscais de sada.
Pasta Recebimento
Esta aba do programa habilitada quando, na aba Integraes, marcado o parmetro Notas fiscais de Entrada da
seo Processos (Datasul para GFE), ou o parmetro de simulao de fretes para Nota Fiscal de Entrada (seo
Simulao de Frete, parmetro Nota Fiscal de Entrada).
Verso 1.0
Contm parmetros importantes que devem ser considerados pelo SIGAGFE na integrao das notas fiscais de
entrada.
No campo Ao Eliminao, da seo Integrao, define-se qual ser o tratamento que o sistema dever executar
quando solicitada, no mdulo de Recebimento do Datasul, uma eliminao de Nota Fiscal de Rateio originada a partir
de um Documento de Fretes ou de um Contrato com Autnomo do SIGAGFE.
Selecionando a opo Nenhuma, a eliminao da Nota Fiscal de Rateio efetuada normalmente e nenhuma
solicitao enviada ao respectivo Documento de Fretes ou Contrato no SIGAGFE.
A opo Impedir bloqueia a tentativa do usurio de eliminao da Nota Fiscal de Rateio de Frete.
Quando selecionada a opo Integrar, a eliminao da Nota Fiscal envia ao SIGAGFE a informao para que a
situao do Documento de frete ou Contrato com Autnomo passe para Pendente Desatualizao.
Pasta Fiscal
Esta aba habilitada quando marcado o parmetro de integrao do processo de Documento Fiscal do GFE com o
Datasul, na aba Integraes ( seo Processos (GFE para Datasul), parmetro Docto Fiscal (Docto Frete) ).
Nesta pasta, deve ser informado um cdigo de Item vlido, que ser vinculado ao documento fiscal criado.
quando solicitada, no mdulo de Obrigaes Fiscais do Datasul, uma eliminao de Documento Fiscal originado a
partir de um Documento de Fretes do SIGAGFE.
Selecionando a opo Nenhuma, a eliminao do Documento fiscal efetuada normalmente e nenhuma solicitao
enviada ao respectivo Documento de Fretes no SIGAGFE.
A opo Impedir bloqueia a tentativa do usurio de eliminao do Documento.
Quando selecionada a opo Integrar, a eliminao do Documento Fiscal envia ao SIGAGFE a informao para que a
situao do Documento de frete passe para Pendente Desatualizao.
Pasta Financeiro
Esta pasta habilitada quando algum parmetro de integrao com o mdulo financeiro selecionado na pasta
Integraes, seo Processos (GFE para Datasul).
Os campos desta pasta so utilizados para a criao do ttulo no mdulo de Contas a Pagar do sistema financeiro do
Datasul.
Os campos de Espcie de Pr-faturas, Faturas e Contrato so obrigatrios para que o documento seja gerado.
Para pr-faturas, a espcie informada deve ser do tipo PROVISO.
quando solicitada, no mdulo Financeiro do Datasul, uma eliminao de Ttulo originado a partir de um Documento
do SIGAGFE (Pr-fatura, fatura ou contrato).
Selecionando a opo Nenhuma, a eliminao do Ttulo efetuada normalmente e nenhuma solicitao enviada ao
respectivo Documento no SIGAGFE.
Verso 1.0
A opo Impedir bloqueia a tentativa do usurio de eliminao do Documento.

Quando selecionada a opo Integrar, a eliminao do Ttulo envia ao SIGAGFE a informao para que a situao do
Documento passe para Pendente Desatualizao.
Outras Funcionalidades
Todas as funcionalidades chamados pelos botes mencionados abaixo tambm podem ser executados
separadamente, atravs do menu do Datasul ou pelas teclas de atalho (Ctrl+Alt+x):
Sincronizao com GFE, este boto abre o programa de sincronizao Batch dos dados de cadastro e notas
fiscais do Faturamento e Recebimento do Datasul 11 para o GFE.
Verificar Sincronismo de Dados, este boto abre a funo Verificar Sincronismo de Dados (CD0084), onde
possvel visualizar os percentuais de registros dos cadastros do Datasul 11 integrados ao GFE.
Aps aberto o programa, deve-se clicar no boto Atualizar para iniciar a contagem de registros na base de
dados do Datasul 11 e a comparao com os registros existentes na base do GFE.
Contingncia de Integrao, Registros que deixam de integrar do Datasul para o GFE por falha na
comunicao com o WebService podero ser visualizados na funo Contingencia de Integrao (CD0082),
executados a partir deste boto.
No programa tambm possvel reenviar os registros para integrao aps o reestabelecimento da
comunicao ou descart-los.
Nos botes da rgua superior do programa, pode-se testar a conexo com o WebService e agendar execuo
da integrao via servidor RPW.
Matrizes de Traduo, na funo Matriz de Traduo (CD0089B) deve-se criar a relao entre os
estabelecimentos do Datasul 11 com os estabelecimentos do GFE.
O programa composto por duas abas, uma onde relacionamos os estabelecimentos dos mdulos fiscal,
faturamento e recebimento com o GFE e outra relacionando os estabelecimentos do mdulo financeiro com
o GFE.
Quando no houver diferena nos cdigos entre os sistemas, mantenha a coluna Filial GFE em branco.
APPCs de Integrao, esta opo apresenta os programas de integrao que so vinculados aos gatilhos de
dicionrio ou interface do Datasul 11.
Para ativar os gatilhos do dicionrio de dados, deve ser executado o Otimizador de performance.
Por contingncia, possvel retirar algum programa de integrao do ar atravs do boto Retirar APPC.
Para voltar o cadastro da APPC retirada, pode-se utilizar o boto Atribuir APPCs Conforme Configurao de
Integrao, que atribui os programas APPCs conforme configuraes de integrao.
Na mesma funcionalidade podem ser verificadas as UPCs e DPCs ativas no sistema Datasul.
No sistema de integrao padro, no so cadastrados programas UPCs ou DPCs. Porm, eles podem ser
criados sob demanda (atravs de customizao) para atender necessidades especficas de integrao.
Parmetros do mdulo de finanas

Cadastrar o mdulo GFE no APB (programa BAS_MODUL_DTSUL).
10
Verso 1.0
FILTRO DE NOTAS FISCAIS E CONVERSO DA NATUREZA DE OPERAO

Para filtrar notas fiscais do faturamento e recebimento, que no necessitam ser enviadas para o GFE (exemplo: notas
fiscais de sada com tipo de frete FOB), utilize o programa de Engine de regras, cadastrando antecipadamente o tipo
de operao no programa CD0025 e posteriormente utilizando-o para o cadastro da regra no programa CD0024, com
a utilizao das respectivas variveis para manipulao:
Faturamento (Nota fiscal de sada):
Cadastrar o tipo de operao GFE-NFS e utilizar as variveis:
cod-estabel
serie
nome-ab-cli
cod-emitente
cod-cond-pag
nome-transp
nat-operacao
ind-tip-nota
esp-docto
ind-tp-frete
cidade-cif
Recebimento (Nota fiscal de entrada):
Cadastrar o tipo de operao GFE-NFE e utilizar as variveis:
cod-emitente
tipo-frete
ind-tip-nota
nat-oper
Exemplo de cadastro de regras.
Este exemplo visa bloquear notas fiscais de entrada com tipo de frete CIF:
1. Cadastrar o tipo de operao no CD0025;
Verso 1.0
11
2. Cadastrar o cabealho da Regra no CD0024;

3. Incluir varivel que ter a condio avaliada;
4. Incluir um nome para a Regra;
5. Informar a condio para atribuio da regra;
6. Incluir o retorno para o campo GFE-NFE (mesmo nome do tipo de operao) igual a NO.
Para o processo de integrao de processos do GFE com mdulos do Datasul, utilize da mesma forma os cadastros de
tipo de operao e regra de negcios para a adequao de campos, como por exemplo, alterao de natureza de
12
Verso 1.0
operao na integrao do documento de fretes com o fiscal. Utilize os tipos de operao e variveis abaixo para
converses de dados nas integraes com os mdulos:
FISCAL:
Cadastrar o tipo de operao GFE-FISCAL e utilizar as variveis:
cod-estabel
cod-emitente
cidade
estado
nat-operacao
cod-acesso-cte
it-cd-trib-iss
it-aliquota-ISS
it-cd-trib-icm
it-aliquota-icm
Nota Fiscal de Rateio:
Cadastrar o tipo de operao GFE-RE e utilizar as variveis:
nat-operacao
cod-servico
aliquota-icm
6.2
Protheus
Web Service
Deve-se parametrizar os dados para execuo do WebService no arquivo appserver.ini da instalao do TOTVS GFE.
Deve-se criar uma entrada como a do exemplo acima, informado o IP ou Host do servidor no qual o AppServer est
instalado e uma porta de comunicao exclusiva para o Web Service. Como PATH deve-se informar o caminho no
qual os arquivos de Web Service esto localizados (diretrio de instalao do TOTVS GFE + "\web\ws"). Como
ENVIRONMENT deve-se informar o ambiente parametrizado para acesso s bases de dados do TOTVS GFE. Os
demais parmetros podem ser mantidos como os do exemplo.
Tambm se deve inserir a clusula PREPAREIN nos parmetros do JOB_WS do arquivo, contendo a empresa do
SIGAGFE e um estabelecimento padro.
Verso 1.0
13
Aps a configurao e reinicializao do APP Server do TOTVS GFE, pode-se verificar a disponibilidade do servio e do
mtodo de comunicao do WS pelo navegador de internet: abra uma pgina do tipo http informando o caminho
parametrizado para o WS; verifique se o mtodo WSGFE est habilitado.
No caso do link WSGFE no ser mostrado, certifique-se de ter atualizado o RPO do ambiente at o patch mais
recente do ambiente Protheus e ao persistir essa situao, solicite uma atualizao de programas abrindo um
chamado para a TOTVS.
Aps acionar o link WSGFE deve ser apresentada uma pgina com os seguintes mtodos. No caso algum desses
mtodos no ser mostrado, certifique-se de ter atualizado o RPO do ambiente at o patch mais recente do ambiente
Protheus e ao persistir essa situao, solicite uma atualizao de programas abrindo um chamado para a TOTVS.
14
Verso 1.0
Parametrizar, nos Parmetros do frete embarcador (GFEX000), a configurao da URL do WebService com a porta e o
nome da instncia:
Especificamente nos casos da integrao de Notas Fiscais de Sada e Notas Fiscais de Entrada, os dados integrados
diretamente na base de dados do TOTVS SIGAGFE passaro por uma validao de consistncia, aplicada pela rotina
Agent Releaser, mantida em execuo por intermdio do Scheduler na instalao do TOTVS GFE.
Verso 1.0
15
16
Verso 1.0
O programa CD9125 permite a integrao em lote dos dados existentes na base de dados do Datasul 11 anteriores
implantao do TOTVS GFE. (Ver seo Sincronizao com GFE, programa CD9125).
Quando o WS no estiver disponvel para conexo ou houver algum erro de exceo no envio dos dados, ser
mantido um histrico de falhas na base de dados do Datasul 11 para anlise e reprocessamento.
Verso 1.0
17
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 devero 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.
Suporte
O suporte aos recursos da Integrao ser de responsabilidade de todas as linhas, sendo assim as equipes de suporte
dos produtos Datasul 11 e Protheus SIGAGFE estaro aptas a fazer a primeira anlise e, quando necessrio, repassar
para a equipe mais adequada em cada caso.
Fluxo das Informaes
informaes
GFE
DATASUL / TOTVS 11
CLIENTES
EMITENTES
FORNECEDORE
S
CONTATOS
CIDADE
CIDADE
UNITIZADORES
EMBALAGENS
CENTRO DE
CUSTO
CONTA
CONTBIL
CENTRO DE
CUSTO
CONTA
CONTBIL
GRUPO DE
EMITENTES
GRUPO DE
CLIENTES
18
Verso 1.0
GFE
DATASUL / TOTVS 11
NOTA FISCAL
DE SADA
DOC. CARGA
NOTA FISCAL
DE ENTRADA
EMBARQUE
ROMANEIO
DOCUMENTO
FISCAL
DOCUMENTO
DE FRETES
NOTA FISCAL
DE RATEIO
CONTRATO
FOLHA DE
PAGAMENTO
PR-FATURA
TTULO A
PAGAR*
FATURA
* Para as pr-faturas, o ttulo a pagar de espcie Provisria.
10
Situaes comuns (opcional)
Integrao com mdulo financeiro:

1 Ao integrar com o financeiro, ocorrem os erros:
8437 - Usurio financeiro <nome usurio> no habilitado para estabelecimento <Cod. Estab.>
20639 - Atualizao no permitida para o usurio !
20636 - Implantao no permitida para o usurio !
8437 - Usurio financeiro <nome usurio> no habilitado para estabelecimento .
Soluo:
Cadastrar, no programa de manuteno de permisses do usurio no mdulo APB, a relao entre o Usurio de
criao do ttulo e o mdulo GFE (o mdulo GFE deve estar previamente cadastrado no financeiro).
Devem ser cadastradas tambm as permisses do usurio com o estabelecimento financeiro.
Verso 1.0
19
2 Cadastros do Datasul 11 no so integrados com GFE, mesmo com os parmetros de integrao de cadastros
marcados no CD0089.
Soluo:
Executar o programa Otimizador de Performance de Produto do Datasul e reiniciar a sesso.
Caso a ao anterior no tenha efeito, verifique se o seu usurio do ERP tem permisses para gravao no dicionrio
de dados.
3 Nota fiscal de sada no integrou com o GFE.
Soluo:
1. Verificar se o registro encontra-se na lista de Contingencias de integrao, no programa CD0089. Em caso
positivo, verificar o motivo e solicitar a integrao do registro atravs do boto Integrar.
2. Verificar se as APPCs referentes a clculo e manuteno de notas fiscais esto acionadas (programa
CD0089). Em caso negativo, revisar os parmetros da aba integrao e confirmar.
3. Verificar no programa de Engine de regras, CD0024, se h alguma regra de filtro de notas fiscais de sada
(conforme tpico FILTRO DE NOTAS FISCAIS E CONVERSO DA NATUREZA DE OPERAO).
4. Executar o programa CD9125, informando os dados da nota fiscal em questo.
20
Verso 1.0
4 Nota fiscal de entrada no integrou com o GFE.

Soluo:
1. Verificar se o registro encontra-se na lista de Contingencias de integrao, no programa CD0089. Em caso
positivo, verificar o motivo e solicitar a integrao do registro atravs do boto Integrar.
2. Verificar se as APPCs referentes a clculo e manuteno de notas fiscais esto acionadas (programa
CD0089). Em caso negativo, revisar os parmetros da aba integrao e confirmar.
3. Verificar no programa de Engine de regras, CD0024, se h alguma regra de filtro de notas fiscais de entrada
(conforme tpico FILTRO DE NOTAS FISCAIS E CONVERSO DA NATUREZA DE OPERAO).
4. Executar o programa CD9125, informando os dados da nota fiscal em questo.
5. Confirmar se a nota fiscal atualizou o estoque (RE0701a, aba integ. Sist., campo CE atualizado).
5 Aps aplicao do pacote de atualizao do GFE, no aparece o mtodo WSGFE na consulta da URL + porta +
instancia atravs do navegador de internet.
Soluo:
Finalizar todas as sesses do GFE e reiniciar o servio appserver no servidor da aplicao.
11
Checklist de suporte da aplicao
Instalao/Configurao
1. Verificar se o mtodo WSGFE apresentado na consulta da URL+porta+instancia pelo navegador de internet.
2. Testar conexo com o WebService atravs do programa CD0089.
3. Verificar se as transaes EAI referente ao frete foram retiradas (boto Configurao EAI, programa
CD0089).
4. Confirmar se a lista de APPCs referente ao mdulo de gesto de frete embarcador esto acionadas (boto
APPCs de integrao, programa CD0089).
Checklist de Verificaes:
Identificar o funcionamento da integrao:
o Para integrao de informaes do Datasul para o GFE:
Verificar existncia de registros em Contingncias de integrao e a causa descrita.
Solicitar a integrao do registro pelo boto Integrar e confirmar a integrao ou erro.
o Para integrao de processos do GFE para o Datasul 11:
Executar novo pedido de atualizao do processo no GFE e acompanhar integrao
atravs do monitor CD0433.
Coletar evidncias do mau funcionamento relatado pelo cliente
o Para cadastros e notas fiscais, comparar as imagens de telas de consultas do mesmo registro no
Datasul 11 e no GFE.
o Para processos, solicitar o arquivo de log do CD0433 gravado no diretrio temporrio da sesso.
Em caso de execuo via RPW, solicitar o arquivo de log do CD0433rp gravado no servidor de
execuo.
Verso 1.0
21
12
Anexos
Anexo I Relao entre o Datasul 11 e o SIGAGFE

CADASTROS
Datasul 11
TOTVSGFE
Grupos de Clientes
Grupos de Emitentes
Clientes/Fornecedores
Emitentes
Contatos dos Clientes/Fornecedores
Contatos dos Emitentes
Cidades
Cidades
Embalagens
Unitizadores
Contas Contbeis
Centros de Custo
Centros de Custo
DOCUMENTOS (Datasul para GFE)

Datasul 11
TOTVSGFE
Nota Fiscais de Sada
Documentos de Carga
Embarques
Romaneios
Documentos de Entrada
DOCUMENTOS (GFE para Datasul)

Datasul 11
TOTVSGFE
Documentos Fiscais
Documentos de Frete
Ttulos a Pagar
Pr-faturas de Frete
Ttulos a Pagar
Faturas de Frete
Ttulos a Pagar
Nota de Rateio
Faturas de Frete
Nota de Rateio
Prestaes de Servio de Terceiros
22
Verso 1.0
ANEXO II - Lista de Programas evolvidos na integrao

Programa
Cdigo do
Programa
Eventos
APPCs
Cadastro de Grupos de
Emitentes
CD0701
Trigger write, Trigger

delete
CDAPI622 / CDAPI623
Cadastro de Clientes
CD0704

delete
CDAPI600 / CDAPI606
Importao de Clientes
CD1302

delete
CDAPI600 / CDAPI606
Cadastro de Fornecedores
CD0401

delete
CDAPI600 / CDAPI606
Importao de Fornecedores
CD1608

delete
CDAPI600 / CDAPI606
Cadastro de Cidades
CD0330

delete
CDAPI609 / CDAPI602
Cadastro de Embalagens
CD1117

delete
CDAPI624 / CDAPI625
UTB033AA

delete
PRGINT/UTB/UTB600GF.P
Centros de Custo
UTB066AA

delete
Notas Manuais
FT4003
EndEfetivaNota
CDAPI655
Faturamento de Pedidos
FT4002
EndEfetivaNota
CDAPI655
Clculo de Embarques
FT4001
EndEfetivaNota
CDAPI655
Fim_cancelanotafiscal
CDAPI652
Cancelamento de Notas Fiscais FT2200

de Sada
Simulao de Embarques
EQ0503
Gerao de Pr-faturamento
EQ0504
Gerao de Embarques
EQ0506
CDAPI630

delete
Atualizao de Documentos de RE1001/RE1005

Entrada
fim-atualizacao
CDAPI651
Desatualizao de
RE0402RP
CDAPI650
Verso 1.0
RE0402
23
Anexo III Programas sem correspondente no SIGAGFE e justificativa.

Programa
Cdigo do
Programa
Justificativa
Cadastro de Transportadores
CD0402
Os Transportadores devem ser obrigatoriamente cadastrados como

Fornecedores para a integrao com o GFE.
Cadastro de Representantes
CD0708
No GFE o nome abreviado do Representante do Documento de

Carga tem relevncia restrita e no possui tabela estrangeira
relacionada.
Cadastro de Grupos de
Estoque
CD0201
No GFE o cdigo do Grupo de Estoque dos Itens do Documento de

relacionada.
Cadastro de Famlias
Comerciais
CD0206
No GFE o cdigo da Famlia Comercial dos Itens do Documento de

relacionada.
Cadastro de Famlias de
Materiais
CD0202
No GFE o cdigo do Grupo da Famlia de Material dos Itens do

Documento de Carga tem relevncia restrita e no possui tabela
estrangeira relacionada.
Cadastro de Canais de Venda
CD1517
No GFE o cdigo do Canal de Venda do Documento de Carga tem

relevncia restrita e no possui tabela estrangeira relacionada.
Cadastro de Unidades de
Negcio
CD9762
No GFE o cdigo da Unidade de Negcio dos Itens do Documento

de Carga tem relevncia restrita e no possui tabela estrangeira
relacionada.
Cadastro de Naturezas de
Operao
CD0606
A Natureza de Operao uma entidade prpria do Datasul e no

GFE no utilizada como entidade agregadora da parametrizao
tributria como no Datasul.
Cadastro de CFOPs
CD0620
Quantidade de registros varia pouco. O CFOP um dado

informativo no GFE por isso no validado contra uma tabela
previamente cadastrada.
Cadastro de Itens (e
relacionados)
CD0204/
CD0205/
...
No GFE o cdigo dos Itens dos Documentos de Carga tem

relevncia restrita e no possuem tabela estrangeira relacionada.
Cadastro de
Estabelecimentos
CD0403
As Filiais requerem um processo prprio de autorizao na

plataforma Protheus.
Cadastro de Empresas
CD0104
As Empresas fazem parte do layput de Filiais na plataforma

Protheus.
Cadastro de Pases
CD0181
Quantidade de registros varia pouco.
CD0904
Poucas ocorrncias na tabela. Quantidade de registros varia pouco.
24
Verso 1.0
Federao
Medida
CD0203
No GFE a Unidade de Medida utilizada apenas em rotinas e

entiades do prprio mdulo, sem relao com os registros
recebidos ou enviados para o ERP.
Cadastro de Sries Fiscais
CD0905
Nmero de registros varia pouco. A Srie Fiscal no uma

informao relevante para o GFE, utilizada apenas para compor a
identificao nica de certos documentos.
Calendrio Comercial
CD0211
O GFE possui um calendrio prprio e independente, restrito s

informaes utilizadas nas operaes relacionadas ao transporte de
cargas.
Anexo IV - Lista de APPCs

APPC
cdapi600
Programa ou tabela
relacionada
Finalidade
mgadm.emitente
Sincronizao da incluso e alterao de clientes e fornecedores
mgdis.cidade
Sincronizao da eliminao de cidades
cdapi605
movind.docum-est
Sincronizao da eliminao de Nota de Rateio gerada pela integrao

com GFE
cdapi606
mgadm.emitente
Sincronizao da eliminao de clientes e fornecedores
mgdis.cidade
Sincronizao da incluso e alterao de cidades
cdapi618
movdis.wt-docto
Eliminar os registros da tabela de extenso wt-docto-redesp
cdapi619
movdis.nota-fiscal
Eliminar os registros das tabelas de extenso nota-fisc-redesp e simulnota-fisc
cdapi620
pd4000
Disponibilizar lista de campos para os Redespachantes e o boto para

Simulao de Fretes
cdapi621
pd4050
Disponibilizar o boto para Simulao de Fretes
cdapi622
mgadm.gr-cli
Sincronizar da incluso e alterao de Grupos de Clientes
cdapi601
cdapi602
cdapi603
cdapi604
cdapi607
cdapi608
cdapi609
cdapi610
Verso 1.0
25
cdapi623
mgadm.gr-cli
Sincronizar da eliminao de grupos de clientes
cdapi624
mgdis.embalag
Sincronizar da incluso e alterao de Embalagens
cdapi625
mgdis.embalag
Sincronizar da eliminao de Embalagens
cdapi630
mgdis.embarque
Sincronizar da incluso e alterao de Embarques
cdapi631
mgdis.embarque
Sincronizar da eliminao de Embarques
cdapi632
mgadm.cont-emit
Sincronizar a incluso e alterao de Contatos dos Emitentes
cdapi633
mgadm.cont-emit
Sincronizar da eliminao de Contatos dos Emitentes
cdapi634
movdis.doc-fiscal
Sincronizar a eliminao de Documento Fiscal gerado pela integrao

com GFE
cdapi650
re0402rp
Sincronizar a desatualizao de Documentos de Entrada
cdapi651
re1005rp; reapi190
Sincronizar da incluso de Documentos de Entrada
cdapi652
bodi135cancel
Sincronizar o cancelamento de Notas Fiscais de Sada
cdapi653
ft0502
Emitir mensagem informando que no h integrao dos dados

alterados para o GFE
cdapi655
bodi317ef; bodi317ef
Sincronizar da incluso de Notas Fiscais de Sada
cdapi656
boin090
Criar registro da tabela de extenso da docum-est
cdapi657
boin176
Criar registro da tabela de extenso da item-doc-est
cdapi654
cdapi658
Em desuso.
cdapi659
cdapi660
re1001a1
Disponibilizar o boto "Outros Totais" que solicita os campos Peso

Bruto total, Peso Cubado total e Volume total do Documento de
Entrada e o boto "Fretes" que solicita os Redespachantes,
Embalagens e campos para o clculo de frete automtico.
cdapi661
re1001b2
Disponibilizar os campos Peso Bruto, Peso Cubado e Volume na

alterao de Itens do Documento de Entrada
cdapi662
re1001b

navegao de Itens do Documento de Entrada
cdapi663
re0701b
cdapi664
re0501ra
cdapi665
re0501rb
26
Verso 1.0
cdapi666
re0501rc
cdapi667
re0501rd
cdapi668
re0701
cdapi669
cdapi670
re2001a
Criar registro da tabela de extenso da docum-est
cdapi671
re2001z
Criar registro da tabela de extenso da item-doc-est
cdapi673
re2001b

manuteno de Itens do Recebimento Fsico.
cdapi674
ft4003b
Solicitar os Redespachantes da Nota Fiscal de Sada no programa de

Faturamento de Notas Manuais
cdapi675
ft4060b
Em desuso. Emisso de Nota Manual (verso internacional) est fora

do escopo do GFE.
cdapi677
pd1001
Disponibilizar os Redespachantes e dados da Simulao de Frete da

Nota Fiscal para consulta
cdapi678
pd4050a
Solicitar os Redespachantes no programa de Manuteno de Pedidos

de Venda
cdapi679
ft0904
Disponibilizar os Redespachantes e dados da Simulao de Frete do

Pedidos de Venda para consulta
cdapi680
bodi159
Gravar o registro com os Redespachantes na tabela de extenso do

Pedido de Venda
cdapi681
bodi317sd
Redespachantes da Nota Fiscal de Sada
cdapi682
ft4001
Disponibilizar o boto de Simulao de Frete no programa de Clculo

de Embarques
cdapi683
ft4003
Disponibilizar campos para o clculo de frete automtico no programa

de Emisso de Notas Manuais
cdapi684
ft4005
Disponibilizar o boto de Simulao de Frete no programa de Emisso

de Notas Manuais
cdapi685
ft4001a
Disponibilizar o boto de Simulao de Frete no programa de

Faturamento por Embarque
ft4002
Disponibilizar o boto de Simulao de Frete no programa de
cdapi676
cdapi686
cdapi687
cdapi688
Verso 1.0
27
Faturamento de Pedidos de Venda

cdapi689
bodi159cpy
Realiza a cpia do registro da tabela de extenso com os

Redespachantes do Pedido de Venda
cdapi805
boin295
cdapi806
cc0300a
cdapi807
cc0300b
cdapi808
cc0311rp
cdapi809
cc0506
cdapi810
cc0509
cdapi811
oc0201a
utb600gf
emsuni.cta_ctbl_integr Sincronizao da incluso e alterao de Contas Contbeis de

Integrao
utb601gf
emsuni.cta_ctbl_integr Sincronizao da eliminao de Contas Contbeis de Integrao
utb602gf
emsuni.ccusto
Sincronizao da incluso e alterao de Centros de Custo
utb603gf
emsuni.ccusto
Sincronizao da eliminao de Centros de Custo
utb607gf
movfin.tit_ap
Sincronizao da eliminao de Ttulo a Pagar gerado pela integrao

com GFE
Em desuso
28
Verso 1.0

Manual de Integração - GFE X Datasul

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual de Integração - GFE X Datasul

Enviado por

Direitos autorais:

Formatos disponíveis

Integrao Datasul 11 x Protheus / SIGAGFE

Datasul 11 x Protheus / SIGAGFE

Contexto de negcio .................................................................................................................. 3

Sistemas Envolvidos ................................................................................................................... 4

Pr-requisitos instalao/implantao/utilizao ..................................................................... 7

Controle de Verso .................................................................................................................... 18

Fluxo das Informaes ............................................................................................................... 18

Situaes comuns (opcional) ..................................................................................................... 19

Checklist de suporte da aplicao .............................................................................................. 21

Datasul 11 x Protheus / SIGAGFE>

Datasul 11 x Protheus / SIGAGFE

Protheus / Gesto de Frete Embarcador

Datasul 11 x Protheus / SIGAGFE>

Envio de dados do Datasul para o GFE

Recebimento de dados do GFE no Datasul

Datasul 11 x Protheus / SIGAGFE

Agendamento via RPW Monitor de Integrao (CD0433):

Datasul 11 x Protheus / SIGAGFE>

Liberao oficial: release 11.5.5 e posteriores.

Parmetros Globais (CD0101)

Datasul 11 x Protheus / SIGAGFE

Datasul 11 x Protheus / SIGAGFE>

Datasul 11 x Protheus / SIGAGFE

A opo Impedir bloqueia a tentativa do usurio de eliminao do Documento.

Parmetros do mdulo de finanas

Datasul 11 x Protheus / SIGAGFE>

FILTRO DE NOTAS FISCAIS E CONVERSO DA NATUREZA DE OPERAO

Datasul 11 x Protheus / SIGAGFE

2. Cadastrar o cabealho da Regra no CD0024;

4. Incluir um nome para a Regra;

5. Informar a condio para atribuio da regra;

Datasul 11 x Protheus / SIGAGFE>

Datasul 11 x Protheus / SIGAGFE

Datasul 11 x Protheus / SIGAGFE>

Datasul 11 x Protheus / SIGAGFE

Datasul 11 x Protheus / SIGAGFE>

Datasul 11 x Protheus / SIGAGFE

Fluxo das Informaes

Datasul 11 x Protheus / SIGAGFE>

* Para as pr-faturas, o ttulo a pagar de espcie Provisria.

Situaes comuns (opcional)

Integrao com mdulo financeiro:

Datasul 11 x Protheus / SIGAGFE

Datasul 11 x Protheus / SIGAGFE>

4 Nota fiscal de entrada no integrou com o GFE.

Checklist de suporte da aplicao

Datasul 11 x Protheus / SIGAGFE

Anexo I Relao entre o Datasul 11 e o SIGAGFE

Contatos dos Clientes/Fornecedores

Contatos dos Emitentes

Contas Contbeis Integrao

DOCUMENTOS (Datasul para GFE)

Nota Fiscais de Sada

DOCUMENTOS (GFE para Datasul)

Contratos com Autnomos

Contratos com Autnomos

Prestaes de Servio de Terceiros

Contratos com Autnomos

Datasul 11 x Protheus / SIGAGFE>

ANEXO II - Lista de Programas evolvidos na integrao

Trigger write, Trigger

Trigger write, Trigger