Histórico da Página
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: o 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 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.
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. 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:
NOME | TIPO DE DADO |
---|---|
CNPJ |
...
...
String |
Razão Social |
...
String | |
Nome Fantasia |
...
Atividade Principal;
String |
Atividade Secundária - lista de atividades secundárias apresentada em formato de array. Os objetos possuem em sua estrutura:
...
Atividade;
...
Natureza Jurídica |
...
String | |
Endereço |
...
String | |
Número |
...
String | |
Complemento |
...
...
String |
Bairro |
...
String | |
Cidade |
...
String | |
CEP | String |
Estado | String |
String | |
Telefone | String |
EFR | String |
...
Situação Cadastral |
...
String | |
Data da Situação Cadastral |
...
String |
...
Data de Início da Atividade | String |
Atividade Econômica | String |
Atividade Econômica Secundária | String |
Tipo do CNPJ | String |
Situação Especial |
...
String | |
Data da Situação Especial |
...
String | |
Motivo da Situação Cadastral | String |
Porte | String |
Capital Social | String |
URL Comprovante | String |