{"_id":"5739edbe6c5ba134007a199f","__v":11,"parentDoc":null,"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"},"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"},"project":"56abd2434e4b730d009eb10a","user":"56abd213d4432d1900eed227","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-16T15:56:46.064Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"Las cotizaciones son un documento informativo que se emite a los clientes para indicarles el precio al cual se venden los productos y servicios. \n\nLas cotizaciones en Alegra deben estar asociadas a un contacto y deben contener mínimo un producto o servicio.\n\nUna cotización contiene los siguientes atributos:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Nombre\",\n    \"h-1\": \"Tipo\",\n    \"h-2\": \"Descripción\",\n    \"0-0\": \"id\",\n    \"0-1\": \"Integer\",\n    \"0-2\": \"Identificador único que representa una cotización específica. La aplicación lo asigna automáticamente.\",\n    \"1-0\": \"date\",\n    \"1-1\": \"String.  Formato yyyy-MM-dd\",\n    \"1-2\": \"Fecha de la cotización.\",\n    \"2-0\": \"dueDate\",\n    \"2-1\": \"String.  Formato yyyy-MM-dd\",\n    \"2-2\": \"Fecha de vencimiento de la cotización.\",\n    \"4-0\": \"observations\",\n    \"4-1\": \"String\",\n    \"4-2\": \"Observaciones de la cotización. No visibles en el documento impreso o PDF.\",\n    \"5-0\": \"anotation\",\n    \"5-2\": \"Notas de la cotización, visibles en el documento impreso o PDF.\",\n    \"5-1\": \"String\",\n    \"6-0\": \"client\",\n    \"6-2\": \"Objeto que contiene la información del cliente asociado a la cotización.\",\n    \"6-1\": \"Object\",\n    \"7-0\": \"number\",\n    \"8-0\": \"total\",\n    \"7-2\": \"Número de la cotización\",\n    \"8-2\": \"Total de la cotización. Se debe tener en cuenta que el total de la cotización es calculado según la precisión decimal que tenga configurada la empresa al momento de crear la cotización.\",\n    \"8-1\": \"Double\",\n    \"7-1\": \"Integer\",\n    \"9-0\": \"items\",\n    \"9-1\": \"Array\",\n    \"9-2\": \"Array de objetos Item, que contiene los productos o servicios asociados a cotización.\\nCada objeto contiene los siguientes atributos:\\n* id: Identificador del producto o servicio vendido. \\n* name: Nombre del producto o servicio.\\n* description: Descripción del producto o servicio.\\n* reference: Referencia del producto o servicio\\n* discount: Porcentaje de descuento aplicado al producto.\\n* tax: Array de objetos tax que indican los impuestos aplicados al producto o servicio al momento de la venta.\\n* price: Precio de venta del producto o servicio.\\n* quantity: Cantidad vendida del producto o servicio.\\n* total: Total del producto (no incluye impuestos).\",\n    \"10-0\": \"seller\",\n    \"10-1\": \"Object\",\n    \"10-2\": \"Objeto que indica el vendedor asociado a la cotización. Éste contiene los siguientes atributos:\\n* id: Identificador del vendedor.\\n* name : Nombre del vendedor.\\n* identification: Identificación (Nit, RFC, cédula, etc) del vendedor.\\n* observations: Observaciones del vendedor.\",\n    \"h-3\": \"Ejemplo\",\n    \"0-3\": \"15\",\n    \"1-3\": \"2016-02-27\",\n    \"2-3\": \"2016-03-27\",\n    \"4-3\": \"Estas son las observaciones de la cotización.\",\n    \"5-3\": \"La cotización tiene validez por dos meses después de emitida.\",\n    \"6-3\": \"```\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Coorporación Alegrate\\\",                        \\\"identification\\\": \\\"159.549.847\\\",\\n\\\"email\\\": \\\"prueba:::at:::alegra.com\\\",                      \\\"phonePrimary\\\": \\\"999-99-99\\\",\\n\\\"phoneSecondary\\\": \\\"\\\",\\n\\\"fax\\\": \\\"\\\",\\n\\\"mobile\\\": \\\"(333) 555-55-55\\\",\\n\\\"address\\\" : {\\n   \\\"address\\\" : \\\"Calle principal #45\\\",\\n    \\\"city\\\" : \\\"Barcelona\\\"\\n  }\\n}\\n```\",\n    \"7-3\": \"150\",\n    \"8-3\": \"12500.45\",\n    \"9-3\": \"```\\n[\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Billetera\\\",\\n\\\"description\\\": \\\"Billetera de cuero negro\\\",\\n\\\"reference\\\": \\\"REF-005\\\",\\n\\\"discount\\\" : 10,\\n\\\"tax\\\" : [\\n{\\n\\\"id\\\" : 6,\\n\\\"name\\\" : \\\"IVA\\\",\\n\\\"percentage\\\" : 16,\\n\\\"description\\\" : \\\"Impuesto de valor agregado\\\",\\n\\\"type\\\": \\\"IVA\\\",\\n\\\"status\\\" : \\\"active\\\"\\n}\\n],\\n\\\"price\\\" : 80,\\n\\\"quantity\\\" : 5\\n},\\n\\\"total\\\" : 360\\n]\\n```\",\n    \"10-3\": \"```\\n{\\n\\\"id\\\" : \\\"12\\\",\\n\\\"name\\\" : \\\"Diana Giraldo\\\",\\n\\\"identification\\\" : \\\"520.526.21\\\",\\n\\\"observations\\\" : \\\"Líder de Ventas\\\"\\n}\\n```\",\n    \"11-0\": \"priceList\",\n    \"11-1\": \"Object\",\n    \"11-2\": \"Objeto PriceList que indica la lista de precios asociada a la cotización. Ésta contiene los siguientes atributos:\\n* id: Identificador de la lista de precios.\\n* name: Nombre de la lista de precios.\",\n    \"11-3\": \"```\\n{\\n\\\"id\\\" : 5,\\n\\\"name\\\" : \\\"Distribuidor\\\"\\n}\\n```\",\n    \"12-0\": \"currency\",\n    \"12-1\": \"Object\",\n    \"12-2\": \"Objeto que incluye la información de la moneda asociada a la cotización.\\n** Solo se incluye si la compañía tiene activo multimoneda y la cotización está en una moneda diferente de la principal de la cuenta.\\n**\\nEste objeto contiene:\\n* code : Código ISO de la moneda asociada a la empresa.\\n* exchangeRate: Tasa de cambio.\",\n    \"12-3\": \"```\\n{\\n\\\"code\\\" : \\\"USD\\\",\\n\\\"symbol\\\" : \\\"$\\\",\\n\\\"exchangeRate\\\" : 2950\\n}\\n```\",\n    \"3-0\": \"number\",\n    \"3-1\": \"String\",\n    \"3-2\": \"Número de la cotización. Lo asigna automáticamente la aplicación según la configuración de la empresa.\",\n    \"3-3\": \"15\"\n  },\n  \"cols\": 4,\n  \"rows\": 13\n}\n[/block]","excerpt":"Endpoint /estimates","slug":"cotizaciones","type":"basic","title":"Descripción general"}

Descripción general

Endpoint /estimates

Las cotizaciones son un documento informativo que se emite a los clientes para indicarles el precio al cual se venden los productos y servicios. Las cotizaciones en Alegra deben estar asociadas a un contacto y deben contener mínimo un producto o servicio. Una cotización contiene los siguientes atributos: [block:parameters] { "data": { "h-0": "Nombre", "h-1": "Tipo", "h-2": "Descripción", "0-0": "id", "0-1": "Integer", "0-2": "Identificador único que representa una cotización específica. La aplicación lo asigna automáticamente.", "1-0": "date", "1-1": "String. Formato yyyy-MM-dd", "1-2": "Fecha de la cotización.", "2-0": "dueDate", "2-1": "String. Formato yyyy-MM-dd", "2-2": "Fecha de vencimiento de la cotización.", "4-0": "observations", "4-1": "String", "4-2": "Observaciones de la cotización. No visibles en el documento impreso o PDF.", "5-0": "anotation", "5-2": "Notas de la cotización, visibles en el documento impreso o PDF.", "5-1": "String", "6-0": "client", "6-2": "Objeto que contiene la información del cliente asociado a la cotización.", "6-1": "Object", "7-0": "number", "8-0": "total", "7-2": "Número de la cotización", "8-2": "Total de la cotización. Se debe tener en cuenta que el total de la cotización es calculado según la precisión decimal que tenga configurada la empresa al momento de crear la cotización.", "8-1": "Double", "7-1": "Integer", "9-0": "items", "9-1": "Array", "9-2": "Array de objetos Item, que contiene los productos o servicios asociados a cotización.\nCada objeto contiene los siguientes atributos:\n* id: Identificador del producto o servicio vendido. \n* name: Nombre del producto o servicio.\n* description: Descripción del producto o servicio.\n* reference: Referencia del producto o servicio\n* discount: Porcentaje de descuento aplicado al producto.\n* tax: Array de objetos tax que indican los impuestos aplicados al producto o servicio al momento de la venta.\n* price: Precio de venta del producto o servicio.\n* quantity: Cantidad vendida del producto o servicio.\n* total: Total del producto (no incluye impuestos).", "10-0": "seller", "10-1": "Object", "10-2": "Objeto que indica el vendedor asociado a la cotización. Éste contiene los siguientes atributos:\n* id: Identificador del vendedor.\n* name : Nombre del vendedor.\n* identification: Identificación (Nit, RFC, cédula, etc) del vendedor.\n* observations: Observaciones del vendedor.", "h-3": "Ejemplo", "0-3": "15", "1-3": "2016-02-27", "2-3": "2016-03-27", "4-3": "Estas son las observaciones de la cotización.", "5-3": "La cotización tiene validez por dos meses después de emitida.", "6-3": "```\n{\n\"id\": 1,\n\"name\": \"Coorporación Alegrate\", \"identification\": \"159.549.847\",\n\"email\": \"prueba@alegra.com\", \"phonePrimary\": \"999-99-99\",\n\"phoneSecondary\": \"\",\n\"fax\": \"\",\n\"mobile\": \"(333) 555-55-55\",\n\"address\" : {\n \"address\" : \"Calle principal #45\",\n \"city\" : \"Barcelona\"\n }\n}\n```", "7-3": "150", "8-3": "12500.45", "9-3": "```\n[\n{\n\"id\": 1,\n\"name\": \"Billetera\",\n\"description\": \"Billetera de cuero negro\",\n\"reference\": \"REF-005\",\n\"discount\" : 10,\n\"tax\" : [\n{\n\"id\" : 6,\n\"name\" : \"IVA\",\n\"percentage\" : 16,\n\"description\" : \"Impuesto de valor agregado\",\n\"type\": \"IVA\",\n\"status\" : \"active\"\n}\n],\n\"price\" : 80,\n\"quantity\" : 5\n},\n\"total\" : 360\n]\n```", "10-3": "```\n{\n\"id\" : \"12\",\n\"name\" : \"Diana Giraldo\",\n\"identification\" : \"520.526.21\",\n\"observations\" : \"Líder de Ventas\"\n}\n```", "11-0": "priceList", "11-1": "Object", "11-2": "Objeto PriceList que indica la lista de precios asociada a la cotización. Ésta contiene los siguientes atributos:\n* id: Identificador de la lista de precios.\n* name: Nombre de la lista de precios.", "11-3": "```\n{\n\"id\" : 5,\n\"name\" : \"Distribuidor\"\n}\n```", "12-0": "currency", "12-1": "Object", "12-2": "Objeto que incluye la información de la moneda asociada a la cotización.\n** Solo se incluye si la compañía tiene activo multimoneda y la cotización está en una moneda diferente de la principal de la cuenta.\n**\nEste objeto contiene:\n* code : Código ISO de la moneda asociada a la empresa.\n* exchangeRate: Tasa de cambio.", "12-3": "```\n{\n\"code\" : \"USD\",\n\"symbol\" : \"$\",\n\"exchangeRate\" : 2950\n}\n```", "3-0": "number", "3-1": "String", "3-2": "Número de la cotización. Lo asigna automáticamente la aplicación según la configuración de la empresa.", "3-3": "15" }, "cols": 4, "rows": 13 } [/block]