robotV2

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.

Visão Geral

O objeto Sintegra (V2) é utilizado para consultar informações cadastrais de contribuintes no sistema SINTEGRA, utilizando parâmetros como UF, CNPJ ou Inscrição Estadual durante a execução de um robô.

Essa versão do objeto oferece uma estrutura padronizada de consulta, permitindo que automações realizem verificações fiscais estaduais com maior estabilidade e controle de execução.

O objeto permite obter informações relacionadas ao cadastro estadual de empresas, sendo utilizado em processos que exigem validação de dados fiscais ou verificação de registros estaduais.

Opcionalmente, o resultado da consulta pode ser salvo em PDF ou capturado como imagem da página consultada.


Funcionamento

O objeto Sintegra (V2) realiza consultas em portais do SINTEGRA utilizando os parâmetros configurados.

Fluxo de funcionamento:

  1. O robô executa o objeto Sintegra (V2).

  2. O campo UF define o estado onde a consulta será realizada.

  3. A consulta pode ser realizada utilizando CNPJ ou Inscrição Estadual.

  4. O sistema acessa o portal correspondente ao estado informado.

  5. O robô coleta as informações disponíveis no resultado da consulta.

  6. Os dados obtidos podem ser utilizados no fluxo da automação.

O objeto também oferece opções adicionais que permitem configurar o comportamento da consulta.

Quando usar

  • Quando for necessário consultar informações fiscais no SINTEGRA.

  • Quando o robô precisar validar inscrições estaduais de empresas.

  • Quando processos automatizados exigirem verificação cadastral em bases fiscais estaduais.

Quando não usar

Não utilizar quando o processo não exigir consulta de dados fiscais estaduais.


Configuração

CAMPO
DESCRITIVO

Versão do componente

Define a versão do componente utilizada pelo objeto.

Título

Nome do objeto dentro do fluxo do robô.

Nome Identificador do Objeto

Identificador único do objeto dentro do robô.

UF

Unidade federativa onde a consulta será realizada.

CNPJ

Número do CNPJ utilizado para consulta no SINTEGRA.

Inscrição Estadual

Número da inscrição estadual utilizado na consulta.

Retornar todas as IEs

Quando habilitado, retorna todas as inscrições estaduais vinculadas à empresa consultada.

Consultar Online

Quando habilitado, realiza a consulta diretamente no portal online do SINTEGRA.

Consulta via Certificado

Permite realizar a consulta utilizando certificado digital.

Tirar print da página

Quando habilitado, captura uma imagem da página de resultado da consulta.

Salvar Resultado em um PDF

Quando habilitado, gera um arquivo PDF contendo o resultado da consulta.

Restringir download para arquivos maliciosos

Quando habilitado, restringe downloads identificados como potencialmente maliciosos durante a consulta.

Utilizar proxy

Permite utilizar um proxy durante a consulta.

Utilizar driver indetectável

Quando habilitado, utiliza um driver de navegador com menor possibilidade de detecção automática.


Exemplos

Exemplo simples

Fluxo básico para consultar dados no SINTEGRA:

  1. Inserir o objeto Sintegra (V2) no fluxo do robô.

  2. Informar a UF onde será realizada a consulta.

  3. Informar o CNPJ ou Inscrição Estadual.

  4. Executar o robô.

Após a execução, o robô retorna os dados cadastrados no SINTEGRA.

Exemplo aplicado

Cenário: um robô precisa validar dados fiscais de fornecedores cadastrados.

Fluxo:

  1. O robô recebe o CNPJ de uma empresa.

  2. O objeto Sintegra (V2) consulta os dados fiscais no estado correspondente.

  3. O robô valida a inscrição estadual da empresa.

  4. Opcionalmente, o resultado da consulta é salvo em PDF para auditoria.


Retornos


Erros comuns e como evitar

UF inválida

Ocorre quando a unidade federativa informada não corresponde a um estado válido.

Como evitar:

  • Informar uma UF válida correspondente ao estado da consulta.

CNPJ ou Inscrição Estadual inválidos

A consulta pode falhar quando os dados informados não são válidos.

Como evitar:

  • Garantir que os dados informados estejam corretos.

Consulta bloqueada pelo portal

Alguns portais estaduais podem restringir consultas automatizadas.

Como evitar:

  • Utilizar opções como proxy ou driver indetectável quando necessário.


Boas práticas

  • Informar corretamente a UF antes de executar a consulta.

  • Validar previamente os dados de CNPJ ou Inscrição Estadual.

  • Utilizar geração de PDF quando for necessário manter registro das consultas realizadas.

  • Utilizar configurações como proxy quando houver restrições de acesso ao portal consultado.

Last updated

Was this helpful?