×
Entrar
Experimente grátis
Top

PUT /pedido/{numero}

  • Atualizado
Seguir

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 link-externo.png

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 link-externo.png

 

Atualiza a situação do pedido

Atualiza a situação do pedido a partir de seu numero.

curl    

 
curl -X PUT "https://bling.com.br/Api/v2/pedido/{numero}/json/"
     -G
     -d "apikey={apikey}"
     -d "xml={xml_do_pedido}" 

PHP

 
$url = 'https://bling.com.br/Api/v2/pedido/{numero}/json';
$xml = '...';
$posts = array (
    'apikey' => '{apikey}',
    'xml' => rawurlencode($xml)
);
$retorno = executeUpdateOrder($url, $posts);
echo $retorno;
function executeUpdateOrder($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_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 ExecuteUpdateOrder() {
    HttpWebRequest request =
        (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/pedido/{numero}/json");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apiKey}&xml={xml_do_produto}";
    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 situação do pedido string

 

Para o parâmetro xml, é necessário seguir o padrão.

Grupo    Campo Informação Padrão Opcional Nota  
raiz pedido     Obrigatório  
pedido idSituacao    Número da situação do pedido    INTEGER(10)    Obrigatório    1

 

Notas:

  1. Conforme a API de situações
<?xml version="1.0" encoding="UTF-8"?>
<pedido>
    <idSituacao>6</idSituacao>
</pedido>

 

Retorno

Em caso de sucesso, retornará o número do pedido atualizado e uma mensagem descritiva, 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": {
        "pedidos":[
            {
                "pedido": {
                    "numero": "289258",
                    "mensagem": "No Bling, o status foi atualizado para atendido."
                }
            }
        ]
    }
}

Artigos relacionados