Páginas filhas
  • BACKOFFICE LOGIX x SUÍTE LOGÍSTICA - TMS Visão Transportador - Requisitos e Configurações

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  • 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:

      APItmsr_deletead_tms_saas1Função-
      FontesTipoVersão
      CustomerscancelCRE_TMS_SaaS.4glAPI43
      tms90430cap8881.4glFunção513
      vendorsCustomers.4glAPI34
      tmsrdeleteAD_TMS_vendorsSaaS.4glFunçãoAPI23
      tmsinsertAd_documentoTMS_fiscalSaaS.4glAPI52
      tms0815omc00573.4glcnvFunçãoConversor de parâmetro6-
      omc00574.cnvConversor de parâmetro-
      omc00575.cnvConversor de parâmetro-
      omc0913.4glFunção19
      roteador_API_TMS_SaaS.4glAPI1
      tms_documento_fiscal_cancelar.4glAPI3
      tms9208tms_documento_fiscal.4glFunçãoAPI35
      tms_titulos_receber.4glAPI2
      tms0815.4glFunção6
      tms0913.4glFunção2
      omc0913tms90430.4glFunção195
      tms9208cancelCRE_TMS_SaaS.4glAPIFunção3
      tmsr_cancelCRE_TMS_SaaS.4glFunção1
      roteadortmsr_APIdeletead_TMStms_SaaSsaas.4glAPIFunção1insertAd_TMS_SaaS.4gl2
      tmsr_insertad_tms_saas.4glFunção1
      omc00573.cnvConversor de parâmetro-
      cap8881tmsr_vendors.4glFunção13
      deleteAD_TMS_SaaS.4glAPI3
      2
      vdp90076.4glFunção
      66
      vdpr247.4glFunção22vdp90076.4gl66
      vdpr57Função249omc00575Conversor de parâmetro
      vendors.4glAPI3
  • 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).
  • 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.

...