A API V3 JÁ ESTÁ DISPONÍVEL
As integrações API v2 que já estão configuradas, seguirão funcionando temporariamente. |
Insere uma categoria
Insere uma categoria no sistema.
curl |
curl -X POST "https://bling.com.br/Api/v2/categoria/json/" |
PHP |
$url = 'https://bling.com.br/Api/v2/categoria/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/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 um 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 |
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
<categorias>
<categoria>
<descricao>Calçado</descricao>
<idCategoriaPai>123456</idCategoriaPai>
</categoria>
</categorias>
Retorno
Em caso de sucesso, retornará o inserido, 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 em JSON
{
"retorno": {
"categorias": [
[
{
"categoria": {
"id": 1312847,
"descricao": "Calçado",
"idCategoriaPai": 123456
}
}
]
]
}
}