Top

PUT /categoria/{idCategoria}

  • Atualizado
Seguir

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
                }
            }
        ]
    }
}

Artigos relacionados