×
Entrar
Experimente grátis
Top

GET /notasservico

  • Atualizado
Seguir

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 link-externo.png

Info- icon-P.png 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 link-externo.png

 

Busca todos os RPSs

Recupera todas os RPSs cadastrados no sistema.

curl      
 curl -X GET "https://www.bling.com.br/Api/v2/notasservico/json/"
     -G
     -d "apikey={apikey}"
PHP 
$apikey = "{apikey}";
$outputType = "json";
$url = 'https://www.bling.com.br/Api/v2/notasservico/' . $outputType;
$retorno = executeGetFiscalDocuments($url, $apikey);
echo $retorno;
function executeGetFiscalDocuments($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 ExecuteGetFiscalDocuments() {
    var request = HttpWebRequest.Create(@"https://www.bling.com.br/Api/v2/notasservico/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_api_key string

 

Situações da nota

Código Mensagem
0 Todas
1 Pendente
2 Emitida
3 Cancelada

 

Filtros

Pode-se utilizar filtros para restringir o retorno de dados. Observe a tabela de possíveis filtros abaixo.

Filtro Descrição Tipo Predicate
dataEmissao Filtra por data de emissão do RPS no intervalo especificado não incluindo os cancelados date (dd/mm/YYYY) TO
situacao Filtra pela situação do RPS integer (segundo tabela de situações acima)

 

 

curl -X GET "https://www.bling.com.br/Api/v2/notasservico/json/"
 -G
 -d "filters=dataEmissao[12/12/2013 TO 05/02/2014]; situacao[2]"
 -d "apikey={apikey}"

 

Retorno

Em caso de sucesso, retornará todas os RPSs registrados, no mesmo modelo do exemplo a seguir. Caso contrário, retornará um erro.

A resposta será no formato especificado na URL (XML ou JSON).

{
      "retorno": {
         "notasservico": [
             {
                 "notasservico": {
                     "serie": "1",
                     "numero": "000003",
                     "numeroNFSe": null,
                     "situacao": "Rejeitada",
                     "contato": "Organisys Software",
                     "dataEmissao": "2009-09-25",
                     "valorNota": "0.00",
                     "linkNFSe": "https://linkexemplo.com.br/nfse",
                     "codigoVerificacao": "53022JP7YUG3E"
            }
         }
      ]
   }
}

 

Artigos relacionados