×
Entrar
Experimente grátis
Top

GET /pedidoscompra

  • 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 todos os pedidos de compras

Recupera todos os pedidos de compras cadastrados no sistema. Para mais informações, vide exemplo de retorno abaixo.

curl    

 
curl -X GET "https://bling.com.br/Api/v2/pedidoscompra/json/"
     -G
     -d "apikey={apikey}"

PHP

 
$apikey = "{apikey}";
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/pedidoscompra/' . $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/pedidoscompra/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    

 

Filtros

Pode-se utilizar filtros para restringir o retorno de dados. Observe a tabela de possíveis filtros abaixo.

Filtro Descrição Tipo Predicate Nota
dataEmissao    Filtra por data de emissão do pedido de  compra no intervalo especificado                   date (dd/mm/YYYY) TO  
idSituacao Filtra pelo id da situação do pedido de compra (obtidas no GET de situações por módulo) integer    
situacao Filtra pelo id da situação do pedido de compra integer   8
 
curl -X GET "https://bling.com.br/Api/v2/pedidoscompra/json/"
     -G
     -d "filters=dataEmissao[01/07/2019 TO 01/08/2019]; situacao[3]"
     -d "apikey={apikey}"

 

Retorno

Em caso de sucesso, retornará todos os pedidos de compras registrados, 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": {
         "pedidoscompra": [
             [
                 {
                     "pedidocompra": {
                         "numeropedido": "1",
                         "datacompra": "2019-07-31",
                         "dataprevista": "",
                         "ordemcompra": "",
                         "desconto": "0",
                         "observacoes": "",
                         "observacaointerna": "Uma observação qualquer",
                         "fornecedor": {
                             "id": "1234567890",
                             "nome": "Fornecedor teste 1",
                             "tipopessoa": "F",
                             "cpfcnpj": "",
                             "ie": "",
                             "rg": "",
                             "contribuinte": "9",
                             "endereco": "Rua Marques de Souza 1024",
                             "endereconro": "",
                             "complemento": "",
                             "bairro": "São Francisco",
                             "cep": "95.703-012",
                             "cidade": "Bento Gonçalves",
                             "uf": "RS",
                             "fone": "(54) 2222-2222",
                             "celular": "(54) 92222-2222",
                             "email": "testeemail2019@gmail.com"
                         },
                         "itens": [
                             {
                                 "item": {
                                     "codigo": "123456",
                                     "codigofornecedor": "654321",
                                     "descricao": "produto 1",
                                     "un": "UN",
                                     "qtde": 1,
                                     "valor": 12.50
                                 }
                             },
                             {
                                 "item": {
                                     "codigo": "223456",
                                     "codigofornecedor": "223456",
                                     "descricao": "produto 2",
                                     "un": "",
                                     "qtde": 3,
                                     "valor": 12.50
                                 }
                              }
                           ],
                           "parcelas": [
                               {
                                   "parcela": {
                                       "idLancamento": "1234",
                                        "nrodias": "30",
                                        "valor": 25,
                                        "dataVencimento": "12/09/2019",
                                        "obs": "",
                                        "forma_pagamento":      {
                                             "id": "123",
                                             "descricao": "Boleto Bradesco",
                                             "codigoFiscal": "15"
                                         }
                                    }
                               }
                           ],
                           "transporte": {
                               "transportador": "",
                               "freteporconta": "R",
                               "qtdvolumes": "0",
                               "frete": 0
                           }
                           "categoria": {
                               "id": "6423776723",
                               "descricao": "Salários"
                            }
                       }
                  }
             ]
        ]
    }
}

 

 

Artigos relacionados