Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

Parâmetros de Integração - CD0089

Visão Geral do Programa

A integração do Datasul com o Gestão de Frete Embarcador pode ocorrer por dois canais, podendo ser:

EAI + TOTVS ESB

 

Web Service

 

Para a integração dos documentos registrados no TOTVS GFE (Gestão de Frete Embarcador) para o ERP é utilizada uma rotina de execução contínua (Agente Listener), essa rotina monitora a base de dados do TOTVS GFE utilizando como canal de comunicação o mesmo WS (Web Service) do modelo de envio de dados do ERP para o TOTVS GFE.

O controle dos dados que estão aptos para integração é efetuado pelo TOTVS GFE.

O Agent Listener utiliza as rotinas de negócio 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 também é possível solicitar a eliminação de dados anteriormente processados pela integração, situação na qual o resultado do processamento, quando executado com sucesso, retorna a situação do documento para “Não enviado” no TOTVS GFE.

Quando o WS não estiver disponível para conexão, ou houver algum erro de exceção no envio dos dados, será mantido um histórico de falhas na base de dados do Datasul 11 para análise.

A cada intervalo de execução parametrizado, o Agent Listener fará uma nova tentativa de conexão com o WS.

O Agent Listener possui 3 formas de execução: Sessão em background, agendamento via RPW e rotina com interface.Ficando a critério do cliente e/ou consultor de implantação definir qual a forma de execução mais adequada.

Parâmetros de Integração - Pasta Conexão

Objetivo da tela:

Permitir definir os modos de integração e os dados da conexão com Web Service.


Outras Ações/Ações Relacionadas:

 

Ação:

Descrição:

Testar Conexão

Quando acionado, verifica se o Datasul 11 consegue estabelecer uma conexão válida com o Web Service de integração do TOTVS GFE, sendo retornado uma mensagem de sucesso ou não do teste de conexão.

Histórico

Quando acionado, é apresentado o programa Histórico de Conexão (CD0081), na qual é possível consultar as eventuais falhas de conexão com o Web Service registradas pelas diversas rotinas de envio de dados do Datasul para o TOTVS Gestão de Frete Embarcador.

Configurar

Quando acionado, permite a configuração do envio de e-mail de alerta.

Testar E-mail

Quando acionado, permite testar o envio de e-mail de alerta.

Sincronização com GFE

Quando acionado, é apresentada o programa Sincronização de Dados (CD9125), na qual é possível efetuar a de sincronização On-line ou Batch dos dados de cadastro e notas fiscais do Faturamento e Recebimento do Datasul 11 para o Gestão de Frete Embarcador.

Verificar Sincronismo dos Dados

Quando acionado, é apresentado o programa Verificar Sincronismo de Dados (CD0084), na qual é possível visualizar os percentuais de registros dos cadastros do Datasul 11 integrados ao Gestão de Frete Embarcador.

Contingencia de Integração

Quando acionado, é apresentado o programa Contingência de Integração (CD0082), na qual é possível visualizar os registros que deixaram de integrar do Datasul 11 para o Gestão de Frete Embarcador por falha na comunicação com o WebService. Permitindo também o reenvio dos registros após o restabelecimento da comunicação ou descartar esses registros.

Configuração de Restrição dos Registros para Integração

Quando acionado, é apresentado o programa Configuração de Regras (CD0024), na qual é possível definir regras que permitem filtrar notas fiscais do faturamento e recebimento, que não necessitam ser enviadas para o Gestão de Frete Embarcador. Por exemplo: notas fiscais de saída com tipo de frete FOB.

Matrizes de Tradução

Quando acionado, é apresentada a tela Matrizes de Tradução (CD0089B), na qual é possível criar a relação entre os estabelecimentos do Datasul 11 com os estabelecimentos do Gestão de Frete Embarcador.

Configuração EAI

Quando acionado, e apresentada a tela Configuração de Transações EAI (EAI0202), na qual é possível efetuar a manutenção das configurações de transações de entrada e saída do EAI.

APPCs de Integração

Quando acionado, é apresentada a tela APPCs de Integração (CD0089A), na qual visualizar os programas de integração que são vinculados aos gatilhos de dicionário ou à interface do Datasul 11.


Principais Campos e Parâmetros:


Campo:

Descrição:

Canal Saída

Selecionar a opção que determina o canal de saída a ser utilizado na integração. As opções disponíveis são:

  • EAI + TOTVS ESB.

  • Web Service.

Nota
titleNota:

Para integração utilizando o Web Service deve-se obrigatoriamente indicar que os canais de saída e entrada são Web Service.

Canal Entrada

Selecionar a opção que determina o canal de entrada a ser utilizado na integração.As opções disponíveis são:

  • EAI + TOTVS ESB.

  • Web Service.

Servidor

Inserir a URL do Web Service.

Nota
titleNota:

A URL informada é a mesma que consta na entrada configurada para o WS no arquivo appserver.ini da instalação do TOTVS GFE.

Usuário

Inserir o usuário de instalação do Gestão de Frete Embarcador.

Nota
titleNota:

Essa informação é opcional e é utilizada quando o usuário do ERP não possui as permissões necessárias no Gestão de Frete Embarcador.

Senha

Inserir a senha de instalação do Gestão de Frete Embarcador.

Nota
titleNota:
Essa informação é opcional e é utilizada quando o usuário do ERP não possui as permissões necessárias no Gestão de Frete Embarcador.

Integração temporariamente suspensa

Quando assinalado, indica ao Datasul 11 que o Web Service de integração com o TOTVS GFE está intencionalmente fora do ar.

Nesse caso o Datasul 11 irá registrar as pendências de integração para posterior processamento sem realizar tentativas de conexão com o Web Service, poupando recursos de processamento das rotinas.

Informações
titleImportante:

Não é necessário reiniciar os Agentes de integração ao assinalar esse parâmetro.

Enviar e-mail nas falhas de conexão

Quando assinalado, determina que caso haja algum problema de conexão com o Web Service, o sistema envia via e-mail um aviso informando que houve uma falha de conexão do Datasul com o Web Service durante a integração com o TOTVS GFE. Permitindo que os destinatários do e-mail verifiquem se o Web Service sofreu alguma queda imprevista.

Remetente

Inserir o remetente do e-mail que reporta a falha na conexão com o Web Service.

Destinatário(s)

Inserir os destinatários a serem considerados para receber o e-mail que reporta a falha na conexão com o Web Service.

Nota
titleNota:

Caso haja necessidade de informar mais de um destinatário deve ser utilizado o sinal de ponto e virgula ";" como separador dos e-mails.

API REST TOTVS - Servidor

Informar a URL de conexão para a API REST do GFE.

Nota
titleNota:

A URL deve ser informada no padrão http://servidor:porta/. A porta de conexão para API REST é indicada na inicialização do App Server do Protheus conforme imagem a seguir.

Usuário

Inserir o usuário de instalação do Gestão de Frete Embarcador.


Nota
titleNota:

Essa informação é opcional e é utilizada quando o usuário do ERP não possui as permissões necessárias no Gestão de Frete Embarcador.


Senha

Inserir a senha de instalação do Gestão de Frete Embarcador.


Nota
titleNota:

Essa informação é opcional e é utilizada quando o usuário do ERP não possui as permissões necessárias no Gestão de Frete Embarcador.


Parâmetros de Integração - Pasta Integrações

Objetivo da tela:

Permitir definir os cadastros e processos que são integrados com o Gestão de Frete Embarcador. Internamente, cada parâmetro assinalado (e confirmado) nas seções desta pasta gera a inclusão de um programa APPC (Advanced Program to Program Communication) nos gatilhos de criação e eliminação do dicionário de dados do Datasul 11.


Principais Campos e Parâmetros:


Campo:

Descrição:

Cadastros (Datasul para GFE)

Assinalar os cadastro do Datasul a serem integrados ao Gestão de Fretes Embarcador. As opções disponíveis são:

  • Grupos de Clientes

  • Clientes e Fornecedores

  • Contatos

  • Cidades

  • Embalagens (Unitizadores)

  • Centros de Custo

  • Contas Contábeis

  • Tipos Carga (Tipos Veículo)

Processos (Datasul para GFE)

Assinalar os processos do Datasul a serem integrados ao Gestão de Fretes Embarcador. As opções disponíveis são:

  • Notas Fiscais de Saída

  • Embarques (Romaneios)

  • Notas Fiscais de Entrada 

  • Contratos

Simulação de Frete

Assinalar as informações a serem consideradas para simulação de frete. As opções disponíveis são:

  • Pedidos de Venda

  • Notas Fiscais de Saída

  • Ordem de Compra

  • Pedido de Compra

  • Notas Fiscais de Entrada

Processos (GFE para Datasul)

Assinalar os processos do Gestão de Fretes Embarcador a serem integrados ao Datasul. As opções disponíveis são:

  • Títulos Provisórios (Pré-faturas)

  • Títulos a Pagar (Faturas)

  • Títulos a Pagar (Contratos)

  • Docto Fiscal (Docto Frete)

  • Notas de Rateio (Docto Frete)

  • Notas de Rateio (Contratos)

  • Movto Prest Serv (Contratos)

  • Aprov. Negoc. Frete (MLA)
  • Aprov. Docto. Frete (MLA)
  • Aprov. Fatura Frete (MLA)
  • Negociação de Frete (Consulta)

Parâmetros de Integração - Pasta Faturamento

Objetivo da tela:

Permitir definir parâmetros importantes que devem ser considerados pelo Gestão de Frete Embarcador na integração das notas fiscais de saída.

Nota
titleNota:

Essa pasta somente é habilitada quando, na pasta Integrações, é assinalado o parâmetro Notas Fiscais de Saída da seção Processos (Datasul para GFE), ou o parâmetro Simulação de Fretes para Nota Fiscal de Saída, da seção Simulação de Frete, parâmetro Nota Fiscal de Saída.


Principais Campos e Parâmetros:


Campo:

Descrição:

Repassar valor de frete às Notas Fiscais

Quando assinalado, um percentual do valor de frete deve ser repassado para a nota fiscal de vendas.

Admitir múltiplos Redespachantes

Quando assinalado, determina que permitirá mais de um redespachante.

Permitir alterar a Simulação de Frete nas Notas Fiscais.

Quando assinalado, determina que é permitido efetuar alterações na simulação de frete nas notas fiscais.

Simular com todos os transp.

Quando assinalado, determina é permitido efetuar as simulações do cálculo do frete com todos os transportadores que possuírem tabela de frete atendendo os trechos do documento.

Nota
titleNota:

Caso não seja assinalado a simulação é efetuada somente com o transportador do embarque.

Manter Frete Simulado ERP no GFE

Quando assinalado, determina que a simulação de fretes deve ser mantida como o cálculo do frete do documento de carga (nota fiscal) no GFE. Caso não seja assinalado, o frete pode ser simulado e também pode ocorrer repasse, porém, não será mantido o mesmo valor de frete no GFE.

Nota
titleNota:

Este parâmetro é habilitado quando estiver assinalada a simulação de pedidos de vendas e notas fiscais de saída.

Prazo máximo previsto para expedição: dia(s) e hora(s)

Informar o prazo máximo previsto para expedição em dias e horas.

Adicionar o peso das Embalagens ao peso bruto dos Itens

Quando assinalado, determina que os pesos das embalagens devem ser adicionado ao peso bruto dos itens.

Considerar o volume das embalagens como volume dos itens

Quando assinalado, determina que o volume cúbico das embalagens deve ser considerado como volume dos itens.

Critério de rateio (dados dos itens)

Selecionar a opção que determina o critério de rateio do frete, considerando os dados dos itens. As opções disponíveis são:

  • Volume, determina que o volume cúbico dos itens deve ser considerado como critério de rateio.

  • Peso Bruto, determina que o peso bruto dos itens deve ser considerado como critério de rateio.

  • Quantidade, determina que a quantidade dos itens deve ser considerado como critério de rateio.

Fator de conversão

Informar o fator de conversão que deverá ser utilizado para converter o peso na emissão das notas fiscais.

Nota
titleNota:

Se a emissão das notas fiscais, o peso  for em quilos, o fator deverá ser "1".

Se a emissão das notas, o peso  for em gramas, deverá ser informado o fator "1000".

Parâmetros de Integração - Pasta Recebimento

Objetivo da tela:

Permitir definir parâmetros importantes que devem ser considerados pelo Gestão de Frete Embarcador na integração das notas fiscais de entrada.

Nota
titleNota:

Essa pasta somente é habilitada quando, na pasta Integrações, é assinalado o parâmetro Notas fiscais de Entrada da seção Processos (Datasul para GFE), ou o parâmetro de Simulação de Fretes para Nota Fiscal de Entrada, da seção Simulação de Frete, parâmetro Nota Fiscal de Entrada.


Principais Campos e Parâmetros:


Campo:

Descrição:

Funcionalidades

Assinalar as funcionalidades da integração com o Gestão de Frete Embarcador a serem utilizadas no módulo Recebimento do Datasul. As opções disponíveis são:

  • Controlar Modalidade de Frete (Pedido x NF).

  • Admitir múltiplos Redespachantes na NF.

  • Permitir alterar Transportador da Simulação na NF.

  • Permitir Alterar Simulação de Frete na NF.

Peso Bruto, Peso Cubado, Volume

Selecionar a opção que determina qual os valores de peso e volume devem ser considerados. As opções disponíveis são:

  • Dos Itens da NF.

  • Dos Totais da NF, para essa opção, deve ser definido o critério de rateio a ser utilizado.

Critério de rateio

Selecionar a opção que determina o critério de rateio, considerando os totais da nota fiscal. As opções disponíveis são:

  • Peso Líquido.

  • Quantidade.

  • Valor.

Ação Eliminação

Selecionar a opção que determina qual o tratamento que o sistema deve executar quando solicitado, no módulo de Recebimento do Datasul, uma eliminação de uma Nota Fiscal de Rateio originada a partir de um Documento de Fretes ou de um Contrato com Autônomo do Gestão de Frete Embarcador. As opções disponíveis são:

  • Nenhuma, determina que a eliminação da Nota Fiscal de Rateio pode ser efetuada normalmente e nenhuma solicitação deve enviada ao respectivo Documento de Fretes ou Contrato no Gestão de Frete Embarcador.

  • Impedir, determina que a eliminação da Nota Fiscal de Rateio de Frete deve ser bloqueada, impedindo o usuário de efetuar a eliminação.

  • Integrar, determina que a eliminação da Nota Fiscal pode ser efetuada normalmente. Nesse caso, é enviado ao Gestão de Frete Embarcador a informação para que a situação do Documento de frete ou Contrato com Autônomo passe para Pendente Desatualização.

Condição Integração

Selecionar a opção que determina a condição de sucesso na integração de dados fiscais do SIGAGFE com o Datasul. As opções disponíveis são:

  • Criação Documento: criação do Documento de Entrada com sucesso no Recebimento;

  • Atualização Documento: criação e atualização do Documento de Entrada com sucesso no Recebimento;

  • Integração Documento: criação e atualização do Documento de Entrada com sucesso no Recebimento. E integração do Documento de Entrada com sucesso no Obrigações Fiscais. E integração com o Contas a Pagar, quando gerar Duplicatas por CT-e.

Parâmetros de Integração - Pasta Fiscal

Objetivo da tela:

Permitir definir parâmetros importantes que devem ser considerados pelo Gestão de Frete Embarcador na integração do documento fiscal.

Nota
titleNota:

Essa pasta somente é habilitada quando assinalado o parâmetro de integração do processo de Documento Fiscal do GFE com o Datasul, na pasta Integrações, seção Processos (GFE para Datasul), parâmetro Docto Fiscal (Docto Frete).


Principais Campos e Parâmetros:


Campo:

Descrição:

Funcionalidades

Inserir um código de item a ser vinculado aos documentos fiscais a serem criados na integração.

Ação Eliminação

Selecionar a opção que determina qual o tratamento que o sistema deve executar quando solicitado, no módulo Obrigações Fiscais, uma eliminação de um Documento Fiscal originado a partir de um Documento de Fretes do Gestão de Frete Embarcador. As opções disponíveis são:

  • Nenhuma, determina que a eliminação do documento fiscal pode ser efetuada normalmente e nenhuma solicitação deve enviada ao respectivo Documento de Fretes no Gestão de Frete Embarcador.

  • Impedir, determina que a eliminação do documento fiscal deve ser bloqueado, impedindo o usuário de efetuar a eliminação.

  • Integrar, determina que a eliminação do documento fiscal pode ser efetuada normalmente. Nesse caso, é enviado ao Gestão de Frete Embarcador a informação para que a situação do Documento de Frete passe para Pendente Desatualização.

Parâmetros de Integração - Pasta Financeiro

Objetivo da tela:

Permitir definir parâmetros importantes que devem ser considerados pelo Gestão de Frete Embarcador, para criação dos títulos, na integração com o módulo Contas a Pagar do Datasul.

Nota
titleNota:

Essa pasta somente é habilitada quando algum parâmetro de integração com o módulo financeiro é selecionado na pasta Integrações, seção Processos (GFE para Datasul).


Principais Campos e Parâmetros:


Campo:

Descrição:

Espécie Título  Pré-fatura

Inserir a a espécie a ser considerada para a integração de pré-faturas com o financeiro.

Nota
titleNota:

Para pré-faturas, a espécie informada deve ser do tipo Provisão.

Espécie Título Fatura

Inserir a a espécie a ser considerada para a integração de faturas com o financeiro.

Cod Imp ICMS Retido

Inserir o código do ICMS Retido para os documentos de integração com o financeiro.

Cod Imp ISS Retido

Inserir o código do ISS Retido para os documentos de integração com o financeiro.

Espécie Título Contrato

Inserir a espécie a ser considerada para a integração de contratos com o financeiro.

Cod Imp ISS

Inserir o código do ISS para os documentos de integração com o financeiro.

Cod Imp IRRF

Inserir o código do IRRF para os documentos de integração com o financeiro.

Cod Imp INSS Embarcador

Inserir o código do INSS para integração de documentos de embarcadores com o financeiro.

Cod Imp INSS Autônomo

Inserir o código do INSS para integração de documentos de autônomos com o financeiro.

Cód Imp SEST/SENAT

Inserir o código do SEST/SENAT para os documentos de integração com o financeiro.

Ação Eliminação

Selecionar a opção que determina qual o tratamento que o sistema deve executar quando solicitado, no módulo de Contas a Receber, uma eliminação de um Título originado a partir de um Documento de Fretes do Gestão de Frete Embarcador. As opções disponíveis são:

  • Nenhuma, determina que a eliminação do documento fiscal pode ser efetuada normalmente e nenhuma solicitação deve enviada ao respectivo Documento de Fretes no Gestão de Frete Embarcador.

  • Impedir, determina que a eliminação do documento fiscal deve ser bloqueado, impedindo o usuário de efetuar a eliminação.

  • Integrar, determina que a eliminação do documento fiscal pode ser efetuada normalmente. Nesse caso, é enviado ao Gestão de Frete Embarcador a informação para que a situação do Documento de Frete passe para Pendente Desatualização.

Integrar Data de Pagamento

Permitir realizar a integração da data de liquidação do título do contas a pagar com a SIGAGFE.

Integração de Duplicata por CT-ePermitir que ao integrar o Documento de Entrada no recebimento, sejam geradas as duplicatas e integradas com o Contas a Pagar.

APPCs de Integração (CD0089A) - Pasta APPCs

Objetivo da tela:

Permitir visualizar os programas de integração que são vinculados aos gatilhos de dicionário ou à interface do Datasul 11. Para ativar os gatilhos do dicionário de dados, deve ser executado o Otimizador de performance.


Outras Ações/Ações Relacionadas:

 

Ação:

Descrição:

Atualizar Dados das Listas

Quando acionado, atualiza os dados das listas apresentadas em tela.

Atribuir APPCs Conforme Configuração de Integração

Quando acionado, permite voltar o cadastro da APPC previamente retirada pelo botão Retirar APPCs.

Retirar APPCs

Quando acionado, permite retirar o programa de integração selecionado.


Principais Campos e Parâmetros:


Campo:

Descrição:

Mostrar apenas APPCs do GFE

Quando assinalado, determina que somente as APPCs do GFE devam ser apresentadas. Caso contrário, todas as APPCs do Datasul são apresentadas.

Matriz de Tradução (CD0089B) - Pasta Estabelec

Objetivo da tela:

Permitir criar a relação entre os estabelecimentos dos módulos Fiscal, Faturamento e Recebimento com as filiais do Gestão de Frete Embarcador.


Outras Ações/Ações Relacionadas:

 

Ação:

Descrição:

Atualizar

Quando acionado, atualiza os dados das listas apresentadas em tela.

Grava Dados

Quando acionado, grava os dados da matriz de tradução informada.


Principais Campos e Parâmetros:


Campo:

Descrição:

Filial GFE

Inserir a filial do Gestão de Frete Embarcador que é correspondente ao estabelecimento do Datasul.

Nota
titleNota:

Quando não houver diferença nos códigos entre os sistemas, mantenha a coluna “Filial GFE” em branco.

Matriz de Tradução (CD0089B) - Pasta Estab Fin

Objetivo da tela:

Permitir criar a relação entre os estabelecimentos do módulo Financeiro com as filiais do Gestão de Frete Embarcador.


Principais Campos e Parâmetros:


Campo:

Descrição:

Filial GFE

Inserir a filial do Gestão de Frete Embarcador que é correspondente ao estabelecimento do Financeiro do Datasul.

Nota
titleNota:

Quando não houver diferença nos códigos entre os sistemas, mantenha a coluna “Filial GFE” em branco.


Conteúdos Relacionados:

Atualização de Parâmetros Globais (CD0101), deve estar assinalado o campo Frete Embarcador Multiplataforma (TotvsGFE).

Cadastrar o módulo GFE no APB (programa BAS_MODUL_DTSUL).