Suframa

A API da Suframa fornece uma forma ágil e precisa de consultar informações cadastrais de empresas registradas na Superintendência da Zona Franca de Manaus (SUFRAMA). Com ela, é possível validar o número de inscrição, confirmar a situação cadastral, identificar a data de habilitação e verificar a regularidade junto ao órgão.

A SUFRAMA é responsável por administrar os incentivos fiscais concedidos às empresas localizadas na Zona Franca de Manaus e em áreas de livre comércio da Amazônia. Por meio desta API, é possível automatizar processos de validação fiscal, auditorias e integrações que exigem comprovação de cadastro ativo no sistema da Suframa.

Informações de entrada

Para realizar uma consulta na API, são necessários apenas dois parâmetros:

CNPJ: O número do Cadastro Nacional da Pessoa Jurídica (CNPJ) da empresa que deseja consultar. Deve ser informado sem pontos, traços ou barras (exemplo: 12345678000195).

Cache: Define se os dados podem ser retornados a partir de um cache recente ou se uma nova consulta deve ser realizada diretamente nas fontes oficiais. O valor aceito vai de 0 a 45, sendo que qualquer número acima de 0 indica que o cache deve ser utilizado, se disponível, enquanto o valor 0 força uma nova consulta, ignorando completamente o cache. O cache é compartilhado entre os clientes, o que significa que uma consulta realizada por um cliente pode alimentar o cache utilizado por outros.

Parâmetros Obrigatórios

Name
cnpj
Type
string
Description
Documento fiscal da empresa - pode ser informado em qualquer padrão de formatação contanto que esteja completo.

GET/consultas/v2/suframa/{cnpj}

Suframa

Esse endpoint habilita você receber os dados do Suframa mais atualizados, consultados diretamente no site oficial do Suframa.

Atributos opcionais

Name
cache
Type
number
Description
Informa a API se ela pode consultar o cache ou não. Há um ganho significativo de performance, porém, a informação pode ter uma atraso. O valor default deste campo é 25.

Requisição

GET

/consultas/v2/suframa/{cnpj}

curl -G https://api.sintegrapi.com.br/consultas/v2/suframa/04301024000131 \
  -H "x-api-key: {apiKey}" \
  -H "cache: 25"

Resposta

   {
       "atualizado_em": "2025-11-02T21:39:23.431Z",
       "cnpj": "04301024000131",
       "inscricao": "200100408",
       "nome": "CALOI NORTE S/A",
       "desde": "2018-02-19",
       "matriz": true,
       "aprovado": true,
       "data_aprovacao": "2017-08-10",
       "status": {
           "codigo": 1,
           "descricao": "Ativa"
       },
       "natureza_juridica": {
           "codigo": 2054,
           "descricao": "Sociedade Anônima Fechada"
       },
       "endereco": {
           "codigo_municipio": 1302603,
           "logradouro": "Avenida Abiurana",
           "numero": "150",
           "bairro": "Distrito Industrial I",
           "cidade": "Manaus",
           "estado": "AM",
           "cep": "69075010",
           "pais": {
               "nome": "Brasil"
           }
       },
       "telefones": [
           {
               "ddd": "92",
               "numero": "36171104"
           }
       ],
       "emails": [
           {
               "endereco": "anogueira@caloi.com",
               "dominio": "caloi.com"
           }
       ],
       "atividade_principal": {
           "codigo": 3092000,
           "atividade_exercida": true,
           "descricao": "Fabricação de bicicletas e triciclos não-motorizados, peças e acessórios"
       },
       "atividades_secundarias": [],
       "incentivos": [
           {
               "fundamento_legal": "Decreto 7.212 de 2010 (Art. 81)",
               "beneficio": "Isenção",
               "finalidade": "Consumo Interno, Industrialização e Utilização",
               "tributo": "IPI"
           },
           {
               "fundamento_legal": "Convênio ICMS n° 65 de 1988",
               "beneficio": "Isenção",
               "finalidade": "Industrialização e Comercialização",
               "tributo": "ICMS"
           }
       ],
       "request_id": "d051632a-d86d-4beb-8bb9-45c476d93339",
       "success": true,
       "error": false
   }

Integração com CRMs e ERPs

Este endpoint retorna dados estruturados do cadastro SUFRAMA, incluindo incentivos fiscais, natureza jurídica, endereço e situação cadastral — informações essenciais para qualificação de fornecedores e clientes em regiões com incentivos da Zona Franca de Manaus.

A resposta pode ser mapeada diretamente em entidades de fornecedor ou cliente em sistemas como SAP S/4HANA (módulo MM e SD), Oracle Fusion Cloud, Salesforce, Microsoft Dynamics 365 e TOTVS Protheus. O campo incentivos é especialmente valioso para automação de regras fiscais em ERPs, permitindo identificar isenções de IPI e ICMS aplicáveis às operações com empresas da ZFM.

Para integrações via iPaaS, o schema abaixo pode ser importado em MuleSoft Anypoint, Dell Boomi, Workato e Azure Logic Apps para acelerar a criação de fluxos de validação fiscal.

Use o JSON Schema abaixo para:

Validar automaticamente as respostas antes de processar no ERP
Gerar classes e modelos de dados com ferramentas como Quicktype
Configurar mapeamentos de campos em conectores de integração e ETLs
Automatizar a qualificação fiscal de fornecedores da Zona Franca de Manaus

JSON Schema da Resposta

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Suframa — 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."
    },
    "atualizado_em": {
      "type": "string",
      "format": "date-time",
      "description": "Data e hora da última atualização do registro no formato ISO 8601."
    },
    "cnpj": {
      "type": "string",
      "description": "CNPJ consultado, sem formatação."
    },
    "inscricao": {
      "type": "string",
      "description": "Número de inscrição na SUFRAMA."
    },
    "nome": {
      "type": "string",
      "description": "Razão social da empresa."
    },
    "desde": {
      "type": "string",
      "format": "date",
      "description": "Data de início do cadastro na SUFRAMA no formato YYYY-MM-DD."
    },
    "matriz": {
      "type": "boolean",
      "description": "Indica se o estabelecimento é a matriz."
    },
    "aprovado": {
      "type": "boolean",
      "description": "Indica se o cadastro está aprovado na SUFRAMA."
    },
    "data_aprovacao": {
      "type": "string",
      "format": "date",
      "description": "Data de aprovação do cadastro no formato YYYY-MM-DD."
    },
    "status": {
      "type": "object",
      "description": "Situação cadastral atual na SUFRAMA.",
      "properties": {
        "codigo": { "type": "integer", "description": "Código numérico da situação." },
        "descricao": { "type": "string", "description": "Descrição da situação (ex: Ativa)." }
      },
      "required": ["codigo", "descricao"]
    },
    "natureza_juridica": {
      "type": "object",
      "description": "Natureza jurídica da empresa.",
      "properties": {
        "codigo": { "type": "integer", "description": "Código da natureza jurídica." },
        "descricao": { "type": "string", "description": "Descrição da natureza jurídica." }
      },
      "required": ["codigo", "descricao"]
    },
    "endereco": {
      "type": "object",
      "description": "Endereço registrado na SUFRAMA.",
      "properties": {
        "codigo_municipio": { "type": "integer", "description": "Código IBGE do município." },
        "logradouro": { "type": "string" },
        "numero": { "type": "string" },
        "bairro": { "type": "string" },
        "cidade": { "type": "string" },
        "estado": { "type": "string", "description": "Sigla do estado (UF)." },
        "cep": { "type": "string", "description": "CEP sem formatação." },
        "pais": {
          "type": "object",
          "properties": {
            "nome": { "type": "string" }
          }
        }
      }
    },
    "telefones": {
      "type": "array",
      "description": "Lista de telefones cadastrados.",
      "items": {
        "type": "object",
        "properties": {
          "ddd": { "type": "string", "description": "Código de área (DDD)." },
          "numero": { "type": "string", "description": "Número do telefone." }
        }
      }
    },
    "emails": {
      "type": "array",
      "description": "Lista de e-mails cadastrados.",
      "items": {
        "type": "object",
        "properties": {
          "endereco": { "type": "string", "description": "Endereço de e-mail completo." },
          "dominio": { "type": "string", "description": "Domínio do e-mail." }
        }
      }
    },
    "atividade_principal": {
      "type": "object",
      "description": "Atividade econômica principal da empresa.",
      "properties": {
        "codigo": { "type": "integer", "description": "Código CNAE." },
        "atividade_exercida": { "type": "boolean" },
        "descricao": { "type": "string", "description": "Descrição da atividade econômica." }
      }
    },
    "atividades_secundarias": {
      "type": "array",
      "description": "Lista de atividades econômicas secundárias.",
      "items": { "type": "object" }
    },
    "incentivos": {
      "type": "array",
      "description": "Lista de incentivos fiscais concedidos à empresa.",
      "items": {
        "type": "object",
        "properties": {
          "fundamento_legal": {
            "type": "string",
            "description": "Base legal do incentivo fiscal."
          },
          "beneficio": {
            "type": "string",
            "description": "Tipo de benefício fiscal (ex: Isenção, Redução)."
          },
          "finalidade": {
            "type": "string",
            "description": "Finalidade do incentivo (ex: Industrialização e Comercialização)."
          },
          "tributo": {
            "type": "string",
            "description": "Tributo ao qual o incentivo se aplica (ex: IPI, ICMS)."
          }
        },
        "required": ["fundamento_legal", "beneficio", "finalidade", "tributo"]
      }
    }
  },
  "required": ["request_id", "success", "error", "cnpj"]
}