Child pages
  • Receita Federal - Consulta de CNPJ

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Anchor
direta
direta
Execução

...

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

TIPO DE PARÂMETROTIPO DE DADODESCRIÇÃO
INPUTCHARACTERCNPJ para consulta
OUTPUTJSONObjeto JSON com informações do CNPJ informado
Code Block
RUN ConsultaCNPJ IN hMashup(INPUT "12345678901234", OUTPUT oJson).

Durante a consulta, será exibida uma tela onde deve deverá 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.

...

resolvido o ReCaptcha conforme exemplo abaixo:

Image Added

Após ser resolvido o ReCaptcha com sucesso, os dados serão retornados.

Um exemplo completo pode

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:

Code Block
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.w(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ÂMETROTIPO DE DADODESCRIÇÃO
INPUTCHARACTERCNPJ para consulta
INPUTCHARACTERTexto exibido no CAPTCHA
INPUT-OUTPUTJSON

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.

Code Block
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:

NOMETIPO DE DADO
CNPJString
Data de AberturaString
Razão SocialString
Nome FantasiaString
Atividade PrincipalString

Atividade Secundária

NOMETIPO DE DADO
AtividadeString
CodigoString
JSONArray
Natureza JurídicaString
EndereçoString
NúmeroString
ComplementoString
CEPString
BairroString
CidadeString
EstadoString
Situação CadastralString
Data da Situação CadastralString
Motivo da Situação CadastralString
Situação EspecialString
Data da Situação EspecialString