Á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. Mais informações sobre os serviços oferecidos pelo Mashup TOTVS disponíveis em Na Totvs este serviço é identificado como TAS - TOTVS API Service, paramais informações sobre esse serviço consulte Status Mashup.


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

...

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)

Fontes

...

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

<FOUNDATION>/utp/

  • ut-mashuptas-a.p

  • ut-mashuptas-b.p

  • ut-mashuptas-banco-central.p

  • ut-mashuptas-c.p

  • ut-mashuptas-d.p

  • ut-mashuptas-e.p

  • ut-mashuptas-f.p

  • ut-mashuptas-receita.p

  • ut-mashuptas-sintegra-captcha.p

  • ut-mashuptas-sintegra-inscricoes.p

  • ut-mashuptas-sintegra.p

  • ut-mashuptas-suframa-a.p

  • ut-mashuptas-suframa.p

  • ut-mashuptas.p

  • ut-mashuptas-tela.w

Âncora
ConfigMashup
ConfigMashup
Configuração

...

O programa utp/ut-mashuptas deve ser executado de forma persistente em uma variável HANDLE, a partir da qual serão executados os métodos de consumo dos serviços:

Bloco de código
RUN utp/ut-mashuptas.p PERSISTENT SET hMashuphTas.

Na antiga arquitetura JBOSS a configuração do endereço do proxy deverá ser feito no arquivo de propriedades do Datasul (datasul_framework.properties):

mashup.proxy = http://<server>:<port>

valor padrão.

Informações

Devido ao excesso de requisições realizadas pelo servidor do Mashup Totvs no site da Receita Federal, na versão 12.1.11 do Datasul foi adicionado a opção de configuração de proxy para o Mashup Totvs passar a utilizar este endereço em suas requisições externas. É importante ressaltar que o proxy não é obrigatório para todas as estações clientes do produto, no entanto, em caso de erros de conexão a sugestão é instalar o proxy. O acesso ao mashup sempre se dará pela parte cliente, pois, existe sempre a necessidade visual de validar os desafios das imagens, portanto, não existe como executar esse funcionalidade diretamente via backend. 

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 MASHUP TAS é necessário parametrizar duas propriedades na tabela dinâmica:

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

Caso as propriedades totvs.mashuptas.debug e totvs.mashuptas.proxyurl não existam na tabela dinâmica, as mesmas assumiram valores padrão FALSE e VAZIO respectivamente. Ao retornar o valor vazio para o proxy a url assumirá, assim, o proxy do servidor.

Informações

Usuário e senha devem ser definidos para utilização dos serviços através do método SetUserPassword:

Bloco de código
RUN SetUserPassword IN hMashuphTas(INPUT cUser, INPUT cPassword).

...

Bloco de código
IF oJson:getString("Erro") <> ? THEN
	cErro = oJson:getString("Erro").

Exemplos

...

Para exemplificar o consumo dos serviços oferecidos pela API desenvolvida, podem ser utilizados os exemplos abaixo: