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).
Suframa - CNPJ
A Superintendência da Zona Franca de Manaus (Suframa) é uma Autarquia vinculada ao Ministério do Desenvolvimento, Indústria e Comércio Exterior que administra a Zona Franca de Manaus - ZFM, com a responsabilidade de construir um modelo de desenvolvimento regional que utilize de forma sustentável os recursos naturais, assegurando viabilidade econômica e melhoria da qualidade de vida das populações locais. A consulta confirma os dados e a situação cadastral da pessoa jurídica junto ao Suframa.
Casos de Uso
- Integração com Suframa - CNPJ
- Onboarding e qualificação KYB de empresas e fornecedores
- Análise de crédito B2B e prevenção à inadimplência
- Due diligence e monitoramento de parceiros
Aplicações
- Prevenção de Autuações Fiscais
- Compliance/ESG
Benefícios
- Documentação de Suframa - CNPJ acessível e atualizada
- Diminui risco com checagens confiáveis
- Acelera cadastro com automação
- Facilita auditorias e conformidade
URL Base
A API está hospedada no seguinte endereço:
https://apiv3.directd.com.br/api/SuframaCNPJEndpoint
GET https://apiv3.directd.com.br/api/SuframaCNPJ?Cnpj={0}&Token=Seu_TokenDescrição: Endpoint para realizar consultas Suframa - CNPJ.
Nota: Esta consulta não gera comprovantes.
Campos Retornados
- Atividade Econômica Estadual: Atividade econômica estadual da entidade
- Atividade Econômica Principal: Informa o CNAE e a descrição da atividade econômica principal da empresa
- Bairro: Bairro do endereço
- CEP: Número CEP do endereço
- CNPJ: CNPJ da empresa
- Complemento: Complemento do endereço do registro em questão
- Data da Consulta: Data da consulta
- Data da Consulta Suframa: Data da consulta da inscrição no Suframa
- Data de Validade Cadastral: Data de validade cadastral da inscrição
- E-mail: Endereço de e-mail da entidade
- Inscrição do Suframa: Inscrição da entidade no Suframa
- Lista de Atividades Econômicas Secundárias: Lista as atividades econômicas secundárias da entidade
- Lista de Inscrições: Lista os detalhes das inscrições
- Logradouro: Nome da rua, avenida, travessa, alameda ou outros onde está localizado o endereço.
- Município: Município/cidade referente ao registro
- Quantidade de Inscrições: Quantidade de iscrições disponíveis no Suframa
- Razão Social: Razão social da empresa
- Situação Cadastral Atual: Situação cadastral atual da inscrição no Suframa
- Telefone: Número de telefone do indivíduo ou entidade
- UF: Unidade Federativa (estado) referente ao registro
Parâmetros
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
CNPJ | string | Sim | O parâmetro CNPJ pode ser enviado com ou sem formatação. |
TOKEN | string | Sim | O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br |
Exemplo de Resposta
{
"metaDados": {
"consultaNome": "string",
"consultaUid": "string",
"chave": "string",
"usuario": "string",
"mensagem": "string",
"ip": "string",
"resultadoId": 0,
"resultado": "string",
"apiVersao": "v3",
"enviarCallback": false,
"gerarComprovante": false,
"urlComprovante": "string",
"assincrono": true,
"data": "dd/MM/yyyy HH:mm:ss",
"tempoExecucaoMs": 0
},
"retorno": {
"quantidadeInscricoes": 0,
"inscricoes": [
{
"atividadeEconomicaEstadual": "string",
"atividadeEconomicaPrincipal": "string",
"atividadesEconomicasSecundarias": [
"string"
],
"bairro": "string",
"cep": "string",
"cnpj": "string",
"complemento": "string",
"dataConsulta": "string",
"dataConsultaSuframa": "string",
"dataValidadeCadastral": "string",
"email": "string",
"inscricaoSuframa": 0,
"logradouro": "string",
"municipio": "string",
"razaoSocial": "string",
"situacaoCadastralAtual": "string",
"telefone": "string",
"uf": "string"
}
]
}
}Erros Comuns
| Código | Descrição |
|---|---|
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. |
Notas Importantes
- Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
- Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228