×
Entrar
Experimente grátis
Top

GET /nfce/{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 NFC-e

Busca uma NFC-e a partir de seu numero e sua serie.

curl    

 
curl -X GET "https://bling.com.br/Api/v2/nfce/{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/nfce/' . $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/nfce/{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 NFC-e integer
serie série da NFC-e integer

 

Retorno

Em caso de sucesso, retornará a NFC-e 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).

Observação: O campo linkDanfe somente será preenchido se a nota tiver sido enviada por e-mail e os campos marcados em negrito, no exemplo de retorno, estão depreciados e serão removidos em atualizações futuras.

Exemplo de retorno

{
    "retorno": {
        "notasfiscais": [
            {
                "notafiscal": {
                    "serie": "1",
                    "numero": "000003",
                    "numeroPedidoLoja": "100000002",
                    "loja": 0,
                    "tipo": "S",
                    "situacao": "Pendente",
                    "contato": "Organisys Software",
                    "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",
                    "codigosRastreamento": {
                        "codigoRastreamento": "SX123451051BR"
                    },
                    "transporte": {
                        "transportadora": "Transportadora",
                        "tipo_frete": "R",
                        "servico_correios": "PAC Faixa",
                        "volumes": [
                            {
                                "idServico" : 4627,
                                "servico": "PAC Faixa",
                                "codigoRastreamento": "PI000000014BR",
                                "dataSaida": "2015-11-04",
                                "prazoEntregaPrevisto": 3,
                                "valorFretePrevisto": 0.00
                            }
                        ],
                        "enderecoEntrega": {
                            "nome": "Organisys Software Entrega",
                            "endereco": "Rua Assis Brasil",
                            "numero": "222",
                            "complemento": "",
                            "cidade": "Bento Gonçalves",
                            "bairro": "Centro",
                            "cep": "95.700-000",
                            "uf": "RS"
                       }
                    }
                }
            }
        ]
    }
}

 

Artigos relacionados