PUT /categoria/{idCategoria} – Bling!

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

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

Atualiza uma categoria

Atualiza uma categoria a partir do seu id.

curl

curl -X PUT "https://bling.com.br/Api/v2/categoria/{idCategoria}/json/"
     -G
     -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 = executeUpdateCategory($url, $posts);
echo $retorno;
function executeUpdateCategory($url, $data){
    $curl_handle = curl_init();
    curl_setopt($curl_handle, CURLOPT_URL, $url);
    curl_setopt($curl_handle, CURLOPT_CUSTOMREQUEST, 'PUT');
    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 ExecuteUpdateCategory() {
    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 = "PUT";
    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
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
                }
            }
        ]
    }
}