Filtros – 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

A API versão 2 do Bling possibilita o uso de filtros na execução de chamadas GET para restrição de conteúdo.

Para a correta utilização dos filtros, faz-se necessário o uso do parâmetro filters na chamada. Dentro deste parâmetro, deverá ser posto o nome do filtro (especificado no manual do método) e, entre colchetes ([ ]), o seu valor.

Exemplo do uso de filtros

curl -X GET "https://bling.com.br/Api/v2/notasfiscais/json/"
     -G
     -d "filters=nome_do_filtro[valor]" 
     -d "apikey={apikey}"

Caso haja a necessidade do uso de múltiplos filtros, um ponto e vírgula (;) deverá ser usado para separá-los.

Exemplo do uso de múltiplos filtros

curl -X GET "https://bling.com.br/Api/v2/notasfiscais/json/"
     -G
     -d "filters=nome_do_filtro[valor];nome_do_filtro_2[valor]" 
     -d "apikey={apikey}"

É possível, também, fazer do uso depredicates com a intenção de combinar ou comparar resultados. Segue a lista de possíveis predicates.

Predicate TO
Descrição Usado para selecionar os valores dentro de um intervalo
Exemplo [12/12/2013 TO 01/02/2014]

É importante ressaltar que nem todos os métodos da API possuem filtros. Para mais informações, pesquise no manual dos mesmos.

A API V3 JÁ ESTÁ DISPONÍVEL

Artigos relacionados