{"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\t  \"warehouse\": 2\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"},{"name":"warehouse","type":"mixed","default":"","desc":"Objeto que indica el id de la bodega/almacén asociada a la cotización. Se puede enviar directamente el id de la bodega/almacén en este atributo. Si no se envía este parámetro la cotización queda asociada a la bodega/almacén Principal.","required":false,"in":"body","ref":"","_id":"5f495473ac8a21006134456d"},{"name":"comments","type":"array_string","default":"","desc":"Arreglo de strings con cada uno de los comentarios que se desean asociar.","required":false,"in":"body","ref":"","_id":"5f4fb7ba19a1b60051baa47e"},{"name":"numberTemplate","type":"mixed","default":"","desc":"Objeto que contiene la información de la numeración de la cotización. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la cotización. Si no se envía este atributo la aplicación intenta crear la cotización con la numeración preferida que tiene configurada la empresa.","required":false,"in":"body","ref":"","_id":"616861156046670022e8f27d"}],"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  \"warehouse\": {\n  \t\"id\": \"1\",\n    \"name\": \"Principal\"\n\t},\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","5f172282d7522c03be08713f","5f3c4814ac3e6209c38b7615","5f4fbe7281626c006887f104","5f5242887d2f8701ff580d22","5fc1133c51c8370081b28e2a","60807d7adc33b10010370740","60d30b1745665d00237faa55","60d30b2efa7b7200235a3c93","61006d2332a29f00801deea2","610d39edae2fc2000f014232","61c9cb2afbb56b000f39c13a"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":50,"createdAt":"2016-01-29T20:57:39.712Z"},"__v":8}

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.
warehouse:
mixed
Objeto que indica el id de la bodega/almacén asociada a la cotización. Se puede enviar directamente el id de la bodega/almacén en este atributo. Si no se envía este parámetro la cotización queda asociada a la bodega/almacén Principal.
comments:
array of strings
Arreglo de strings con cada uno de los comentarios que se desean asociar.
numberTemplate:
mixed
Objeto que contiene la información de la numeración de la cotización. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la cotización. Si no se envía este atributo la aplicación intenta crear la cotización con la numeración preferida que tiene configurada la empresa.

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