{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/purchase-orders","auth":"required","method":"post","examples":{"codes":[{"name":"Orden de compra sencilla","language":"json","code":"{\n    \"date\": \"2019-02-12\",\n    \"dueDate\": \"2019-02-12\",\n    \"provider\": 1,\n    \"purchases\": {\n        \"categories\": [\n            {\n                \"id\": 5091,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Otros gastos\",\n                \"tax\": {\n                    \"id\": 1\n                }\n            }\n        ],\n        \"items\": [\n            {\n                \"id\": 1,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Artículos de escritorio y papelería\",\n                \"tax\": {\n                   \"id\": 1\n                }\n            }\n        ]\n    }\n}"},{"name":"Orden de compra completa","language":"json","code":"{\n    \"date\": \"2019-02-12\",\n    \"deliveryDate\": \"2019-02-12\",\n    \"observations\": \"Se adquirieron suplementos de oficina\",\n    \"termsConditions\": \"Términos y condiciones de mi empresa\",\n    \"provider\": {\n        \"id\": 1\n    },\n    \"warehouse\": {\n        \"id\": 2\n    },\n    \"currency\": {\n        \"code\": \"USD\",\n        \"exchangeRate\": 3136\n    },\n    \"purchases\": {\n        \"categories\": [\n            {\n                \"id\": 5091,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Otros gastos\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ],\n        \"items\": [\n            {\n                \"id\": 1,\n                \"price\": 120,\n                \"quantity\": 5,\n                \"discount\": 10,\n                \"observations\": \"Artículos de escritorio y papelería\",\n                \"tax\": [\n                    {\n                        \"id\": 1\n                    }\n                ]\n            }\n        ]\n    },\n    \"costCenter\": {\n        \"id\": 3\n    }\n}"},{"language":"curl","code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X POST  https://api.alegra.com/api/v1/bills/ -u 'micorreo:::at:::alegra.com:mitoken12345' -d '{\"date\": \"2019-02-12\", \"deliveryDate\": \"2019-02-12\", \"provider\":  1, \"purchases\" : { \"categories\" : [ { \"id\": 5091, \"price\" : 120, \"quantity\" : 5, \"discount\" : 10, \"observations\": \"Otros gastos\", \"tax\" : [ { \"id\" : 1 } ] }], \"items\" : [ { \"id\": 1, \"price\" : 120, \"quantity\" : 5, \"discount\" : 10, \"observations\": \"Artículos de escritorio y papelería\", \"tax\" : [ { \"id\" : 1 } ] }] }}'"}]},"results":{"codes":[{"status":200,"language":"json","code":"{\n    \"id\": \"2\",\n    \"date\": \"2021-02-01\",\n    \"deliveryDate\": \"2021-02-20\",\n    \"observations\": \"Se adquirieron suplementos de oficina\",\n    \"termsConditions\": \"Términos y condiciones de mi empresa\",\n    \"status\": \"open\",\n    \"provider\": {\n        \"id\": \"1\",\n        \"name\": \"Papelería Alegría S.A.S\",\n        \"identification\": \"1234567890\",\n        \"phonePrimary\": \"\",\n        \"phoneSecondary\": \"\",\n        \"fax\": \"\",\n        \"mobile\": \"\",\n        \"email\": \"\"\n    },\n    \"numberTemplate\": {\n        \"number\": \"8\",\n      \t\"prefix\": null,\n        \"id\": 9,\n    },\n    \"total\": 1134,\n    \"subTotal\": 1134,\n    \"decimalPrecision\": \"0\",\n    \"warehouse\": {\n        \"id\": \"2\",\n        \"name\": \"Almacén de la 80\"\n    },\n    \"purchases\": {\n        \"items\": [\n            {\n                \"id\": \"3\",\n                \"name\": \"Artículos de escritorio y papelería\",\n                \"price\": 120,\n                \"discount\": 10,\n                \"observations\": \"Artículos de escritorio y papelería\",\n                \"tax\": [\n                    {\n                        \"id\": \"2\",\n                        \"name\": \"IVA\",\n                        \"percentage\": \"5.00\",\n                        \"description\": \"\",\n                        \"status\": \"active\",\n                        \"type\": \"IVA\",\n                        \"amount\": 27\n                    }\n                ],\n                \"quantity\": 5,\n                \"taxAmount\": 27,\n                \"subtotal\": 540,\n                \"total\": 567\n            }\n        ],\n        \"categories\": [\n            {\n                \"id\": \"5066\",\n                \"name\": \"Papelería\",\n                \"price\": 120,\n                \"discount\": 10,\n                \"observations\": \"Papelería\",\n                \"tax\": [\n                    {\n                        \"id\": \"2\",\n                        \"name\": \"IVA\",\n                        \"percentage\": \"5.00\",\n                        \"description\": \"\",\n                        \"status\": \"active\",\n                        \"type\": \"IVA\",\n                        \"amount\": 27\n                    }\n                ],\n                \"quantity\": 5,\n                \"taxAmount\": 27,\n                \"subtotal\": 540,\n                \"total\": 567\n            }\n        ]\n    },\n    \"costCenter\": {\n      \"id\": \"3\",\n      \"code\": \"CC03\",\n      \"name\": \"Centro de costo proveedores\",\n      \"description\": \"Ingresos y gastos asociados a proveedores\",\n      \"status\": \"active\" \n    }\n}","name":""},{"status":400,"language":"json","code":"{ \n    \"error\": \"No se encontró información para crear el recurso\",\n    \"code\" : 400\n}","name":""}]},"settings":"","params":[{"name":"date","type":"yyyy-mm-dd","default":"","desc":"Fecha de la orden de compra. Formato yyyy-MM-dd.","required":true,"in":"body","ref":"","_id":"5c8e9ac6d571760037edaffe"},{"name":"deliveryDate","type":"yyyy-mm-dd","default":"","desc":"Fecha de entrega de la orden de compra. Formato yyyy-MM-dd.","required":true,"in":"body","ref":"","_id":"5c8e9ac6d571760037edaffd"},{"name":"observations","type":"string","default":"","desc":"Observaciones de la orden de compra. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"5c8e9ac6d571760037edaffc"},{"name":"termsConditions","type":"string","default":"","desc":"Términos y condiciones de la orden de compra. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"5c8e9ac6d571760037edaffb"},{"name":"provider","type":"mixed","default":"","desc":"Objeto que contiene el id del proveedor asociado a la orden de compra. Se puede enviar directamente el id del proveedor en este atributo.","required":true,"in":"body","ref":"","_id":"5c8e9ac6d571760037edaff8"},{"name":"warehouse","type":"mixed","default":"","desc":"Objeto que indica el id de la bodega/almacén asociada a la orden de compra. Se puede enviar directamente el id de la bodega/almacén en este atributo. Si no se envía este parámetro la orden de compra queda asociada a la bodega/almacén Principal.","required":false,"in":"body","ref":"","_id":"5c8e9ac6d571760037edaff7"},{"name":"currency","type":"object","default":"","desc":"Objeto que incluye la información de la moneda y tasa de cambio asociada a la orden de compra. 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":"5c8e9ac6d571760037edaff6"},{"name":"purchases","type":"object","default":"","desc":"Objeto que contiene los arreglos `items` y `categories` con la información de los items inventariables y categorías de egresos y/o activos fijos para la orden de compra. Arreglo `items`: Array de objetos item (productos inventariables) asociados a la orden de compra. Cada objeto debe incluir: `id (number, obligatorio)`: identificador del producto inventariable que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones del producto inventariable; `tax (objeto)` : indica la información del impuesto; `quantity (obligatorio)`: cantidad comprada del producto inventariable; `discount (decimal)`: porcentaje de descuento aplicado al producto inventariable, éste no debe incluir el símbolo %. El precio del producto inventariable no debe incluir impuestos ni descuentos. Arreglo `categories`: Array de objetos category (categorías de egresos y/o activos fijos) asociados a la orden de compra. Cada objeto debe incluir: `id (number, obligatorio)`: identificador de la categoría que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones de la categoría; `tax (objeto)` : indica la información del impuesto; `quantity (obligatorio)`: cantidad comprada de la categoría; `discount (decimal)`: porcentaje de descuento aplicado a la categoría, éste no debe incluir el símbolo %. El precio de la categoría no debe incluir impuestos ni descuentos.","required":true,"in":"body","ref":"","_id":"5c8e9ac6d571760037edaff5"},{"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":"5ea9d5f2f71fe9002b0ea0f6"},{"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":"5f4fb93efca0640011e8c990"}]},"next":{"description":"","pages":[]},"title":"Crear una Órden de compra","type":"endpoint","slug":"crear-orden-de-compra","excerpt":"Endpoint para crear una orden de compra.","body":"","updates":[],"order":3,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"6018163d733aa1005f028964","createdAt":"2021-02-01T14:54:53.198Z","user":"5a2184feb778240012e38415","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Órdenes de Compra","slug":"órdenes-de-compra","order":26,"from_sync":false,"reference":false,"_id":"5e9f0d4c720ad8006c6c7dc1","createdAt":"2020-04-21T15:12:12.508Z","version":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":0},"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"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":45,"createdAt":"2016-01-29T20:57:39.712Z"},"project":"56abd2434e4b730d009eb10a","__v":10,"parentDoc":null}

postCrear una Órden de compra

Endpoint para crear una orden de compra.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

date:
required
yyyy-mm-dd
Fecha de la orden de compra. Formato yyyy-MM-dd.
deliveryDate:
required
yyyy-mm-dd
Fecha de entrega de la orden de compra. Formato yyyy-MM-dd.
observations:
string
Observaciones de la orden de compra. Longitud máxima permitida: 500.
termsConditions:
string
Términos y condiciones de la orden de compra. Longitud máxima permitida: 500.
provider:
required
mixed
Objeto que contiene el id del proveedor asociado a la orden de compra. Se puede enviar directamente el id del proveedor en este atributo.
warehouse:
mixed
Objeto que indica el id de la bodega/almacén asociada a la orden de compra. Se puede enviar directamente el id de la bodega/almacén en este atributo. Si no se envía este parámetro la orden de compra queda asociada a la bodega/almacén Principal.
currency:
object
Objeto que incluye la información de la moneda y tasa de cambio asociada a la orden de compra. 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.
purchases:
required
object
Objeto que contiene los arreglos `items` y `categories` con la información de los items inventariables y categorías de egresos y/o activos fijos para la orden de compra. Arreglo `items`: Array de objetos item (productos inventariables) asociados a la orden de compra. Cada objeto debe incluir: `id (number, obligatorio)`: identificador del producto inventariable que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones del producto inventariable; `tax (objeto)` : indica la información del impuesto; `quantity (obligatorio)`: cantidad comprada del producto inventariable; `discount (decimal)`: porcentaje de descuento aplicado al producto inventariable, éste no debe incluir el símbolo %. El precio del producto inventariable no debe incluir impuestos ni descuentos. Arreglo `categories`: Array de objetos category (categorías de egresos y/o activos fijos) asociados a la orden de compra. Cada objeto debe incluir: `id (number, obligatorio)`: identificador de la categoría que se compra; `price (double, obligatorio)`: precio de compra; `observations (string)`: observaciones de la categoría; `tax (objeto)` : indica la información del impuesto; `quantity (obligatorio)`: cantidad comprada de la categoría; `discount (decimal)`: porcentaje de descuento aplicado a la categoría, éste no debe incluir el símbolo %. El precio de la categoría no debe incluir impuestos ni descuentos.
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.
comments:
array of strings
Arreglo de strings con cada uno de los comentarios que se desean asociar.

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