API: SINTEGRA




Documentação da API SINTEGRA


Recuperar dados de uma empresa no SINTEGRA

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


    URL para requisição

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

Parâmetros passados na API do SINTEGRA


token

string

OBRIGATÓRIO

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


cnpj ou ie

string

OBRIGATÓRIO

CNPJ ou inscrição estadual que deseja obter as informações do SINTEGRA.


uf

string

*Obrigatório apenas se o parâmetro ie for escolhido.

UF da inscrição estadual deseja obter as informações do SINTEGRA.


plugin

string

OBRIGATÓRIO

Site no qual deseja as informações, no caso do SINTEGRA informar "ST".

Exemplo de resposta da API SINTEGRA


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: 100 ms
  • Size: 871 bytes
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.
nome_fantasia string Nome fantasia.
inscricao_estadual string Inscrição Estadual.
tipo_inscricao string Tipo de Inscrição Estadual.
data_situacao_cadastral string Data da situação cadastral no formato dd-MM-yyyy.
situacao_cnpj string Situação cadastral do CNPJ.
situacao_ie string Situação Cadastral da Inscrição Estadual (IE) no Sintegra:
Valores possíveis:
  • Ativo
  • Inativo
  • Baixado
situacao_ie_desc string Situação Cadastral da Inscrição Estadual (IE) no Sintegra sem tratamento.
data_inicio_atividade string Data do início da atividade no formato dd-MM-yyyy.
regime_tributacao string Regime de tributação.
informacao_ie_como_destinatario string Informação da Inscrição Estadual como destinatário.
porte_empresa string Porte da empresa.
cnae_principal objeto Atividade econômica principal.
cnae_principal.code string Código do CNAE principal
cnae_principal.text string Descrição da atividade econômica principal
data_fim_atividade string Data na qual a empresa foi cancelada no formato dd-MM-yyyy. Apenas para empresas com o status diferente de Ativo.
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.
ibge novo objeto IBGE.
ibge.codigo_municipio string Código IBGE do municipio.
ibge.codigo_uf string Código IBGE da UF.
outras_ies beta Array<objeto> Retorna lista de outras inscrições estaduais. que o CNPJ tem.
inscricao_estadual string Inscrição Estadual.
uf string Sigla da Unidade da Federação.
situacao_ie string Situação Cadastral da Inscrição Estadual (IE) no Sintegra:
Valores possíveis:
  • Ativo
  • Inativo
  • Baixado
contribuinte_icms beta Boolean Verifica se a Inscrição Estadual (IE) no Sintegra é contribuinte de ICMS:
Valores possíveis:
  • True
  • False
Retornos disponíveis
code status message
0 OK Pesquisa realizada com sucesso.
1 OK Nenhum estabelecimento encontrado no SINTEGRA. (significa que o CNPJ não tem cadastro no site oficial do Sintegra)
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 Sintegra 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: 'ST' } }; 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 Sintegra 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', 'ST'); 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 cnpj = "06990590000123"; var plugin = "ST"; $.ajax({ // Endpoint da API Sintegra url: "https://www.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); } } });
<? // Endpoint da API Sintegra $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' => 'ST' ); $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 consulta feita no Sintegra echo "Nome empresarial: " . $json->nome_empresarial; // preencher os outros campos // ... ?>
<? $request = new HttpRequest(); // Endpoint da API Sintegra $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' => 'ST' )); // 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 consulta feita no Sintegra echo "Nome empresarial: " . $json->nome_empresarial; // preencher os outros campos // ... ?>
<? $client = new http\Client; $request = new http\Client\Request; // Endpoint da API Sintegra $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' => 'ST' ))); // 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 consulta feita no Sintegra 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":"ST"} response = requests.request("GET", url, params=querystring) print(response.text)
import http.client token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" cnpj = "06990590000123"; plugin = "ST"; 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", "ST") .asString();
using System; 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", "ST"); } public static void consultaCNPJSintegraWS(String token, String cnpj, String plugin) { Sintegra sintegra = new Sintegra(); 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; sintegra = Newtonsoft.Json.JsonConvert.DeserializeObject(jsonRetorno); if (sintegra.code.Equals("0")) { Console.WriteLine("Nome empresarial: " + sintegra.nome_empresarial); } else { Console.WriteLine("Erro: " + sintegra.message); } } } } } public class Sintegra { public String status { get; set; } public String code { get; set; } public String message { get; set; } public String nome_empresarial { get; set; } public String cnpj { get; set; } public String inscricao_estadual { get; set; } public String tipo_inscricao { get; set; } public String data_situacao_cadastral { get; set; } public String situacao_cnpj { get; set; } public String situacao_ie { get; set; } public String nome_fantasia { get; set; } public String data_inicio_atividade { get; set; } public String regime_tributacao { get; set; } public String informacao_ie_como_destinatario { get; set; } public String porte_empresa { get; set; } public cnae_principal cnae_principal { get; set; } public String data_fim_atividade { get; set; } public String uf { get; set; } public String municipio { get; set; } public String logradouro { get; set; } public String complemento { get; set; } public String cep { get; set; } public String numero { get; set; } public String bairro { get; set; } public Ibge ibge { get; set; } } public class cnae_principal { public string code { get; set; } public string text { 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: