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.

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:
  • https://tdn.totvs.com/pages/viewpage.action?pageId=407112736
  • https://centraldeatendimento.totvs.com/hc/pt-br/articles/360045112094-Framework-Linha-Logix-FRW-Comunica%C3%A7%C3%A3o-REST
• 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".
• 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
    Customers.4gl	API	3
    tms90430.4gl	Função	4
    vendors.4gl	API	2
    tmsr_vendors.4gl	Função	2
    tms_documento_fiscal.4gl	API	4
    tms0815.4gl	Função	5
    omc00574.cnv	Conversor de parâmetro	-
    tms_documento_fiscal_cancelar.4gl	API	2
    tms9208.4gl	Função	2
    tms_titulos_receber.4gl	API	1
    tms0913.4gl	Função	1
    omc0913.4gl	Função	19
    cancelCRE_TMS_SaaS.4gl	API	2
    tmsr_cancelCRE_TMS_SaaS.4gl	Função	1
    roteador_API_TMS_SaaS.4gl	API	1
    insertAd_TMS_SaaS.4gl	API	1
    tmsr_insertad_tms_saas.4gl	Função	1
    omc00573.cnv	Conversor de parâmetro	-
    cap8881.4gl	Função	13
    deleteAD_TMS_SaaS.4gl	API	2
    tmsr_deletead_tms_saas.4gl	Função	1
    vdpr247.4gl	Função	22
    vdp90076.4gl	Função	66

• 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).
• 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.
• Integração Online com o módulo Fiscal do Logix:
  • 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.
• Integração Online com o módulo Contabilidade do Logix:
  • 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.
• 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.

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.