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 da Receita Federal.
https://www.sintegraws.com.br/api/v1/execute-api.php?token=TOKEN_DE_ACESSO&cnpj=CNPJ_DESEJADO&plugin=RF
token
string
OBRIGATÓRIO
O seu token é gerado após o cadastro no portal: Obtenha seu token clicando aqui.
cnpj
string
OBRIGATÓRIO
CNPJ que deseja obter as informações da Receita Federal.
plugin
string
OBRIGATÓRIO
Site no qual deseja as informações, no caso da Receita Federal informar "RF".
Uma resposta típica é composta por um JSON.
Atenção: utilize o CNPJ 06990590000123 como modo SandBox (teste) para que não seja efetuada cobrança nos créditos contratados.
Campo | Tipo | Descrição |
---|---|---|
code | string | Código de retorno utilizado para informar o status da requisição. Ver códigos de retorno. |
status | string | Indica a situação da requisição. Valores possíveis:
|
message | string | Mensagem explicativa indicando o campo status. |
cnpj | string | CNPJ no formato 00.000.000/0000-00. |
tipo | string |
Tipo do CNPJ cadastrado na Valores possíveis:
|
porte | string | Porte do CNPJ na Receita federal. Valores possíveis:
|
situacao | string | Situação Cadastral do CNPJ na Receita federal: Valores possíveis:
|
abertura | string | Data de abertura no formato dd/mm/aaaa. |
nome | string | Razão social. |
fantasia | string | Nome fantasia. |
atividade_principal | Array<objeto> | Atividade principal. Um array com um elemento. |
atividade_principal.code | string | Código CNAE da atividade no formato 0000000. |
atividade_principal.text | string | Descrição da atividade. |
atividades_secundarias | Array<objeto> | Atividades secundárias. |
atividades_secundarias.code | string | Código CNAE da atividade no formato 00.00-0-00. |
atividades_secundarias.text | string | Descrição da atividade. |
natureza_juridica | string | Natureza jurídica. |
logradouro | string | Logradouro. |
numero | string | Número. |
complemento | string | Complemento. |
cep | string | CEP no formato 00.000-000. |
bairro | string | Bairro. |
municipio | string | Município. |
uf | string | Sigla da Unidade da Federação. |
string | Email. | |
telefone | string | Telefone. |
efr | string | Entedade Federativo Responsável, disponibilizado apenas para CNPJs da administração pública. |
data_situacao | string | Data da situação no formato dd/mm/aaaa. |
motivo_situacao | string | Motivo da situação. |
situacao_especial | string | Situação especial. |
data_situacao_especial | string | Data da situação especial no formato dd/mm/aaaa. |
capital_social | string | Valor do capital social no formato 0.00. |
qsa | Array<objeto> | Quadro de Sócios e Administradores. |
qsa.nome | string | Nome do sócio. |
qsa.qual | string | Qualificação do sócio. |
qsa.pais_origem | string | País de origem do sócio. Disponível apenas para sócios estrangeiros. |
qsa.nome_rep_legal | string | Nome do representante legal. Disponível apenas para sócios com representantes. |
qsa.qual_rep_legal | string | Qualificação do representante legal. Disponível apenas para sócios com representantes. |
extra | objeto | Campo reservado para uso futuro. |
ibge novo | objeto | IBGE. |
ibge.codigo_municipio | string | Código IBGE do municipio. |
ibge.codigo_uf | string | Código IBGE da UF. |
cnpjs_do_grupo novo | Array<objeto> | CNPJs do grupo da empresa pesquisada. |
cnpj | string | CNPJ no formato 00000000000000. |
uf | string | Sigla da Unidade da Federação. |
tipo | string |
Tipo do CNPJ cadastrado na Valores possíveis:
|
code | status | message |
---|---|---|
0 | OK | Pesquisa realizada com sucesso. |
1 | OK | CNPJ não tem cadastro na Receita federal. |
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 da Receita federal esta com instabilidade. |
8 | ERROR | Ocorreu um erro interno, por favor contatar o nosso suporte. |
var request = require("request");
var options = {
method: 'GET',
url: 'https://www.sintegraws.com.br/api/v1/execute-api.php',
qs: {
token: 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
cnpj: '06990590000123',
plugin: 'RF'
}
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
// Aqui recuperamos e realizamos o parse do JSON retornado
var resposeSWS = JSON.parse(body);
console.log(resposeSWS.status);
});
var data = null;
// Endpoint da API Receita Federal
const url = new URL('https://www.sintegraws.com.br/api/v1/execute-api.php');
// Parâmetros utilizados na chamada da API
const params = new URLSearchParams();
params.set('token', 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX');
params.set('cnpj', '06990590000123');
params.set('plugin', 'RF');
url.search = params.toString();
var xhr = new XMLHttpRequest();
xhr.addEventListener("readystatechange", function () {
if (this.readyState === this.DONE)
{
// Aqui recuperamos e realizamos o parse do JSON retornado
var resposeSWS = JSON.parse(this.responseText);
if(resposeSWS.code == "0")
{
// Mostra informações da ficha cadastral do CNPJ na Receita federal
document.getElementById("nome_empresarial").innerHTML = resposeSWS.nome_empresarial;
//preencher os outros campos
// ...
} else {
// Aqui exibimos uma mensagem caso tenha ocorrido algum erro
alert(response.message);
}
}
});
xhr.open("GET", url);
xhr.send(data);
// Parâmetros utilizados na chamada da API
var token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX";
var cnpj = "06990590000123";
var plugin = "RF";
$.ajax({
// Endpoint da API Receita Federal
url: "https://www.sintegraws.com.br/api/v1/execute-api.php?token="+token+"&cnpj="+cnpj+"&ano="+ano+"&plugin="+ plugin,
method:'GET',
complete: function(xhr){
// Aqui recuperamos o JSON retornado
response = xhr.responseJSON;
if(response.status == 'OK') {
// Mostra informações da ficha cadastral do CNPJ na Receita federal
$('#nome_empresarial').val(response.nome_empresarial);
//preencher os outros campos
// ...
// Aqui exibimos uma mensagem caso tenha ocorrido algum erro
} else {
alert(response.message);
}
}
});
<?
// Endpoint da API Receita Federal
$service_url = 'https://www.sintegraws.com.br/api/v1/execute-api.php';
// Parâmetros utilizados na chamada da API
$params = array(
'token' => 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
'cnpj' => '06990590000123',
'plugin' => 'RF'
);
$service_url = $service_url . '?' . http_build_query($params);
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $service_url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 90,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
));
// Faz a chamada da API
$response = curl_exec($curl);
// 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 da ficha cadastral do CNPJ na Receita federal
echo "Nome empresarial: " . $json->nome_empresarial;
// preencher os outros campos
// ...
?>
<?
$request = new HttpRequest();
// Endpoint da API Receita Federal
$request->setUrl('https://www.sintegraws.com.br/api/v1/execute-api.php');
$request->setMethod(HTTP_METH_GET);
// Parâmetros utilizados na chamada da API
$request->setQueryData(array(
'token' => 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
'cnpj' => '06990590000123',
'plugin' => 'RF'
));
// Faz a chamada da API
$response = $request->send();
// Aqui fazemos o parse do JSON retornado
$json = json_decode($response->getBody());
// Aqui exibimos uma mensagem caso tenha ocorrido algum erro
if ($json->code != '0')
{
die("Erro " . $json->code . ": " . $json->message);
}
// Mostra informações da ficha cadastral do CNPJ na Receita federal
echo "Nome empresarial: " . $json->nome_empresarial;
// preencher os outros campos
// ...
?>
<?
$client = new http\Client;
$request = new http\Client\Request;
// Endpoint da API Receita Federal
$request->setRequestUrl('https://www.sintegraws.com.br/api/v1/execute-api.php');
$request->setRequestMethod('GET');
// Parâmetros utilizados na chamada da API
$request->setQuery(new http\QueryString(array(
'token' => 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
'cnpj' => '06990590000123',
'plugin' => 'RF'
)));
// Faz a chamada da API
$client->enqueue($request)->send();
$response = $client->getResponse();
// Aqui fazemos o parse do JSON retornado
$json = json_decode($response->getBody());
// Aqui exibimos uma mensagem caso tenha ocorrido algum erro
if ($json->code != '0')
{
die("Erro " . $json->code . ": " . $json->message);
}
// Mostra informações da ficha cadastral do CNPJ na Receita federal
echo "Nome empresarial: " . $json->nome_empresarial;
// preencher os outros campos
// ...
?>
import requests
url = "https://www.sintegraws.com.br/api/v1/execute-api.php"
querystring = {"token":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","cnpj":"06990590000123","plugin":"RF"}
response = requests.request("GET", url, params=querystring)
print(response.text)
import http.client
token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
cnpj = "06990590000123";
plugin = "RF";
url = "/api/v1/execute-api.php?token=" + token + "&cnpj=" + cnpj + "&plugin=" + plugin;
conn = http.client.HTTPSConnection("www.sintegraws.com.br")
conn.request("GET", url)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
HttpResponse response = Unirest.get("https://www.sintegraws.com.br/api/v1/execute-api.php")
.queryString("token", "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")
.queryString("cnpj", "06990590000123")
.queryString("plugin", "RF")
.asString();
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", "RF");
}
public static void consultaCNPJSintegraWS(String token, String cnpj, String plugin)
{
ReceitaFederal receita_federal = new ReceitaFederal();
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<string> result = content.ReadAsStringAsync();
string jsonRetorno = jsonRetorno = result.Result;
receita_federal = Newtonsoft.Json.JsonConvert.DeserializeObject<ReceitaFederal>(jsonRetorno);
if (receita_federal.code.Equals("0"))
{
Console.WriteLine("Nome empresarial: " + receita_federal.nome);
}
else
{
Console.WriteLine("Erro: " + receita_federal.message);
}
}
}
}
}
public class ReceitaFederal
{
public String code { get; set; }
public string status { get; set; }
public String message { get; set; }
public List<AtividadePrincipal> atividade_principal { get; set; }
public string data_situacao { get; set; }
public string complemento { get; set; }
public string nome { get; set; }
public string uf { get; set; }
public string telefone { get; set; }
public string email { get; set; }
public List<AtividadesSecundaria> atividades_secundarias { get; set; }
public List<Qsa> qsa { get; set; }
public string situacao { get; set; }
public string bairro { get; set; }
public string logradouro { get; set; }
public string numero { get; set; }
public string cep { get; set; }
public string municipio { get; set; }
public string abertura { get; set; }
public string natureza_juridica { get; set; }
public string cnpj { get; set; }
public string ultima_atualizacao { get; set; }
public string tipo { get; set; }
public string fantasia { get; set; }
public string efr { get; set; }
public string motivo_situacao { get; set; }
public string situacao_especial { get; set; }
public string data_situacao_especial { get; set; }
public string capital_social { get; set; }
public string porte { get; set; }
public Ibge ibge { get; set; }
}
public class AtividadePrincipal
{
public string text { get; set; }
public string code { get; set; }
}
public class AtividadesSecundaria
{
public string text { get; set; }
public string code { get; set; }
}
public class Qsa
{
public string qual { get; set; }
public string qual_rep_legal { get; set; }
public string nome_rep_legal { get; set; }
public string pais_origem { get; set; }
public string nome { get; set; }
}
public class Ibge
{
public string codigo_municipio { get; set; }
public string codigo_uf { get; set; }
}
}
Por favor, nos explique com o máximo de detalhes o que o motivou a dar essa nota:
Se teve algum problema, o que aconteceu. Se tudo deu certo, o que mais lhe agradou.
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: