A API V3 JÁ ESTÁ DISPONÍVEL
A API v2 foi descontinuada e não receberá mais atualizações.
Acesse a documentação da API v3
As integrações API v2 que já estão configuradas, seguirão funcionando temporariamente. Realize a migração para a nova versão o mais breve possível. Consulte o calendário
|
Busca um RPS
Busca um RPS a partir de seu número
curl |
curl -X GET "https://www.bling.com.br/Api/v2/notaservico/{numero}/json/" -G -d "apikey={apikey}" -d "number={numero}"
|
PHP |
$apikey = "{apikey}"; $documentNumber = 12; $outputType = "json"; $url = 'https://www.bling.com.br/Api/v2/notaservico/' . $documentNumber . '/' . $outputType; $retorno = executeGetFiscalDocument($url, $apikey); echo $retorno; function executeGetFiscalDocument($url, $apikey){ $curl_handle = curl_init(); curl_setopt($curl_handle, CURLOPT_URL, $url . '&apikey=' . $apikey); curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, TRUE); $response = curl_exec($curl_handle); curl_close($curl_handle); return $response; }
|
C# |
public static void ExecuteGetFiscalDocument() { var request = HttpWebRequest.Create(@"https://www.bling.com.br/Api/v2/notaservico/{numero}/json&apikey={apikey}"); request.ContentType = "application/json"; request.Method = "GET"; using (HttpWebResponse response = request.GetResponse() as HttpWebResponse) { if (response.StatusCode != HttpStatusCode.OK) Console.Out.WriteLine("Error. Server returned status code: {0}", response.StatusCode); using (StreamReader reader = new StreamReader(response.GetResponseStream())) { var content = reader.ReadToEnd(); if(string.IsNullOrWhiteSpace(content)) Console.Out.WriteLine("Empty Response"); else Console.Out.WriteLine("Response Body: \r\n {0}", content); } } }
|
Parâmetro |
Descrição |
Tipo |
apikey |
Sua apikey |
string |
number |
Número do RPS |
integer |
Retorno
Em caso de sucesso, retornará o RPS solicitado, no mesmo modelo do exemplo a seguir. Caso contrário, retornará um erro.
A resposta será no formato especificado na URL (XML ou JSON).
Exemplo de retorno
{
"retorno": {
"notasservico": [
{
"notaservico": {
"serie": "1",
"numero": "000003",
"numeroNFSe": null,
"situacao": "Pendente",
"contato": "Organisys Software",
"dataEmissao": "2009-09-25",
"valorNota": "0.00",
"linkNFSe": "https://linkexemplo.com.br/nfse",
"codigoVerificacao": "53022JP7YUG3E"
}
}
]
}
}