# Suframa - Zona Franca de Manaus

> Valida inscrição e dados cadastrais de empresas na Suframa, retornando situação jurídica e atividades econômicas para conformidade na Zona Franca de Manaus.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint consulta informações cadastrais e a situação jurídica de empresas inscritas na Superintendência da Zona Franca de Manaus (Suframa). Permite validar dados cadastrais, verificar registros ativos e obter detalhes sobre inscrições no programa da ZFM.
>
> A consulta é útil para processos de qualificação de parceiros comerciais, análise de crédito, due diligence, conformidade regulatória e prevenção de inadimplência. Facilita automação de onboarding, reduz riscos operacionais e acelera processos de auditoria relacionados a operações na zona franca.

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/suframa-consulta",
    params={"cnpj": "SEU_CNPJ"},
    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/suframa-consulta");

url.search = new URLSearchParams({
  "cnpj": "SEU_CNPJ"
}).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 (somente números, 14 dígitos) | formato: 00.000.000/0000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta retorna um objeto contendo:
>
> **`quantidadeInscricoes`** (inteiro)  
> Total de registros encontrados para o CNPJ consultado.
>
> **`inscricoes`** (array)  
> Lista com os detalhes de cada inscrição. Cada registro inclui:
>
> - **Dados cadastrais**: razão social, CNPJ, e-mail, telefone
> - **Localização**: logradouro, complemento, bairro, município, UF, CEP
> - **Atividades**: atividade econômica principal (com CNAE e descrição), atividades econômicas secundárias, atividade econômica estadual
> - **Inscrição Suframa**: número de inscrição na Zona Franca de Manaus
> - **Datas**: data da consulta, data da consulta Suframa, data de validade cadastral
> - **Status**: situação cadastral atual da inscrição

### Exemplo de resposta

```json
{
  "inscricoes": [],
  "quantidadeInscricoes": 0
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "inscricoes": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "uf": {
            "type": [
              "string",
              "null"
            ],
            "description": "Unidade Federativa (estado)."
          },
          "cep": {
            "type": [
              "string",
              "null"
            ],
            "description": "CEP do endereço."
          },
          "cnpj": {
            "type": [
              "string",
              "null"
            ],
            "description": "CNPJ da empresa."
          },
          "email": {
            "type": [
              "string",
              "null"
            ],
            "description": "Endereço de e-mail da entidade."
          },
          "bairro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bairro do endereço."
          },
          "telefone": {
            "type": [
              "string",
              "null"
            ],
            "description": "Número de telefone da entidade."
          },
          "municipio": {
            "type": [
              "string",
              "null"
            ],
            "description": "Município do registro."
          },
          "logradouro": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nome da rua, avenida ou logradouro do endereço."
          },
          "complemento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Complemento do endereço."
          },
          "razaoSocial": {
            "type": [
              "string",
              "null"
            ],
            "description": "Razão social da empresa."
          },
          "dataConsulta": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data da consulta."
          },
          "inscricaoSuframa": {
            "type": [
              "number",
              "null"
            ],
            "description": "Número de inscrição da entidade."
          },
          "dataConsultaSuframa": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data da consulta da inscrição."
          },
          "dataValidadeCadastral": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data de validade cadastral."
          },
          "situacaoCadastralAtual": {
            "type": [
              "string",
              "null"
            ],
            "description": "Situação cadastral atual da inscrição."
          },
          "atividadeEconomicaEstadual": {
            "type": [
              "string",
              "null"
            ],
            "description": "Atividade econômica estadual da entidade."
          },
          "atividadeEconomicaPrincipal": {
            "type": [
              "string",
              "null"
            ],
            "description": "CNAE e descrição da atividade econômica principal."
          },
          "atividadesEconomicasSecundarias": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": [
                "string",
                "null"
              ]
            },
            "description": "Lista de atividades econômicas secundárias."
          }
        }
      },
      "description": "Lista de inscrições."
    },
    "quantidadeInscricoes": {
      "type": [
        "number",
        "null"
      ],
      "description": "Quantidade de inscrições disponíveis."
    }
  }
}
```

## 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. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint gera comprovantes em PDF conforme solicitado pelo cliente. Pode ser utilizado em fluxos de conformidade, análise de risco e validação de dados para operações na Zona Franca de Manaus.
>
> Não há limitações técnicas de requisições simultâneas; o serviço processa consultas de forma imediata. Para dúvidas operacionais, consulte a equipe de suporte interna do gateway.

---

Página em HTML: https://fontedata.com/docs/fiscal/suframa-consulta
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