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.
|
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. |
Usuário | Inserir o usuário de instalação do Gestão de Frete Embarcador. |
Senha | Inserir a senha de instalação do 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. |
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. |
API REST TOTVS - Servidor | Informar a URL de conexão para a API REST do GFE. |
Usuário | Inserir o usuário de instalação do Gestão de Frete Embarcador.
|
Senha | Inserir a senha de instalação do 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: Notas Fiscais de Saída Embarques (Romaneios) Notas Fiscais de Entrada
|
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. |
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. |
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. |
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. |
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. |
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: |
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 com OF: 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.
|
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. |
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. |
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. |
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.
|
APPCs de Integração | Quando acionado, é apresentada a tela APPCs de Integração (CD0098A), na qual visualizar os programas de integração que são vinculados aos gatilhos de dicionário ou à interface do Datasul 11. |
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. |
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. |
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).