API: PGMEI




Atenção: Essa API está momentaneamente indisponível.

Documentação da API PGMEI


Recuperar dados de uma empresa no PGMEI

Método para recuperar as informações de impostos de uma empresa MI através do seu CNPJ. As informações são exatamente as mesmas retornadas pelo site do PGMEI.


    URL para requisição

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

Parâmetros passados na API do PGMEI


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 do DAS.


ano

string

OBRIGATÓRIO

Ano no qual deseja as informações.


plugin

string

OBRIGATÓRIO

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

Exemplo de resposta da API PGMEI


Uma resposta típica é composta por um JSON.






  •  200  OK
  • Time: 24 s
  • Size: 2321 bytes
Campos de retorno da API PGMEI
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.
guia_pagamento Array<objeto> Guia de pagamento.
guia_pagamento.periodo_apuracao string Periudo da Apuração. Ex: Janeiro, Fevereiro, Março...
guia_pagamento.ano string Ano.
guia_pagamento.apuracao string Apuração.
guia_pagamento.principal string Valor princial do documento.
guia_pagamento.impostos objeto Impostos gerados.
impostos.ICMS string Imposto ICMS.
impostos.ISS string Imposto ISS.
impostos.INSS string Imposto INSS.
guia_pagamento.multa string Multa, caso haja atraso no pagamento da DAS.
guia_pagamento.juros string Multa, caso haja atraso no pagamento da DAS.
guia_pagamento.total string Valor totala ser pago.
guia_pagamento.data_vencimento string Data do vencimento da DAS.
guia_pagamento.data_acolhimento string Data do acolhimento.
Retornos disponíveis
code status message
0 OK Pesquisa realizada com sucesso.
1 OK Contribuinte não optante pelo SIMEI.
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 PGMEI está com instabilidade.
8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.
9 ERROR Ano inválido.
10 ERROR É necessário apresentar a(s) DASN-Simei do(s) ano(s) anterior(es).
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: '03033345000130', ano: '2020', plugin: 'DAS' } }; 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 DAS 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', '22011051000151'); params.set('ano', '2020'); params.set('plugin', 'DAS'); 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 = "22011051000151"; var ano = "2020"; var plugin = "DAS"; $.ajax({ // Endpoint da API DAS 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') { // 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 DAS $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' => '22011051000151', 'ano' => '2020', 'plugin' => 'DAS' ); $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 DAS echo "Nome empresarial: " . $json->nome_empresarial; // preencher os outros campos // ... ?>
<? $request = new HttpRequest(); // Endpoint da API DAS $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' => '22011051000151', 'ano' => '2020', 'plugin' => 'DAS' )); // 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 DAS echo "Nome empresarial: " . $json->nome_empresarial; // preencher os outros campos // ... ?>
<? $client = new http\Client; $request = new http\Client\Request; // Endpoint da API DAS $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' => '22011051000151', 'ano' => '2020', 'plugin' => 'DAS' ))); // 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 DAS 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":"22011051000151","ano":"2020","plugin":"DAS"} response = requests.request("GET", url, params=querystring) print(response.text)
import http.client token = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" cnpj = "22011051000151"; ano = "2020"; plugin = "DAS"; url = "/api/v1/execute-api.php?token=" + token + "&cnpj=" + cnpj + "&ano=" + ano + "&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", "22011051000151") .queryString("ano", "2020") .queryString("plugin", "DAS") .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", "22011051000151", "2020", "DAS"); } public static void consultaCNPJSintegraWS(String token, String cnpj, String ano, String plugin) { PGMEI pgmei = new PGMEI(); using (HttpClient client = new HttpClient()) { String url = "https://www.sintegraws.com.br/api/v1/execute-api.php?token=" + token + "&cnpj=" + cnpj + "&ano=" + ano + "&plugin=" + plugin; var response = client.GetAsync(url).Result; using (HttpContent content = response.Content) { Task result = content.ReadAsStringAsync(); string jsonRetorno = jsonRetorno = result.Result; pgmei = Newtonsoft.Json.JsonConvert.DeserializeObject(jsonRetorno); if (pgmei.code.Equals("0")) { Console.WriteLine("Nome empresarial: " + pgmei.nome_empresarial); } else { Console.WriteLine("Erro: " + pgmei.message); } } } } } public class PGMEI { public string code { get; set; } public string status { get; set; } public string message { get; set; } public string cnpj { get; set; } public string nome_empresarial { get; set; } public List<GuiaPagamento> guia_pagamento { get; set; } } public class Impostos { public string ICMS { get; set; } public string ISS { get; set; } public string INSS { get; set; } } public class GuiaPagamento { public string periudo_apuracao { get; set; } public string ano { get; set; } public string apuracao { get; set; } public string principal { get; set; } public Impostos impostos { get; set; } public string multa { get; set; } public string juros { get; set; } public string total { get; set; } public string data_vencimento { get; set; } public string data_acolhimento { get; set; } } }

0 / 5

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: