{"_id":"5739f06f6c5ba134007a19a7","githubsync":"","user":"56abd213d4432d1900eed227","category":{"_id":"5739ed9aad40e23200f674b6","__v":0,"version":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-05-16T15:56:10.484Z","from_sync":false,"order":4,"slug":"cotizaciones","title":"Cotizaciones"},"parentDoc":null,"project":"56abd2434e4b730d009eb10a","__v":4,"version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":28,"createdAt":"2016-01-29T20:57:39.712Z","releaseDate":"2016-01-29T20:57:39.712Z","categories":["56abd2444e4b730d009eb10e","56abd4c8f25f160d00e17f81","56abd72ff25f160d00e17f84","56b3b8ea9f97020d0012d936","56b3b91ac25dea2b00b0cac9","56b4b2faeed075230097d688","56b4b32deed075230097d689","56b4b37327d9c00d005d6bc4","56b4b3bf3d5f130d00dad120","56b4b3d9eed075230097d68a","56b4b3eb7bccae0d00e9a12e","56b4b4085997532100bc6b61","56fbce6e2885e80e006c855f","5739ed9aad40e23200f674b6","573dd672b3f88f0e00dcae1c","58ad0922e570c62500512a82","58ad092b55018f1900218fda","58e412a5aa544d1b0005f7da","59e62c2a3ccab100263e800a","59e63126b4f8b0002edbe92c","5b5bbc98eaf71700031c2fda","5bedb529a56934002ee522b9","5c3e39454d3006001420f73e","5c4f5c0e1555130014796daa","5c6ac741acb04f003f927fa7","5c7e9c7c412d4c003f750162","5d055915910ab30020e5bc06","5d76e2018e0ce7006c82dbe1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"editedParams2":true,"editedParams":true,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-16T16:08:15.182Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"method":"get","results":{"codes":[{"name":"Ejemplo consulta exitosa","status":200,"code":"[\n  {\n    \"id\": \"8\",\n    \"number\" : \"8\",\n    \"date\": \"2016-05-16\",\n    \"dueDate\": \"2016-06-15\",\n    \"observations\": \"\",\n    \"anotation\": \"\",\n    \"seller\": null,\n    \"priceList\" : null,\n    \"client\": {\n      \"id\": \"1\",\n      \"name\": \"Mi contacto\",\n      \"identification\": \"12345678\",\n      \"phonePrimary\": \"384596546\",\n      \"phoneSecondary\": \"96875146\",\n      \"fax\": \"\",\n      \"mobile\": \"\",\n      \"email\": \"\",\n      \"address\": {\n        \"address\": \"\",\n        \"city\": \"\"\n      }\n    },\n    \"total\": 1720400,\n    \"items\": [\n      {\n        \"id\": 2,\n        \"name\": \"Consultoría\",\n        \"description\": \"Consultoría mes de Mayo\",\n        \"price\": 500000,\n        \"discount\": \"0.00\",\n        \"reference\": \"\",\n        \"quantity\": \"3.00\",\n        \"tax\" : [],\n        \"total\": 1500000\n      },\n      {\n        \"id\": 1,\n        \"name\": \"Servicio\",\n        \"description\": null,\n        \"price\": 95000,\n        \"discount\": \"0.00\",\n        \"reference\": \"852\",\n        \"quantity\": \"2.00\",\n        \"tax\": [\n          {\n          \"id\": \"3\",\n          \"name\": \"IVA\",\n          \"percentage\": \"16.00\",\n          \"description\": \"\",\n          \"type\": \"IVA\",\n          \"status\" : \"active\"\n            }\n          ],\n        \"total\": 220400\n      }\n    ]\n  },\n  {\n    \"id\": \"9\",\n    \"number\" : \"15\",\n    \"date\": \"2016-05-16\",\n    \"dueDate\": \"2016-06-15\",\n    \"observations\": \"Observaciones\",\n    \"anotation\": \"Notas de mi cotización\",\n    \"client\": {\n       \"id\": 2,\n        \"name\": \"Acrecer\",\n        \"identification\": \"963.654.988\",\n        \"email\": \"prueba2:::at:::alegra.com\",\n        \"phonePrimary\": \"111 11 11\",\n        \"phoneSecondary\": \"\",\n        \"fax\": \"\",\n        \"mobile\": \"(333) 555-55-55\",\n        \"observations\": \"\",\n        \"address\": {\n            \"address\": \"Avenida Madison\",\n            \"city\": \"New York, USA\"\n      }\n    },\n    \"total\": 610200,\n    \"seller\": {\n      \"id\": \"6\",\n      \"name\": \"Alejandro\",\n      \"identification\": \"1958-985\",\n      \"observations\": \"Vendedor del almacén del sur\"\n    },\n    \"priceList\" : null,\n    \"currency\": {\n      \"code\" : \"USD\",\n      \"symbol\" : \"$\",\n      \"exchangeRate\" : 2950\n    },\n    \"items\": [\n      {\n        \"id\": 2,\n        \"name\": \"Servicio\",\n        \"description\": \"\",\n        \"price\": 500000,\n        \"discount\": \"0.00\",\n        \"reference\": \"\",\n        \"quantity\": \"1.00\",\n        \"tax\" : [],\n        \"total\": 500000\n      },\n      {\n        \"id\": 1,\n        \"name\": \"Termo negro\",\n        \"description\": \"Termo para agua \",\n        \"price\": 95000,\n        \"discount\": \"0.00\",\n        \"reference\": \"852\",\n        \"quantity\": \"1.00\",\n        \"tax\": [\n          {\n          \"id\": \"3\",\n          \"name\": \"IVA\",\n          \"percentage\": \"16.00\",\n          \"description\": \"\",\n          \"type\": \"IVA\",\n\t\t\t\t  \"status\" : \"active\"\n            }\n          ],\n        \"total\": 110200\n      }\n    ]\n  },\n  {\n    \"id\": \"10\",\n    \"number\" : \"10\",\n    \"date\": \"2016-05-16\",\n    \"dueDate\": \"2016-06-15\",\n    \"observations\": \"\",\n    \"anotation\": \"\",\n    \"client\": {\n      \"id\": \"1\",\n      \"name\": \"Mi contacto\",\n      \"identification\": \"12345678\",\n      \"phonePrimary\": \"384596546\",\n      \"phoneSecondary\": \"96875146\",\n      \"fax\": \"345454\",\n      \"mobile\": \"12345678\",\n      \"email\": \"email@correo.com\",\n      \"address\": {\n        \"address\": \"Mi casa\",\n        \"city\": \"Mi ciudad\"\n      }\n    },\n    \"total\": 610200,\n    \"seller\" : null,\n    \"priceList\" : null,\n    \"items\": [\n      {\n        \"id\": 2,\n        \"name\": \"Servicio\",\n        \"description\": \"\",\n        \"price\": 500000,\n        \"discount\": \"0.00\",\n        \"reference\": \"\",\n        \"quantity\": \"1.00\",\n        \"tax\": [],\n        \"total\": 500000\n      },\n      {\n        \"id\": 1,\n        \"name\": \"Termo negro\",\n        \"description\": \"Termo para agua \",\n        \"price\": 95000,\n        \"discount\": \"0.00\",\n        \"reference\": \"852\",\n        \"quantity\": \"1.00\",\n        \"tax\": [\n          {\n          \"id\": \"3\",\n          \"name\": \"IVA\",\n          \"percentage\": \"16.00\",\n          \"description\": \"\",\n          \"type\": \"IVA\",\n\t\t\t\t  \"status\" : \"active\"\n            }\n          ],\n        \"total\": 110200\n      }\n    ]\n  }\n ]","language":"json"},{"name":"Bad Request - Límite sobrepasa máximo permitido","status":400,"language":"json","code":"{ \n\t\"error\": \"El límite de cotizaciones para retornar debe ser menor o igual a 30\",\n\t\"code\" : 903\n}"},{"name":"Consulta exitosa con metadatos","code":"{\n  \"metadata\" : {\n    \"total\" : 15\n  },\n  \"data\" : [\n    [\n      {\n        \"id\": \"8\",\n        \"date\": \"2016-05-16\",\n        \"dueDate\": \"2016-06-15\",\n        \"observations\": \"\",\n        \"anotation\": \"\",\n        \"client\": {\n          \"id\": \"1\",\n          \"name\": \"Mi contacto\",\n          \"identification\": \"12345678\",\n          \"phonePrimary\": \"384596546\",\n     \t\t  \"phoneSecondary\": \"96875146\",\n\t\t      \"fax\": \"\",\n    \t\t  \"mobile\": \"\",\n\t\t      \"email\": \"\",\n\t\t      \"address\": {\n            \"address\": \"\",\n            \"city\": \"\"\n          }\n        },\n        \"total\": 1720400,\n        \"seller\": null,\n        \"priceList\" : null,\n        \"items\": [\n          {\n            \"id\": 2,\n            \"name\": \"Consultoría\",\n            \"description\": \"Consultoría mes de Mayo\",\n            \"price\": 500000,\n            \"discount\": \"0.00\",\n            \"reference\": \"\",\n            \"quantity\": \"3.00\",\n            \"total\": 1500000,\n            \"tax\" : []\n            },\n          {\n            \"id\": 1,\n            \"name\": \"Servicio\",\n            \"description\": null,\n            \"price\": 95000,\n            \"discount\": \"0.00\",\n            \"reference\": \"852\",\n            \"quantity\": \"2.00\",\n            \"tax\": [\n              {\n                \"id\": \"3\",\n                \"name\": \"IVA\",\n                \"percentage\": \"16.00\",\n                \"description\": \"\",\n                \"type\": \"IVA\",\n                \"status\" : \"active\"\n                }\n              ],\n            \"total\": 220400\n            }\n          ]\n      },\n      {\n        \"id\": \"9\",\n        \"date\": \"2016-05-16\",\n        \"dueDate\": \"2016-06-15\",\n        \"observations\": \"Observaciones\",\n        \"anotation\": \"Notas de mi cotización\",\n        \"client\": {\n          \"id\": 2,\n          \"name\": \"Acrecer\",\n          \"identification\": \"963.654.988\",\n          \"email\": \"prueba2@alegra.com\",\n          \"phonePrimary\": \"111 11 11\",\n          \"phoneSecondary\": \"\",\n          \"fax\": \"\",\n          \"mobile\": \"(333) 555-55-55\",\n          \"observations\": \"\",\n          \"address\": {\n            \"address\": \"Avenida Madison\",\n            \"city\": \"New York, USA\"\n            }\n          },\n        \"total\": 610200,\n        \"seller\": {\n          \"id\": \"6\",\n          \"name\": \"Alejandro\",\n          \"identification\": \"1958-985\",\n          \"observations\": \"Vendedor del almacén del sur\"\n          },\n        \"priceList\" : null,\n        \"items\": [\n          {\n            \"id\": 2,\n            \"name\": \"Servicio\",\n            \"description\": \"\",\n            \"price\": 500000,\n            \"discount\": \"0.00\",\n            \"reference\": \"\",\n            \"quantity\": \"1.00\",\n            \"tax\" : [],\n            \"total\": 500000\n            },\n          {\n            \"id\": 1,\n            \"name\": \"Termo negro\",\n            \"description\": \"Termo para agua \",\n            \"price\": 95000,\n            \"discount\": \"0.00\",\n            \"reference\": \"852\",\n            \"quantity\": \"1.00\",\n            \"tax\": [\n              {\n                \"id\": \"3\",\n                \"name\": \"IVA\",\n                \"percentage\": \"16.00\",\n                \"description\": \"\",\n                \"type\": \"IVA\",\n                \"status\" : \"active\"\n                }\n              ],\n            \"total\": 110200\n            }\n          ]\n        },\n      {\n        \n        \"id\": \"10\",\n        \"date\": \"2016-05-16\",\n        \"dueDate\": \"2016-06-15\",\n        \"observations\": \"\",\n        \"anotation\": \"\",\n        \"client\": {\n          \"id\": \"1\",\n          \"name\": \"Mi contacto\",\n          \"identification\": \"12345678\",\n          \"phonePrimary\": \"384596546\",\n          \"phoneSecondary\": \"96875146\",\n          \"fax\": \"345454\",\n          \"mobile\": \"12345678\",\n          \"email\": \"email@correo.com\",\n          \"address\": {\n            \"address\": \"Mi casa\",\n            \"city\": \"Mi ciudad\"\n            }\n          },\n        \"total\": 610200,\n        \"seller\": null,\n        \"priceList\" : null,\n        \"items\": [\n          {\n            \"id\": 2,\n            \"name\": \"Servicio\",\n            \"description\": \"\",\n            \"price\": 500000,\n            \"discount\": \"0.00\",\n            \"reference\": \"\",\n            \"quantity\": \"1.00\",\n            \"tax\" : [],\n            \"total\": 500000\n            },\n          {\n            \"id\": 1,\n            \"name\": \"Termo negro\",\n            \"description\": \"Termo para agua \",\n            \"price\": 95000,\n            \"discount\": \"0.00\",\n            \"reference\": \"852\",\n            \"quantity\": \"1.00\",\n            \"tax\": [\n              {\n                \"id\": \"3\",\n                \"name\": \"IVA\",\n                \"percentage\": \"16.00\",\n                \"description\": \"\",\n                \"type\": \"IVA\",\n                \"status\" : \"active\"\n                }\n              ],\n            \"total\": 110200\n            }\n          ]\n        }\n      ]\n    ]\n}","language":"json","status":200}]},"settings":"","examples":{"codes":[{"code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X GET  https://app.alegra.com/api/v1/estimates/ -u 'usuario@alegra.co:mitoken'","language":"curl"}]},"auth":"required","params":[{"_id":"56afd9393c70b01700facf25","ref":"","in":"query","required":false,"desc":"Desde cual cotización se quiere consultar. Por ejemplo para consultar desde la cotización 20, se envía start=20.","default":"0","type":"int","name":"start"},{"_id":"56b0b7da36d2580d002477d7","ref":"","in":"query","required":false,"desc":"Cantidad de cotizaciones a partir del inicio que se desea retornar.  Por defecto retorna 30 cotizaciones. Si este valor es mayor que 30, la aplicación retorna error.","default":"30","type":"int","name":"limit"},{"_id":"56b0b7da36d2580d002477d6","ref":"","in":"query","required":false,"desc":"Orden ascendente o descendente en el cual se quieren retornar las cotizaciones.  Opciones disponibles son DESC o ASC.  Por defecto es ASC (ascendente).","default":"ASC","type":"string","name":"order_direction"},{"_id":"56b0b7da36d2580d002477d5","ref":"","in":"query","required":false,"desc":"Campo por el cual se desea ordenar, las opciones posibles son id, name, date, dueDate.","default":"date","type":"string","name":"order_field"},{"_id":"5739f140b94be63400a28ea0","ref":"","in":"query","required":false,"desc":"Incluir en los resultados metadatos. Se debe tener en cuenta que si se envía este parámetro el objeto que retorna la aplicación incluye un atributo \"metadata\" y otro \"data\" en donde se envían las cotizaciones.  Actualmente la información que se envía en metadata incluye el total de cotizaciones que tiene registrada la empresa.","default":"","type":"boolean","name":"metadata"}],"url":"/estimates/"},"isReference":true,"order":1,"body":"Endpoint que retorna las cotizaciones registradas en la cuenta de Alegra. Si no se envía límite de cotizaciones, por defecto se envían 30 cotizaciones.  \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Atención\",\n  \"body\": \"Se debe tener en cuenta que el valor máximo para el atributo limit es 30, si se supera ese valor la aplicación retorna el código de error:\\n```\\n{\\n  \\\"code\\\": 903,\\n  \\\"message\\\" : \\\"El límite debe ser menor o igual a 30\\\"\\n}\\n```\"\n}\n[/block]","excerpt":"Endpoint que permite consultar las cotizaciones registradas en la aplicación","slug":"lista-de-cotizaciones","type":"endpoint","title":"Lista de cotizaciones"}