Suframa - Zona Franca de Manaus

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/suframa-consulta

R$ 0,51 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

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 -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/suframa-consulta?cnpj=SEU_CNPJ"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cnpj obrigatório	CNPJ	CNPJ (somente números, 14 dígitos)	00.000.000/0000-00

Resposta

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 — 200 OK

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

Schema da resposta (JSON Schema)

JSON Schema

{
  "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

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.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.