Documento+de+Integracao_V03.pdf

Documento para Integraes

Nova Integrao

Datasul 11 x SIGAGFE

Nova Integrao Datasul 11 x SIGAGFE

2 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 Responsvel Descrio da reviso

20/02/2013 PEDRO.SCANDOLARA 1.0



1 Contedo

1 Contedo .............................................................................................................................................. 3

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

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

4 Integrao ............................................................................................................................................ 5

5 Escopo .................................................................................................................................................. 6

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

7 Instalao/Atualizao ......................................................................................................................... 11

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

9 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



2 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:

DATASUL SIGAGFE

Fornecedores................................... Emitentes

CA

DA

STR

OS

Grupo de Clientes............................ Grupo de Emitentes

Clientes............................................ Emitentes Cidades............................................ Cidades Embalagens..................................... Unitizadores Contas Contbeis Integrao........... Contas Contbeis Centros de Custo............................. Centros de Custo

PR

OC

ESSO

S

Notas Fiscais de Sada..................... Documentos de Carga Embarques....................................... Romaneios Documentos de Entrada.................. Documentos de Carga

Os Processos realizados dentro do SIGAGFE e que tem informaes enviadas aos mdulos do Datasul 11

so:

SIGAGFE DATASUL

PR

OC

ESSO

S

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

Contratos com Autnomos.................... Notas de Rateio

Contratos com Autnomos.................... Movimentos de Prestao de Servio



3 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.

4 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.



5 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.



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.

6 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.

7 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 +



"\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.



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.



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.



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



"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). 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.

No campo Ao Eliminao, da seo Integrao, define-se qual ser o tratamento que o sistema dever 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.



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.

No campo Ao Eliminao, da seo Integrao, define-se qual ser o tratamento que o sistema dever 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).



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:



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:



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.



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.

Testar Conexo com Web Service

Agendar Servidor RPW



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 , 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).

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;



- 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;



- 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"



8 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.

9 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

EMITENTES

CLIENTES

FORNECEDORES

CONTATOS

CIDADE CIDADE

UNITIZADORES EMBALAGENS

CENTRO DE CUSTO CENTRO DE CUSTO

CONTA CONTBIL CONTA CONTBIL

GFE DATASUL / TOTVS 11

GRUPO DE

EMITENTES

GRUPO DE

CLIENTES



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

GFE DATASUL / TOTVS 11

DOC. CARGA

NOTA FISCAL DE

SADA

NOTA FISCAL DE

ENTRADA

DOCUMENTO DE

FRETES

PR-FATURA

FATURA

CONTRATO

DOCUMENTO

FISCAL

NOTA FISCAL DE

RATEIO

TTULO A PAGAR*

FOLHA DE

PAGAMENTO

ROMANEIO EMBARQUE



11 Situaes comuns

Integrao com mdulo financeiro:

1 -Ao integrar com o financeiro, ocorrem os erros: 8437 - Usurio financeiro no habilitado para estabelecimento

20639 - Atualizao no permitida para o usurio !

20636 - Implantao no permitida para o usurio !

8437 - Usurio financeiro 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.



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.



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.



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 Contratos com Autnomos

Prestaes de Servio de Terceiros Contratos com Autnomos



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 Trigger write, Trigger delete CDAPI600 / CDAPI606

Importao de Clientes CD1302 Trigger write, Trigger delete CDAPI600 / CDAPI606

Cadastro de Fornecedores CD0401 Trigger write, Trigger delete CDAPI600 / CDAPI606

Importao de Fornecedores CD1608 Trigger write, Trigger delete CDAPI600 / CDAPI606

Cadastro de Cidades CD0330 Trigger write, Trigger delete CDAPI609 / CDAPI602

Cadastro de Embalagens CD1117 Trigger write, Trigger delete CDAPI624 / CDAPI625

Contas Contbeis Integrao UTB033AA Trigger write, Trigger delete PRGINT/UTB/UTB600GF.P PRGINT/UTB/UTB601GF.P

Centros de Custo UTB066AA Trigger write, Trigger delete PRGINT/UTB/UTB602GF.P PRGINT/UTB/UTB603GF.P

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 CDAPI630

Gerao de Pr-faturamento EQ0504

Gerao de Embarques EQ0506 Trigger write, Trigger delete

Atualizao de Documentos de Entrada

RE1001/RE1005 fim-atualizacao CDAPI651

Desatualizao de Documentos de Entrada

RE0402 RE0402RP CDAPI650



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 Carga tem relevncia restrita e no possui tabela estrangeira relacionada.

Cadastro de Famlias Comerciais CD0206 No GFE o cdigo da Famlia Comercial dos Itens do Documento de Carga tem relevncia restrita e no possui tabela estrangeira 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.

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.



Anexo IV - Lista de APPCs

APPC Programa ou tabela

relacionada Finalidade

cdapi600 mgadm.emitente Sincronizao da incluso e alterao de clientes e fornecedores

cdapi601

cdapi602 mgdis.cidade Sincronizao da eliminao de cidades

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

cdapi607

cdapi608

cdapi609 mgdis.cidade Sincronizao da incluso e alterao de cidades

cdapi610

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 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

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 Disponibilizar os campos Peso Bruto, Peso Cubado e Volume na 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 Disponibilizar os campos Peso Bruto, Peso Cubado e Volume na 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.

cdapi676

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

cdapi686

cdapi687

cdapi688 ft4002 Disponibilizar o boto de Simulao de Frete no programa de 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 Em desuso

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

Documents

Documento+de+Integracao_V03.pdf