Atualiza uma categoria
Atualiza uma categoria a partir do seu id.
curl |
curl -X POST "https://bling.com.br/Api/v2/categoria/{idCategoria}/json/" -d "apikey={apikey}" -d "xml={xml_da_categoria}" |
PHP |
$url = 'https://bling.com.br/Api/v2/categoria/{idCategoria}/json/'; $xml = '>...'; $posts = array ( "apikey" => "{apikey}", "xml" => rawurlencode($xml) ); $retorno = executeInsertCategory($url, $posts); echo $retorno; function executeInsertCategory($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 ExecuteInsertCategory() { HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/categoria/{idCategoria}/json/"); ASCIIEncoding encoding = new ASCIIEncoding(); string postData = "apikey={apiKey}&xml={xml_da_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 a 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 | categorias | Obrigatório | ||||
categorias | categoria | Objeto categoria | Obrigatório | |||
categoria | descricao | Descrição da categoria | STRING(50) | Obrigatório | ||
categoria | idCategoriaPai | ID da categoria pai | INTEGER(11) | 0 | Opcional |
Mensagens de erros específicos
Código | Mensagem |
---|---|
90 | Não foi possível salvar as informações da categoria |
91 | O campo descrição é obrigatório |
92 | Não foi possível atualizar a categoria - Categoria não encontrada no sistema |
93 | A categoria não foi localizada |
94 | Já existe uma categoria de mesmo nível e pai com a descrição informada |
95 | Não foi localizada nenhuma categoria com o idCategoriaPai informado |
Exemplo de XML
<?xml version="1.0" encoding="UTF-8"?>
<categorias>
<categoria>
<descricao>Casa, Mesa e Banho</descricao>
<idcategoriapai>0</idcategoriapai>
</categoria>
</categorias>
Retorno
Em caso de sucesso, retornará a categoria alterada, no mesmo modelo do exemplo a seguir. Caso contrário, retornará um erro.
A resposta será no formato especificado na URL (XML ou JSON).
{ "retorno": { "categorias": [ { "categoria": { "id": 792, "descricao": "Casa, Mesa e Banho", "idCategoriaPai": 0 } } ] } }