×
Entrar
Experimente grátis
Top

GET /notafiscal/{numero}/{serie}

  • 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 uma nota fiscal

Busca uma nota fiscal a partir de seu numero e sua serie.

curl

 
curl -X GET "https://bling.com.br/Api/v2/notafiscal/{numero}/{serie}/json/"
     -G
     -d "apikey={apikey}"
     -d "number={numero}"
     -d "serie={serie}"

PHP    

 
$apikey = "{apikey}";
$documentNumber = 12;
$documentSerie = 1;
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/notafiscal/' . $documentNumber . '/'. $documentSerie . '/' . $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://bling.com.br/Api/v2/notafiscal/{numero}/{serie}/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
number número da nota fiscal integer
serie série da nota fiscal integer

 

Retorno

Em caso de sucesso, retornará a nota fiscal solicitada, 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":{
      "notasfiscais":[
         {
            "notafiscal":{
               "serie":"1",
               "numero":"000003",
               "numeroPedidoLoja":"100000002",
               "loja":0,
               "tipo":"S",
               "situacao":"Pendente",
               "contato":"Organisys Software",
               "cliente":{
                  "nome":"Organisys Software",
                  "cnpj":"00.000.000/0000-1",
                  "ie":"0000000000",
                  "rg":"162788484",
                  "endereco":"Rua Visconde de São Gabriel",
                  "numero":"000",
                  "complemento":"Sala 000",
                  "cidade":"Bento Gonçalves",
                  "bairro":"Cidade Alta",
                  "cep":"95.700-000",
                  "uf":"RS",
                  "email":"teste@organisys.com.br",
                  "fone":"(21) 96858-0182"
               },
               "cnpj":"99999999000199",
               "vendedor":"",
               "dataEmissao":"2009-09-25 00:00:00",
               "valorNota":0.00,
               "chaveAcesso":"43130893518124000144550010023289261494793111",
               "xml":"https://bling.com.br/relatorios/nfe.xml.php?s&chaveAcesso=43130893518124000144550010023289261494793111",
               "linkDanfe":"https:www.bling.com.br/doc.view.php?id=5dd9e49df1a9577476b65ef0c6e95d68",
               "cfops":[
                  5102
               ],
               "transporte":{
                  "transportadora":"Transportadora",
                  "cnpj":"00.000.000/0000-1",
                  "tipo_frete":"R",
                  "volumes":[
                     {
                        "volume":{
                           "id": "6423805580",
                           "idServico":"4523213"
                           "servico":"PAC",
                           "codigoServico":"04669",
                           "codigoRastreamento":"EC272330554BR",
                           "dataSaida":"2017-07-28",
                           "prazoEntregaPrevisto":"10",
                           "valorFretePrevisto":"12.00",
                           "valorDeclarado": "80.50",
                           "remessa":{
                              "numero":"12345AAA",
                              "dataCriacao":"2017-10-17"
                           },
                           "dimensoes":{
                              "peso":"5.000",
                              "altura":"15",
                              "largura":"15",
                              "comprimento":"15",
                              "diametro":"0"
                           },
                           "urlRastreamento":"https://www.exemplo.com.br/rastreio?q=EC272330554BR"
                        }
                     },
                     {
                        "volume":{
                           "id": "6423805635",
                           "idServico":"1231293",
                           "servico":"SEDEX 10",
                           "codigoServico":"03158",
                           "codigoRastreamento":"SX052413651BR",
                           "dataSaida":"2017-07-28",
                           "prazoEntregaPrevisto":"3",
                           "valorFretePrevisto":"37.30",
                           "valorDeclarado": "0.00",
                           "remessa":null,
                           "dimensoes":{
                              "peso":"3.000",
                              "altura":"15",
                              "largura":"15",
                              "comprimento":"15",
                              "diametro":"0"
                           }
                        }
                     }
                  ],
                  "enderecoEntrega":{
                     "nome":"Organisys Software Entrega",
                     "endereco":"Rua Assis Brasil",
                     "numero":"222",
                     "complemento":"",
                     "cidade":"Bento Gonçalves",
                     "bairro":"Centro",
                     "cep":"95.700-000",
                     "uf":"RS"
                  }
               }
            }
         }
      ]
   }
}

 

Observações:

O campo linkDanfe somente será preenchido se a nota tiver sido enviada por e-mail.

Artigos relacionados