A API V3 JÁ ESTÁ DISPONÍVEL
|
Busca todos os contatos
Recupera todos os contatos cadastrados no sistema.
curl |
curl -X GET "https://bling.com.br/Api/v2/contatos/json/" |
PHP |
$apikey = "{apikey}"; |
C# |
public static void ExecuteGetContacts() { var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/contatos/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 |
dataInclusao |
Filtra pela data de inclusão do contato no intervalo especificado | date (dd/mm/YYYY) | TO |
dataAlteracao |
Filtra pela data de alteração do contato no intervalo especificado | date (dd/mm/YYYY) |
TO
|
tipoPessoa |
Filtra pelo tipo de pessoa do contato. | F, J ou E |
|
curl -X GET "https://bling.com.br/Api/v2/contatos/json/"
-G
-d "filters=dataInclusao[12/12/2013 TO 05/02/2014]; dataAlteracao[12/12/2013 TO 05/02/2014]"
-d "apikey={apikey}"
Tipos de pessoa
Sigla | Descrição |
F | Pessoa Física |
J | Pessoa Jurídica |
E | Estrangeiro |
Retorno
Em caso de sucesso, retornará todos os contatos 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).
{ "retorno": { "contatos": [ { "contato": { "id": "5312341", "nome": "Nome do contato", "fantasia": "Contato Corp", "tipoPessoa": "", "contribuinte": "2", "cpf_cnpj": "11.111.111/1111-11", "ie_rg": "146849932111", "endereco": "Rua João Moura Teste", "numero": "1251", "complemento": null, "bairro": "Pinheiros", "cep": "05.412-001", "cidade": "São Paulo", "uf": "SP", "fone": "(11) 999999999", "email": "contato@teste.com", "limiteCredito": "0.00" } } ] } }