×
Entrar
Experimente grátis
Top

GET/produtos

  • 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 todos os produtos

Recupera todos os produtos cadastrados no sistema.

curl    

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

PHP

 
 $apikey = "{apikey}";
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/produtos/' . $outputType;
$retorno = executeGetProducts($url, $apikey);
echo $retorno;
function executeGetProducts($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 ExecuteGetProducts() {
    var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/produtos/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 apikey string
estoque Parâmetro opcional, informar "S" para incluir estoque atual por depósito e total no retorno string
loja Parâmetro opcional, informar o  "Código da Loja" para incluir informações específicas de uma loja vinculada ao produto string
imagem Parâmetro opcional, informar "S" para incluir as imagens vinculadas ao produto. string

 

Filtros

Pode-se utilizar filtros para restringir o retorno de dados. Observe a tabela de possíveis filtros abaixo.

Filtro Descrição Tipo Predicate
dataInclusao Filtra pela data de inclusão do produto no intervalo especificado date (dd/mm/YYYY) ou datetime (dd/mm/YYYY H:i:s) TO
dataAlteracao Filtra pela data de alteração do produto no intervalo especificado date (dd/mm/YYYY) ou datetime (dd/mm/YYYY H:i:s) TO
dataAlteracaoLoja Filtra pela data de alteração do produto na Loja no intervalo especificado (OBS: Este filtro só funciona com o parâmetro loja ) date (dd/mm/YYYY) ou datetime (dd/mm/YYYY H:i:s) TO
dataInclusaoLoja Filtra pela data de inclusão do produto na Loja no intervalo especificado (OBS: Este filtro só funciona com o parâmetro loja ) date (dd/mm/YYYY) ou datetime (dd/mm/YYYY H:i:s) TO
tipo Filtra pelo tipo (segundo tabela de tipos abaixo) string(1)  
situacao Filtra pela situação do produto (segundo tabela de situações abaixo) string(1)   
curl -X GET "https://bling.com.br/Api/v2/produtos/json/"
    -G
    -d "filters=dataInclusao[12/12/2013 TO 05/02/2014]; dataAlteracaoLoja[12/12/2013 10:00:00 TO 05/02/2014 11:00:00]"
    -d "apikey={apikey}"

 

Tipos

Filtro Descrição
P Produto
S Serviço

 


Situações 

Filtro Descrição
A Ativo
I Inativo

 

Paginação

O limite do retorno do GET produtos é de 100 produtos, para acessar os demais produtos, utilize a paginação seguindo o exemplo abaixo.

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

Para mais informações acesse a seção Limites.

 

Retorno

Em caso de sucesso, retornará todos os produtos registrados, 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":{  
      "produtos":[  
         {  
            "produto":{  
               "codigo":"CAD00011",
               "tipo":"P",
               "descricao":"CADEIRA XYZ F5",
               "unidade":"",
               "preco":"100.0000000000",
               "precoCusto":"85.0000000000",
               "pesoLiq":"1.000",
               "pesoBruto":"1.000",
               "estoqueMinimo":"0.00",
               "estoqueMaximo":null,
               "gtin":"",
               "gtinEmbalagem":"",
               "descricaoCurta":"CADEIRA XYZ",
               "descricaoComplementar":"CADEIRA em detalhes",
               "larguraProduto":"10",
               "alturaProduto":"89",
               "profundidadeProduto":"67",
               "unidadeMedida":"Centímetros",
               "dataInclusao":"2016-08-17",
               "dataAlteracao":"2016-08-17",
               "imageThumbnail":null,
               "nomeFornecedor":"Bling",
               "marca":"Marca de teste",
               "class_fiscal":"1234.56.78",
               "cest":"28.040.00",
               "origem":"1",
               "idGrupoProduto": "12345",
               "linkExterno": "https://minhaloja.com.br/cadeira-xyz-f5",
               "observacoes": "Observações da CADEIRA XYZ F5",
               "grupoProduto": "Móveis",
               "itensPorCaixa": 2,
               "volumes": 2,
               "urlVideo": "https://www.youtube.com/watch?v=zKKL-SgC5lY",
               "localizacao":"Prateleira B",
               "crossdocking": "2",
               "garantia": 4,
               "condicao": "Novo",
               "freteGratis": "S",
               "producao": "P",
               "dataValidade": "2019-11-20",
               "descricaoFornecedor": "Descrição do fornecedor",
               "imagem":[
                  {
                    "link": "http://teste05.s3.amazonaws.com/10b19a1b6dfd022cfaa65172dab740ba/184c75cb44203396e7c281cd7892576c?AWSAccessKeyId=AKIAIRKPH2R4VDLL422A&Expires=1506023235&Signature=ayQ0dzsFwBLqREsvcdDVrTTVGIg%3D",
                    "validade": "10/09/2017",
                    "tipoArmazenamento": "interno"
                  },{
                    "link": "http://teste05.s3.amazonaws.com/10b19a1b6dfd022cfaa65172dab740ba/58f39bca9d794571bae24ac1fd29ae67?AWSAccessKeyId=AKIAIRKPH2R4VDLL422A&Expires=1506023235&Signature=URYAB1fZFLjrlKQQKPsYf2WLFFc%3D",
                    "validade": "10/09/2017",
                    "tipoArmazenamento":"interno"
                  },{
                     "link": "http://teste05.s3.amazonaws.com/10b19a1b6dfd022cfaa65172dab740ba/774ba89cbea1fdfc7e4442f9306f2136?AWSAccessKeyId=AKIAIRKPH2R4VDLL422A&Expires=1506023235&Signature=3otgTawOYy8wiwUH0sDKX2Ipcvc%3D",
                     "validade": "S/ Validade",
                     "tipoArmazenamento":"externo"
                  }],
               "produtoLoja": {
                        "preco": {
                            "preco": 105.00,
                            "precoPromocional": 95.00
                        },
                        "categoria": [
                            {
                                "id": "10",
                                "descricao": "Móveis",
                                "idCategoriaPai": "0"
                            },
                            {
                                "id": "102",
                                "descricao": "Cadeiras",
                                "idCategoriaPai": "10"
                            },
                            {
                                "id": "684",
                                "descricao": "Cadeiras executivas",
                                "idCategoriaPai": "102"
                            }
                        ]
                    },
               "codigopai":"CAD",
               "estoqueAtual":24,
               "depositos":[  
                  {  
                     "deposito":{  
                        "id":"51212592",
                        "nome":"Geral",
                        "saldo":"24.0000"
                     }
                  }
               ]
            }
         }
      ]
   }
}

 

 

Artigos relacionados