Sintegra

Nossa API oferece uma forma rápida e eficiente de consultar informações cadastrais de empresas nos sistemas estaduais do Sintegra. Com ela, é possível verificar a regularidade fiscal, validar a Inscrição Estadual e obter dados detalhados de qualquer CNPJ ou Inscrição Estadual registrada no sistema.

Custos

Os valores abaixo são o total de créditos por requisição, tanto para resultados em cache quanto para consultas online.

O adicional de endereço é de 1 crédito por requisição, inclusive em uf=BR. O total de uf=BR não depende da quantidade de inscrições estaduais encontradas. Retornos com erro não consomem créditos.

Crédito é a unidade de consumo do plano. Consulte o valor dos planos e a tabela de Consumo por consulta.

Informações de entrada

Para realizar uma consulta na API Sintegra, é necessário informar apenas o CNPJ. Os demais parâmetros são opcionais e permitem controlar o comportamento da consulta.

CNPJ: O número do Cadastro Nacional da Pessoa Jurídica (CNPJ) da empresa que deseja consultar. Pode ser informado com ou sem pontuação.

UF: Representa a UF que deverá ser consultada. Aceita o código de uma UF brasileira (ex: SP, RJ, MG) ou o valor especial BR para consultar todas as UFs de uma vez (total de 26 créditos, ou 27 com endereço). Se nenhuma UF for informada, a API poderá utilizar a UF de emissão do CNPJ quando essa informação estiver disponível.

Cache: Define por quantos dias uma consulta armazenada em cache ainda pode ser considerada válida. O cache é compartilhado entre os clientes da plataforma para melhorar performance e disponibilidade. Esse reaproveitamento ocorre de forma segura: a API não informa qual cliente originou a consulta e não compartilha dados comerciais entre usuários.

Cache Strategy: Define o comportamento da consulta, determinando a prioridade entre utilizar dados em cache e realizar uma nova consulta online nos Sintegras estaduais.

Error Fallback: Define se a API poderá utilizar dados em cache como resposta alternativa quando ocorrer erro na consulta online, independentemente da estratégia definida em cache_strategy.

Endereço: Define se a API também deve buscar o endereço da inscrição estadual. Aceita true ou false.

Parâmetros Obrigatórios

Parâmetros Opcionais

Estratégias de Cache

A API oferece diferentes estratégias para balancear entre performance, custo e atualização dos dados:

Sintegra

curl -G https://api.sintegrapi.com.br/consultas/v2/sintegra/15436940000103 \
  -H "x-api-key: {apiKey}" \
  -d "uf=BR" \
  -d "cache_strategy=ONLINE_PREFERENCIAL" \
  -d "endereco=true"

  {
    "cnpj": "00001180000800",
    "razao_social": "AXIA ENERGIA S.A.",
      "uf": "SP",
      "inscricoes_estaduais": [
          {
        "inscricao_estadual": "47329590401",
        "uf": "MG",
              "ativa": true,
              "tipo_ie": "IE Substituto Tributário",
        "situacao_pj": "Bloqueado como Destinatário na UF",
        "updated_at": "2026-07-14 15:44:37"
          },
          {
        "inscricao_estadual": "137774473115",
        "uf": "SP",
              "ativa": true,
        "tipo_ie": "IE Normal",
        "situacao_pj": "Sem restrição",
        "updated_at": "2026-07-14 15:44:37",
        "endereco": {
          "logradouro": "RUA S TOME",
          "numero": "86",
          "complemento": "ANDAR 14 E 16 CONJ 141 / 161 E 162",
          "bairro": "VILA OLIMPIA",
          "municipio": "SAO PAULO",
          "codigo_municipio_ibge": "3550308",
          "uf": "SP",
          "cep": "04551080"
        }
          }
      ],
    "request_id": "f54d694b-10b8-4119-8a3f-91534d02e48f",
      "success": true,
    "error": false,
    "is_cache": false
  }

Variações relevantes nos campos de resposta

Abaixo estão descritas variações importantes que podem ocorrer nos campos retornados pela API.

Exemplos de Uso

Consulta em uma UF específica (valores padrão)

GET /consultas/v2/sintegra/12345678000199?uf=SP

Equivalente a:

GET /consultas/v2/sintegra/12345678000199?uf=SP&cache_strategy=ONLINE_PREFERENCIAL&cache=7&error_fallback=false

Consulta em todas as UFs

GET /consultas/v2/sintegra/12345678000199?uf=BR

A API executa buscas em todas as UFs disponíveis em background e retorna as inscrições estaduais encontradas para o CNPJ informado.

Consulta com endereço por inscrição estadual

GET /consultas/v2/sintegra/12345678000199?uf=SP&endereco=true

Quando endereco=true, a API tenta retornar o campo endereco por inscrição estadual e contabiliza 1 consulta extra na requisição.

Consulta em todas as UFs com endereço

GET /consultas/v2/sintegra/12345678000199?uf=BR&endereco=true

Nesse cenário, a API continua consultando múltiplas UFs e a busca de endereço contabiliza apenas 1 consulta extra no total (não 1 por UF).

Consulta priorizando cache por 30 dias

GET /consultas/v2/sintegra/12345678000199?uf=SP&cache_strategy=CACHE_PREFERENCIAL&cache=30

A API utilizará o cache se ele tiver até 30 dias de idade. Caso contrário, tentará uma nova consulta online.

Consulta sempre online

GET /consultas/v2/sintegra/12345678000199?uf=SP&cache_strategy=SO_ONLINE

A API tentará consultar diretamente os Sintegras estaduais, sem utilizar cache como fallback.

Consulta online com fallback para cache válido

GET /consultas/v2/sintegra/12345678000199?uf=SP&cache_strategy=ONLINE_PREFERENCIAL&cache=7

A API tentará primeiro a consulta online. Se a consulta online falhar, poderá retornar um cache válido de até 7 dias.

Consulta online com fallback habilitado em caso de erro

GET /consultas/v2/sintegra/12345678000199?uf=SP&error_fallback=true

Se a consulta online falhar por instabilidade do Sintegra estadual, a API retornará dados em cache quando disponíveis.

Observações Importantes

• O parâmetro cache não força a criação de um novo cache. Ele define apenas a idade máxima aceita para considerar um cache válido.
• O parâmetro endereco aceita true ou false e controla a inclusão do campo endereco por inscrição estadual.
• Quando endereco=true, a requisição contabiliza 1 consulta extra para busca de endereço.
• Quando endereco=true junto com uf=BR, a busca de endereço contabiliza apenas 1 consulta extra no total da requisição.
• Algumas inscrições estaduais não possuem endereço disponível; nesses casos, o campo endereco não é retornado para aquela inscrição.
• Quando endereco não é solicitado, a resposta retorna sem o campo endereco.
• O cache é compartilhado entre os clientes da plataforma para melhorar performance, disponibilidade e eficiência operacional.
• O uso de cache compartilhado não expõe dados de clientes, histórico de consultas ou informações comerciais entre usuários da API.
• Quando houver cache válido para o mesmo CNPJ e UF, a API poderá reutilizar esse resultado conforme a estratégia definida em cache_strategy.
• Consultas online aos Sintegras estaduais tendem a ser mais lentas e podem falhar por instabilidade dos portais estaduais; por isso, o cache pode aumentar a previsibilidade da integração.
• O parâmetro uf=BR pode aumentar o tempo de processamento, pois a API executa consultas em múltiplas UFs em paralelo.
• A disponibilidade e a estabilidade da consulta online dependem dos Sintegras estaduais.
• Para a maioria dos clientes, a estratégia recomendada é ONLINE_PREFERENCIAL, pois combina tentativa de atualização online com fallback para cache válido.
• Quando a consulta for sensível a dados mais recentes, utilize SO_ONLINE.
• Quando o objetivo for reduzir latência, dependência dos portais estaduais ou chamadas online repetidas, utilize CACHE_PREFERENCIAL ou CACHE_SE_EXISTIR.

Integração com CRMs e ERPs

A API Sintegra permite incluir a consulta de inscrição estadual no cadastro de clientes e fornecedores do seu ERP ou CRM. A integração utiliza requisições HTTPS e mapeamento de campos, implementados pela sua equipe ou parceiro conforme os recursos da versão contratada.

Inscrição estadual no TOTVS Protheus, SAP e Sankhya

Em um projeto com TOTVS Protheus, TOTVS RM, SAP S/4HANA, SAP Business One ou Sankhya, consulte o CNPJ e a UF antes de atualizar o cadastro fiscal. Preserve cada inscrição estadual separadamente: um mesmo CNPJ pode ter inscrições e situações diferentes entre estados. O mesmo fluxo pode apoiar cadastros em Omie e Bling, com adaptação dos campos no sistema de destino.

Qualificação de empresas no Salesforce e Microsoft Dynamics 365

No Salesforce, Microsoft Dynamics 365, HubSpot ou Zoho CRM, associe o resultado à conta da empresa para apoiar a passagem de vendas para faturamento. Avalie error antes dos dados cadastrais; uma falha de consulta não deve apagar uma inscrição previamente confirmada. Use os tipos de IE e a situação retornada como dados de apoio às regras do seu processo.

Mantenha a API key no servidor da integração e escolha a estratégia de cache conforme a necessidade de atualização. O JSON Schema da resposta ajuda a validar os campos antes de gravá-los no ERP ou CRM.

JSON Schema da Resposta

O schema usa JSON Schema Draft 2020-12. Os campos de negócio podem ser omitidos ou nulos quando não há informação disponível ou quando ocorre um erro. Valide também success e error antes de atualizar o cadastro. Propriedades adicionais são aceitas para permitir evolução compatível. O schema descreve o corpo JSON; o código HTTP deve ser tratado separadamente.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Sintegra — Resposta",
  "type": "object",
  "properties": {
    "request_id": { "type": "string", "format": "uuid" },
    "success": {
      "type": "boolean",
      "description": "Resultado funcional da consulta; avalie junto com error."
    },
    "error": {
      "type": "boolean",
      "description": "Indica falha técnica ou de validação."
    },
    "is_cache": { "type": ["boolean", "null"] },
    "cnpj": {
      "type": ["string", "null"],
      "description": "CNPJ consultado, sem formatação."
    },
    "razao_social": {
      "type": ["string", "null"],
      "description": "Razão social da empresa, quando disponível."
    },
    "uf": {
      "type": ["string", "null"],
      "description": "UF de emissão principal do CNPJ, quando disponível."
    },
    "inscricoes_estaduais": {
      "type": ["array", "null"],
      "description": "Lista de inscrições estaduais encontradas para o CNPJ nas UFs consultadas.",
      "items": {
        "type": ["object", "null"],
        "properties": {
          "inscricao_estadual": {
            "type": ["string", "null"],
            "description": "Número da inscrição estadual."
          },
          "uf": {
            "type": ["string", "null"],
            "description": "UF da inscrição estadual."
          },
          "ativa": {
            "type": "boolean",
            "description": "Indica se a inscrição estadual está ativa."
          },
          "tipo_ie": {
            "type": ["string", "null"],
            "description": "Tipo da inscrição estadual (ex: IE Normal, IE Substituto Tributário, IE de Produtor Rural)."
          },
          "situacao_pj": {
            "type": ["string", "null"],
            "description": "Situação da pessoa jurídica na UF (ex: Sem restrição, Bloqueado como destinatário na UF)."
          },
          "updated_at": {
            "type": ["string", "null"],
            "description": "Data e hora no formato YYYY-MM-DD HH:mm:ss.",
            "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$"
          },
          "endereco": {
            "type": ["object", "null"],
            "properties": {
              "tipo": { "type": ["string", "null"] },
              "logradouro": { "type": ["string", "null"] },
              "numero": { "type": ["string", "null"] },
              "complemento": { "type": ["string", "null"] },
              "bairro": { "type": ["string", "null"] },
              "municipio": { "type": ["string", "null"] },
              "codigo_municipio_ibge": { "type": ["string", "null"] },
              "uf": { "type": ["string", "null"] },
              "cep": { "type": ["string", "null"] }
            }
          },
          "data_status": {
            "type": ["string", "null"],
            "description": "Data civil no formato YYYY-MM-DD.",
            "format": "date"
          }
        }
      }
    },
    "error_message": {
      "type": ["object", "null"],
      "properties": {
        "message": {
          "type": ["string", "null"],
          "description": "Mensagem pública da consulta."
        },
        "code": {
          "type": ["string", "null"],
          "description": "Código público, quando informado."
        }
      }
    },
    "regime_tributacao": { "type": ["string", "null"] },
    "endereco": {
      "type": ["object", "null"],
      "properties": {
        "tipo": { "type": ["string", "null"] },
        "logradouro": { "type": ["string", "null"] },
        "numero": { "type": ["string", "null"] },
        "complemento": { "type": ["string", "null"] },
        "bairro": { "type": ["string", "null"] },
        "municipio": { "type": ["string", "null"] },
        "codigo_municipio_ibge": { "type": ["string", "null"] },
        "uf": { "type": ["string", "null"] },
        "cep": { "type": ["string", "null"] }
      }
    }
  },
  "required": ["request_id", "success", "error"],
  "additionalProperties": true
}