Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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: 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
direta
direta
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ÂMETROTIPO DE DADODESCRIÇÃO
INPUTCHARACTERCNPJ para consulta
OUTPUTJSONObjeto 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Â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.

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:


NOMETIPO DE DADO
CNPJ

...

...

String
Razão Social

...

String
Nome Fantasia

...

...

Atividade Principal;

...

Atividade Secundária - lista de atividades secundárias apresentada em formato de array. Os objetos possuem em sua estrutura:

  • Atividade;

  • Codigo;

...

Natureza Jurídica;

...

Endereço;

...

Número;

...

Complemento;

...

CEP;

...

Bairro;

...

Cidade;

...

Estado;

String
Natureza JurídicaString
EndereçoString
NúmeroString
ComplementoString
BairroString
CidadeString
CEPString
EstadoString
EmailString
TelefoneString
EFRString
Situação CadastralString

...

Data da Situação Cadastral

...

String

...

Data de Início da AtividadeString
Atividade EconômicaString
Atividade Econômica SecundáriaString
Tipo do CNPJString
Situação Especial

...

String
Data da Situação Especial

...

String
Motivo da Situação CadastralString
PorteString
Capital Social String
URL ComprovanteString