GET /nfces – Bling!

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

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

Busca todas as NFC-es

Recupera todas os NFC-es cadastradas no sistema.

curl

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

PHP

$apikey = "{apikey}";
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/nfces/' . $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://bling.com.br/Api/v2/nfces/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
4	Enviada - Aguardando recibo
5	Rejeitada
6	Autorizada
7	Emitida DANFE
8	Registrada
9	Enviada - Aguardando protocolo
10	Denegada

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 e hora de emissão da nota no intervalo especificado, não incluindo as canceladas. Hora opcional.	date (dd/mm/YYYY 00:00:00)	TO
`situacao`	Filtra pela situação da NFC-e	integer (segundo tabela de situações acima)

curl -X GET "https://bling.com.br/Api/v2/nfces/json/"
     -G
     -d "filters=dataEmissao[12/12/2013 14:20:00 TO 05/02/2014 19:59:59]; situacao[6]"
     -d "apikey={apikey}"

Retorno

Em caso de sucesso, retornará todas as NFC-es registradas, 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: 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": "Rejeitada",
                    "contato": "Organisys Software",
                    "vendedor": "",
                    "dataEmissao": "2009-09-25 00:00:00",
                    "valorNota": 0.00,
                    "chaveAcesso": "43130893518124000144550010023289261494793111",
                    "tipoIntegracao": "Magento",
                    "codigosRastreamento": {
                            "codigoRastreamento": "PI000000014BR"
                    },
                    "transporte": {
                        "transportadora": "Transportadora",
                        "tipo_frete": "R",
                        "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"
                       }
                    }
                }
            }
        ]
    }
}