Histórico da Página
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.
Âncora | ||||
---|---|---|---|---|
|
...
Após a configuração, deve ser feita a chamado para a 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 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:
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:
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.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Â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:
NOME | TIPO DE DADO | ||||||
---|---|---|---|---|---|---|---|
CNPJ | String | ||||||
Data de Abertura | String | ||||||
Razão Social | String | ||||||
Nome Fantasia | String | ||||||
Atividade Principal | String | ||||||
Atividade Secundária
| JSONArray | ||||||
Natureza Jurídica | String | ||||||
Endereço | String | ||||||
Número | String | ||||||
Complemento | String | ||||||
CEP | String | ||||||
Bairro | String | ||||||
Cidade | String | ||||||
Estado | String | ||||||
Situação Cadastral | String | ||||||
Data da Situação Cadastral | String | ||||||
Motivo da Situação Cadastral | String | ||||||
Situação Especial | String | ||||||
Data da Situação Especial | String |