Árvore de páginas

Versões comparadas

Chave

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

Introdução

...

Mashups são sites personalizados que utilizam conteúdo de mais de uma fonte para criar um serviço completo. O conteúdo de mashups geralmente são códigos de terceiros utilizando uma interface pública ou API. Na Totvs este serviço é identificado como TAS - TOTVS API Service, paramais informações sobre esse serviço consulte https://www.totvs.com/totvs-api-services/O serviço do TAS permite a integração de qualquer aplicativo de qualquer sistema operacional e linguagem de programação. A sua implementação foi feita em cima da WCF (Windows Communication Foundation) utilizando o padrão WS-*, XML e SOAP para a comunicação. Mas é expansível a outros padrões suportados pela WCF da plataforma Microsoft.NET.


Aviso
titleAtenção

Por se tratarem de serviços públicos, estamos sujeitos a mudanças de comportamento e à disponibilidade destes serviços. Sendo assim pedimos compreensão quando houver decorrência destes.

A TOTVS continuamente buscará soluções para manter a disponibilidade destes serviços, mas nos reservamos o direito de remover, a qualquer momento, sem aviso prévio, alguns dos serviços, bem como não nos responsabilizamos por qualquer prejuízo causado pelas informações ou disponibilidade dos serviços.

Objetivo

Adesão

...

OTOTVS 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. Mais informações sobre os serviços pagos acesse: https://www.totvs.com/totvs-api-services/

Para que o cliente posso consumir este serviço é necessário que o mesmo possua licença de algum produto TOTVS que suporte a integração com o TOTVS API Services ou que possa ser customizado. A adesão e os planos disponíveis estão disponíveis na TOTVS Store.

Apenas os serviços abaixo estão disponíveis no plano pago, ou seja, os demais serviços do Mashup continuam funcionando normalmente.

Serviço

Receita Federal - Consulta de CNPJ
Receita Federal - Consulta de CPF
Receita Federal - Consulta Simples Nacional
Sintegra - Consulta Nacional ao Cadastro
Sintegra - Consulta Unificada ao Cadastro
Suframa - Consulta Situação Fornecedor


Serviços disponíveis

...

Abaixo estão todos os serviços disponíveis para integração com o produto Datasul.A TOTVS desenvolveu um mashup integrado a diversos serviços públicos. Com base neste mashup, foi desenvolvida uma API para a linha Datasul com o objetivo de consumo dos serviços oferecidos, sendo  eles:

...

Informações
titleMatriz de Evolução
Versão / ReleaseFuncionalidade
12.1.6Liberação de API Mashup
12.1.8Retirada necessidade de parametrização de usuário e senha pelo desenvolvedor
12.1.11Adicionada opção de proxy - IP da Totvs foi bloqueado devido a excesso de requisições
12.1.20Adicionada Consulta ao Simples Nacional
12.1.21Adicionada validação com ReCaptcha (v3.0)
12.1.2311Adicionado Totvs API Service



Fontes

...

<FOUNDATION>/interfac/Recaptcha: executável de exibição do ReCaptcha 3.0

...

Devido ao excesso de requisições realizadas pelo servidor do Mashup Totvs no site da Receita Federal, na
Bloco de código
RUN utp/ut-tas.p PERSISTENT SET hTas.
Informações


Com a versão 12.1.

...

8, não será mais necessário informar manualmente o nome de usuário e senha, será enviado automaticamente essas informações para o TOTVS API Services. 

Nas propriedades do sistema em Integrações TOTVS os seguintes parâmetros devem ser configurados:

URL: É a url do TOTVS API SERVICES, este parâmetro não é obrigatório, quando não preenchido assume o valor padrão: http://totvsapiservices.totvs.com.br;

Chave de Acesso: É uma chave para utilização dos serviços pagos do TOTVS API SERVICES. Mais detalhes de onde obter o token podem ser encontradas neste link.

Debug: Indica se irá gerar log de execução do serviço no debug.


Image Added

O Mashup Totvs fornece uma ferramenta para que o WebService simule um proxy (http://mashup.totvs.com.br/TOTVSMashups.Setup.zip) em suas requisições, de modo a não utilizar sempre o mesmo endereço. A instalação adota a porta 8055 por padrão.

(aviso) Importante:

Na Arquitetura Tomcat para utilização do TAS é necessário parametrizar duas propriedades na tabela dinâmica:

  • totvs.tas.debug - para baixar os arquivos de debug;
  • totvs.tas.url - para parametrizar o endereço em requisições externas.

...


A API desenvolvida retorna os dados dos serviços em formato JSON. Caso ocorra algum erro na execução do serviço, será retornado no valor "Erro", que pode ser pego através do método getString:

...