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.

Custos

Consulta	Créditos consumidos
Cadastro Suframa de um CNPJ, em cache ou online	1 crédito

O valor é o total por requisição concluída sem erro. Consultar online ou reutilizar um resultado em cache não altera o preço. Retornos com erro não consomem créditos.

Crédito é a unidade de consumo do plano. Consulte o valor dos planos e a tabela de Consumo por consulta.

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

A consulta SUFRAMA pode integrar o cadastro de parceiros comerciais e a revisão de operações com empresas da Zona Franca de Manaus. A resposta reúne inscrição, situação, endereço e incentivos informados pela fonte.

Consulta SUFRAMA no SAP, TOTVS Protheus e Oracle Fusion Cloud

Em uma integração com SAP S/4HANA, SAP Business One, TOTVS Protheus, Oracle Fusion Cloud ou Sankhya, vincule o resultado ao CNPJ do cliente ou fornecedor. Inscrição, status e incentivos podem ser encaminhados ao processo fiscal antes da aprovação do cadastro ou da operação.

Campo da resposta	Uso na integração
`cnpj` e `inscricao`	Identificar o parceiro e seu cadastro SUFRAMA.
`status.codigo` e `status.descricao`	Registrar a situação apresentada pela fonte.
`aprovado` e `data_aprovacao`	Apoiar a conferência do cadastro, quando informados.
`endereco` e `atividade_principal`	Complementar localização e atividade econômica.
`incentivos[]`	Encaminhar tributo, benefício, finalidade e fundamento legal para análise fiscal.

Qualificação comercial no Salesforce e Dynamics 365

No Salesforce, Microsoft Dynamics 365 ou HubSpot, associe a inscrição SUFRAMA à empresa e crie uma etapa de revisão para dados pendentes. Os incentivos retornados são informações para análise do processo; a integração deve aplicar as regras fiscais da operação antes de liberar benefícios.

A conexão exige implementação via HTTPS e adaptação aos campos e recursos do ERP ou CRM contratado. Preserve request_id, trate erros sem sobrescrever dados confirmados e use o JSON Schema da resposta para validar o retorno.

JSON Schema da Resposta

O schema usa JSON Schema Draft 2020-12. Os campos de negócio podem ser omitidos ou nulos quando não há informação disponível ou quando ocorre um erro. Valide também success e error antes de atualizar o cadastro. Propriedades adicionais são aceitas para permitir evolução compatível. O schema descreve o corpo JSON; o código HTTP deve ser tratado separadamente.

JSON Schema

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