A API V3 JÁ ESTÁ DISPONÍVEL
As integrações API v2 que já estão configuradas, seguirão funcionando temporariamente. |
Atualiza uma categoria
Atualiza o vínculo categoria a partir do idLoja e idCategoria.
curl |
curl -X POST "https://bling.com.br/Api/v2/categoriasLoja/{idLoja}/{idCategoria}/json/" |
PHP |
$url = 'https://bling.com.br/Api/v2/categoriasLoja/{idLoja}/{idCategoria}/'; $xml = '...'; $posts = array ( "apikey" => "{apikey}", "xml" => rawurlencode($xml) ); $retorno = executeUpdateCategoriesStore($url, $posts); echo $retorno; function executeUpdateCategoriesStore($url, $data){ $curl_handle = curl_init(); curl_setopt($curl_handle, CURLOPT_URL, $url); curl_setopt($curl_handle, CURLOPT_POST, count($data)); curl_setopt($curl_handle, CURLOPT_POSTFIELDS, $data); curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, TRUE); $response = curl_exec($curl_handle); curl_close($curl_handle); return $response; } |
C# |
public static void ExecuteUpdateCategoriesStore() { HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/categoriasLoja/{idLoja}/{idCategoria}"); ASCIIEncoding encoding = new ASCIIEncoding(); string postData = "apikey={apiKey}&xml={xml_do_vinculo_categoria}"; byte[] data = encoding.GetBytes(postData); request.Method = "POST"; request.ContentType = "application/x-www-form-urlencoded"; request.ContentLength = data.Length; using (Stream stream = request.GetRequestStream()) stream.Write(data,0,data.Length); HttpWebResponse response = (HttpWebResponse)request.GetResponse(); string responseString = new StreamReader(response.GetResponseStream()).ReadToEnd(); Console.Out.WriteLine("Response Body: \r\n {0}", responseString); } |
Parâmetro | Descrição | Tipo |
apikey |
apikey gerada no sistema | string |
xml |
Xml contendo o vínculo da categoria | string |
Para o parâmetro xml
, é necessário seguir o padrão.
Tabela de campos do XML
Grupo | Campo | Informação | Tipo | Padrão | Opcional | Nota |
---|---|---|---|---|---|---|
raiz | categoriasLoja | Obrigatório | ||||
categoriasLoja | categoriaLoja | Obrigatório | ||||
categoriaLoja | idCategoria | ID da Categoria | INTEGER(11) | Obrigatório | ||
categoriaLoja | idVinculoLoja | ID da Categoria na Loja Virtual | INTEGER(11) | Obrigatório | ||
categoriaLoja | descricaoVinculo | Descrição da Categoria na Loja Virtual | STRING(120) | Obrigatório |
Mensagens de erros específicos
Código | Mensagem |
---|---|
110 | Não foi possível salvar as informações do vínculo da categoria por loja |
111 | O campo descricaoVinculo é obrigatório |
112 | Não foi possível criar/atualizar a categoria loja - Categoria não encontrada no sistema |
113 | A categoria não foi localizada |
114 | Já existe um idVinculoLoja cadastrado com o valor informado |
115 | O campo idVinculoLoja é obrigatório |
116 | Nenhuma loja ativa foi localizada com o ID informado |
117 | O campo idCategoria é obrigatório |
Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<categoriasloja>
<categorialoja>
<idcategoria>792</idcategoria>
<descricaovinculo>Casa, Mesa e Banho</descricaovinculo>
<idvinculoloja>1234</idvinculoloja>
</categorialoja>
</categoriasloja>
Retorno
Em caso de sucesso, retornará o vínculo da categoria alterado, 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": { "categoriasLoja": [ { "categoriaLoja": { "idCategoria": 792, "descricaoVinculo": "Casa, Mesa e Banho", "idVinculoLoja": 1234 } } ] } }