{"_id":"5739f28f13b3f60e00fe3316","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"},"user":"56abd213d4432d1900eed227","editedParams2":true,"parentDoc":null,"editedParams":true,"project":"56abd2434e4b730d009eb10a","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":20,"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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"__v":1,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-16T16:17:19.430Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"code":"{\n    \"date\": \"2015-11-15\",\n    \"dueDate\": \"2015-12-15\",\n    \"client\": 2,\n    \"items\" : [\n        {\n            \"id\": 1,\n            \"price\" : 12000,\n            \"quantity\" : 5\n        },\n        {\n            \"id\": 2,\n            \"price\": 8500,\n            \"quantity\" : 1\n        }\n    ]\n}","language":"json","name":"Cotización sencilla"},{"language":"json","name":"Cotización completa","code":"{\n    \"date\": \"2015-12-15\",\n    \"dueDate\": \"2015-12-25\",\n    \"observations\": \"Observaciones de la cotización.\",\n    \"anotation\" : \"Notas de mi cotización\",\n    \"client\": {\n        \"id\": 2\n    },\n    \"seller\" : {\n        \"id\" : \"2\"\n    },\n    \"currency\" : {\n        \"code\" : \"USD\" ,\n        \"exchangeRate\" : 3100\n        },\n    \"items\" : [\n        {\n            \"id\": 1,\n            \"description\": \"Billetera de cuero negro\",\n            \"reference\": \"REF-005\",\n            \"discount\" : 0,\n            \"tax\" : [\n                {\n                    \"id\" : 2\n                }\n            ],\n            \"price\" : 120,\n            \"quantity\" : 5\n        },\n        {\n            \"id\": 2,\n            \"description\": \"Cartera de cuero color café\",\n            \"reference\": \"CAR-195\",\n            \"price\": 85,\n            \"discount\" : 10,\n            \"tax\" : [\n                {\n                    \"id\" : 1\n                }\n            ],\n            \"quantity\" : 1\n        }\n    ]\n}"},{"language":"curl","code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X POST  https://app.alegra.com/api/v1/estimates/ -u 'micorreo:::at:::alegra.com:mitoken12345' -d '{\"date\": 2015-11-15\", \"dueDate\": \"2015-12-15\", \"client\": 2, \"items\" : [{\"id\": 1, \"price\" : 12000, \"quantity\" : 5}, {\"id\": 2, \"price\": 8500, \"quantity\" : 1 }]}'"}]},"method":"post","results":{"codes":[{"language":"json","status":200,"name":"","code":"{\n  \"id\": \"21\",\n  \"date\": \"2015-12-15\",\n  \"number\" : \"22\",\n  \"dueDate\": \"2015-12-25\",\n  \"observations\": \"Observaciones de la cotización.\",\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\": 707,\n  \"seller\": {\n    \"id\": \"6\",\n    \"name\": \"Alejandro Mesa\",\n    \"identification\": \"123456\",\n    \"observations\": \"Ventas sur\"\n  },\n  \"priceList\" : null,\n  \"currency\": {\n    \"code\": \"USD\",\n    \"exchangeRate\": 3100\n  },\n  \"items\": [\n    {\n      \"id\": 1,\n      \"name\": \"Billetera\",\n      \"description\": \"Billetera de cuero negro\",\n      \"price\": 120,\n      \"discount\": \"0.00\",\n      \"reference\": \"REF-005\",\n      \"quantity\": \"5.00\",\n      \"tax\": [\n        {\n        \"id\": \"2\",\n        \"name\": \"IVA\",\n        \"percentage\": \"5.00\",\n        \"description\": \"Impuesto de valor agregado\",\n        \"type\": \"IVA\",\n        \"status\" : \"active\"\n          }\n        ],\n      \"total\": 630\n    },\n    {\n      \"id\": 2,\n      \"name\": \"Cartera\",\n      \"description\": \"Cartera de cuero color café\",\n      \"price\": 85,\n      \"discount\": \"10.00\",\n      \"reference\": \"CAR-195\",\n      \"quantity\": \"1.00\",\n      \"tax\": [\n        {\n        \"id\": \"1\",\n        \"name\": \"IVA\",\n        \"percentage\": \"0.00\",\n        \"description\": \"Impuesto de valor agregado\",\n        \"type\": \"IVA\",\n        \"status\" : \"active\"\n          }\n        ],\n      \"total\": 77\n    }\n  ]\n}"},{"code":"{ \n\t\"error\": \"La información para crear el modelo no existe o es inválida\",\n  \"code\" : 400\n}","language":"json","status":400,"name":""}]},"settings":"","auth":"required","params":[{"_id":"56b0cbcbce5f410d0056c9c7","ref":"","in":"body","required":true,"desc":"Fecha de la cotización. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"date"},{"_id":"56b0cd936d004b17008065cf","ref":"","in":"body","required":true,"desc":"Fecha de vencimiento de la cotización. Formato yyyy-MM-dd.","default":"","type":"yyyy-mm-dd","name":"dueDate"},{"_id":"56b0cd936d004b17008065ce","ref":"","in":"body","required":false,"desc":"Observaciones de la cotización (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.","default":"","type":"string","name":"observations"},{"_id":"56b0cd936d004b17008065cd","ref":"","in":"body","required":false,"desc":"Notas de la cotización, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.","default":"","type":"string","name":"anotation"},{"_id":"56b0cd936d004b17008065ca","ref":"","in":"body","required":true,"desc":"Objecto que contiene el id del cliente asociado a la cotización. Se puede enviar directamente el id del cliente en este atributo.","default":"","type":"mixed","name":"client"},{"_id":"56b210797ae4550d00062924","ref":"","in":"body","required":true,"desc":"Array de objetos item (productos/servicios) asociados a la cotización. Cada objeto debe incluir: `id (number, obligatorio)`: identificador del producto o servicio que se cotiza; `price (double, obligatorio)`: precio en la cotización; `reference (string)` : referencia del producto/servicio; `description (string)`: descripción del producto/servicio; `tax (objeto)` : array de objetos tax que indican la información del impuesto; `quantity (obligatorio)`: cantidad cotizada del producto o servicio; `discount (decimal)`: porcentaje de descuento aplicado al producto, éste no debe incluir el símbolo %, únicamente su tasa. El precio del producto/servicio no debe incluir impuestos ni descuentos.","default":"","type":"array_object","name":"items"},{"_id":"56b210797ae4550d00062922","ref":"","in":"body","required":false,"desc":"Objeto que indica el id del vendedor asociado a la cotización. Se puede enviar directamente el id del vendedor en este atributo.","default":"","type":"mixed","name":"seller"},{"_id":"56b210797ae4550d00062921","ref":"","in":"body","required":false,"desc":"Objeto que indica el id de la lista de precios asociada a la cotización. Se puede enviar directamente el id de la lista de precios en este atributo.","default":"","type":"mixed","name":"priceList"},{"_id":"56b210cf3b6f690d00bdb6a9","ref":"","in":"body","required":false,"desc":"Objecto que incluye la información de la moneda y tasa de cambio asociada a la cotización. Solo se debe incluir si la compañía tiene activa la funcionalidad de multimoneda y tiene configurada la moneda seleccionada. Debe incluir el código de la moneda (de tres letras según ISO) y la tasa de cambio.","default":"","type":"object","name":"currency"}],"url":"/estimates"},"isReference":true,"order":3,"body":"","excerpt":"","slug":"crear-cotización","type":"endpoint","title":"Crear cotización"}

postCrear cotización


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

date:
required
yyyy-mm-dd
Fecha de la cotización. Formato yyyy-MM-dd.
dueDate:
required
yyyy-mm-dd
Fecha de vencimiento de la cotización. Formato yyyy-MM-dd.
observations:
string
Observaciones de la cotización (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.
anotation:
string
Notas de la cotización, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.
client:
required
mixed
Objecto que contiene el id del cliente asociado a la cotización. Se puede enviar directamente el id del cliente en este atributo.
items:
required
array of objects
Array de objetos item (productos/servicios) asociados a la cotización. Cada objeto debe incluir: `id (number, obligatorio)`: identificador del producto o servicio que se cotiza; `price (double, obligatorio)`: precio en la cotización; `reference (string)` : referencia del producto/servicio; `description (string)`: descripción del producto/servicio; `tax (objeto)` : array de objetos tax que indican la información del impuesto; `quantity (obligatorio)`: cantidad cotizada del producto o servicio; `discount (decimal)`: porcentaje de descuento aplicado al producto, éste no debe incluir el símbolo %, únicamente su tasa. El precio del producto/servicio no debe incluir impuestos ni descuentos.
seller:
mixed
Objeto que indica el id del vendedor asociado a la cotización. Se puede enviar directamente el id del vendedor en este atributo.
priceList:
mixed
Objeto que indica el id de la lista de precios asociada a la cotización. Se puede enviar directamente el id de la lista de precios en este atributo.
currency:
object
Objecto que incluye la información de la moneda y tasa de cambio asociada a la cotización. Solo se debe incluir si la compañía tiene activa la funcionalidad de multimoneda y tiene configurada la moneda seleccionada. Debe incluir el código de la moneda (de tres letras según ISO) y la tasa de cambio.

Examples


Result Format


User Information

Try It Out

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