A API V3 JÁ ESTÁ DISPONÍVEL
|
Busca todas as propostas comerciais
Recupera todas as propostas comerciais cadastradas no sistema. Para mais informações, vide exemplo de retorno abaixo.
curl |
curl -X GET "https://bling.com.br/Api/v2/propostascomerciais/json/" |
PHP |
$apikey = "{apikey}"; |
C# |
public static void ExecuteGetOrder() { var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/propostascomerciais/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 |
Situações
Descrição |
Pendente |
Aguardando |
Não aprovado |
Aprovado |
Concluído |
Rascunho |
Filtros
Pode-se utilizar filtros para restringir o retorno de dados. Observe a tabela de possíveis filtros abaixo.
Filtro | Descrição | Tipo | Predicate |
data |
Filtra por data da proposta comercial no intervalo especificado | date (dd/mm/YYYY) | TO |
situacao |
Filtra pela situação da proposta | situacao(conforme as situações validas da proposta) | |
idContato |
Filtra pelo id do contato | integer |
curl -X GET "https://bling.com.br/Api/v2/propostascomerciais/json/"
-G
-d "filters=data[13/01/2018 TO 14/01/2018]; idContato[000001]"
-d "apikey={apikey}"
Retorno
Em caso de sucesso, retornará todas as propostas registradas, 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": { "propostascomerciais": [ { "propostacomercial": { "desconto": "10", "observacaoInterna": "", "dataEmissao": "2019-01-10", "dataProximoContato": "2019-02-15", "numeroProposta": "1", "vendedor": "Jose", "valorFrete": "50.00", "subtotal": "5005.00", "totalOrcamento": "5045.00", "situacao": "Rascunho", "loja": "000000", "aosCuidadosDe": "", "garantia": "10", "validadeDaProposta": "15", "observacao": "Testando", "prazoEntrega": "5", "assinaturaSaudacao": "Atenciosamente,", "assinaturaResponsavel": "Departamento de vendas", "cliente": { "idContato": "00000000", "nome": "Organisys Software", "cpfCnpj": "00.000.000/0000-1", "ie": "", "rg": "", "endereco": "Rua Visconde de São Gabriel", "numero": "000", "complemento": "Sala 03", "cidade": "Bento Gonçalves", "bairro": "Cidade Alta", "cep": "95.700-000", "uf": "RS", "email": "teste@organisys.com.br", "celular": "(00) 00000-0000", "fone": "(00) 0000-0000" }, "itens": [ { "item": { "codigo": "01", "descricao": "teste", "quantidade": "5.0000", "valorUnidade": "1.0000000000", "precoLista": "0.0000000000", "descontoItem": "0.00", "un": "un" } }, { "item": { "codigo": "02", "descricao": "teste2", "quantidade": "100.0000", "valorUnidade": "50.0000000000", "precoLista": "0.0000000000", "descontoItem": "0.00", "un": "pc" } } ], "parcelas": [ { "parcela": { "valor": "90.00", "nrDias": 50, "obs": "Teste obs 1", "formaPagamento": { "id": 0001, "descricao": "Dinheiro", "codigoFiscal": 1 } } }, { "parcela": { "valor": "5000.00", "nrDias": 100, "obs": "Teste obs 2", "formaPagamento": { "id": 0002, "descricao": "Debito", "codigoFiscal": 3 } } } ], "transporte": { "transportadora": "Transportadora XYZ", "tipoFrete": "S", "qtdVolumes": "50", "pesoBruto": "5.000" } } } ] } }