Para que serve
Mostra se a empresa tem inscrição na Suframa e em que situação ela está: validade do cadastro, atividades e endereço de cada inscrição. Necessária para quem vende ou compra com os benefícios fiscais da Zona Franca de Manaus.
Ideal para
Por que usar
Benefício fiscal conferido
Confirme a inscrição e a validade antes de aplicar o benefício na nota.
Todas as inscrições
O retorno lista cada inscrição do CNPJ, com situação e atividades.
Prova para auditoria
Comprovante em PDF da consulta, com data e hora, guardado por 90 dias para anexar ao processo de crédito ou de compliance.
Parâmetros
| Parâmetro | Descrição | Regra |
|---|---|---|
cnpj | CNPJCNPJ da empresa, somente dígitos ou formatado. | Obrigatório |
O que você recebe
10 campos no retorno, como o seu sistema recebe.
quantidadeInscricoesInscrições na Suframa
Quantidade de inscrições do CNPJ na Suframa.
inscricoesCadastro na Suframa
Cada inscrição, com situação, validade, atividades e endereço.
inscricoes[].inscricaoSuframaInscrição Suframa
Número da inscrição na Suframa.
inscricoes[].razaoSocialRazão social
Nome empresarial registrado.
inscricoes[].situacaoCadastralAtualSituação cadastral
Situação do cadastro no órgão (ex.: Regular, Ativa, Suspensa, Baixada).
inscricoes[].dataValidadeCadastralData de validade
Data até quando o documento ou cadastro vale.
inscricoes[].atividadeEconomicaPrincipalAtividade econômica principal
CNAE principal, com código e descrição.
inscricoes[].atividadesEconomicasSecundariasAtividades secundárias
Lista de CNAEs secundários, com código e descrição.
inscricoes[].municipioMunicípio
Nome do município.
inscricoes[].ufUF
Sigla do estado.
Opções da chamada
assincrono=trueProcessa em segundo plano e devolve 202 com o consultaId.comprovante=trueGera também o comprovante da consulta em PDF (custo adicional).
Códigos de resposta
200Sucesso — Consulta concluída; o retorno traz os dados da fonte.202Em processamento — Recupere em GET /api/Marketplace/Consulta/Resultado/{consultaId}. Recuperar não é cobrado.422Requisição inválida — Parâmetros validados antes de qualquer cobrança.429Limite simultâneo — Até 5 consultas simultâneas por cliente.503Em manutenção — A consulta está temporariamente indisponível; nada é cobrado.
Como é cobrado
- Débito por chamada — do saldo pré-pago ou do contrato pós-pago
- Preço exibido na plataforma antes de executar
- Falhas estornadas automaticamente
- Mesmo preço na plataforma e na API
curl "https://api.agrolitics.com.br/api/Marketplace/Consulta/suframa?cnpj=00000000000" \ -H "X-Api-Key: $AGROLITICS_API_KEY"{ "metaDados": { "consultaId": "3f9c2a71-5b8e-4d1a-9c07-1e6b2f8a4d90", "apiIdentificador": "suframa", "apiNome": "Suframa", "fonte": "Suframa · Zona Franca de Manaus", "status": "Concluída", "resultado": "Sucesso", "tempoExecucaoMs": 1840, "assincrono": false, "urlComprovante": null }, "retorno": { /* dados da fonte — variam por consulta */ }}Perguntas frequentes sobre Suframa
Outras APIs para combinar
Ver catálogo completoReceita Federal - Pessoa Física
Situação do CPF na Receita Federal: regularidade, inscrição e indicador de óbito.
Receita Federal - Pessoa Jurídica
Ficha cadastral do CNPJ na Receita Federal: situação, CNAE, capital social e, opcionalmente, o quadro societário.
Vínculo Empregatício
Funcionários da empresa pelo CNPJ: quantidade e lista com CPF, nome, data de nascimento, cargo (CBO) e data de admissão.
Comece a integrar
Leve as fontes oficiais do agro para dentro do seu sistema
Crie sua conta e teste qualquer API na plataforma — ou fale com um especialista para desenhar a integração e o contrato ideais para o seu volume.
- APIs de fontes oficiais, com resposta padronizada
- Pague por chamada — sem mensalidade, falhas estornadas
- API do Dossiê BNIR com lotes de até 1.000 CARs
- Webhooks assinados e comprovante em PDF
- Conformidade LGPD — fontes oficiais, log auditável
Solicite uma Demonstração
Nossa equipe entrará em contato em breve.