A API V3 JÁ ESTÁ DISPONÍVEL
|
Busca todas as notas fiscais
Recupera todas os notas fiscais cadastradas no sistema, informadas em Suprimentos > Notas de entrada e Vendas > Notas fiscais.
curl |
curl -X GET "https://bling.com.br/Api/v2/notasfiscais/json/" |
PHP |
$apikey = "{apikey}"; |
C# |
public static void ExecuteGetFiscalDocuments() { var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/notasfiscais/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 | Descrição |
---|---|---|
1 | Pendente | Situação inicial das notas criadas pelo usuário. |
2 | Emitida | Não é mais utilizada (depreciada). |
3 | Cancelada | Nota foi cancelada após o envio para SEFAZ. |
4 | Enviada - Aguardando recibo | Nota foi enviada para a SEFAZ e aguarda informações do recibo de entrega (situação temporária durante o processo de envio). |
5 | Rejeitada | O envio da nota foi rejeitado pela SEFAZ. |
6 | Autorizada | O envio da nota foi autorizado pela SEFAZ (a nota possui valor fiscal). |
7 | Emitida DANFE | A nota está autorizada e foi realizada a emissão da DANFE. |
8 | Registrada | Situação das notas de terceiros importadas no sistema. |
9 | Enviada - Aguardando protocolo | A nota foi enviada para a SEFAZ e aguarda informações do protocolo de autorização (situação temporária durante o processo de envio). |
10 |
Denegada |
O envio da nota foi denegado pela SEFAZ. |
11 |
Consultar situação |
Situação especial para notas que apresentam rejeição de duplicidade sem diferença na chave de acesso. |
12 |
Bloqueada |
A nota é bloqueada quando é rejeitada várias vezes pelo mesmo motivo. É necessário corrigir o motivo da rejeição para desbloquear. |
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 notas canceladas. Hora opcional. | datetime (dd/mm/YYYY 00:00:00) | TO |
situacao |
Filtra pela situação da nota fiscal | integer (segundo tabela de situações acima) | |
tipo |
Filtra pelo tipo da nota fiscal | string (E - Entrada, S - Saída) |
|
numeroPedidoLoja |
Filtra pelo número do pedido na loja integrada | String (1 a 15 caracteres) |
|
curl -X GET "https://bling.com.br/Api/v2/notasfiscais/json/"
-G
-d "filters=dataEmissao[12/12/2019 14:01:00 TO 05/02/2020 19:59:59]; situacao[6]"
-d "apikey={apikey}"
Lista todas as notas fiscais cadastradas no sistema em Vendas > Notas fiscais. Incluindo o filtro tipo [E], lista as informadas em Suprimentos > Notas de entrada.
As notas canceladas são omitidas a menos que seja especificado o filtro SITUACAO[3].
Retorno
Em caso de sucesso, retornará todas as notas fiscais 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).
Exemplo de retorno
{ "retorno":{ "notasfiscais":[ { "notafiscal":{ "serie":"1", "numero":"000003", "numeroPedidoLoja":"100000002", "loja":0, "tipo":"S", "situacao":"Rejeitada", "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":"35200112340001560123456000031234567890",
"xml":"https://bling.com.br/relatórios/nfe.xml.php?s&chaveAcesso=35200112340001560123456000031234567890",
"linkDanfe":"https://bling.com.br/doc.view.php?id=c=352b112cb0001dbba45a0067890", "linkPDF": "https://bling.com.br/a/doc.view.php?PDF=true&id=c=352b112cb0001dbba45a0067890",
"tipoIntegracao":"Magento", "cfops":[ 5102 ], "transporte":{ "transportadora":"Transportadora", "cnpj":"00.000.000/0000-1", "tipo_frete":"R", "volumes":[ { "volume":{
"id": "6423805580", "idServico": "4627", "servico":"PAC Faixa",
"codigoServico":"04669", "codigoRastreamento":"PI000000014BR", "dataSaida":"2015-11-04", "prazoEntregaPrevisto":13, "valorFretePrevisto":27.50, "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=PI000000014BR", } }, { "volume":{
"id": "6423805635", "idServico":"1231293", "servico":"SEDEX 10",
"codigoServico":"03158", "codigoRastreamento":"SX052413651BR", "dataSaida":"2017-07-28", "prazoEntregaPrevisto":"5", "valorFretePrevisto":"47.30", "valorDeclarado": "0.00", "remessa":null, "dimensoes":{ "peso":"3.500", "altura":"35", "largura":"25", "comprimento":"10", "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" } } } } ] } }