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.
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 https://tdn.totvs.com/pages/viewpage.action?pageId=407112736
- 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 | 2 |
| tms90430.4gl | Função | 3 |
| vendors.4gl | API | 1 |
| tmsr_vendors.4gl | Função | 2 |
| tms_documento_fiscal.4gl | API | 1 |
| tms0815.4gl | Função | 1 |
| omc00574.cnv | Conversor de parâmetro | - |
| tms_documento_fiscal_cancelar.4gl | API | 1 |
| tms9208.4gl | Função | 1 |
| tms_titulos_receber.4gl | API | 1 |
| tms0913.4gl | Função | 1 |
| omc0913.4gl | Função | 19 |
| cancelCRE_TMS_SaaS.4gl | API | 1 |
| 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 | 1 |
| tmsr_deletead_tms_saas.4gl | Função | 1 |
- 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).
- 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) 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).