A consulta do Simples Nacional trabalha com dois parâmetros: 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 direta

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

RUN ConsultaSimplesNacional IN hMashup(INPUT "12345678901234", OUTPUT oJson).

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.

Execução em etapas

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:

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:

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

Um exemplo completo poder ser baixado aqui.

Retorno de dados

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