{"_id":"5739f06f6c5ba134007a19a7","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":3,"version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":18,"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"],"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":"","githubsync":"","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"}

getLista de cotizaciones

Endpoint que permite consultar las cotizaciones registradas en la aplicación

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

start:
integer0
Desde cual cotización se quiere consultar. Por ejemplo para consultar desde la cotización 20, se envía start=20.
limit:
integer30
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.
order_direction:
stringASC
Orden ascendente o descendente en el cual se quieren retornar las cotizaciones. Opciones disponibles son DESC o ASC. Por defecto es ASC (ascendente).
order_field:
stringdate
Campo por el cual se desea ordenar, las opciones posibles son id, name, date, dueDate,
metadata:
boolean
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.

Examples


Result Format


Documentation

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. [block:callout] { "type": "warning", "title": "Atenció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```" } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}