Orientações e respostas da equipe da Direct Data

💡 Esta API verifica os dados cadastrais e a situação jurídica de uma empresa registrada na Suframa, auxiliando na validação e conformidade de operações ligadas à Zona Franca de Manaus (ZFM).

Introdução

A API Suframa - CNPJ permite consultar informações relacionadas ao cadastro de pessoas jurídicas na Superintendência da Zona Franca de Manaus (Suframa). Esta consulta é essencial para validação de operações comerciais, conformidade fiscal e ambiental, e auditorias de ESG.

---

URL Base

https://api.directd.com.br

---

Endpoint

GET /api/SuframaCNPJ

Descrição: Consulta informações cadastrais e econômicas de empresas registradas na Suframa.

---

Autenticação

• Um token válido é obrigatório e deve ser enviado como parâmetro na URL.
• Caso tenha dúvidas sobre como obter o token, entre em contato com suporte@directd.com.br.

---

Campos da API

Dados Básicos

• CNPJ: Cadastro Nacional de Pessoa Jurídica.
• Razão Social.
• Inscrição na Suframa.
• Data de Validade Cadastral.

Atividades Econômicas

• Atividade Econômica Principal.
• Lista de Atividades Econômicas Secundárias.
• Atividade Econômica Estadual.

Endereço

• Logradouro, Complemento, Bairro, Município, UF.
• CEP: Código Postal.

Contatos

• Telefone.
• E-mail.

Situação

• Situação Cadastral Atual.
• Data da Consulta na Suframa.

---

Parâmetros

---

Exemplos de Requisição

Usando cURL

curl 'https://api.directd.com.br/api/SuframaCNPJ?CNPJ=12345678000195&TOKEN=seu_token_aqui'

---

Respostas

Sucesso (200)

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "Suframa - CNPJ",
    "consultaUid": "directd-123456",
    "usuario": "Cliente",
    "mensagem": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 1500
  },
  "retorno": {
    "quantidadeInscricoes": 1,
    "inscricoes": [
      {
        "atividadeEconomicaEstadual": "Comércio Atacadista",
        "atividadeEconomicaPrincipal": "Fabricação de produtos plásticos",
        "atividadesEconomicasSecundarias": ["Transporte Rodoviário"],
        "bairro": "Distrito Industrial",
        "cep": "69075-000",
        "cnpj": "12.345.678/0001-95",
        "complemento": "Galpão 2",
        "dataConsulta": "2024-01-10T10:00:00",
        "dataConsultaSuframa": "2024-01-09T15:00:00",
        "dataValidadeCadastral": "2025-12-31",
        "email": "contato@empresaexemplo.com.br",
        "inscricaoSuframa": 123456,
        "logradouro": "Avenida Governador Jorge Teixeira",
        "municipio": "Manaus",
        "razaoSocial": "Empresa Exemplo LTDA",
        "situacaoCadastralAtual": "Ativa",
        "telefone": "(92) 1234-5678",
        "uf": "AM"
      }
    ]
  }
}

Erros Comuns

---

Notas Importantes

1. Autorização: Apenas empresas com registro ativo na Suframa serão retornadas.
2. Atualizações Periódicas: Certifique-se de que os dados foram atualizados recentemente na Suframa.
3. Limitações Regionais: Dados são focados em empresas da Zona Franca de Manaus.
4. Consulta Individual: Apenas um CNPJ por consulta.

---