Árvore de páginas

Versões comparadas

Chave

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

A consulta ao Sintegra trabalha com dois parâmetro: código do CNPJ e estado.

Execução

...

Após a configuração REST

O serviço de consulta do SINTEGRA pode possuir de uma a três etapas:

  1. Verificação de CAPTCHA;
  2. Seleção de inscrição estadual;
  3. Retorno de dados.

O consumo do serviço pode ser feito de duas maneiras: chamada do serviço, que, caso necessário, abrirá uma tela com a imagem para verificação e seleção de inscrição, ou a execução em etapas, onde deve ser verificado se houve retorno de imagem ou lista de inscrições para reenvio e retorno dos dados.

...

Após a configuração, deve ser feita a chamado para a procedure ConsultaSintegra procedure ConsultaSintegra com os seguintes parâmetros:

TIPO DE PARÂMETRO

TIPO DE DADO

DESCRIÇÃO

INPUTCHARACTERCNPJ para
o qual será executada a
consulta
INPUTCHARACTERSigla do estado
para o qual a pesquisa será efetuada. Os estados podem ser obtidos através do método GetEstados
OUTPUTJSONObjeto JSON com informações do CNPJ informado

...

RUN

...

ConsultaSintegra

...

IN

...

hTasRest(INPUT

...

"12345678901234",

...

INPUT

...

"

...

SP",

...

OUTPUT

...

poJson).


Um exemplo completo pode ser baixado aqui.

...

Após a configuração, deve ser feita a chamada para a procedure SintegraParcial com os seguintes parâmetros:

TIPO DE PRÂMETROTIPO DE DADODESCRIÇÃO
INPUTCHARACTERCNPJ para o qual será executada a consulta
INPUTCHARACTERSigla do estado para o qual a pesquisa será efetuada. Os estados podem ser obtidos através do método GetEstados
OUTPUTJSON

Objeto JSON com 3 retornos possíveis:

Bloco de código
RUN SintegraParcial IN hMashup(INPUT "12345678901234", INPUT "SC", OUTPUT oJson).

O objeto de retorno da procedure SintegraParcial pode possuir uma imagem para validação de CAPTCHA sob o valor "Imagem" ou uma lista com inscrições estaduais do CNPJ selecionado sob o valor "Inscricoes".

...

Caso o objeto retornado possua uma imagem para validação, esta deve ser validada para reenvio das informações e do texto digitado.

O texto digitado para a imagem deve ser adicionado o objeto JSON retornado sob o valor "Codigo" através do método putValue. Este objeto deverá ser passado para a procedure SintegraContinuacao, já que contém dados necessários para a próxima etapa:

Bloco de código
IF oJson:getString("Imagem") <> ? THEN
DO:
    lcImg = oJson:getString("Imagem").
    RUN utp\ut-mashup-tela(INPUT lcImg, INPUT "", OUTPUT cCaptcha, OUTPUT cValor).
    oJson:putValue("Codigo", cCaptcha).
    RUN SintegraContinuacao IN hMashup(INPUT-OUTPUT oJson).
END.

O objeto retornado poderá ter uma lista para seleção de inscrição estadual ou os dados do CNPJ informado.

...

Retorno de dados

...

Âncora
dados
dados

Os dados retornados pelo serviço de consulta do SINTEGRA são:


NOMETIPO DE DADO
CNPJString
InscriçãoString
RazãoString
Nome FantasiaString
LogradouroString
NúmeroString
ComplementoString
BairroString
CEPString
CidadeString
EstadoString
TelefoneString
Atividade EconômicaString
Atividade Econômica SecundáriaString
Data Início da AtividadeString
Data SituaçãoString
Regime ICMSString
ObservaçõesString
Situação CadastralString
URL ComprovanteString

...

Caso o objeto retornado possua a lista com inscrições estaduais, esta deve ser apresentada para seleção do usuário.

As tabelas de inscrições estaduais são diferente entre estados. Por este motivo, o os objetos do array "Inscricoes" pode ter objetos com diferentes estruturas. Pode-se buscar a definição da tabela de inscrições através do valor "InscSchema", um array com a definição da tabela retornada, formado por objetos com a seguinte estrutura:

  • Name - nome do campo da tabela de inscrições
  • DataType - tipo de campo.

Após selecionada a inscrição, o objeto JSON associado a ela deve ser adicionado ao objeto retornado pelo última execução no valor "InscEstadual" através do método putValue.

Bloco de código
/*verificação de existência de lista de inscrições*/
IF oJson:getLongchar("Inscricoes") <> ? THEN
DO:
    oJsonArray = oJson:getJSONArray("Inscricoes").
    DO iCount = 1 TO  oJsonArray:count():
        oJsonAux = oJsonArray:getJSONObject(iCount).
        IF cInsc <> "" THEN
            cInsc = cInsc + ",".
		/*exemplo utilizando estrutura de inscrições do estado de Alagoas*/
        cInsc = cInsc + oJsonAux:getString("Razão") + "," + oJsonAux:getString("Inscrição").
    END.
    RUN utp\ut-mashup-tela(INPUT "", INPUT cInsc, OUTPUT cCaptcha, OUTPUT cValor).
    bloco_do:
    /*busca de objeto com inscrição selecionada pelo usuário para adição ao objeto de retorno*/
    DO iCount = 1 TO  oJsonArray:count():
        oJsonAux = oJsonArray:getJSONObject(iCount).
        IF oJsonAux:getString("Inscrição") = cValor THEN   /*AL*/
        DO:
            oJson:putValue("InscEstadual", oJsonAux).
            LEAVE bloco_do.
        END.
    END.
    RUN SintegraContinuacao IN hMashup(INPUT-OUTPUT oJson).
END.

Após o envio de inscrição estadual, o retorno será com os dados do CNPJ informado.

 

Exemplos com as duas verificações e retornos podem ser encontrados aqui.

...

Para retorno de estados, deve ser utilizado o método GetEstados, que retornará um objeto JSON contendo um array sob o valor "Estados" contendo objetos com a seguinte estrutura:

  • Code;

  • Description.

 

Bloco de código
RUN GetEstadosIN hMashup(OUTPUT oJson).

Um exemplo com o retorno dos estados e leitura do array pode ser baixado aqui.

...

Os dados retornados pelo serviço de consulta do SINTEGRA são:

  • CNPJ;

  • Inscrição;

  • Razão;

  • Logradouro;

  • Número;

  • Complemento;

  • Bairro;

  • Cidade;

  • Estado;

  • CEP;

  • Telefone;

  • E-Mail;

  • Data Inscrição;

  • Situação;

  • Data Situação;

  • Atividade;

  • Regime ICMS;

  • Observações;

  • Atividade Principal.

...