×
Entrar
Experimente grátis
Top

GET /produto/{codigo}

  • 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 um produto

Busca um produto a partir do seu codigo.

curl    

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

PHP

 
$code = "{codigo}";
$apikey = "{apikey}";
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/produto/' . $code . '/' . $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}/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

 

Retorno

Em caso de sucesso, retornará o produto solicitado, 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 Produto Simples

{  
   "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": "12348",
               "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": "T",
               "dataValidade": "2019-11-20",
               "spedTipoItem": "",
               "camposCustomizados": {
                   "valorDeFabrica": "5.200,00",
                   "modelo": "X1-45",
                   "marca": "Amazon",
                   "codigoAgrupador": 3
                }
               "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"
                            }
                        ]
                     },
               "estoqueAtual":24,
               "depositos":[  
                  {  
                     "deposito":{  
                        "id":"51212592",
                        "nome":"Geral",
                        "saldo":"24.0000"
                     }
                  }
               ]
            }
         }
      ]
   }

 

Exemplo de retorno Produto com Variação

{  
   "retorno":{  
      "produtos":[  
         {  
            "produto":{  
               "codigo":"223435780",
               "tipo":"P",
               "descricao":"Caneta 001 99",
               "unidade":"Pc",
               "preco":"1.6800000000",
               "precoCusto":"0.0000000000",
               "pesoLiq":"0.180",
               "pesoBruto":"0.200",
               "estoqueMinimo":"1.00",
               "estoqueMaximo":"100.00",
               "gtin":"223435780",
               "gtinEmbalagem":"54546",
               "descricaoCurta":"Descrição Curta da caneta",
               "descricaoComplementar":"Descrição complementar da caneta",
               "larguraProduto":"11",
               "alturaProduto":"21",
               "profundidadeProduto":"31",
               "unidadeMedida":"Centímetros",
               "dataInclusao":"2017-03-01",
               "dataAlteracao":"2017-03-03",
               "imageThumbnail":null,
               "nomeFornecedor":"",
               "marca":"",
               "class_fiscal":"1000.01.01",
               "cest":"28.040.00",
               "origem":"0",
               "idGrupoProduto": "12389",
               "linkExterno": "https://minhaloja.com.br/meu-produto",
               "observacoes": "Observações do produto",
               "grupoProduto": "Material escolar",
               "itensPorCaixa": 2,
               "volumes": 2,
               "urlVideo": "https://www.youtube.com/watch?v=zKKL-SgC5lY",
               "localizacao":"",
               "crossdocking": "2",
               "garantia": 4,
               "condicao": "Novo",
               "freteGratis": "S",
               "producao": "T",
               "dataValidade": "2019-11-20",
               "spedTipoItem": "",
               "camposCustomizados": {
                   "valorDeFabrica": "5.200,00",
                   "modelo": "X1-45",
                   "marca": "Amazon",
                   "codigoAgrupador": 3
                  }
               "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"
                            }
                        ]
                    },
               "variacoes":[  
                  {  
                     "variacao":{  
                        "nome":"Cor:Preto",
                        "codigo":"223435780-Preto",
                        "estoqueAtual":70,
                        "depositos":[  
                           {  
                              "deposito":{  
                                 "id":"51921476",
                                 "nome":"Geral",
                                 "saldo":"50.0000"
                              }
                           },
                           {  
                              "deposito":{  
                                 "id":"51921764",
                                 "nome":"Deposito 2",
                                 "saldo":"20.0000"
                              }
                           }
                        ]
                     }
                  },
                  {  
                     "variacao":{  
                        "nome":"Cor:Branco",
                        "codigo":"223435780-Branco",
                        "estoqueAtual":120,
                        "depositos":[  
                           {  
                              "deposito":{  
                                 "id":"51921476",
                                 "nome":"Geral",
                                 "saldo":"50.0000"
                              }
                           },
                           {  
                              "deposito":{  
                                 "id":"51921764",
                                 "nome":"Deposito 2",
                                 "saldo":"70.0000"
                              }
                           }
                        ]
                     }
                  }
               ]
            }
         }
      ]
   }
}

 

Exemplo de retorno Produto com Composição

{
    "retorno": {
        "produtos": [
            {
                "produto": {
                    "codigo": "composicaoteste",
                    "descricao": "Composição teste",
                    "tipo": "P",
                    "situacao": "Ativo",
                    "unidade": "",
                    "preco": "0.0000000000",
                    "precoCusto": "3.8900000000",
                    "descricaoCurta": "",
                    "descricaoComplementar": "",
                    "dataInclusao": "2019-12-05",
                    "dataAlteracao": "2019-12-09",
                    "imageThumbnail": null,
                    "urlVideo": "",
                    "nomeFornecedor": "",
                    "codigoFabricante": "",
                    "marca": "",
                    "class_fiscal": "",
                    "cest": "",
                    "origem": "0",
                    "idGrupoProduto": "0",
                    "linkExterno": "",
                    "observacoes": "",
                    "grupoProduto": null,
                    "garantia": "0",
                    "descricaoFornecedor": "",
                    "idFabricante": "",
                    "categoria": {
                        "id": "951635",
                        "descricao": "Categoria padrão"
                    },
                    "pesoLiq": "0.000",
                    "pesoBruto": "0.000",
                    "estoqueMinimo": "0.00",
                    "estoqueMaximo": "0.00",
                    "gtin": "",
                    "gtinEmbalagem": "",
                    "larguraProduto": "",
                    "alturaProduto": "",
                    "profundidadeProduto": "",
                    "unidadeMedida": "Centímetros",
                    "itensPorCaixa": 0,
                    "volumes": 0,
                    "localizacao": "",
                    "crossdocking": "3",
                    "condicao": "Não Especificado",
                    "freteGratis": "N",
                    "producao": "P",
                    "dataValidade": "0000-00-00",
                    "spedTipoItem": "",
                    "camposCustomizados": {
                         "valorDeFabrica": "5.200,00",
                         "modelo": "X1-45",
                         "marca": "Amazon",
                         "codigoAgrupador": 3
                         }
                    "estrutura": [
                        {
                            "componente": {
                                "nome": "Componente teste 01",
                                "codigo": "componenteteste01"
                            }
                        },
                        {
                            "componente": {
                                "nome": "Componente teste 02",
                                "codigo": "componenteteste02"
                            }
                        }
                    ]
                }
            }
        ]
    }
}

Artigos relacionados