{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/estimates","auth":"required","examples":{"codes":[{"name":"Cotización sencilla","language":"json","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}"},{"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    \"costCenter\": 1\n}","name":"Cotización completa","language":"json"},{"code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X POST  https://api.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 }]}'","language":"curl"}]},"method":"post","params":[{"name":"date","type":"yyyy-mm-dd","default":"","desc":"Fecha de la cotización. Formato yyyy-MM-dd.","required":true,"in":"body","ref":"","_id":"56b0cbcbce5f410d0056c9c7"},{"name":"dueDate","type":"yyyy-mm-dd","default":"","desc":"Fecha de vencimiento de la cotización. Formato yyyy-MM-dd.","required":true,"in":"body","ref":"","_id":"56b0cd936d004b17008065cf"},{"name":"observations","type":"string","default":"","desc":"Observaciones de la cotización (no visibles en el pdf o documento impreso). Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ce"},{"name":"anotation","type":"string","default":"","desc":"Notas de la cotización, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cd"},{"name":"client","type":"mixed","default":"","desc":"Objecto que contiene el id del cliente asociado a la cotización. Se puede enviar directamente el id del cliente en este atributo.","required":true,"in":"body","ref":"","_id":"56b0cd936d004b17008065ca"},{"name":"items","type":"array_object","default":"","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.","required":true,"in":"body","ref":"","_id":"56b210797ae4550d00062924"},{"name":"seller","type":"mixed","default":"","desc":"Objeto que indica el id del vendedor asociado a la cotización. Se puede enviar directamente el id del vendedor en este atributo.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062922"},{"name":"priceList","type":"mixed","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210797ae4550d00062921"},{"name":"currency","type":"object","default":"","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.","required":false,"in":"body","ref":"","_id":"56b210cf3b6f690d00bdb6a9"},{"name":"costCenter","type":"mixed","default":"","desc":"Objeto que indica el id del centro de costo asociado. Se puede enviar directamente el id del centro de costo en este atributo o enviarlo como objeto.","required":false,"in":"body","ref":"","_id":"5ee23f8bbf4ad2003a662d68"}],"results":{"codes":[{"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\": \"[email protected]\",\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}","name":"","status":200,"language":"json"},{"name":"","status":400,"language":"json","code":"{ \n\t\"error\": \"La información para crear el modelo no existe o es inválida\",\n  \"code\" : 400\n}"}]},"settings":""},"next":{"description":"","pages":[]},"title":"Crear cotización","type":"endpoint","slug":"crear-cotización","excerpt":"Endpoint que permite crear una cotización desde cero.","body":"","updates":[],"order":4,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5739f28f13b3f60e00fe3316","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Cotizaciones","slug":"cotizaciones","order":4,"from_sync":false,"reference":true,"_id":"5739ed9aad40e23200f674b6","createdAt":"2016-05-16T15:56:10.484Z","__v":0,"version":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a"},"user":"56abd213d4432d1900eed227","githubsync":"","editedParams2":true,"parentDoc":null,"createdAt":"2016-05-16T16:17:19.430Z","editedParams":true,"project":"56abd2434e4b730d009eb10a","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"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","5d9ca92eac34370012872d08","5d9f8149103b9f006c1421e0","5e3098aba5919200612d0c33","5e8ca028538a310018ccd2df","5e9f0d4c720ad8006c6c7dc1","5ea9c2f382fcd2003df9f412","5ec7defc6aa2be001e7504f5","5ed8f716a8308c0412b5473a","5ed9274fe5a9b8041fd1df43","5ed92afa0d09d60253220b3f","5efcff9cd7e1be00118e8272"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":39,"createdAt":"2016-01-29T20:57:39.712Z"},"__v":5}

postCrear cotización

Endpoint que permite crear una cotización desde cero.

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.
costCenter:
mixed
Objeto que indica el id del centro de costo asociado. Se puede enviar directamente el id del centro de costo en este atributo o enviarlo como objeto.

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 }}