API Suframa

Documentação da API Suframa

Recuperar dados de uma empresa no Suframa

Método para recuperar as informações de uma empresa brasileira através do seu CNPJ. As informações são exatamente as mesmas retornadas pelo site do Suframa.

GET

URL para requisição 

https://www.sintegraws.com.br/api/v1/execute-api.php?token={token}&cnpj={cnpj}&plugin={SF}

Parâmetros de requisição da API do Suframa

token
string

obrigatório
O seu token é gerado após o cadastro no portal.
Ver meu token

cnpj
string

obrigatório
CNPJ que deseja obter as informações do Suframa. Utilize o formato 00000000000000.

plugin
string

obrigatório
Site no qual deseja as informações, no caso da API Suframa informar "SF".

Exemplo de resposta da API Suframa
Uma resposta típica é composta por um JSON.

  • Status: 200 OK
  • Time: 200 ms
  • Size: 2021 bytes 
{"code":"0","status":"OK","message":"Pesquisa realizada com sucesso.","cnpj":"84496066000104","nome_empresarial":"Pst eletronica ltda","inscricao_suframa":"200149172","endereco_eletronico":"jcbackes@stoneridge.com","telefone":"(92) 3614-1425","situacao_cadastral":"ATIVA","data_validade_cadastral":"","natureza_juridica":{"codigo":"2062","descricao":"Sociedade Empres\u00e1ria Limitada"},"endereco":{"logradouro":"Avenida aca\u00ed","numero":"2.045","complemento":"Lote 2.2","bairro":"Distrito industrial i","cep":"69075-020","municipio":"Manaus","uf":"AM"},"atividade_principal":{"codigo":"2945000","descricao":"Fabrica\u00e7\u00e3o de material el\u00e9trico e eletr\u00f4nico para ve\u00edculos automotores, exceto baterias","atividade_exercida":true},"atividade_secundaria":[{"codigo":"2640000","descricao":"Fabrica\u00e7\u00e3o de aparelhos de recep\u00e7\u00e3o, reprodu\u00e7\u00e3o, grava\u00e7\u00e3o e amplifica\u00e7\u00e3o de \u00e1udio e v\u00eddeo","atividade_exercida":true},{"codigo":"3319800","descricao":"Manuten\u00e7\u00e3o e repara\u00e7\u00e3o de equipamentos e produtos n\u00e3o especificados anteriormente","atividade_exercida":true},{"codigo":"4520007","descricao":"Servi\u00e7os de instala\u00e7\u00e3o, manuten\u00e7\u00e3o e repara\u00e7\u00e3o de acess\u00f3rios para ve\u00edculos automotores","atividade_exercida":true},{"codigo":"4530701","descricao":"Com\u00e9rcio por atacado de pe\u00e7as e acess\u00f3rios novos para ve\u00edculos automotores","atividade_exercida":true},{"codigo":"4530703","descricao":"Com\u00e9rcio a varejo de pe\u00e7as e acess\u00f3rios novos para ve\u00edculos automotores","atividade_exercida":true},{"codigo":"6190699","descricao":"Outras atividades de telecomunica\u00e7\u00f5es n\u00e3o especificadas anteriormente","atividade_exercida":true},{"codigo":"6202300","descricao":"Desenvolvimento e licenciamento de programas de computador customiz\u00e1veis","atividade_exercida":true},{"codigo":"6311900","descricao":"Tratamento de dados, provedores de servi\u00e7os de aplica\u00e7\u00e3o e servi\u00e7os de hospedagem na internet","atividade_exercida":true},{"codigo":"6399200","descricao":"Outras atividades de presta\u00e7\u00e3o de servi\u00e7os de informa\u00e7\u00e3o n\u00e3o especificadas anteriormente","atividade_exercida":true},{"codigo":"6462000","descricao":"Holdings de institui\u00e7\u00f5es n\u00e3o","atividade_exercida":true},{"codigo":"7112000","descricao":"Servi\u00e7os de engenharia","atividade_exercida":true},{"codigo":"7490104","descricao":"Atividades de intermedia\u00e7\u00e3o e agenciamento de servi\u00e7os e neg\u00f3cios em geral, exceto imobili\u00e1rios","atividade_exercida":true},{"codigo":"7733100","descricao":"Aluguel de m\u00e1quinas e equipamentos para escrit\u00f3rio","atividade_exercida":true},{"codigo":"8020001","descricao":"Atividades de monitoramento de sistemas de seguran\u00e7a eletr\u00f4nico","atividade_exercida":true},{"codigo":"2610800","descricao":"Fabrica\u00e7\u00e3o de componentes eletr\u00f4nicos","atividade_exercida":true}],"incentivos":[{"tributo":"IPI","beneficio":"Isen\u00e7\u00e3o","finalidade":"Consumo Interno, Industrializa\u00e7\u00e3o e Utiliza\u00e7\u00e3o","base_legal":"Decreto 7.212 de 2010 (Art. 81)"},{"tributo":"ICMS","beneficio":"Isen\u00e7\u00e3o","finalidade":"Industrializa\u00e7\u00e3o e Comercializa\u00e7\u00e3o","base_legal":"Conv\u00eanio ICMS n\u00b0 65 de 1988"}],"projeto":{"aprovado":true,"data_aprovacao":"30\/12\/1994"},"html":"...<\/html>","version":"1"}

Campos de retorno da API Suframa

code string
Código de retorno utilizado para informar o status da requisição.
status string
Indica a situação da requisição.
Valores possíveis:
  • OK
  • ERROR
message string
Mensagem explicativa indicando o campo status.
cnpj string
CNPJ no formato 00000000000000.
nome_empresarial string Novidade
Nome empresarial ou razão social retornada pelo Suframa.
inscricao_suframa string
Inscrição Suframa.
endereco_eletronico string
E-mail do CNPJ.
telefone string
Telefone de contato do CNPJ.
situacao_cadastral string
Situação cadastral da Inscrição Suframa.
data_validade_cadastral string
Data de validade cadastral.
natureza_juridica objeto
Natureza jurídica.

natureza_juridica.codigo string
Código da natureza jurídica.
natureza_juridica.descricao string
Descrição da natureza jurídica.
endereco objeto
Endereço.

endereco.logradouro string
Logradouro.
endereco.numero string
Número.
endereco.complemento string
Complemento.
endereco.bairro string
Bairro.
endereco.cep string
CEP no formato 00000-000.
endereco.municipio string
Município.
endereco.uf string
Sigla da Unidade da Federação.
atividade_principal objeto
Atividade principal.

atividade_principal.codigo string
Código CNAE da atividade.
atividade_principal.descricao string
Descrição da atividade.
atividade_principal.atividade_exercida boolean
Indica se a atividade é exercida.
Valores possíveis:
  • true
  • false
atividade_secundaria Array [objeto] Novidade
Atividades secundárias retornadas pela Suframa.

atividade_secundaria.codigo string
Código CNAE da atividade.
atividade_secundaria.descricao string
Descrição da atividade.
atividade_secundaria.atividade_exercida boolean
Indica se a atividade é exercida.
Valores possíveis:
  • true
  • false
incentivos Array [objeto]
Incentivos tributários.

incentivos.tributo string
Tributo relacionado ao incentivo.
Valores possíveis:
  • IPI
  • ICMS
incentivos.beneficio string
Benefício do incentivo.
incentivos.finalidade string
Finalidade do incentivo.
incentivos.base_legal string
Base legal para o incentivo.
projeto objeto Novidade
Informações do projeto aprovado na Suframa.

projeto.aprovado boolean
Indica se há projeto aprovado.
Valores possíveis:
  • true
  • false
projeto.data_aprovacao string
Data de aprovação do projeto, no formato dd/mm/aaaa.
html string Novidade
HTML do comprovante de inscrição e situação cadastral retornado pela Suframa.
version string Novidade
Versão do retorno da API.
Retornos disponíveis
Status Request code status message
200 OK 0 OK Pesquisa realizada com sucesso.
200 OK 1 OK CNPJ não tem cadastro no site do Suframa.
200 OK 2 ERROR CNPJ inválido.
401 Unauthorized 3 ERROR Token inválido.
200 OK 4 ERROR Usuário não contratou nenhum pacote de créditos.
200 OK 5 ERROR Os créditos contratados acabaram.
200 OK 6 ERROR Plugin não existe.
200 OK 7 ERROR Site do Suframa está com instabilidade.
200 OK 8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.