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.
Execução...
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 |
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Â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. |
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:
NOME | TIPO DE DADO |
---|
CNPJ | String |
Data de Abertura | String |
Razão Social | String |
Nome Fantasia | String |
Atividade Principal | String |
Atividade Secundária NOME | TIPO DE DADO |
---|
Atividade | String | Codigo | String |
| 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 |