Linha Logix

Páginas filhas
  • DFWKLOGIX-890 DT Integração LOGIX x TOTVS API Services (Troca Mashups)

01. DADOS GERAIS

Produto:

TOTVS Framework

Linha de Produto:

Linha Logix

Segmento:

Tecnologia

Módulo:

Framework (Linha Logix) - Integrações

Função:WebServices Mashups e TOTVS API Services
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DFWKLOGIX-890


02. SITUAÇÃO/REQUISITO

Ajustar o produto Logix para prever comunicação com a nova ferramenta TOTVS Api Services que substituiu a ferramenta Mashups Totvs.

Esta demanda é uma réplica da issue DFWKLOGIX-859 expedida no pacote 12.1.2311, mas que precisa ser antecipada para o pacote 12.1.2305 devido a descontinuidade do Mashups Totvs a partir do dia 15/04/2023.

03. SOLUÇÃO

Para que a integração com a comunicação com o novo serviço TOTVS Api Services passe a ser consumido em substituição ao serviço Mashups Totvs que foi descontinuado, será preciso definir uma nova chave no arquivo de profile do Logix (logixprofile.pro ou totvsprofile.pro):

logix.tas.tokenAPIKey=<Chave de autenticação (Token) fornecida na aquisição do serviço TOTVS API SERVICES via TOTVS APPS>

Após ajuste desta chave acima no arquivo de profile e RPO atualizado com patch contendo as alterações aqui liberadas, o sistema já estará apto a se comunicar com serviços do TOTVS Api Services que é pago para algumas consultas que realiza em entidades públicas e está disponível para qualquer solução TOTVS através de APIs padronizadas, independente do serviço público de consulta. Para mais informações acesse Sobre o Totvs API Services.

As antigas chaves de profile nomeadas com o prefixo mashups.<chave> foram descontinuadas e não são mais utilizadas em nenhuma configuração ou rotina do sistema Logix.


Procedimento para adquirir acesso ao serviço TOTVS API Services e configurar o uso pelo produto LOGIX:

  1. Aderir a um dos pacotes disponíveis na TOTVS Store:
    1. Plano grátis: https://totvs.store/br/produto/totvs-api-services-pacote-de-20-consultas-gratuitas.html
    2. Plano Pago: https://totvs.store/br/produto/totvs-api-services.html
    3. Divulgação: https://www.totvs.com/totvs-api-services/

  2. Visualizar a API-KEY (Token)
    1. Página de apoio https://tdn.totvs.com/display/TASS/Sobre+o+Totvs+API+Services

  3. Configurar o código da API-KEY (token) no arquivo de PROFILE Logix (Chave logix.tas.tokenAPIKey=<API-KEY>)

  4.  Verifique se os seguintes endereços estão liberados no servidor onde os APPServers Logix estão em uso: 
    1. https://totvsapiservices.totvs.com.br
    2. https://totvsapiservices.totvs.com.br/TOTVSSoa.Host/SOAManager.svc
    3. https://api-services.totvs.app

  5.  Aplicar o patch de atualização deste requisito no RPO do Logix.

  6. PRONTO! (piscar o olho) O Logix já está configurado para acessar os serviços do TOTVS API Services. 



Observações:

  • Para obter o código da API-KEY (token) ou revogar o acesso ao ambiente TOTVS API Services acesse AQUI.
  • Para dúvidas ou problemas na adesão dos pacotes, envie um e-mail para: [email protected].

ATUALIZAÇÃO DO LOGIX PARA VERSÕES ANTERIORES A 12.1.2309

  • Para pacotes anteriores ao pacote LOGIX 12.1.2311 existe um PATCH publicado na central de downloads que pode ser aplicado, mas tendo como pré-requisito aplicar o FIX Framework até o pacote 12.1.2301.FIX01. Para acessar o patch clique AQUI.
  • Para acessar os pacotes FIX Framework LOGIX clique AQUI.


04. DEMAIS INFORMAÇÕES


A constante indisponibilidade de alguns serviços com acesso a dados da Receita Federal, Sintegra e Suframa e a complexidade de evolução arquitetural do produto Mashups levaram a TOTVS a desenvolver uma nova solução chamada TOTVS API SERVICES.

Apresentado no UNIVERSO TOTVS, o TOTVS API SERVICES ou, simplesmente TAS, entrega os mesmos serviços em funcionamento do MASHUPS, além dos serviços atualmente quebrados (Receita, Sintegra e Suframa), de forma mais otimizada, (estrela) sem a necessidade da instalação do proxy e resolução de captchas (estrela).

Para minimizar o impacto aos clientes, mantivemos o mesmo formato de entrega do dado para que ao configurar seu ambiente com o TAS, seu ERP continue funcionando da mesma forma que antes.

IMPORTANTE destacar que para os serviços da Receita Federal, Sintegra e Suframa (informação) é necessário aderir a um dos pacotes disponíveis na TOTVS Store (informação). São ofertados dois planos, sendo:

    • um plano gratuito renovado mensalmente com 20 requisições/mês
    • um plano de 200 requisições/mês com valor adicional após o consumo destas.

Desta forma oficializamos que a data de encerramento do MASHUPS é a partir do dia 15 de abril de 2023.


IMPORTANTE!

Disponível a partir do pacote oficial 12.1.2309 ou Framework Fix 12.1.2305(fix01)


05. ASSUNTOS RELACIONADOS