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

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

Insere uma logística personalizada

Insere uma logística personalizada no sistema.

curl

curl -X POST "https://bling.com.br/Api/v2/logistica/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 executePost($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 => 'POST'
   ]);
   $response = curl_exec($curlHandle);
   if ($errorNumber = curl_errno($curlHandle)) {
       $response = 'cURL error (' . $errorNumber . '): ' . curl_strerror($errorNumber);
   }
   curl_close($curlHandle);
   return $response;
}
echo executePost('logistica/servicos', 'json', [
  'apikey' => '{apikey}',
  'xml' => '{xml}'
]);

C#

public static void ExecuteSendTracking() {
   HttpWebRequest request = (HttpWebRequest)WebRequest.Create("https://bling.com.br/Api/v2/logistica/servicos/json");
   ASCIIEncoding encoding = new ASCIIEncoding();
   string postData = "apikey={apiKey}&xml={xml}";
   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 da logística	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	tipo_integracao	Identificador da logística homologada	STRING		Opcional
logistica	descricao	Descrição da logística	STRING		Obrigatório
logistica	servicos	Grupo de serviços logísticos			Opcional
servicos	servico	Serviços logísticos			Opcional	1
servico	descricao	Descrição do serviço logístico	STRING		Obrigatório
servico	frete_item	Valor do frete para o item	DECIMAL		Opcional
servico	est_entrega	Estimativa de entrega em dias	INTEGER		Opcional
servico	codigo	Código do serviço	STRING		Opcional
servico	id_transportadora	Id da transportadora obtida no método GET	INTEGER		Opcional	2
servico	aliases	Grupo de aliases			Opcional
aiases	alias	Alias para o serviço	STRING		Obrigatório

Notas:

Sempre irá incluir um novo serviço.
O id do contato obtido no método GET da API de contatos , com tipo de contato transportador, será o id_transportadora.
Lista de integrações disponíveis

ASAPLog
AWR
DLog
Sylog
Estoca
FindMyPack
FMTransportes
FreteRapido
GoFretes
IbexLogistica
CustomLogistic
MandaBem
MeusCorreios
Pier8
PrePostagem
SGPWeb
SHL
TrackCorreios
UxSolutions
VIPP

Exemplo de XML

<logistica>
   <descricao>Criacao</descricao>
   <tipo_logistica>CustomLogistic</tipo_logistica>
   <servicos>
       <servico>
           <descricao>criacao1</descricao>
           <frete_item>5</frete_item>
           <est_entrega>10</est_entrega>
           <aliases>
               <alias>cr1</alias>
               <alias>cr2</alias>
           </aliases>
       </servico>
       <servico>
           <descricao>criacao2</descricao>
           <frete_item>54</frete_item>
           <est_entrega>104</est_entrega>
       </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

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).

Exemplo de retorno

{
    "retorno": {
       "logisticas": [
          {
              "id_logistica": "12345",
              "descricao": "Criacao",
              "servicos": [
                  {
                     "servico": {
                         "id_servico": 2064107,
                         "descricao": "criacao1",
                         "frete_item": 5,
                         "est_entrega": 10,
                         "aliases": [
                             {
                                    "alias": "cr1"
                             },
                             {
                                    "alias": "cr2"
                             }
                        ],
                        "codigo": ""
                    }
               },
               {
                     "servico": {
                         "id_servico": 2064108,
                         "descricao": "criacao2",
                         "frete_item": 54,
                         "est_entrega": 104,
                         "codigo": ""
                    }
                }
             ]
          }
      ]
   }
}