A API V3 JÁ ESTÁ DISPONÍVEL
As integrações API v2 que já estão configuradas, seguirão funcionando temporariamente. |
Busca uma conta a receber
Busca uma conta a receber a partir do seu ID
. Para mais informações, vide exemplo de retorno abaixo.
curl |
curl -X GET "https://bling.com.br/b/Api/v2/contareceber/{id}/json/" |
PHP |
$apikey = "{apikey}"; $orderNumber = 12; $outputType = "json"; $url = 'https://bling.com.br/Api/v2/contareceber/' . $orderNumber . '/' . $outputType; $retorno = executeGetOrder($url, $apikey); echo $retorno; function executeGetOrder($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 ExecuteGetOrder() { var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/contareceber/{id}/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 |
apikey gerada no sistema | string |
Retorno
Em caso de sucesso, retornará a conta a receber solicitada, 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":{ "contasreceber":[ { "contareceber":{ "id":"13123121",
"situacao": "aberto", "dataEmissao":"2017-03-09", "vencimentoOriginal":"2017-03-09", "vencimento":"2017-03-09",
"competencia":"2017-03-01". "nroDocumento":"0123456", "valor":15.00, "saldo":0.00, "historico":"Referente ao pedido de venda nº 423", "categoria":"Vendas", "idFormaPagamento": "123", "portador":"CEF", "nroNoBanco":"00100358-56", "vendedor":"Vendedor exemplo", "pagamento": { "totalPago": 15.00, "totalJuro": 0, "totalDesconto": 0, "totalAcrescimo": 0, "totalTarifa": 0, "data": "2017-03-09" }, "ocorrencia":"Unica", "linkBoleto":"https://www.bling.com.br/doc.view.php?132", "cliente":{ "nome":"Organisys Software", "cpf_cnpj":"00.000.000/0000-1", "tipoPessoa":"J", "ie_rg":"0000000000", "endereco":"Rua Barão do Rio Branco", "numero":"000", "complemento":"Sala 000", "cidade":"Bento Gonçalves", "bairro":"Centro", "cep":"00.000-000", "uf":"RS", "email":"teste@organisys.com.br" } } } ] } }