OBJETIVO
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 em 2022, 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.
1. O que é TOTVS API Services
O TOTVS API Services é um serviço pago que realiza consultas em entidades públicas e os disponibiliza para qualquer solução TOTVS através de APIs padronizadas, independente do serviço público de consulta. Os serviços disponibilizados pelo mesmo são listados abaixo e dependem do mínimo esforço para consumo dos mesmos.
Este serviço substitui o antigo serviço MASHUP TOTVS que teve seu encerramento a partir do dia 15 de abril de 2023.
Para mais informações acesse Serviços - TOTVS API Services.
Para minimizar o impacto aos clientes, foi mantido o mesmo formato de entrega do dado para que ao configurar o ambiente com o TAS, o ERP continue funcionando da mesma forma que antes.
IMPORTANTE destacar que para os serviços da Receita Federal, Sintegra e Suframa é necessário aderir a um dos pacotes disponíveis na TOTVS Store . 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.
2. Pré-requisitos para uso do TOTVS API Services
Na sequência estão as informações e configurações necessárias para que o TAS possa operar corretamente a partir do produto LOGIX.
2.1 CHAVES DE PROFILE:
Todas as chaves a seguir são obrigatórias para uso da funcionalidade envolvendo Totvs API Service (TAS), nova ferramenta que substituiu os serviços da ferramenta Mashup Totvs que foi descontinuada a partir de 15/04/2023.
Para mais informações acesse DFWKLOGIX-890 DT Integração LOGIX x TOTVS API Services (Troca Mashups).
Exemplos:
- Consulta de CPF
- Consulta de CEP
- etc.
TAS disponível a partir do pacote Logix 12.1.2305 ou Fix Framework Logix 12.1.2305.fix01.
A ferramenta TAS, entrega os mesmos serviços em funcionamento da ferramenta MASHUPS que foi descontinuada, além dos serviços atualmente quebrados (Receita, Sintegra e Suframa), de forma mais otimizada, sem a necessidade da instalação do proxy e resolução de captchas .
Chave | Descrição |
---|---|
logix.tas.apiKey | Código da API-KEY (token) registrado para uso dos serviços disponíveis no TAS (Totvs API Services).
|
2.2 PROCEDIMENTOS NECESSÁRIOS
Procedimento para adquirir acesso ao serviço TOTVS API Services e configurar o uso pelo produto LOGIX:
- Aderir a um dos pacotes disponíveis na TOTVS Store:
- Visualizar a API-KEY (Token)
- Página de apoio https://tdn.totvs.com/display/TASS/Sobre+o+Totvs+API+Services
- Página de apoio https://tdn.totvs.com/display/TASS/Sobre+o+Totvs+API+Services
- Configurar o código da API-KEY (token) no arquivo de PROFILE Logix (Chave logix.tas.tokenAPIKey=<API-KEY>)
- Verifique se os seguintes endereços estão liberados no servidor onde os APPServers Logix estão em uso:
- Aplicar o patch de atualização deste requisito no RPO do Logix.
- PRONTO! 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].
- Verifique se os endereços estão liberados no servidor onde os AppServers do Logix estão em execução e que acessam o TAS: https://totvsapiservices.totvs.com.br/ e https://totvsapiservices.totvs.com.br/TOTVSSoa.Host/SOAManager.svc