V2

Objeto que realiza busca em 27 sintegras. Com base nos parâmetros enviados, este robô acessa o Sintegra correspondente, resolve o captcha e extrai de forma padrão em formato JSON.

CONFIGURAÇÃO

Configuração Geral do Objeto V2

Preenchendo o Objeto:

Campo
Descritivo

Título

É o nome do objeto e não precisa ser alterado, a menos que você queira identificá-lo para facilitar a localização dele no robô, por exemplo: "Sintegra - São Paulo".

Nome Identificador do Objeto

É um identificador único do objeto e não precisa ser alterado, mas você pode renomear caso queira para localizá-lo mais facilmente quando for usá-lo em outros objetos. Apenas lembre-se que esse nome deve ser único e sem espaços ou caracteres especiais.

UF

Opção para indicar UF desejada. Não necessário colocar o nome inteiro, somente a sigla do Estado.

CNPJ

Opção para preencher o CNPJ desejado.

Inscrição Estadual

Opção para inserir Inscrição estadual a ser buscada.

Check Retornar todas as IEs (Apenas Estado do Amazonas, Distrito Federal e Minas Gerais)

Opção para fazer o retorno de todas as IEs cadastradas na Empresa.

Check Tirar print da página

Tirar print do resultado da consulta.

Check Consultar Online

Quando assinalado, ele realiza a consulta online sem verificar o banco de dados. Quando não assinalado, consulta o banco de dados da Roboteasy e verifica se houve alguma consulta nos últimos 3 dias, casa tenha, retorna os dados da consulta antiga, senão ele realiza a consulta online normalmente.

Check Salvar o Resultado em um PDF

Cria um PDF com o resultado da consulta.

Check Restringir download para arquivos maliciosos

Ação para download de arquivos maliciosos.

Utilizar proxy

Opção para Utilizar IP Proxy na consulta, a funcionalidade atualmente está disponível apenas para o estado de Santa Catarina.

RETORNOS

⇒ INSERIR GIF DE COMO ACESSAR OS RETORNOS

Para acessar um retorno basta colocar o nome identificador do objeto na frente de uma propriedade.

  • Acessar dados da EXECUÇÃO DO ROBÔ.

Informação
Propriedade
Retorno

CNPJ

.Cnpj

Retona o CNPJ informado no objeto.

Inscrição Estadual

.Ie

Retorna a Inscrição Estadual informada no objeto.

Estado

.State

Retorna o Estado informado no objeto.

Tempo de Execução

.ExecutionTime

Retorna o tempo de execução do robô.

Restringir Download para Arquivos Maliciosos?

.EnableSafeBrowsing

Retona se "Restringir Download para Arquivos Maliciosos" foi marcada.

Salvar Resultados em PDF?

.GeneratePdf

Retona se "Salvar Resultados em PDF" foi marcada.

Consulta Online?

.OnlineConsultant

Retona se "Consulta Online" foi marcada.

Retornar Todas as Inscrições Estaduais?

.ReturnAllIe

Retona se "Retornar Todas as Inscrições Estaduais" foi marcada.

Retorno Padrão?

.StandardizedReturn

Retona se "Retorno Padrão" foi marcada.

Utilizar Proxy?

.UseProxy

Retona se "Utilizar Proxy" foi marcada.

Caminho do diretório

.Path

Retorna o diretório do Print ou do PDF.

Retorno da execução da consulta

.Result

Retorna as informações da execução da consulta.

Número do documento utilizado na pesquisa(CNPJ ou IE)

.Result.value

Retorna o número do documento utilizado na pesquisa.

Tipo de documento (CNPJ ou IE)

.Result.type

Retona o tipo de documento(CNPJ ou IE).

Código Status da consulta

.Result.code

Retorna o Código Status da Consulta (SIN001 indica sucesso).

Mensagem do status da consulta

.Result.message

Retorna a mensagem do Status da consulta.

Caminho do arquivo gerado (Print ou PDF)

.Result.path_save

Retorna o caminho o caminho do Print ou do PDF.

Mensagem do resultado da Print

.Result.screenshot_result

Retorna a mensagem do resultado do Print.

  • Acessar DADOS DAS IEs

O robô retorna uma lista com todas as IEs e suas informações com base nas informações inseridas no objeto. Para acessar a lista basta utilizar .Result.datas . Para acessar uma IE específica basta utlizar .Result.datas[posicao], em que "posicao" é a posição em que a IE está na lista (iniciando por 0). O número "0" presente na tabela é somente um exemplo.

Informação
Propriedade
Retorno

Lista com os dados das IEs encontrados

.Result.datas

Retorna a lista com todas as IEs e suas informações.

Dados da primeira IE encontrada

.Result.datas[0]

Retorna todos os dados de uma IE específica.

CNPJ

.Result.datas[0].CNPJ

Retorna o CNPJ da IE.

CPF

.Result.datas[0].CPF

Retorna o CPF da IE.

Inscrição Estadual

.Result.datas[0].IE

Retorna o número da IE.

Razão Social

.Result.datas[0].RazaoSocial

Retorna a razão social da IE.

Nome Fantasia

.Result.datas[0].NomeFantasia

Retorna o nome fantasia da IE.

Data Inscrição Estadual

.Result.datas[0].DataInscricaoEstadual

Retorna a data da inscrição estadual.

Situação Cadastral Sintegra

.Result.datas[0].SituacaoCadastralSintegra

Retorna a Situação Cadastral da IE no Sintegra.

Situação Cadastral

.Result.datas[0].SituacaoCadastral

Retorna a Situação Cadastral da IE.

Regime de Apuração do ICMS

.Result.datas[0].RegimeApuracaoICMS

Retorna o Regime de Apuração de ICMS da IE.

UF (Unidade Federal)

.Result.datas[0].UF

Retorna a UF da IE.

Município

.Result.datas[0].Municipio

Retorna o município da IE.

CEP

.Result.datas[0].CEP

Retorna o CEP da IE.

Bairro

.Result.datas[0].Bairro

Retorna o bairro da IE.

Logradouro

.Result.datas[0].Logradouro

Retorna o Logradouro da IE.

Complemento sobre o Endereço

.Result.datas[0].Complemento

Retorna o complemento do endereço da IE.

Número

.Result.datas[0].Numero

Retorna o número do endereço da IE.

Telefone

.Result.datas[0].Telefone

Retorna o telefone da IE.

Endereço Eletrônico (Email)

.Result.datas[0].EnderecoEletronico

Retorna o endereço da IE.

Atividade Econômica Principal

.Result.datas[0].AtividadePrincipal

Retorna as Informações da Atividade Principal da IE.

Código CNAE

.Result.datas[0].AtividadePrincipal.CNAE

Retorna o código CNAE da Atividade Principal da IE.

Descrição CNAE

.Result.datas[0].AtividadePrincipal.Descricao

Retorna a Descrição do CNAE da Atividade Principal da IE.

Data Inicial

.Result.datas[0].AtividadePrincipal.DataInicial

Retorna a data inicialda atividade principal da IE.

  • Acessar dados das ATIVIDADES SECUNDÁRIAS de uma IE.

Para cada IE, o robô retorna uma lista com todas as atividades secundárias da IE. Para acessar a lista basta utilizar .Result.datas[0].OutrasAtividades. Para acessar uma atividade secundária específica basta utlizar .Result.datas.OutrasAtividades[posicao], em que "posicao" é a posição em que a atividade secundária está na lista (iniciando por 0). O número "0" presente na tabela é somente um exemplo.

Informação
Propriedade
Retorno

Lista com as Atividades Secundárias

.Result.datas[0].OutrasAtividades

Retorna uma lista com todas as Atividades secundárias de uma IE.

Dados de uma Atividade Secundária

.Result.datas[0].OutrasAtividades[0]

Retorna os dados de uma Atividade Secundária.

Código CNAE

.Result.datas[0].OutrasAtividades[0].CNAE

Retorna o Código CNAE de uma Atividade Secundária.

Descrição da CNAE

.Result.datas[0].OutrasAtividades[0].Descricao

Retorna a Descrição do CNAE da Atividade Secundária.

Data Inicial

.Result.datas[0].OutrasAtividades[0].DataInicial

Retorna a Data Inicial da Atividade Secundária.

CÓDIGOS E MENSAGENS DE RETORNO

Utilizando-se do .Result, é possível obter o código e a mensagem de retorno do processamento do robô pronto. Contudo, existem códigos que possibilitam maiores detalhes:

  • .code (para obter o código do processamento)

  • .message (para obter a mensagem do processamento).

Esses códigos são necessários para realizar uma validação de maior precisão quanto ao funcionamento do robô pronto.

Abaixo segue a relação dos códigos e mensagens disponíveis atualmente no robô.

.Result.code
.Result.message

SIN000

Erro inesperado!

SIN001

Valores extraídos com sucesso!

SIN010

Site indisponível no momento. Tente novamente mais tarde!

SIN011

Resultado indisponível no momento. Tente novamente mais tarde!

SIN012

Erro da pagina:

SIN013

Mais de uma IE para o CNPJ informado. Deve ser consultado por IE.

SIN014

Documento inválido, não informado ou não suportado no portal do estado

SIN015

Erro inesperado! Não foi possível gerar o Token

SIN016

Tipo de busca não informada

SIN017

Documento não informado ou não encontrado no Cadastro de Contribuinte do ICMS

SIN018

Erro ao executar sintegra: {motivoDoErro}

SIN019

Excesso de tentativas alcançado: {motivoDoErro}

SIN020

Falha ao capturar imagem das informações durante a consulta do Sintegra: {motivoDoErro}

SIN021

Erro ao converter arquivo PDF para HTML: {motivoDoErro}

SIN022

Aconteceu um erro no captcha, favor tente novamente!

SIN023

Não existe registro de Inscrição Estadual na Secretaria de Estado da Fazenda de Santa Catarina

SIN024

Site não carregou a informação correta!

CASOS DE USO

  • Utilizar para consultar informações gerais de empresas e caso deseje salvar essas informações para automação posterior.

EXEMPLO

Utilizar CNPJ da empresa desejada para verificar as informações em tela e caixa de mensagem.

Last updated

Was this helpful?