Integração EDI

Gestão de Frete Embarcador – GFE

 Integração EDI

Sumário …………. .................................................................................................................................................................... 2

1. Introdução .................................................................................................................................................................. 3
2. Objetivos do Treinamento ......................................................................................................................................... 3
3. Identificando a Estrutura do Macroprocesso Integrações ........................................................................................... 3
4. Delimitando o Processo de Integração EDI .................................................................................................................. 4
4.1. Objetivo ...................................................................................................................................................................... 4
4.2. Escopo Funcional ........................................................................................................................................................ 4
5. Identificando os Cadastros Que Impactam Neste Processo ......................................................................................... 5
5.1. Introdução .................................................................................................................................................................. 5
5.2. Parâmetros do Módulo ............................................................................................................................................... 5
5.3. Cadastro – Emitentes .................................................................................................................................................. 6
5.4. Cadastro – Tipos de Documentos de Carga ................................................................................................................. 7
6. Identificando os Layouts Utilizados ............................................................................................................................. 7
6.1. Layout ......................................................................................................................................................................... 7
7. Exportando os Movimentos ........................................................................................................................................ 8
7.1. Tipos de Movimentos Exportados ............................................................................................................................... 9
7.2. Exportação das Notas Fiscais....................................................................................................................................... 9
7.3. Exportação das Pré-Faturas....................................................................................................................................... 11
8. Importando os Movimentos...................................................................................................................................... 12
8.1. Introdução ................................................................................................................................................................ 13
8.2. Tipos de Movimentos Importados ............................................................................................................................ 13
8.3. Características da Importação de Movimentos ......................................................................................................... 14
8.4. Importação de Conhecimentos ................................................................................................................................. 15
8.5. Importação de Faturas .............................................................................................................................................. 16
8.6. Importação de Ocorrências ....................................................................................................................................... 17
9. Processando os Movimentos .................................................................................................................................... 17
9.1. Opção Processar ....................................................................................................................................................... 18
9.2. Validações no Processamento ................................................................................................................................... 18
9.3. Regras Gerais ............................................................................................................................................................ 19
10. Dicas de Negócio ....................................................................................................................................................... 19
11. Conclusão ................................................................................................................................................................. 20

2 Versão – GFE 11.5

 Integração EDI

1. Introdução

Olá!
Seja bem-vindo ao treinamento Integração EDI, do Integrações, do Aplicativo Gestão de Frete Embarcador.

2. Objetivos do Treinamento

Ao término deste treinamento, você terá conhecido um pouco mais sobre:

• Identificar a Estrutura do Macroprocesso Integrações.

• Delimitar o Processo de Integrações EDI.
• Identificar os Cadastros Deste Processo.
• Identificar os Layouts Utilizados.
• Exportar os Movimentos.
• Importar os Movimentos.
• Processar os Movimentos.

3. Identificando a Estrutura do Macroprocesso Integrações

Neste treinamento vamos descrever os atributos do Integrações, que é o quarto e último macroprocesso
que compõe o GFE.

O escopo do Integrações é composto pelas rotinas e funcionalidades que permitem sincronizar e integrar
as informações entre o Aplicativo e o software ERP, enviar e receber arquivos eletrônicos, bem como,
trocar informações entre o Aplicativo e quaisquer outras bases de dados, dispositivos e softwares
externos.

Desta forma, este macroprocesso está subdividido nos seguintes processos:

• Integração EDI (Eletronic Data Interchange).

• Integração com ERP Datasul.
• Integração com Microsiga Protheus.
• Integração com Datasul BI (Business Intelligence).
• Integração CT-e com TOTVS Colaboração.

Cada um destes processos possui um treinamento específico na sequência deste Curso.

Versão – GFE – 11.5. 3

 Integração EDI

Neste treinamento em particular, vamos abordar as propriedades do processo de Integração EDI.

4. Delimitando o Processo de Integração EDI

Vamos iniciar este treinamento descrevendo o objetivo principal do processo de Integração EDI, a
composição do seu escopo funcional, assim como, as rotinas que o compõem.

4.1. Objetivo

Por intermédio do processo de Integração EDI é possível realizar a troca eletrônica de dados entre o
embarcador e seus parceiros de transporte, de forma a agilizar os processos operacionais e reduzir os erros
causados pela entrada incorreta de informações.

4.2. Escopo Funcional

O seu escopo funcional é composto pelas seguintes rotinas:

• Trocar arquivos por intermédio do layout padrão PROCEDA.

• Exportas as Notas Fiscais e as Pré-faturas.
• Importar os Conhecimentos, as Faturas e as Ocorrências de Transporte.
• Processar os movimentos importados.

4 Versão – GFE 11.5

 Integração EDI

5. Identificando os Cadastros Que Impactam Neste Processo

Como visualizamos anteriormente o objetivo principal do processo de Integração EDI e a composição do

seu escopo funcional, vamos conhecer agora os principais cadastros que impactam nas rotinas que o
compõem.

5.1. Introdução

Os cadastros que contêm as informações que impactam no processo de Integração EDI são:

• Parâmetros do Módulo.
• Emitentes.
• Tipos de Documento de Carga.

5.2. Parâmetros do Módulo

Este cadastro permite definir as seguintes informações pertinentes ao processo de Integração EDI:

• CFOP Estadual/Interestadual que será utilizada no documento de frete importado via EDI.

Para definir se a CFOP a ser utilizada é a Estadual ou Interestadual, o GFE verifica o estado do
remetente e o Estado do destinatário de um dos documentos de carga relacionados ao CTRC
que está sendo importado.

Se os Estados forem iguais, é atribuiída a CFOP Estadual ao CTRC; se forem diferentes, é

atribuída a CFOP Interestadual ao CTRC.
Versão – GFE – 11.5. 5
 Integração EDI

• Espécie que será utilizada na criação do documento de frete importado via EDI.

Podem ser:

− Espécie CTR: esta espécie é selecionada quando o documento importado não é um

conhecimento eletrônico e possui imposto de ICMS.

− Espécie CT-e: esta espécie é selecionada quando o documento importado é um CT-e. Esta
informação é identificada porque o arquivo importado contém a chave do conhecimento
eletrônico.

− Espécie NFST: esta espécie é selecionada quando o documento importado não é um

conhecimento eletrônico e possui imposto de ISS.

• Tipo de geração de log e local onde o arquivo de log será gravado.

As rotinas de importação e processamento permitem que sejam gerados logs para auxiliar na
interpretação das validações/consistências que ocorrem nestes processos.

O tipo de geração de log pode ser:

- Não Gerar.
- Normal.
- Modo Debug.
- Modo Console.

5.3. Cadastro – Emitentes

Neste cadastro é possível informar, para cada Emitente Transportador:

• Grupo EDI: permite o agrupamento de parceiros de transporte, o qual facilita a recepção e o

envio das informações quando vários parceiros pertencem a um mesmo grupo empresarial.

• Posição CT-e: posição inicial na qual será informada a chave do CT-e do layout PROCEDA.
Quando não for informado um valor (campo zerado), o sistema assume a posição inicial 675.

Dica: verificar no arquivo CONEMB do transportador a posição na qual ele está enviando a
chave do CT-e e informar neste campo.

6 Versão – GFE 11.5

 Integração EDI

• Caixa Postal EDI: neste campo poder ser informada a caixa postal utilizada pelo Embarcador,
caso este utilize o serviço de uma VAN (Value Added Network ou Rede de Valor Agregado, em
português) para intermediar a troca de arquivos.

5.4. Cadastro – Tipos de Documentos de Carga

Por intermédio deste cadastro é definido se o documento de carga pode ser enviado via EDI ou não.

O programa de Exportação de Notas Fiscais validará este campo antes de enviar qualquer documento de
carga.

Se estiver parametrizado como Envia EDI = Não, os documentos de carga relacionados a este Tipo não
serão exportados.

6. Identificando os Layouts Utilizados

Até este momento conhecemos o objetivo principal do processo de Integração EDI, a composição do seu
escopo funcional, assim como, os principais cadastros que impactam nas rotinas que o compõem.

Vamos para a próxima seção deste treinamento, na qual serão descritos os layouts utilizados por este
Aplicativo.

6.1. Layout

Define o formato e o tipo dos dados, a sua disposição dentro do registro e os tipos de registros contidos no
arquivo texto. Também define se um dado deve obrigatoriamente estar presente no arquivo ou não.

Versão – GFE – 11.5. 7

 Integração EDI

O GFE atende o layout padrão PROCEDA.

Há um layout para cada transação:

• Nota Fiscal (NOTFIS).

• Pré-fatura (PREFAT).
• Conhecimento (CONEMB).
• Fatura (DOCCOB)
• Ocorrências (OCORREN).

Na tabela exemplificada abaixo é possível observar o layout, a versão atendida e a data desta versão.

7. Exportando os Movimentos

Conhecemos até agora o objetivo principal do processo de Integração EDI, a composição do seu escopo
funcional, os principais cadastros que impactam nas rotinas que o compõem, bem como, os layouts que
são utilizados por este Aplicativo.

Vamos para a próxima seção deste treinamento, na qual será descrito detalhamente o processo de
exportação das Notas Fiscais e das Pré-faturas.

8 Versão – GFE 11.5

 Integração EDI

7.1. Tipos de Movimentos Exportados

Exportar Movimentos significa gravar em arquivo texto os movimentos gerados, de acordo com o padrão e
o layout definidos.

Conforme foi mencionado anteriormente, o padrão atendido pelo GFE é o PROCEDA.

Os movimentos que podem ser exportados por este Aplicativo são:

• Notas Fiscais (ou Documentos de Carga)

• Pré-Faturas de Fretes.

As rotinas responsáveis pela exportação destes movimentos são:

• Exportar NOTFIS.
• Exportar PREFAT.

Por intermédio da opção Exportar NOTFIS é possível enviar as informações relativas às Notas Fiscais para
os parceiros de transporte.

Por meio da opção Exportar PREFAT é possível enviar as informações relativas às Pré-faturas para os
parceiros de transporte.

7.2. Exportação das Notas Fiscais

O programa Exportar NOTFIS permite realizar a troca de informações sobre as Notas Fiscais transportadas.

A informação é gravada em arquivo texto, o qual é encaminhado pelo Embarcador ao Transportador.

Este envio agiliza a emissão da documentação necessária para o transporte das mercadorias.

Versão – GFE – 11.5. 9

 Integração EDI

Ao acessar o programa Exportar NOTFIS, no menu Integrações - EDI, é apresentada a tela Parâmetros, na
qual é possível:

• Selecionar as informações por Filial, Série, Número do Documento de Carga, Data de Saída, Data
de Emissão, Grupo de Emitente, Código do Transportador e Romaneio.

• Selecionar somente as Notas embarcadas.

• Selecionar as Notas com ou sem data de saída.

• Enviar no arquivo gerado os dados dos itens das Notas.

• Definir a pasta de destino do(s) arquivo(s) e o tipo de Saída:

− Saída = Arquivo: deve ser informado o nome de um arquivo texto e todas as Notas do
transportador são colocadas neste arquivo (arquivo único para o transportador).

− Saída = Diretório: deve ser informado apenas o diretório e este Aplicativo gerará
automaticamente um arquivo texto para cada Nota da transportadora (vários arquivos para
o transportador).

10 Versão – GFE 11.5

 Integração EDI

Observação:

• Se os trechos de redespachos são pagos será gerado um arquivo da mesma Nota Fiscal para
cada transportador.

• O redespacho de cada transportador será o próximo percurso, até que não existam mais
redespachos.

• O documento de carga exportado permanecerá com a situação Enviado EDI = Sim, podendo ser
reenviado, caso seja necessário.

7.3. Exportação das Pré-Faturas

O programa Exportar PREFAT permite realizar a troca de informações sobre os valores das Prestações de
Serviços de Transporte, com a finalidade de realizar uma conferência anterior à emissão definitiva da
Fatura de Frete, por parte do Transportador.

A informação é gravada em arquivo texto, o qual é encaminhado pelo Embarcador ao Transportador.

Ao acessar o programa Exportar PREFAT, no menu Integrações - EDI, é apresentada a tela Parâmetros, na
qual é possível:

• Selecionar as informações por Filial, Número da Pré-fatura, Data de Criação, Data de

Vencimento, Data de Cancelamento e Código do Transportador.

• Selecionar as faturas nas seguintes situações:

− Criadas.
− Enviadas.
− Aprovadas.
− Canceladas.

• Manter a Data Corrente como opção para o envio das Pré-faturas implantadas no dia.

• Definir a pasta de destino do(s) arquivo(s) e o tipo de Saída:

− Saída = Arquivo: deve ser informado o nome de um arquivo texto e todas as Pré-faturas do
Transportador são colocadas neste arquivo (arquivo único para o transportador).

Versão – GFE – 11.5. 11

 Integração EDI

− Saída = Diretório: deve ser informado apenas o diretório e o Aplicativo gerará

automaticamente um arquivo texto para cada Pré-fatura da transportadora (vários arquivos
para o Transportador).

8. Importando os Movimentos

Até agora conhecemos o objetivo principal do processo de Integração EDI, a composição do seu escopo
funcional, os principais cadastros que são utilizados pelas rotinas que o compõem, os layouts que são
utilizados por este Aplicativo, assim como, o processo de exportação das Notas Fiscais e das Pré-faturas.

Vamos para a próxima seção deste treinamento, na qual será descrito o processo de importação dos
Conhecimentos, das Faturas e das Ocorrências.

12 Versão – GFE 11.5

 Integração EDI

8.1. Introdução

Importar Movimentos significa ler os registros dos arquivos textos, no padrão e layout definidos, e gravá-
los em uma base de dados intermediária.

Para facilitar o entendimento deste processo, ele está subdividido nos seguintes tópicos:

• Tipos de Movimentos Importados.

• Características da Importação de Movimentos.
• Importação de Conhecimentos.
• Importação de Faturas.
• Importação de Ocorrências.

8.2. Tipos de Movimentos Importados

Os movimentos que podem ser importados pelo GFE são:

• Conhecimentos de Transporte (Documentos de Frete).

• Faturas de Frete e Ocorrências de Transporte.

As rotinas que importam estes movimentos são:

• Importar CONEMB: recebe as informações relativas aos Conhecimentos de Transporte.

• Importar DOCCOB: recebe as informações das Faturas de Frete.
• Importar OCORREN: recebe as informações das Ocorrências de Transporte.

Versão – GFE – 11.5. 13

 Integração EDI

8.3. Características da Importação de Movimentos

A seguir são descritas algumas características do processo de Importação de Movimentos, que são comuns
nas três rotinas que realizam a importação.

• Usuários:

O GFE grava a informação do usuário que realizou a importação do arquivo, a data e a hora.
Esta informação é útil para organizar as informações, principalmente quando há mais de um
usuário importando e processando os arquivos simultaneamente.

• Pré-validação na Importação:

Na importação dos movimentos, o GFE faz algumas pré-validações para que o usuário tenha
uma indicação se o arquivo possui ou não alguns erros mais básicos.

As pré-validações realizadas são as seguintes:

− Validação da relação dos documentos.

− Validação de parametrização.
− Validação de consistência dos dados.

• Situação do Documento:

O documento importado poderá apresentar as seguintes situações:

− Importado: indica que o documento foi importado, pré-validado e encontra-se pronto para
o processamento.

− Importado com Erro: indica que o documento foi importado, pré-validado e apresenta
algum erro de consistência.

− Rejeitado: o documento foi rejeitado no momento do processamento, por alguma validação

de negócio.

− Processado: o documento foi processado com sucesso.

Os erros podem ser verificados por meio da opção Visualizar, do documento em questão.

14 Versão – GFE 11.5

 Integração EDI

8.4. Importação de Conhecimentos

O programa Importar CONEMB permite que as informações enviadas pelo Transportador, referentes aos
Conhecimentos de Transporte, sejam inseridas no GFE.

Ao acessar o programa Importar CONEMB, no menu Integrações - EDI, é apresentada uma tela na qual são
demonstrados todos os documentos do tipo Conhecimento que estão na base intermediária, sendo
possível filtrá-los por sua situação ou usuário.

Para importar um novo Conhecimento é necessário acionar Importar, localizado na tela Importar
CONEMB.

Em seguida são apresentados os Transportadores e a localização do(s) arquivo(s) para que possa ser
efetuada a devida seleção. Além disso, também podem ser informados os diretórios de backup dos
arquivos importados com sucesso ou não.

Versão – GFE – 11.5. 15

 Integração EDI

8.5. Importação de Faturas

O programa Importar DOCCOB permite que as informações enviadas pelo Transportador, referentes às
Faturas de Frete, sejam inseridas no GFE.

Ao acessar o programa Importar DOCCOB, no menu Integrações - EDI, é apresentada a tela Importar
DOCCOB, na qual constam todos os documentos do tipo Fatura que estão na base intermediária, sendo
possível filtrá-los por sua situação ou usuário.

Para importar uma nova fatura é necessário acionar Importar, localizado na tela Importar DOCCOB.

Na sequência são apresentados os Transportadores e a localização do(s) arquivo(s) para que possa ser
efetuada a devida seleção. Além disso, também podem ser informados os diretórios de backup dos
arquivos importados com sucesso ou não.

16 Versão – GFE 11.5

 Integração EDI

8.6. Importação de Ocorrências

O programa Importar OCORREN permite que as informações enviadas pelo Transportador, referentes às
Ocorrências de Transporte, sejam inseridas no GFE.

Ao acessar o programa Importar OCORREN, no menu Integrações - EDI, é apresentada a tela Importar
OCORREN, na qual são apresentados todos os documentos do tipo Ocorrências que estão na base
intermediária, sendo possível filtrá-los por sua situação ou usuário.

Para importar uma nova ocorrência é necessário acionar Importar, localizado na tela Importar OCORREN.

Em seguida são apresentados o Transportador, a Filial e a localização do(s) arquivo(s) para que possa ser
efetuada a devida seleção. Além disso, também podem ser informados os diretórios de backup dos
arquivos importados com sucesso ou não.

9. Processando os Movimentos

Já conhecemos o objetivo principal do processo de Integração EDI, a composição do seu escopo funcional,
os principais cadastros que são utilizados pelas rotinas que o compõem, os layouts que são utilizados por
este Aplicativo, bem como, os processos de exportação das Notas Fiscais e das Pré-faturas e da importação
dos Conhecimentos, das Faturas e das Ocorrências.

Vamos para a última seção deste treinamento, na qual serão descritas as particularidades do
processamento dos movimentos.

Versão – GFE – 11.5. 17

 Integração EDI

9.1. Opção Processar

Todos os programas vistos anteriormente - Importar CONEMB, DOCCOB e OCORREN - apresentam a

opção Processar.

É por seu intermédio que os documentos pertinentes à cada um dos programas são processados.

9.2. Validações no Processamento

No processamento dos movimentos, o GFE efetua as validações definitivas para que o documento seja
implantado corretamente.

As validações realizadas são as seguintes:

• Validação de negócio.
• Utiliza o model (programa de origem).
• Mesmos erros que ocorreriam na digitação manual.

18 Versão – GFE 11.5

 Integração EDI

9.3. Regras Gerais

• Quando o documento é processado com sucesso, o registro é criado efetivamente na base de

dados do GFE.

• Quando o documento permanece como rejeitado, o motivo da rejeição pode ser consultado por
intermédio da opção Visualizar.

• A opção Alterar permite corrigir alguma informação que tenha sido enviada erroneamente no
arquivo.

• A opção Excluir Sel., no item Ações Relacionadas, permite limpar a base de dados
intermediária.

10. Dicas de Negócio

• As ocorrências de entrega (Código de Observação = 3) não geram ocorrências no GFE.

Elas são utilizadas para atribuir a data e a hora da ocorrência à data de entrega do trecho
correspondente na Nota Fiscal.

• As ocorrências enviadas pelo Transportador devem estar cadastradas exatamente com o

mesmo código no Cadastro de Tipos de Ocorrência.

Versão – GFE – 11.5. 19

 Integração EDI

11. Conclusão

Assim, você terminou o treinamento Integração EDI, do Integrações, do Aplicativo Gestão de Frete
Embarcador.

Neste treinamento, você conheceu mais sobre:

• Identificar a Estrutura do Macroprocesso Integrações.

• Delimitar o Processo de Integração EDI.
• Identificar os Cadastros Deste Processo.
• Identificar os Layouts Utilizados.
• Exportar os Movimentos.
• Importar os Movimentos.
• Processar os Movimentos.

20 Versão – GFE 11.5