×
Entrar
Experimente grátis
Top

GET /produto/{codigo}/{id_fornecedor}

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

Busca produtos a partir de seu codigo no fornecedor e pelo ID do fornecedor.

curl    

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

PHP

 
 $code = "{codigo}";
$providerId = "{id_fornecedor}";
$apikey = "{apikey}";
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/produto/' . $code . '/' . $providerId . '/' . $outputType;
$retorno = executeGetProduct($url, $apikey);
echo $retorno;
function executeGetProduct($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 ExecuteGetProduct() {
    var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/produtos/{codigo}/{id_fornecedor}/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 apikey gerada no sistema 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

 

Retorno

Em caso de sucesso, retornará o produto solicitado, no mesmo modelo do exemplo a seguir e dos modelos apresentados anteriormente. Caso contrário, retornará um erro.

A resposta será no formato especificado na URL (XML ou JSON).

Exemplo de retorno Variação de um produto

{  
   "retorno":{  
      "produtos":[  
         {  
            "produto":{  
               "codigo":"88-35",
               "descricao":"Mouse Pad 35x35",
               "tipo":"P",
               "unidade":"UN",
               "preco":"58.0000000000",
               "precoCusto":"36.9900000000",
               "descricaoCurta":"Descricao curta",
               "descricaoComplementar":"Descricao complementar",
               "dataInclusao":"2017-08-11",
               "dataAlteracao":"2017-08-15",
               "imageThumbnail":null,
               "nomeFornecedor":"Fornecedor Teste",
               "marca":"",
               "class_fiscal":"",
               "cest":"",
               "origem":"0",
               "idGrupoProduto":"0",
               "linkExterno":"https://minhaloja.com.br/meu-produto",
               "observacoes":"Observações do produto",
               "grupoProduto":null,
               "pesoLiq":"0.300",
               "pesoBruto":"0.300",
               "estoqueMinimo":"20.00",
               "estoqueMaximo":"100.00",
               "gtin":"1231231231111",
               "gtinEmbalagem":"1231231231111",
               "larguraProduto":"35",
               "alturaProduto":"35",
               "profundidadeProduto":"0.6",
               "itensPorCaixa": 2,
               "volumes": 2,
               "urlVideo": "https://www.youtube.com/watch?v=zKKL-SgC5lY",
               "localizacao":"Artigos Eletrônicos",
               "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"
                  },{
                    "link": "http://teste05.s3.amazonaws.com/10b19a1b6dfd022cfaa65172dab740ba/58f39bca9d794571bae24ac1fd29ae67?AWSAccessKeyId=AKIAIRKPH2R4VDLL422A&Expires=1506023235&Signature=URYAB1fZFLjrlKQQKPsYf2WLFFc%3D",
                    "validade": "10/09/2017"
                  },{
                     "link": "http://teste05.s3.amazonaws.com/10b19a1b6dfd022cfaa65172dab740ba/774ba89cbea1fdfc7e4442f9306f2136?AWSAccessKeyId=AKIAIRKPH2R4VDLL422A&Expires=1506023235&Signature=3otgTawOYy8wiwUH0sDKX2Ipcvc%3D",
                     "validade": "10/09/2017"
                  },
               "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":"88",
               "estoqueAtual":30,
               "depositos":[  
                  {  
                     "deposito":{  
                        "id":"51921476",
                        "nome":"Geral",
                        "saldo":"20.0000"
                     }
                  },
                  {  
                     "deposito":{  
                        "id":"51921764",
                        "nome":"Deposito 1",
                        "saldo":"10.0000"
                     }
                  }
               ]
            }
         }
      ]
   }
}

 

Artigos relacionados