Histórico da Página
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 | ||
---|---|---|
| ||
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 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
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 | ||||
---|---|---|---|---|
|
...
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. |
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. Importante:Na Arquitetura Tomcat para utilização do MASHUP TAS é necessário parametrizar duas propriedades na tabela dinâmica:
Caso as propriedades totvs.mashuptas.debug e Informações | Na antiga arquitetura JBOSS a configuração do endereço do proxy deverá ser feito no arquivo de propriedades do Datasul ( mashup.proxy = http://<server>:<port> valor padrão. |
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:
- mashuptas-sample-consulta-cnpj.p
- mashuptas-sample-consulta-cpf.p
- mashuptas-sample-consulta-simples.p
- mashuptas-sample-consulta-simples-etapas.p
- mashuptas-sample-busca-estados.p
- mashuptas-sample-sintegra.p
- mashuptas-sample-sintegra-etapas.p
- mashuptas-sample-suframa.p
- mashuptas-sample-suframa-etapas.p
- mashuptas-sample-consulta-motoristas.p
- mashuptas-sample-lista-ocupacoes.p
- mashuptas-sample-consulta-municipos-nfse.p
- mashuptas-sample-busca-moedas.p
- mashuptas-sample-conversao-moedas.p
- mashuptas-sample-consulta-cep.p
- mashuptas-sample-busca-idiomas.p
- mashuptas-sample-traducao.p