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	sult.datas[0].AtividadePrincipal.Descricao	Retorna a Descrição do CNAE da Atividade Principal da IE.
Data Inicial	.Result.datas[0].AtividadePrincipalDataInicial	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.