NovoCentral de APIs
Cadastral

Suframa

Situação cadastral da empresa na Suframa: habilitação e regularidade na Zona Franca de Manaus.

Fonte
Suframa · Zona Franca de Manaus
Entrada
CNPJ
Comprovante PDF
R$ 0,54 por chamada
Preço
R$ 0,36 por chamada
GEThttps://api.agrolitics.com.br/api/Marketplace/Consulta/suframa?cnpj=00000000000

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

Operações com a Zona Franca de ManausCadastro de clientesConferência de benefício fiscal

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âmetroDescriçãoRegra
cnpjCNPJCNPJ da empresa, somente dígitos ou formatado.Obrigatório

O que você recebe

10 campos no retorno, como o seu sistema recebe.

  • quantidadeInscricoes

    Inscrições na Suframa

    Quantidade de inscrições do CNPJ na Suframa.

  • inscricoes

    Cadastro na Suframa

    Cada inscrição, com situação, validade, atividades e endereço.

  • inscricoes[].inscricaoSuframa

    Inscrição Suframa

    Número da inscrição na Suframa.

  • inscricoes[].razaoSocial

    Razão social

    Nome empresarial registrado.

  • inscricoes[].situacaoCadastralAtual

    Situação cadastral

    Situação do cadastro no órgão (ex.: Regular, Ativa, Suspensa, Baixada).

  • inscricoes[].dataValidadeCadastral

    Data de validade

    Data até quando o documento ou cadastro vale.

  • inscricoes[].atividadeEconomicaPrincipal

    Atividade econômica principal

    CNAE principal, com código e descrição.

  • inscricoes[].atividadesEconomicasSecundarias

    Atividades secundárias

    Lista de CNAEs secundários, com código e descrição.

  • inscricoes[].municipio

    Município

    Nome do município.

  • inscricoes[].uf

    UF

    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"
Resposta · envelope padrão
200 OK
{  "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 */ }}
Referência completa no Swagger

Perguntas frequentes sobre Suframa

A consulta conclui como "Não encontrado" e o retorno vem nulo. Acontece quando o CNPJ não tem inscrição na Suframa. É uma resposta válida da fonte e é cobrada normalmente.

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.

Sem compromisso. Seus dados são usados só para este contato, conforme a Política de Privacidade.