×
Entrar
Experimente grátis
Top

GET /situacao/{módulo}

  • 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

 

Busca as situações a partir do seu módulo.

curl        
curl
 curl -X GET "https://bling.com.br/Api/v2/situacao/{módulo}/json/"
      -G
      -d "apikey={apikey}"
PHP 
$apikey = "{apikey}";
$modulo = "{módulo}";
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/situacao/' . $modulo . '/' . $outputType;
$retorno = executeGetContact($url, $apikey);
echo $retorno;
function executeGetContact($url, $apikey){
  $curl_handle = curl_init();
  curl_setopt($curl_handle, CURLOPT_URL, $url . '&apikey=' . $apikey);
  curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, TRUE);
  $response = curl_exec($curl_handle);
  curl_close($curl_handle);
  return $response;
}
C# 
public static void ExecuteGetSituacao() {
   var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/situacao/Vendas/json&apikey={apikey}");
   request.ContentType = "application/json";
   request.Method = "GET";
   using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)
   {
      if (response.StatusCode != HttpStatusCode.OK)
         Console.Out.WriteLine("Error. Server returned status code: {0}", response.StatusCode);
      using (StreamReader reader = new StreamReader(response.GetResponseStream()))
     {
          var content = reader.ReadToEnd();
          if(string.IsNullOrWhiteSpace(content))
               Console.Out.WriteLine("Empty Response");
          else
               Console.Out.WriteLine("Response Body: \r\n {0}", content);
       }
    }
}
 
Parâmetro   Descrição Tipo
apikey API key gerada no sistema. string
módulo Módulo das situações que você deseja consultar. Utilizar o nome exibido na tabela de módulos. string

 


Tabela de módulos

Nome Módulo
Vendas Pedidos de Venda
PedidosCompra       Pedidos de Compra      
OrdemServico Ordem de Serviço

 

Retorno

Em caso de sucesso, retornará as situações do módulo especificado, 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:

{
     "retorno": {
        "situacoes": [
            {
                "situacao": {
                     "id": "6",
                     "idHerdado": "0",
                     "nome": "Em aberto",
                     "cor": "#E9DC40"
                  }
            },
            {
                "situacao": {
                     "id": "9",
                     "idHerdado": "0",
                     "nome": "Atendido",
                     "cor": "#3FB57A"
                  }
            },
            {
                "situacao": {
                     "id": "12",
                     "idHerdado": "0",
                     "nome": "Cancelado",
                     "cor": "#CBCBCB"
                  }
            },
            {
                "situacao": {
                     "id": "15",
                     "idHerdado": "0",
                     "nome": "Em andamento",
                     "cor": "#0065F9"
                  }
            },
            {
                "situacao": {
                     "id": "18",
                     "idHerdado": "0",
                     "nome": "Venda Agenciada",
                     "cor": "#FF7835"
                  }
            },
            {
                "situacao": {
                     "id": "21",
                     "idHerdado": "0",
                     "nome": "Em digitação",
                     "cor": "#FF66E3"
                  }
            },
            {
                "situacao": {
                     "id": "24",
                     "idHerdado": "0",
                     "nome": "Verificado",
                     "cor": "#85F39E"
                  }
             }
         ]
     }
}

 

Artigos relacionados