PUT /logistica/{id}/servicos – 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 link-externo (1).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

Atualiza uma logística especifica

Atualiza uma logística personalizada específica e seus serviços cadastrados no sistema.

curl

curl -X PUT "https://bling.com.br/Api/v2/logistica/{id}/servicos/json" \
     -G \
     -d "apikey={apikey}" \
     -d "xml={xml}"

PHP

<?php
/**
 * @param string $uri Recurso
 * @param string $outputFormat Formato de retorno (json / xml)
 * @param array $params Parâmetros da requisição
 * 
 * @return mixed $response Retorno da requisição
 */
function executePut($uri, $outputFormat, $params) {
     $curlHandle = curl_init();
     $url = 'https://bling.com.br/Api/v2/' . $uri . '/' . $outputFormat;
     curl_setopt_array($curlHandle, [
        CURLOPT_URL => $url . '?' . http_build_query($params),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => 'PUT'
     ]);
     $response = curl_exec($curlHandle);
     if ($errorNumber = curl_errno($curlHandle)) {
     $response = 'cURL error (' . $errorNumber . '): ' . curl_strerror($errorNumber);
     }
     curl_close($curlHandle);
     return $response;
 }
echo executePut('logistica/{id}/servicos', 'json', [
    'apikey' => '{apikey}',
    'xml' => '{xml}'
]);

C#

public static void ExecuteUpdateOrder() {
   HttpWebRequest request =
       (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/logistica/{id}/servicos/json");
   ASCIIEncoding encoding = new ASCIIEncoding();
   string postData = "apikey={apiKey}&xml={xml}";
   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 os dados da logistica	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	logistica				Obrigatório
logistica	descricao	Descrição da logística	STRING		Obrigatório
logistica	situacao	Situação da logística	STRING (1)	H	Opcional	Valores permitidos: "H" - habilitada "E" - excluída "D" - desabilitada
logistica	servicos	Grupo de serviços logísticos			Opcional
logistica	tipo_integracao	Identificador da logística homologada	STRING		Obrigatório
servicos	servico	Serviços logísticos			Opcional
servico	id_servico	ID do serviço logístico, obtido no método GET ou 0 para um novo serviço	INTEGER(10)		Opcional
servico	descricao	Descrição do serviço logístico	STRING		Obrigatório
servico	frete_item	Valor do frete para o item	DECIMAL(11,2)		Opcional
servico	est_entrega	Estimativa em dias para entrega	INTEGER(10)		Opcional
servico	codigo	Código do serviço logístico	STRING		Opcional
servico	id_transportadora	ID da transportadora obtido no método GET	INTEGER		Opcional	1
servico	aliases	Grupo de aliases			Opcional
aliases	alias	Alias para o serviço logístico	STRING		Obrigatório

Notas:

O id do contato obtido no método GET da API de contatos , com tipo de contato transportador, será o id_transportadora.

Exemplo de XML

<logistica>
   <descricao>logistica 1</descricao>
<tipo_integracao>CustomLogistic</tipo_integracao>
   <servicos>
     <servico>
        <id_servico>0</id_servico>
        <descricao>servico 1</descricao>
        <frete_item>0</frete_item>
        <est_entrega>0</est_entrega>
        <codigo />
        <aliases>
            <alias>serv1</alias>
        </aliases>
        <id_transportadora>123456</id_transportadora>
     </servico>
     <servico>
        <id_servico>123457</id_servico>
        <descricao>servico 2</descricao>
        <frete_item>2</frete_item>
        <est_entrega>2</est_entrega>
        <codigo />
        <id_transportadora>123456</id_transportadora>
     </servico>
  </servicos>
</logistica>

Mensagens de erros específicos

Código	Mensagem
82	Serviço de logística invalido.
87	Não foi possível obter a integração logística
88	Transportadora não encontrada
89	Descrição logística invalida
90	Alias inválido
91	Servico nao encontrado

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": {
        "logisticas": [
            {
                "id_logistica": "1",
                "descricao": "logistica 1",
                "servicos": [
                    {
                       "servico": {
                       "id_servico": "12345678",
                       "descricao": "servico 1",
                       "frete_item": 0,
                       "est_entrega": 0,
                       "codigo": "",
                       "aliases": [
                          {
                              "alias": "serv1"
                           }
                       ],
                       "id_transportadora": "123456"
                    }
                },
            {
                       "servico": {
                       "id_servico": "123457",
                       "descricao": "servico 2",
                       "frete_item": 2,
                       "est_entrega": 2,
                       "codigo": "",
                       "id_transportadora": "123456"
                    }
                }
            ]
         }
      ]
   }
}