# Sintegra - Cadastro Estadual

> Verifica a situação cadastral e o regime de tributação de ICMS junto à SEFAZ. Basta o CNPJ: o estado do estabelecimento é identificado automaticamente. Essencial para validação fiscal, análise de risco e conformidade regulatória de empresas.

- **Consulta:** `sintegra-estadual`
- **Categoria:** Fiscal
- **Preço:** R$ 0,54 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/sintegra-estadual`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/fiscal/sintegra-estadual

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta a situação cadastral e o regime de tributação de ICMS de uma empresa junto à Secretaria da Fazenda estadual. Serve para validar a situação tributária, verificar se a inscrição estadual está ativa e identificar obrigações fiscais relacionadas à emissão de nota fiscal eletrônica.
>
> **Você não precisa saber o estado da empresa.** Informe apenas o CNPJ completo — o endpoint identifica o estado do estabelecimento na base da Receita Federal e consulta a SEFAZ correta.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/sintegra-estadual?cnpj=SEU_CNPJ&uf=SP"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/sintegra-estadual",
    params={"cnpj": "SEU_CNPJ", "uf": "SP"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/sintegra-estadual");

url.search = new URLSearchParams({
  "cnpj": "SEU_CNPJ",
  "uf": "SP"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cnpj` | CNPJ | sim | CNPJ COMPLETO do estabelecimento (14 dígitos, não a raiz). Aceita com ou sem pontuação. | formato: 00.000.000/0000-00 |
| `uf` | texto | não | UF da inscricao estadual (sigla, 2 letras). OPCIONAL. Quando informada, tem precedencia sobre a UF derivada do CNPJ — util para CNPJ com inscricao estadual em mais de um estado (ex.: substituto tributario). Omitida, a UF e' resolvida pelo proprio CNPJ. | `SP` |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> **Identificação:** razão social, CNPJ, inscrição estadual e a UF da inscrição.
>
> **Localização:** logradouro, número, complemento, bairro, CEP, município e estado.
>
> **Tributação:** regime de apuração de ICMS e atividade econômica principal (CNAE).
>
> **Contato:** telefone, quando disponível.
>
> Os dados refletem a situação no momento da consulta. Quando a empresa possui mais de uma inscrição estadual, retornamos a do estabelecimento consultado.
>
> **Situação cadastral:** situação da inscrição estadual junto à SEFAZ (`situacao`) — normalizada para ATIVO, SUSPENSO, BAIXADO, INAPTO, INABILITADO ou NAO INFORMADO — e a data a que ela se refere (`situacao_data`), quando a fonte informa.

### Exemplo de resposta

```json
{
  "ie": "string",
  "uf": "string",
  "cep": "string",
  "cnpj": "string",
  "ufie": "string",
  "bairro": "string",
  "numero": "string",
  "situacao": "string",
  "telefone": "string",
  "municipio": "string",
  "logradouro": "string",
  "complemento": "string",
  "situacao_data": "string",
  "regimeApuracao": "string",
  "nomeEmpresarial": "string",
  "atividadeEconomicaPrincipal": "string"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "ie": {
      "type": [
        "string",
        "null"
      ],
      "description": "Inscrição estadual da entidade."
    },
    "uf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unidade federativa do registro."
    },
    "cep": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código de endereçamento postal."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cadastro de pessoa física."
    },
    "cnpj": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cadastro nacional da pessoa jurídica."
    },
    "ufie": {
      "type": [
        "string",
        "null"
      ],
      "description": "Unidade federativa da inscrição estadual."
    },
    "bairro": {
      "type": [
        "string",
        "null"
      ],
      "description": "Bairro do endereço."
    },
    "numero": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número do endereço."
    },
    "situacao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral da inscrição estadual junto à SEFAZ, normalizada para um conjunto canônico: ATIVO, SUSPENSO, BAIXADO, INAPTO, INABILITADO ou NAO INFORMADO. Valores fora desse conjunto são repassados como vieram da fonte. Nulo quando a fonte consultada não informa a situação."
    },
    "telefone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número de telefone."
    },
    "municipio": {
      "type": [
        "string",
        "null"
      ],
      "description": "Município do endereço."
    },
    "logradouro": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da via ou endereço."
    },
    "complemento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Complemento do endereço."
    },
    "situacao_data": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data (DD/MM/AAAA) a que se refere a situação cadastral, quando informada pela fonte. Nulo quando não disponível."
    },
    "regimeApuracao": {
      "type": [
        "string",
        "null"
      ],
      "description": "Regime de apuração do imposto."
    },
    "nomeEmpresarial": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social da entidade."
    },
    "atividadeEconomicaPrincipal": {
      "type": [
        "string",
        "null"
      ],
      "description": "Código da atividade econômica principal."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Quando usar

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - Onboarding e qualificação de fornecedores e parceiros comerciais
> - Análise de risco e capacidade de crédito em operações B2B
> - Validação de destinatários em transações interestaduais
> - Monitoramento contínuo de conformidade regulatória
> - Auditorias internas e requisitos de compliance

---

Página em HTML: https://fontedata.com/docs/fiscal/sintegra-estadual
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp