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.

    URL para requisição

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

Parâmetros passados na API do Suframa


token

string

OBRIGATÓRIO

Após seu cadastro seu token está localizado em: Nossas APIs > Meu Token.


cnpj

string

OBRIGATÓRIO

CNPJ que deseja obter as informações do Suframa.


plugin

string

OBRIGATÓRIO

Site no qual deseja as informações, no caso do Suframa informar "SF".

Exemplo de resposta da API Suframa


Uma resposta típica é composta por um JSON.

Atenção: utilize o CNPJ 84496066000104 como modo SandBox (teste) para que não seja efetuada cobrança nos créditos contratados.





Campos de retorno da API SINTEGRA
Campo Tipo Descrição
status string Indica a situação da requisição. Valores possíveis: OK, ERROR.
code string Código de retorno utilizado para informar o status da requisição.
message string Mensagem explicativa indicando o campo status.
cnpj string CNPJ no formato 00000000000000.
nome_empresarial string Razão social.
inscricao_suframa string Inscrição Estadual.
data_validade_cadastral string Data da situação cadastral no formato dd-MM-yyyy.
situacao_cadastral string Situação Cadastral da Inscrição Suframa.
uf string Sigla da Unidade da Federação.
cep string CEP no formato 00000000.
municipio string Município.
bairro string Bairro.
logradouro string Logradouro.
complemento string Complemento.
numero string Número.
endereco_eletronico string e-mail do CNPJ.
telefone string Telefone de contato do CNPJ.
tipo_incentivo string Tipo de Incentivo do CNPJ.
observacao string Observacao do CNPJ.
Retornos disponíveis
code status message
0 OK Pesquisa realizada com sucesso.
1 OK CNPJ não tem cadastro no site do Suframa.
2 ERROR CNPJ inválido.
3 ERROR Token inválido.
4 ERROR Usuário não contratou nenhum pacote de créditos.
5 ERROR Os créditos contratados acabaram.
6 ERROR Plugin não existe.
7 ERROR Site do suframa esta com instabilidade.
8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.
Exemplos
var token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"; var cnpj = "84496066000104"; var plugin = "SF"; $.ajax({ url: "https://sintegraws.com.br/api/v1/execute-api.php?token="+token+"&cnpj="+cnpj+"&plugin="+ plugin, method:'GET', complete: function(xhr){ // Aqui recuperamos o JSON retornado response = xhr.responseJSON; if(response.status == 'OK') { // Agora preenchemos os campos com os valores retornados $('#nome_empresarial').val(response.nome_empresarial); //preencher os outros campos // ... // Aqui exibimos uma mensagem caso tenha ocorrido algum erro } else { alert(response.message); } } });
<? // Informações para a chamada da API $token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"; $cnpj = "06990590000123"; $plugin = "SF"; //URL do serviço $service_url = "https://sintegraws.com.br/api/v1/execute-api.php?token=" . $token . "&cnpj=" . $cnpj . "&plugin=" . $plugin; //Faz a chamada da API $response = file_get_contents($service_url); //Aqui fazemos o parse do json retornado $json = json_decode($response); //Aqui exibimos uma mensagem caso tenha ocorrido algum erro if ($json->code != '0') { die("Erro " . $json->code . ": " . $json->message); } //Mostra informações do suframa echo "Nome empresarial: " . $json->nome; //preencher os outros campos // ... ?>
import requests token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" cnpj = "84496066000104"; plugin = "SF"; url = "https://sintegraws.com.br/api/v1/execute-api.php?token=" + token + "&cnpj=" + cnpj + "&plugin=" + plugin; response = requests.request("GET", url) print(response.text)
using System; using System.Collections.Generic; using System.Net.Http; using System.Threading.Tasks; namespace Consumo_Sintegra_WS_Exemplo { public class Program { static void Main(string[] args) { consultaCNPJSintegraWS("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "06990590000123", "SF"); } public static void consultaCNPJSintegraWS(String token, String cnpj, String plugin) { Suframa suframa = new Suframa(); using (HttpClient client = new HttpClient()) { String url = "https://www.sintegraws.com.br/api/v1/execute-api.php?token=" + token + "&cnpj=" + cnpj + "&plugin=" + plugin; var response = client.GetAsync(url).Result; using (HttpContent content = response.Content) { Task result = content.ReadAsStringAsync(); string jsonRetorno = jsonRetorno = result.Result; suframa = Newtonsoft.Json.JsonConvert.DeserializeObject(jsonRetorno); if (suframa.code.Equals("0")) { Console.WriteLine("Situação simples nacional: " + suframa.nome_empresarial); } else { Console.WriteLine("Erro: " + suframa.message); } } } } } public class Suframa { public String code { get; set; } public String status { get; set; } public String message { get; set; } public String nome_empresarial { get; set; } public String cnpj { get; set; } public String inscricao_suframa { get; set; } public String logradouro { get; set; } public String numero { get; set; } public String complemento { get; set; } public String bairro { get; set; } public String cep { get; set; } public String municipio { get; set; } public String uf { get; set; } public String endereco_eletronico { get; set; } public String telefone { get; set; } public String tipo_incentivo { get; set; } public String situacao_cadastral { get; set; } public String data_validade_cadastral { get; set; } public String observacao { get; set; } } }

O SintegraWS provê uma API para recuperação de dados de empresas brasileiras através de seu CNPJ. Existem quatro tipos de consulta, veja as documentações abaixo: