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 apresentadoum parâmetro: código do CNPJ.
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:
NOME | TIPO DE DADO |
---|
CNPJ | String |
Data de AberturaString | Razão Social | String |
Nome Fantasia | String |
Atividade PrincipalNOME | TIPO DE DADO |
AtividadeAtividade Secundária
CodigoJSONArrayNatureza Jurídica | EndereçoNúmeroComplementoCEPBairroCidadeEstadoEFR | String |
Situação Cadastral | String |
Data da Situação Cadastral | String |
Motivo da Situação CadastralData 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 |