Histórico da Página

...

• 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".
• 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).
  • 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).
  • 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.
• 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.

...