A consulta do ao Simples Nacional trabalha com dois parâmetrosum parâmetro: código do CNPJ e código de CAPTCHA. O consumo do serviço pode ser feito de duas maneiras: chamada do serviço, que abrirá uma tela com a imagem para verificação, ou a execução em etapas, onde a imagem será retornada em base 64 e é feito um reenvio de informações com CNPJ e o código do CAPTCHA apresentado.

...

Execução

...

...

Após a a configuração REST, deve ser feita a chamado para a procedure ConsultaSimplesNacional procedure ConsultaSimplesNacional com os seguintes parâmetros:

TIPO DE PARÂMETRO	TIPO DE DADO	DESCRIÇÃO
INPUT	CHARACTER	CNPJ para consulta
OUTPUT	JSON	Objeto JSON com informações do CNPJ informado

...

RUN

...

ConsultaSimplesNacional

...

IN

...

hTasRest(INPUT

...

"12345678901234",

...

OUTPUT

...

poJson).

Durante a consulta, será exibida uma tela onde deve ser digitado o texto exibido na imagem de verificação. Portanto, este procedimento apresentará uma interface para exibir o CAPTCHA e solicitar ao usuário o respectivo valor. O uso deste procedimento é recomendado para aplicações Progress GUI por encapsular todas as etapas necessárias para a consulta do serviço em questão.

Um exemplo completo pode ser baixado aqui.

...

Após a configuração, deve ser feita a chamada para a procedure GetConsultaSimplesCaptcha, que possui um parâmetro de saída no formato JSON. Este objeto possui a imagem de verificação no valor Imagem em formato base 64. Esta imagem pode ser utilizada para verificação na tela de preferência do desenvolvedor. Este procedimento é recomendado quando o processo de negócio estiver sendo executado via Appserver e a camada de apresentação for desenvolvida em tecnologias como HTML ou Flex.

A tela utilizada no exemplo é a mesma que a utilizada na execução direta:

Bloco de código
RUN GetConsultaSimplesCaptcha IN hMashup(OUTPUT oJson). /*imagem retorna em formato base 64 - utilização de longchar*/ lcImg = oJson:getString("Imagem"). RUN utp/ut-mashup-tela.w(INPUT lcImg, INPUT "", OUTPUT cCaptcha, OUTPUT cValor).

Com o código de verificação da imagem, deve ser executada a procedure GetSimples com os seguintes parâmetros:

...

Objeto retornado na etapa anterior - possui informações que serão utilizadas para consumo do serviço.

Será retornado um objeto com os dados do CNPJ.

Retorno de dados

...

RUN GetSimples IN hMashup(INPUT "12345678901234", INPUT cCaptcha, INPUT-OUTPUT oJson).

Um exemplo completo poder ser baixado aqui.

...

Os dados retornados pelo serviço de consulta de CNPJ do Simples Nacional são: