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.

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 (custo de 1 crédito por UF). 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 estrutura de resposta deste endpoint foi projetada para integração direta com sistemas empresariais. Campos como inscricao_estadual, uf, ativa, tipo_ie e situacao_pj são facilmente mapeáveis para entidades de fornecedor, cliente ou parceiro em plataformas como SAP S/4HANA, Salesforce, Microsoft Dynamics 365, Oracle Fusion Cloud, TOTVS e Sankhya.

Para times de integração que utilizam ferramentas iPaaS como MuleSoft Anypoint, Dell Boomi, Workato ou Azure Logic Apps, o JSON Schema abaixo pode ser importado diretamente para gerar automaticamente os mapeamentos de campos e conectores de transformação de dados.

Use o JSON Schema abaixo para:

• Validar automaticamente as respostas antes de processar em workflows de integração
• Gerar modelos de dados e classes com ferramentas como Quicktype
• Configurar mapeamentos de campos em conectores de integração e ETLs
• Documentar o contrato de API nos seus processos de onboarding de fornecedores

JSON Schema da Resposta

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Sintegra — Resposta",
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "Identificador único da requisição."
    },
    "success": {
      "type": "boolean",
      "description": "Indica se a consulta foi processada com sucesso."
    },
    "error": {
      "type": "boolean",
      "description": "Indica se ocorreu um erro na consulta."
    },
    "is_cache": {
      "type": "boolean",
      "description": "Indica se a resposta foi obtida a partir do cache."
    },
    "cnpj": {
      "type": "string",
      "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",
      "description": "Lista de inscrições estaduais encontradas para o CNPJ nas UFs consultadas.",
      "items": {
        "type": "object",
        "properties": {
          "inscricao_estadual": {
            "type": "string",
            "description": "Número da inscrição estadual."
          },
          "uf": {
            "type": "string",
            "description": "UF da inscrição estadual."
          },
          "ativa": {
            "type": "boolean",
            "description": "Indica se a inscrição estadual está ativa."
          },
          "tipo_ie": {
            "type": "string",
            "description": "Tipo da inscrição estadual (ex: IE Normal, IE Substituto Tributário, IE de Produtor Rural)."
          },
          "situacao_pj": {
            "type": "string",
            "description": "Situação da pessoa jurídica na UF (ex: Sem restrição, Bloqueado como destinatário na UF)."
          },
          "updated_at": {
            "type": "string",
            "description": "Data e hora da última atualização do registro no formato YYYY-MM-DD HH:mm:ss."
          },
          "endereco": {
            "type": "object",
            "description": "Endereço da inscrição estadual. Presente apenas quando endereco=true é solicitado e a informação está disponível.",
            "properties": {
              "logradouro": { "type": "string" },
              "numero": { "type": "string" },
              "complemento": { "type": ["string", "null"] },
              "bairro": { "type": "string" },
              "municipio": { "type": "string" },
              "codigo_municipio_ibge": { "type": "string", "description": "Código IBGE do município." },
              "uf": { "type": "string" },
              "cep": { "type": "string", "description": "CEP sem formatação." }
            }
          }
        },
        "required": ["inscricao_estadual", "uf", "ativa"]
      }
    }
  },
  "required": ["request_id", "success", "error", "cnpj", "inscricoes_estaduais"]
}