Requisitos (Licenças) da Suíte Logística
Ter as Licenças de uso dos seguintes módulos da suíte logística:
- TMS Operacional: Após clicar no botão “Efetivar” é iniciado o processo de comunicação com o órgão fiscal (SEFAZ para CTe, Prefeituras para NFSe) para protocolar o documento de transporte. Em seguida é efetuada a averbação deste documento. Se os processos mencionados forem concluídos de forma positiva, então será efetuada a integração do documento de transporte com o ERP.
- Financeiro Logístico: No caso de Títulos a Receber, ao clicar no botão “Concluir” de um Fechamento é efetuada a integração com o ERP. No caso de Títulos a Pagar, primeiro é efetuada a comunicação com o IPEF para obtenção do CIOT, para então efetuar a integração com o ERP.
- Barramento Azure: Este produto interage com os produtos mencionados acima, efetuando um De-Para das informações para envio ao ERP.
Requisitos (Licenças) do ERP Logix
Ter as Licenças de uso dos seguintes módulos do ERP Logix:
- Serviços Rest
- Faturamento
- Financeiro
- Fiscal
- Contabilidade
Maiores informações a respeito do consumo de licenças, acesse Consumo de licenças - LGX
Configurações na suíte/barramento
- É necessário abrir um ticket para a equipe de suporte do barramento Azure configurado na suíte e solicitar a configuração da integração passando o usuário, senha e endereço IP do serviço REST do Logix.
- Após obtido o suporte no barramento Azure, efetue o cadastro de nova Filial do ERP na suite: No Monitor de Integração (SaaS TMS Operacional) acessar: Configuração, Organização, +Novo de/para e cadastrar o relacionamento da Organização/Unidade do SaaS com o Grupo de Empresa e Filial do ERP.
Release do ERP Logix
IMPORTANTE!!!
Devido a alterações em tabelas importantes do fluxo do produto VDP (fat_nf_mestre), indica-se que o cliente esteja com o pacote 2507 aplicado em seu ambiente para que a integração ocorra.
Sugerimos também que ao aplicar o pacote FIX 01 do Framework, seja aplicado também o pacote FIX 02, que contém alguns ajustes relacionados a consumo de APIs e REST.
Configurações prévias no ERP Logix
Para que a integração atenda todas as necessidades corretamente as seguintes configurações prévias devem ser realizadas:
- O ambiente ERP Logix deve ter o serviço Http REST configurado e habilitado para receber o acionamento das APIs de Integração. Para maiores detalhes consulte as documentações abaixo:
- Para verificar se seu ambiente está com o REST habilitado, acesse o indice de serviços REST (IP e Porta configurados no appserver do Logix) mais o conteúdo da variável "URL".
- Para que seja possível analisarmos as informações recebidas e retornadas pelas APIs no arquivo console.log, é importante a ativação das seguintes chaves:
- No arquivo appserver.ini (ou totvsappserver.ini), incluir a chave FGLSQLREPLAY=1 no ambiente REST.
- No arquivo profile.pro (ou totvsprofile.pro), incluir as chaves logix.debug = 1 e logix.source.debug = 1.
- O Repositório deve estar atualizado com as APIs e Funcionalidades de integração. Caso necessário é possível, por ticket para a equipe de integrações da suíte, solicitar o patch contendo tais APIs e Funcionalidades.
Para verificar se APIs e Funcionalidades existem no RPO, acesse o ERP Logix, execute a rotina LOG1700, e procure pelas seguintes funcionalidades e confira se as versões são iguais ou superiores:
Fontes Tipo Versão cancelCRE_TMS_SaaS.4gl API 3 cap8881.4gl Função 13 Customers.4gl API 4 deleteAD_TMS_SaaS.4gl API 3 insertAd_TMS_SaaS.4gl API 2 omc00573.cnv Conversor de parâmetro - omc00574.cnv Conversor de parâmetro - omc00575.cnv Conversor de parâmetro - omc00576.cnv Conversor de parâmetro - omc0913.4gl Função 19 roteador_API_TMS_SaaS.4gl API 1 tms_documento_fiscal_cancelar.4gl API 3 tms_documento_fiscal.4gl API 6 tms_titulos_receber.4gl API 3 tms0815.4gl Função 7 tms0913.4gl Função 2 tms90430.4gl Função 5 tms9208.4gl Função 3 tms9213.4gl Função 1 tmsr_cancelCRE_TMS_SaaS.4gl Função 1 tmsr_deletead_tms_saas.4gl Função 1 tmsr_insertad_tms_saas.4gl Função 1 tmsr_vendors.4gl Função 2 vdp90076.4gl Função 66 vdpr247.4gl Função 22 vdpr57 Função 249 vendors.4gl API 3
- Os seguintes módulos do ERP Logix devem estar devidamente implantados e configurados:
- Vendas
- Contas a Receber
- Fiscal
- Contabilidade
- Contas a Pagar
- Processar os seguintes conversores de parâmetros:
- Os conversores mencionados a seguir criarão a seguinte árvore de parâmetros no sistema, onde os parâmetros mencionados serão armazenados:
- Área de Aplicação: INTEGRAÇÕES
- Sistema: SUÍTE LOGÍSTICA
- Rotina: TMS SAAS
- OMC00573 - cria os seguintes parâmetros:
- tms_saas_cod_favorecido: Código de fornecedor a ser usado como Favorecido nas ADs geradas no CAP a partir de títulos a pagar originados no TMS SaaS. Este código de fornecedor deve estar relacionado ao IPEF (Instituição de Pagamento Eletrônico de Frete) utilizado para gestão do pagamento do titulo a pagar.
- OMC00574 - cria os seguintes parâmetros:
- comp_frete_pedagio_tms_saas: Hash do Componente de frete de pedágio no TMS SAAS. Obs: Caso exista mais de 1 componente de frete de pedágio no TMS SAAS, será necessário criar outros parâmetros iguais a este, e ajustar a lógica da API para leitura dos novos parâmetros.
- Para visualizar o código hash do componente de frete referente ao pedágio, acesse o TMS Comercial, Configurador, Componentes de frete.
- Procure pelo componente de Pedágio, clique nos 3 pontinhos e selecione uma das funcionalidades apresentadas (Alterar, Visualizar, etc).
- No browser será possível visualizar o código hash do componente, antes da função selecionada. Copie-o e cole no LOG00087 para este parâmetro.
- fat_aen_item_nf_classe_uso: Código de classe de uso de Área e Linha de Negócios do Logix a ser utilizada por CTes gerados na Suíte Logística e integrados via APIs do Logix. Este parâmetro será utilizado nos casos de emitentes que não tenham esta informação cadastrada no TMS Logix para o Tomador do frete (ver tabela omc_emitente_aen).
- fat_aen_item_nf_linha_produto: Código de linha de produto de Área e Linha de Negócios do Logix a ser utilizada por CTes gerados na Suíte Logística e integrados via APIs do Logix. Este parâmetro será utilizado nos casos de emitentes que não tenham esta informação cadastrada no TMS Logix para o Tomador do frete (ver tabela omc_emitente_aen).
- fat_aen_item_nf_linha_receita: Código de linha de receita de Área e Linha de Negócios do Logix a ser utilizada por CTes gerados na Suíte Logística e integrados via APIs do Logix. Este parâmetro será utilizado nos casos de emitentes que não tenham esta informação cadastrada no TMS Logix para o Tomador do frete (ver tabela omc_emitente_aen).
- fat_aen_item_nf_segmto_mercado: Código de segmento de mercado de Área e Linha de Negócios do Logix a ser utilizada por CTes gerados na Suíte Logística e integrados via APIs do Logix. Este parâmetro será utilizado nos casos de emitentes que não tenham esta informação cadastrada no TMS Logix para o Tomador do frete (ver tabela omc_emitente_aen).
- comp_frete_pedagio_tms_saas: Hash do Componente de frete de pedágio no TMS SAAS. Obs: Caso exista mais de 1 componente de frete de pedágio no TMS SAAS, será necessário criar outros parâmetros iguais a este, e ajustar a lógica da API para leitura dos novos parâmetros.
- OMC00575 - cria os seguintes parâmetros:
- altera_clifornec_dados_suite: Indica ao sistema se os dados de Pessoas e Prestadores de Serviço da Suíte Logística, irão alterar os dados de Clientes e Fornecedores no ERP Logix. Valores possíveis: "S" - Altera. "N" - Não altera.
- IMPORTANTE! CNPJ, CPF e Inscrição Estadual nunca serão alterados.
- natureza_operacao_ctes_suite: Natureza de operação a ser utilizada para todos os CTes oriundos da Suíte Logística.
- Caso este parâmetro não esteja preenchido a API utilizará a Natureza de Operação parametrizada para o Tomador do frete no cadastro de Emitentes do TMS Logix (OMC0003).
- Caso este Tomador não tenha Natureza de Operação parametrizada, será utilizada a Natureza de Operação padrão do TMS Logix (OMC0013).
- natureza_operacao_nfse_suite: Natureza de operação a ser utilizada para todas as NFSes oriundas da Suíte Logística.
- Caso este parâmetro não esteja preenchido a API utilizará a Natureza de Operação parametrizada para o Tomador do frete no cadastro de Emitentes do TMS Logix (OMC0003).
- Caso este Tomador não tenha Natureza de Operação parametrizada, será utilizada a Natureza de Operação padrão do TMS Logix (OMC0013).
- altera_clifornec_dados_suite: Indica ao sistema se os dados de Pessoas e Prestadores de Serviço da Suíte Logística, irão alterar os dados de Clientes e Fornecedores no ERP Logix. Valores possíveis: "S" - Altera. "N" - Não altera.
- OMC00576 - cria os seguintes parâmetros:
- cond_pagto_nfd_sup_cte_subst: Indica ao sistema qual condição de pagamento será utilizada na geração de Nota Fiscal de Entrada durante a integração de um CTe de Substituição.
- Esta condição de pagamento precisa estar parametrizada no FIN30008 como "Sem pagamento".
- condicao_pagamento_padrao_cte: Indica ao sistema uma condição de pagamento padrão para CTes, a ser utilizada quando o tomador do CTe não tiver condição de pagamento de frete parametrizada no programa VDP10000.
- cond_pagto_nfd_sup_cte_subst: Indica ao sistema qual condição de pagamento será utilizada na geração de Nota Fiscal de Entrada durante a integração de um CTe de Substituição.
- Os conversores mencionados a seguir criarão a seguinte árvore de parâmetros no sistema, onde os parâmetros mencionados serão armazenados:
- Processar os seguintes conversores de tabelas:
- VDP02814 - cria a tabela "fat_nf_conh_doc_carga" que visa armazenar os Documentos de Carga (Notas Fiscais) transportadas pelo Documento de Transporte (CTe). Esta tabela foi criada devido a emissão do arquivo SINTEGRA, processado no programa OBF0317.
- Cálculo de PIS, COFINS e FECOMP
- O Motor Fiscal da Suíte Logística não calcula estes impostos.
- Para que seja possível efetuar o cálculo destes impostos, é necessário criar uma configuração fiscal no ERP Logix via programa VDP0696 (Configuração Fiscal) para a Natureza de Operação do Tomador do frete.
- Essa Natureza de Operação está relacionada ao atual cadastro do tomador como Emitente no TMS Logix (omc_emitente).
- Caso este tomador não esteja cadastrado como Emitente no TMS Logix, será utilizada a Natureza de Operação padrão do TMS Logix (omc_par_padrao).
- Cadastro de Fuso-horário (LOG00179)
- A Suíte Logística trabalha com UTC±00:00 (Coordinated Universal Time). Portanto, para que os documentos de transporte sejam integrados com Data e Hora corretas de acordo com a localização da empresa, é necessário que exista o cadastro do fuso-horário para a empresa neste programa, e que esteja igual ao parametrizado na Suíte Logística.
Integrações Online com outros produtos do Logix
- Contas a Receber:
- Para habilitar esta integração, acesse o programa LOG000086 e altere o parâmetro "exportar_duplic_on_line_cre" para o valor "S". Sua descrição é "Exportação duplicatas on-line?" e fica no caminho "PROCESSO SAIDAS / FATURAMENTO / INTEGRAÇOES FATURAMENTO".
- Desta forma a integração dos Conhecimentos emitidos na Suíte no Contas a Receber Logix será feita automaticamente após a geração das tabelas do Faturamento, baseando-se nas Duplicatas previamente geradas (tabela fat_nf_mestre e fat_nf_duplicata).
- Para consultar o título gerado no Contas a Receber, acesse o programa FIN10050.
- IMPORTANTE! Ao integrar um Título a Receber emitido na Suíte Logística para um CTe cujas Duplicatas já foram integradas, será emitida mensagem de que o Documento de Transporte já foi integrado no Contas a Receber e a integração será rejeitada.
- IMPORTANTE! Caso os CTes emitidos na Suíte possuam numeração conflitante com CTes já emitidos pelo TMS Logix, ao gerar os títulos no Contas a Receber, poderá ocorrer a rejeição "Título já cadastrado", por conta dos títulos gerados para os CTes antigos. Sugerimos avaliar a ativação do parâmetro abaixo para que o número do título gerado no Contas a Receber contenha a série do CTe. A mesma preocupação deve ocorrer quando na mesma empresa existir emissão de CTe e NFSe com série igual, sugerindo então que os documentos possuam séries diferentes.
- Paràmetro "anexa_serie_nf_duplicata".
- Fiscal:
- Para habilitar esta integração, acesse o programa LOG00086 e altere o parâmetro "util_livro_saida_on_line" para o valor "S". Sua descrição é "Utilizar Livro Registro de Saída ON LINE?" e fica no caminho "PROCESSO SAIDAS / FATURAMENTO / INTEGRAÇOES FATURAMENTO".
- Desta forma a integração dos Conhecimentos emitidos na Suíte no módulo FISCAL Logix, será feita automaticamente após a geração das tabelas do Faturamento (fat_nf_mestre e demais tabelas alimentadas). Assim não será preciso preparar os Conhecimentos por meio do OBF0010 (Preparacao para os Livros Fiscais de Saídas).
- A execução do programa OBF0020 para emissão dos Livros Fiscais continuará sendo necessária.
- Contabilidade:
- Para habilitar esta integração, acesse o programa LOG00086 e verifique o valor do parâmetro "cod_emp_cons_ctab". Se estiver nulo, considere a empresa corrente. Sua descrição é "Empresa consolidadora Contabilidade" e fica no caminho "PROCESSO SAIDAS / COMUNICAÇÃO / LANÇAMENTOS CONTÁBEIS".
- Acesse a empresa consolidadora em questão, execute o programa CON10049 (Sistemas geradores), consulte por "VDP" no campo "Sistema" para a empresa citada acima, e desmarque o parâmetro "Integração via batch?".
- Caso o parâmetro esteja marcado, será necessário executar o programa VDP40030 (Lançamentos contábeis).
- Desta forma, após a importação do CTe para o Faturamento, será efetuada a alimentação da tabela "ctb_lanc_ctbl_vdp" com os lançamentos contábeis para o documento.
- Em seguida será necessário executar o programa CON10019 (Consistência/Efetivação de lançamentos) para consistir e efetivar os lançamentos contábeis.
Issues complementares
É recomendado aplicar as issues abaixo para que a integração ocorra de forma mais íntegra:
- DLOGWMSOL-20939 - Ajustes para o programa CRE11060 ler dados de CTe gerados na Suíte.
- Esta issue cria campos de Destinatário e Consignatário na fat_nf_conh.
- DLOGWMSOL-20995 - Armazenamento das Notas Fiscais transportadas no CTe para emissão no SINTEGRA.
- Esta issue cria tabela para armazenamento dos Documentos de Carga (NFes) transportados no CTe.
- DLOGWMSOL-21126 - Ajustes nas APIs de integração.
- Esta issue contempla vários ajustes efetuados nas APIs de integração, encontrados durante as primeiras implantações.
- DMANFATMANUT-10626 - Ajuste na integração com Contabilidade
- Esta issue efetua um ajuste relacionado a retorno de parâmetros, na chamada de uma função da Contabilidade.
- DLOGWMSOL-21260 - Ajustes nas APIs de integração.
- Esta issue visa contemplar os seguintes ajustes encontrados durante a implantação nos clientes:
- Aplicação de fuso horário na data e hora de emissão do CTe.
- Desconto de ICMS da base do PIS e COFINS.
- Integração online com CRE após integração do CTe.
- Ajustes relacionados aos campos "incide" e "tributacao" armazenados na tabela "fat_nf_item_fisc".
- Esta issue visa contemplar os seguintes ajustes encontrados durante a implantação nos clientes:
- DLOGWMSOL-21141 - Geração de Nota Fiscal de Entrada a partir do CTe de Substituição e ajustes nas APIs de integração.
- Esta issue também cria os seguintes parâmetros:
- "cond_pagto_nfd_sup_cte_subst": Condição de pagamento a ser utilizada na Nota Fiscal de Entrada gerada a partir do Cte Original que foi substituído.
- "condicao_pagamento_padrao_cte": Condição de pagamento a ser utilizada na integração de CTes, cujo tomador não possua condição de pagamento de frete parametrizada no ERP.
- Esta issue também cria os seguintes parâmetros:
- DLOGWMSOL-21422 - Validações iniciais relacionadas a integração entre TMS SaaS e ERP Logix
- Esta issue criou uma API para efetuar as seguintes validações iniciais a respeito da integração:
- Parâmetros existentes e preenchidos.
- Validação das versões das APIs e funções necessárias.
- Existência de tabelas necessárias para integração.
- Esta issue criou uma API para efetuar as seguintes validações iniciais a respeito da integração:
- DLOGWMSOL-21441 - Ajustes nas APIs de integração de CTes
- Esta issue efetuou os seguintes ajustes:
- Retorno do erro relacionado a integração do CTe no Contas a Receber do Logix, no JSON da integração do documento de transporte.
- Ajustes relacionados ao Tipo de Frete, considerando sempre como CIF caso esta informação não venha no JSON.
- Alteração no processo de cancelamento de CTE para que CANCELE a Duplicata relacionada. A EXCLUSÃO da Duplicata ocorrerá somente na REABERTURA do título financeiro a receber.
- Esta issue efetuou os seguintes ajustes:
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas