API: Receita Federal CNPJ




Documentação da API Receita Federal


Recuperar dados de uma empresa no Receita Federal

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.


    URL para requisição

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

Parâmetros passados na API da Receita Federal


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".

Exemplo de resposta da API Receita Federal


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.





  •  200  OK
  • Time: 200 ms
  • Size: 2021 bytes
Campos de retorno da API Receita Federal
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:
  • OK
  • ERROR
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 Receita federal.
Valores possíveis:
  • MATRIZ
  • FILIAL
porte string Porte do CNPJ na Receita federal.
Valores possíveis:
  • ME (Micro empresa)
  • EPP (Empresa de pequeno porte)
  • DEMAIS
situacao string Situação Cadastral do CNPJ na Receita federal:
Valores possíveis:
  • NULA
  • ATIVA
  • SUSPENSA
  • INAPTA
  • BAIXADA
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.
email 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 Receita federal.
Valores possíveis:
  • MATRIZ
  • FILIAL
Retornos disponí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.
Exemplos de códigos
                
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; }
    }

}

                
              

0 / 5

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: