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