API: Receita Federal CPF




Documentação da API Receita Federal CPF


Recuperar dados de uma empresa no Receita Federal CPF

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


    URL para requisição

https://www.sintegraws.com.br/api/v1/execute-api.php?token=TOKEN_DE_ACESSO&cpf=CPF_DESEJADO&data-nascimento=DATA_NASCIMENTO&plugin=CPF

Parâmetros passados na API do Receita Federal CPF


token

string

OBRIGATÓRIO

O seu token é gerado após o cadastro no portal: Obtenha seu token clicando aqui.


cpf

string

OBRIGATÓRIO

CPF que deseja obter as informações da Receita Federal. No formato 00000000000.


data-nascimento

string

OBRIGATÓRIO

Data de nascimento do CPF informado. No formato ddmmaaaa.


plugin

string

OBRIGATÓRIO

Site no qual deseja as informações, no caso da Receita Federal CPF informar "CPF".

Exemplo de resposta da API Receita Federal CPF


Uma resposta típica é composta por um JSON.






  •  200  OK
  • Time: 10 s
  • Size: 296 bytes
Campos de retorno da API Receita Federal CPF
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.
cpf string CPF no formato 00000000000.
nome string Nome.
data_nascimento string Data Nascimento. dd/mm/aaaa.
situacao_cadastral string Situação cadastral do CPF na Receita Federal:
Valores possíveis:
  • Regular
  • Suspensa
  • Cancelada
  • Titular falecido
  • Pendente
  • Nula
genero novo string Gênero da pessoa responsavél pelo CPF consultado na Receita Federal:
Valores possíveis:
  • M para Masculino.
  • F para Feminino.
data_inscricao string Data da inscrição. dd/mm/aaaa.
digito_verificador string Digito verificador.
comprovante string Comprovante
Retornos disponíveis
code status message
0 OK Pesquisa realizada com sucesso.
1 OK Nenhum CPF encontrado na Receita Federal.
2 ERROR CPF 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 CPF está com instabilidade.
8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.
9 OK Data de nascimento informada está divergente da base de dados da Receita Federal do Brasil.
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', cpf: '00000000000', data-nascimento: '01051986', plugin: 'CPF' } }; 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 CPF 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('cpf', '00000000000'); params.set('data-nascimento', '01051986'); params.set('plugin', 'CPF'); 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") { // Agora preenchemos os campos com os valores retornados 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 cpf = "00000000000"; var data_nascimento = "01051986"; var plugin = "CPF"; $.ajax({ // Endpoint da API CPF url: "https://www.sintegraws.com.br/api/v1/execute-api.php?token="+token+"&cpf="+cpf+"&data-nascimento="+data_nascimento+"&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); } } });
<? // Endpoint da API CPF $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', 'cpf' => '00000000000', 'data-nascimento' => '01051986', 'plugin' => 'CPF' ); $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 do CPF consultado echo "Nome: " . $json->nome; // preencher os outros campos // ... ?>
<? $request = new HttpRequest(); // Endpoint da API CPF $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', 'cpf' => '00000000000', 'data-nascimento' => '01051986', 'plugin' => 'CPF' )); // 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 do CPF consultado echo "Nome: " . $json->nome; // preencher os outros campos // ... ?>
<? $client = new http\Client; $request = new http\Client\Request; // Endpoint da API CPF $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', 'cpf' => '00000000000', 'data-nascimento' => '01051986', 'plugin' => 'CPF' ))); // 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 do CPF consultado echo "Nome: " . $json->nome; // preencher os outros campos // ... ?>
import requests url = "https://www.sintegraws.com.br/api/v1/execute-api.php" querystring = {"token":"XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","cpf":"00000000000","data-nascimento":"01051986","plugin":"CPF"} response = requests.request("GET", url, params=querystring) print(response.text)
import http.client token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" cpf = "00000000000"; data_nascimento = "01051986"; plugin = "CPF"; url = "/api/v1/execute-api.php?token=" + token + "&cpf=" + cpf + "&data-nascimento=" + data_nascimento + "&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("cpf", "00000000000") .queryString("data-nascimento", "01051986") .queryString("plugin", "CPF") .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", "00000000000", "ddmmaaaa", "CPF"); } public static void consultaCNPJSintegraWS(String token, String numero_cpf, String data_nascimento, String plugin) { CPF cpf = new CPF(); using (HttpClient client = new HttpClient()) { String url = "https://www.sintegraws.com.br/api/v1/execute-api.php?token=" + token + "&cpf=" + numero_cpf + "&data-nascimento=" + data_nascimento + "&plugin=" + plugin; var response = client.GetAsync(url).Result; using (HttpContent content = response.Content) { Task result = content.ReadAsStringAsync(); string jsonRetorno = jsonRetorno = result.Result; cpf = Newtonsoft.Json.JsonConvert.DeserializeObject(jsonRetorno); if (cpf.code.Equals("0")) { Console.WriteLine("nome: " + cpf.nome); } else { Console.WriteLine("Erro: " + cpf.message); } } } } } public class CPF { public String code { get; set; } public String status { get; set; } public String message { get; set; } public String cpf { get; set; } public String nome { get; set; } public String data_nascimento { get; set; } public String situacao_cadastral { get; set; } public String data_inscricao { get; set; } public String digito_verificador { get; set; } public String comprovante { 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: