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:
Nota: 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:
|
Servidor | Inserir a URL do Web Service. Nota: 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: 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: 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. Importante: 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: 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: 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: 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: 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:
|
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:
|
Simulação de Frete | Assinalar as informações a serem consideradas para simulação de frete. As opções disponíveis são:
|
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:
|
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: 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: 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: 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:
|
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: 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: 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:
|
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:
|
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:
|
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:
|
| 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:
|
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: 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:
|
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: 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: 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:
|
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-e | Permitir 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: 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: 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).
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas