Integração Datasul 11 e SIGAGFE

Documento para Integraes
Nova Integrao
Datasul 11 x SIGAGFE
Nova Integrao Datasul 11 x SIGAGFE
Este documento relaciona as informaes do novo processo de integrao entre os produtos Datasul 11 e o sistema de Gesto do
Frete Embarcador. Primeiramente contextualizado o fluxo atual de integrao das informaes entre os dois sistemas. Na sequencia
so demonstrados o fluxograma da nova integrao, apresentados os novos programas e o mtodo de implantao, com possveis
situaes e finalizando com check-list de conferncia.
Data da reviso
20/02/2013
Responsvel
PEDRO.SCANDOLARA
Descrio da reviso
1.0
DATASUL 11 x SIGAGFE
Contedo
Contedo.............................................................................................................................................. 3
Contexto de negcio (introduo) ........................................................................................................ 4
Sistemas envolvidos ............................................................................................................................. 5
Integrao ............................................................................................................................................ 5
Escopo .................................................................................................................................................. 6
Pr-requisitos instalao/implantao/utilizao ................................................................................ 11
Instalao/Atualizao ......................................................................................................................... 11
Controle de verso ............................................................................................................................... 29
Suporte................................................................................................................................................. 29
10 Transaes/Entidades/Mensagens nicas ............................................................................................ Erro! Indicador

no definido.
11
Fluxo das informaes .......................................................................................................................... 29
12 Limitaes/Restries gerais ................................................................................................................ Erro! Indicador

no definido.
13 Como fazer (opcional) .......................................................................................................................... Erro! Indicador
no definido.
14
Situaes comuns (opcional) ................................................................................................................ 31
15
Checklist de suporte da aplicao ......................................................................................................... 33
16
Anexos ................................................................................................................................................. 34
Contexto de negcio (introduo)
Gesto de Frete Embarcador (GFE) 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 os seguintes:
PROCESSOS
CADASTROS
DATASUL
SIGAGFE
Fornecedores...................................
Grupo de Clientes............................
Clientes............................................
Cidades............................................
Embalagens.....................................
Contas Contbeis Integrao...........
Centros de Custo.............................
Emitentes
Grupo de Emitentes
Emitentes
Cidades
Unitizadores
Contas Contbeis
Centros de Custo
Notas Fiscais de Sada.....................

Embarques.......................................
Documentos de Entrada..................
Documentos de Carga
Romaneios
Documentos de Carga
Os Processos realizados dentro do SIGAGFE e que tem informaes enviadas aos mdulos do Datasul 11
so:
PROCESSOS
SIGAGFE
DATASUL
Pr-faturas de Frete................................
Ttulos de Proviso
Documentos de Frete.............................
Documentos Fiscais
Documentos de Frete.............................
Notas de Rateio
Faturas de Frete......................................
Ttulos a Pagar
Contratos com Autnomos....................
Ttulos a Pagar
Notas de Rateio
Movimentos de Prestao de Servio

Sistemas envolvidos
Descrio dos sistemas envolvidos no contexto de negcio (e que sero envolvidos na integrao).
Gesto de Frete Embarcador.
Datasul 11:
o Cadastros Gerais;
o Faturamento;
o Recebimento;
o Fiscal;
o Financeiro;
o RH.
Integrao
No processo antigo de integrao entre o Datasul 11 e o GFE, havia a interveno do sistema ESB, que
intermediava os registros atravs 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, criamos

uma nova forma de integrao entre os sistemas Datasul e SIGAGFE, eliminando o agente intermedirio.
Escopo
O Novo Modelo de integrao

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 GFE.
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 GFE passaro por uma validao de consistncia, aplicada
pela rotina Agent Releaser, mantida em execuo por intermdio do Scheduler na instalao do TOTVS GFE.
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.
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 GFE. 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 GFE (utilizando o WS) para atribuir o resultado: Atualizado ou Rejeitado. Pelo TOTVS GFE 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 GFE.
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. A cada intervalo de execuo
parametrizado, o Agent Listener far uma nova tentativa de conexo com o WS.
O Agent Listener possui 3 formas de execuo: Sesso em background, agendamento via RPW e rotina com
interface. Fica a critrio do cliente e/ou consultor de implantao definir qual a forma de execuo mais
adequada:
Programa CD0433:
Executando no Totvs 11 o programa CD0433, selecione os documentos que devem ser integrados e clicar
na opo 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.
Agendamento via RPW:

No programa CD0433, clicar no boto Agendar execues via RPW. Selecionar o servidor preparado
para executar a tarefa e clicar em Cria pedidos Peridicos, e informar a periodicidade desejada para as
integraes dos processos do GFE.
10
Execuo em Background:
Incluir os dados de execuo do programa CDF433 na inicializao do Windows. No anexo, verifique o
arquivo .bat de exemplo. Deve conter a chamada para o arquivo Alias.pf que contm os bancos do Totvs 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.
Pr-requisitos instalao/implantao/utilizao
Pr-requisitos
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.
Atualizao do SIGAGFE at o ltimo pacote e, em caso de liberao controlada, aplicar o pacote com as
alteraes referentes integrao via WebService.
Instalao/Atualizao
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 +
11
"\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.
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.
12
Parametrizar, nos Parmetros do frete embarcador, a configurao da URL do WebService com a porta e o nome
da instncia:
Parmetros Globais
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.
13
Parmetros de Integrao
A parametrizao das integraes continua a ser configurada no programa Parmetros de Integrao , mas o
cdigo do programa passa a ser CD0089 em vez de CD0080. Ao executar a rotina utilizando o cdigo CD0080 o
programa CD0089 automaticamente executado.
Pasta "Conexo"
Nessa pasta so informados os Modos de Integrao e os dados da conexo com Web Service.
Para integrao utilizando Web Service deve-se obrigatoriamente indicar que os canais de sada e entrada so
Web Service.
14
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 (interface demonstrada a seguir) 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
15
"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.
16
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).
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.
17
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.
executar 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.
18
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.
executar quando solicitada, no mdulo Financeiro do Datasul, uma eliminao de Ttulo originado a partir de um
Documento do SIGAGFE (Pr-fatura, fatura ou contrato).
19
Selecionando a opo Nenhuma, a eliminao do Ttulo efetuada normalmente e nenhuma solicitao

enviada ao respectivo Documento no SIGAGFE.
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:
20
Verificar Sincronismo de Dados
Este boto abre o programa CD0084, onde possvel visualizar os percentuais de registros dos cadastros do
Datasul 11 integrados ao GFE:
21
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 no programa 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.
22
Agendar Servidor RPW
Testar Conexo com Web Service
Matrizes de Traduo
Neste programa 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.
23
24
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
configuraes de integrao.
, que atribui os programas APPCs conforme
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.
25
Parmetros do mdulo de finanas

Cadastrar o mdulo GFE no APB (programa BAS_MODUL_DTSUL).
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.
- Cadastrar o tipo de operao no CD0025;
26
- Cadastrar o cabealho da Regra no CD0024;

- Incluir varivel que ter a condio avaliada;
- Incluir um nome para a Regra;
- Informar a condio para atribuio da regra;
27
- 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 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"
28
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 e SIGAGFE estaro aptas a fazer a primeira anlise e, quando necessrio,
repassar para a equipe mais adequada em cada caso.
10 Fluxo das informaes

GFE
DATASUL / TOTVS 11
CLIENTES
EMITENTES
FORNECEDORES
CONTATOS
CIDADE
CIDADE
UNITIZADORES
EMBALAGENS
CENTRO DE CUSTO
CENTRO DE CUSTO
CONTA CONTBIL
CONTA CONTBIL
GRUPO DE
EMITENTES
GRUPO DE
CLIENTES
29
GFE
DATASUL / TOTVS 11
NOTA FISCAL DE
SADA
DOC. CARGA
NOTA FISCAL DE
ENTRADA
EMBARQUE
ROMANEIO
DOCUMENTO
FISCAL
DOCUMENTO DE
FRETES
CONTRATO
NOTA FISCAL DE
RATEIO
FOLHA DE
PAGAMENTO
PR-FATURA
TTULO A PAGAR*
FATURA
* Para as pr-faturas, o ttulo a pagar de espcie Provisria.
30
11 Situaes comuns
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.
31
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.
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.
32
12 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.
33
13 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 Integrao
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 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
Contratos com Autnomos
Nota de Rateio
Faturas de Frete
Nota de Rateio
Prestaes de Servio de Terceiros
34
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
CDAPI600 / CDAPI606
Importao de Clientes
CD1302
CDAPI600 / CDAPI606
Cadastro de Fornecedores
CD0401
CDAPI600 / CDAPI606
Importao de Fornecedores
CD1608
CDAPI600 / CDAPI606
Cadastro de Cidades
CD0330
CDAPI609 / CDAPI602
Cadastro de Embalagens
CD1117
CDAPI624 / CDAPI625
Contas Contbeis Integrao
UTB033AA
PRGINT/UTB/UTB600GF.P
Centros de Custo
UTB066AA
Notas Manuais
FT4003
EndEfetivaNota
CDAPI655
Faturamento de Pedidos
FT4002
EndEfetivaNota
CDAPI655
Clculo de Embarques
FT4001
EndEfetivaNota
CDAPI655
Cancelamento de Notas Fiscais de

Sada
FT2200
Fim_cancelanotafiscal
CDAPI652
Simulao de Embarques
EQ0503
Gerao de Pr-faturamento
EQ0504
Gerao de Embarques
EQ0506
Atualizao de Documentos de
Entrada
RE1001/RE1005
fim-atualizacao
Desatualizao de Documentos de
Entrada
RE0402
CDAPI630
RE0402RP
CDAPI651
CDAPI650
35
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

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

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.
Cadastro de Unidades de Federao
CD0904
Poucas ocorrncias na tabela. Quantidade de registros varia pouco.
Cadastro de Unidades de 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.
36
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
cdapi601
cdapi602
cdapi603
cdapi604
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

simul-nota-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
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
cdapi650
re0402rp
Sincronizar a desatualizao de Documentos de Entrada
cdapi651
re1005rp; reapi190
Sincronizar da incluso de Documentos de Entrada
cdapi607
cdapi608
cdapi609
cdapi610
Sincronizar a eliminao de Documento Fiscal gerado pela

integrao com GFE
37
cdapi652
bodi135cancel
cdapi653
ft0502
Sincronizar o cancelamento de Notas Fiscais de Sada

Emitir mensagem informando que no h integrao dos dados
alterados para o GFE
cdapi654
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
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
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
cdapi676
Solicitar os Redespachantes no programa de Manuteno de
38
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
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

Emisso de Notas Manuais
cdapi685
ft4001a

Faturamento por Embarque
cdapi688
ft4002

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
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
Redespachantes da Nota Fiscal de Sada
cdapi686
cdapi687
Em desuso
Sincronizao da incluso e alterao de Contas Contbeis de
Integrao
Sincronizao da eliminao de Ttulo a Pagar gerado pela

integrao com GFE
39

Integração Datasul 11 e SIGAGFE

Încărcat de

Informații document

Descriere originală:

Titlu original

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Integração Datasul 11 e SIGAGFE

Încărcat de

Drepturi de autor:

Formate disponibile

Documento para Integraes

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Contexto de negcio (introduo) ........................................................................................................ 4

Sistemas envolvidos ............................................................................................................................. 5

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

Controle de verso ............................................................................................................................... 29

10 Transaes/Entidades/Mensagens nicas ............................................................................................ Erro! Indicador

Fluxo das informaes .......................................................................................................................... 29

12 Limitaes/Restries gerais ................................................................................................................ Erro! Indicador

Situaes comuns (opcional) ................................................................................................................ 31

Checklist de suporte da aplicao ......................................................................................................... 33

Nova Integrao Datasul 11 x SIGAGFE

Contexto de negcio (introduo)

Notas Fiscais de Sada.....................

Contratos com Autnomos....................

Contratos com Autnomos....................

Contratos com Autnomos....................

Movimentos de Prestao de Servio

Nova Integrao Datasul 11 x SIGAGFE

Tendo em vista a simplificao do processo e minimizando a possibilidade de erros de integrao, criamos

Nova Integrao Datasul 11 x SIGAGFE

O Novo Modelo de integrao

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Recebimento de dados do GFE no Datasul

Nova Integrao Datasul 11 x SIGAGFE

Agendamento via RPW:

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Selecionando a opo Nenhuma, a eliminao do Ttulo efetuada normalmente e nenhuma solicitao

Nova Integrao Datasul 11 x SIGAGFE

Verificar Sincronismo de Dados

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

Agendar Servidor RPW

Testar Conexo com Web Service

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

, que atribui os programas APPCs conforme

Nova Integrao Datasul 11 x SIGAGFE

Parmetros do mdulo de finanas

FILTRO DE NOTAS FISCAIS E CONVERSO DA NATUREZA DE OPERAO

Nova Integrao Datasul 11 x SIGAGFE

- Cadastrar o cabealho da Regra no CD0024;

- Incluir um nome para a Regra;

- Informar a condio para atribuio da regra;

Nova Integrao Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

10 Fluxo das informaes

Nova Integrao Datasul 11 x SIGAGFE

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

Nova Integrao Datasul 11 x SIGAGFE