×
Entrar
Experimente grátis
Top

POST /logistica/rastreamento/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

 

Vincula rastreamentos

Vincula rastreamentos ao pedido de venda.

curl

 
curl -X POST "https://bling.com.br/Api/v2/logistica/rastreamento/pedido/{número}/json/"
     -G
     -d "apikey={apikey}"
     -d "xml={xml_rastreamentos}"

PHP

 
$orderNumber = 12;
$url = 'https://bling.com.br/Api/v2/logistica/rastreamento/pedido/' . $orderNumber . '/json';
$xml = '...';
$data = array(
    'apikey' => '{apikey}',
    'xml' => rawurlencode($xml)
);
$retorno = executeGetOrder($url, $data);
echo $retorno;
function executeSendTracking($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 ExecuteSendTracking() {
    HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/rastreamento/pedido/12/json");
    ASCIIEncoding encoding = new ASCIIEncoding();
    string postData = "apikey={apiKey}&xml={xml_rastreamentos}";
    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 os dados de rastreamento string

 

Para o parâmetro xml é necessário seguir o padrão descrito na tabela abaixo.

 

Tabela de campos do XML

Grupo Campo Informação Tipo Padrão Opcional Nota  
raiz rastreamentos       Obrigatório  
rastreamento id_servico ID do serviço da integração logística obtido no método GET INTEGER(10) 9 Obrigatório  
rastreamento codigo Informação do código do rastreamento para ser vínculado na venda STRING(15) ABCDEF123456789 Opcional  

 

 

Mensagens de erros específicos

Código Mensagem
81 O campo id_servico não foi informado.
82 Serviço de logística inválido.
84 Pedido de venda informado não foi encontrado.
280 O campo data_evento esta em um formato invalido

 

Exemplo de XML

<rastreamentos>
    <rastreamento>
        <id_servico>123454</id_servico>
        <codigo>PL000000000BR</codigo>
     </rastreamento>
     <rastreamento>
        <id_servico>123321</id_servico>
        <codigo>AB123456789BR</codigo>
     </rastreamento>
     <rastreamento>
        <id_servico>87654321</id_servico>
        <codigo>AP123123123BR</codigo>
     </rastreamento>
</rastreamentos>

 

Artigos relacionados