A consulta de CNPJ 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.

Âncora
direta direta

Execução

...

...

Após a configuração REST, deve ser feita a chamado para a procedure ConsultaCNPJ procedure ConsultaCNPJ 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

Bloco de código
RUN ConsultaCNPJ IN hMashuphTasRest(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.

...

Após a configuração, deve ser feita a chamada para a procedure GetConsultaCNPJCaptcha, 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 GetConsultaCNPJCaptcha IN hMashup(OUTPUT oJson). /*imagem retorna em formato base 64 - utilização de longchar*/ lcImg = oJson:getString("Imagem"). RUN utp\ut-mashup-tela(INPUT lcImg, INPUT "", OUTPUT cCaptcha, OUTPUT cValor).

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

TIPO DE PARÂMETRO	TIPO DE DADO	DESCRIÇÃO
INPUT	CHARACTER	CNPJ para consulta
INPUT	CHARACTER	Texto exibido no CAPTCHA
INPUT-OUTPUT	JSON	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.

Bloco de código
RUN GetCNPJ 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:

...

...

...

...

...

Atividade Principal;

...

Atividade Secundária - lista de atividades secundárias apresentada em formato de array. Os objetos possuem em sua estrutura:

• Atividade;

• Codigo;

...

Natureza Jurídica;

...

Endereço;

...

Número;

...

Complemento;

...

CEP;

...

Bairro;

...

Cidade;

...

Estado;

...

...

...

...

...