×
Entrar
Experimente grátis
Top

PUT /pedidocompra/{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 (1).png

Info- icon-P (1).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 (1).png

 

Atualiza a situação do pedido de compra

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

 

curl    

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

PHP

 
$url = 'https://bling.com.br/Api/v2/pedidocompra/{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/pedidocompra/{numero}/json");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apiKey}&xml={xml_do_pedido_de_compra}";
    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 de compra     string

 

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

Grupo Campo Informação Padrão Opcional Nota
raiz pedidocompra     Obrigatório  
pedidocompra situacao

Número da nova situação do pedido de compra

 INTEGER(10) Obrigatório 8

 

Exemplo de XML

<?xml version="1.0" encoding="UTF-8"?>
<pedidocompra>
    <situacao>3</situacao>
</pedidocompra>

 

Retorno

Em caso de sucesso, retornará o número do pedido de compra 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).

Exemplo de retorno

{
    "retorno": {
        "pedidoscompra":[
            {
                "pedidocompra": {
                    "numero": "1",
                    "mensagem": "No Bling, o status foi atualizado para Cancelado."
                }
            }
        ]
    }
}

 

Artigos relacionados