{"_id":"56b0b7da36d2580d002477d3","project":"56abd2434e4b730d009eb10a","editedParams":true,"category":{"_id":"56b3b8ea9f97020d0012d936","__v":1,"pages":["56d5f18b31857e2500db0d4b"],"project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-04T20:47:38.572Z","from_sync":false,"order":1,"slug":"productos-o-servicios","title":"Productos o servicios"},"user":"56abd213d4432d1900eed227","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"},"editedParams2":true,"parentDoc":null,"__v":3,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-02T14:06:18.419Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"status":200,"code":"[\n  {\n    \"id\": 1,\n    \"name\": \"Billetera\",\n    \"description\": \"Billetera de cuero negro\",\n    \"reference\": \"REF-005\",\n    \"status\" : \"inactive\",\n    \"inventory\": {\n      \"unit\" : \"piece\",\n      \"availableQuantity\" : 150,\n      \"unitCost\" : 560,\n      \"initialQuantity\" : 320,\n      \"warehouses\" : [\n        {\n          \"id\": \"1\",\n          \"name\": \"Bodega Norte\",\n          \"observations\": null,\n          \"isDefault\": true,\n          \"address\":\"Dirección de la bodega Norte\",\n          \"status\": \"active\",\n          \"initialQuantity\": \"320.0\",\n          \"availableQuantity\": \"150\"\n          }\n        ]\n      },\n    \"tax\" : [\n      {\n        \"id\" : 6,\n        \"name\" : \"IVA\",\n        \"percentage\" : 16,\n        \"description\" : \"Impuesto de valor agregado\",\n        \"status\": \"active\"\n        }\n      ],\n    \"category\" : {\n      \"id\": 54,\n      \"name\" : \"Ventas\"\n      },\n    \"price\" : [\n      {\n        \"idPriceList\" : 1,\n        \"name\" : \"General\",\n        \"price\" : 1200\n        },\n      {\n        \"idPriceList\" : 2,\n        \"name\" : \"Distribuidor\",\n        \"price\" : 1050\n        }\n    ]\n  },\n  {\n    \"id\": 2,\n    \"name\": \"Cartera\",\n    \"description\": \"Cartera de cuero color café\",\n    \"reference\": \"CAR-195\",\n    \"status\" : \"active\",\n    \"inventory\": {\n      \"unit\" : \"piece\",\n      \"availableQuantity\" : 160,\n      \"unitCost\" : 2560,\n      \"initialQuantity\" : 120,\n      \"warehouses\" : [\n        {\n          \"id\": \"1\",\n          \"name\": \"Bodega Norte\",\n          \"observations\": null,\n          \"isDefault\": true,\n          \"address\":\"Dirección de la bodega Norte\",\n          \"status\": \"active\",\n          \"initialQuantity\": \"20.0\",\n          \"availableQuantity\": \"100\"\n        },\n        {\n          \"id\": \"3\",\n          \"name\": \"Bodega Sur\",\n          \"observations\": \"Bodega ubicada en la zona sur\",\n          \"isDefault\": false,\n          \"address\": null,\n          \"status\": \"active\",\n          \"initialQuantity\": \"100.0\",\n          \"availableQuantity\": \"600\"\n          }\n        ]\n      },\n    \"tax\" : [\n      {\n        \"id\" : 6,\n        \"name\" : \"IVA\",\n        \"percentage\" : 16,\n        \"description\" : \"Impuesto de valor agregado\",\n\t      \"status\": \"active\"\n        }\n      ],\n    \"category\" : {\n      \"id\": 54,\n      \"name\" : \"Ventas\"\n      },\n    \"price\" : [\n      {\n        \"idPriceList\" : 1,\n        \"name\" : \"General\",\n        \"price\" : 1200\n        },\n      {\n        \"idPriceList\" : 2,\n        \"name\" : \"Distribuidor\",\n        \"price\" : 3900\n        },\n      {\n        \"name\" : \"Mayorista\",\n        \"idPriceList\" : 6,\n        \"price\" : 3700\n        }\n     ]\n  },\n  {\n    \"id\": 3,\n    \"name\": \"Diseño de monedero \",\n    \"description\": \"Diseño de monedero en cuero.\",\n    \"reference\": \"\",\n    \"status\" : \"active\",\n    \"tax\" : [\n      {\n        \"id\" : 6,\n        \"name\" : \"IVA\",\n        \"percentage\" : 16,\n        \"description\" : \"Impuesto de valor agregado\",\n        \"status\": \"active\"\n        }\n      ],\n    \"category\" : {\n      \"id\": 54,\n      \"name\" : \"Ventas\"\n      },\n    \"price\" : [\n      {\n        \"idPriceList\" : 1,\n        \"name\" : \"General\",\n        \"price\" : 1200\n       }\n     ]\n  }\n]","language":"json","name":"Ejemplo consulta exitosa"},{"code":"{ \n\t\"error\": \"El límite de productos/servicios para retornar debe ser menor o igual a 30\",\n\t\"code\" : 903\n}","name":"Bad Request - Límite sobrepasa máximo permitido","status":400,"language":"json"},{"name":"Consulta exitosa con metadatos","status":200,"language":"json","code":"{\n  \"metadata\": {\n    \"total\" : 150\n  },\n  \"data\": [\n    {\n      \"id\": 1,\n      \"name\": \"Billetera\",\n      \"description\": \"Billetera de cuero negro\",\n      \"reference\": \"REF-005\",\n      \"status\" : \"inactive\",\n      \"inventory\": {\n        \"unit\" : \"piece\",\n        \"availableQuantity\" : 150,\n        \"unitCost\" : 560,\n        \"initialQuantity\" : 320,\n        \"warehouses\" : [\n          {\n            \"id\": \"1\",\n            \"name\": \"Bodega Norte\",\n            \"observations\": null,\n            \"isDefault\": true,\n            \"address\":\"Dirección de la bodega Norte\",\n            \"status\": \"active\",\n            \"initialQuantity\": \"320.0\",\n            \"availableQuantity\": \"150\"\n            }\n          ]\n        },\n      \"tax\" : [\n        {\n          \"id\" : 6,\n          \"name\" : \"IVA\",\n          \"percentage\" : 16,\n          \"description\" : \"Impuesto de valor agregado\"\n          }\n        ],\n      \"category\" : {\n        \"id\": 54,\n        \"name\" : \"Ventas\"\n        },\n      \"price\" : [\n        {\n          \"idPriceList\" : 1,\n          \"name\" : \"General\",\n          \"price\" : 1200\n          },\n        {\n          \"idPriceList\" : 2,\n          \"name\" : \"Distribuidor\",\n          \"price\" : 1050\n          }\n      ]\n    },\n    {\n      \"id\": 2,\n      \"name\": \"Cartera\",\n      \"description\": \"Cartera de cuero color café\",\n      \"reference\": \"CAR-195\",\n      \"status\" : \"active\",\n      \"inventory\": {\n        \"unit\" : \"piece\",\n        \"availableQuantity\" : 160,\n        \"unitCost\" : 2560,\n        \"initialQuantity\" : 120,\n        \"warehouses\" : [\n          {\n            \"id\": \"1\",\n            \"name\": \"Bodega Norte\",\n            \"observations\": null,\n            \"isDefault\": true,\n            \"address\":\"Dirección de la bodega Norte\",\n            \"status\": \"active\",\n            \"initialQuantity\": \"20.0\",\n            \"availableQuantity\": \"100\"\n          },\n          {\n            \"id\": \"3\",\n            \"name\": \"Bodega Sur\",\n            \"observations\": \"Bodega ubicada en la zona sur\",\n            \"isDefault\": false,\n            \"address\": null,\n            \"status\": \"active\",\n            \"initialQuantity\": \"100.0\",\n            \"availableQuantity\": \"600\"\n            }\n          ]\n        },\n      \"tax\" : [\n        {\n          \"id\" : 6,\n          \"name\" : \"IVA\",\n          \"percentage\" : 16,\n          \"description\" : \"Impuesto de valor agregado\"\n          }\n       ],\n      \"category\" : {\n        \"id\": 54,\n        \"name\" : \"Ventas\"\n        },\n      \"price\" : [\n        {\n          \"idPriceList\" : 1,\n          \"name\" : \"General\",\n          \"price\" : 1200\n          },\n        {\n          \"idPriceList\" : 2,\n          \"name\" : \"Distribuidor\",\n          \"price\" : 3900\n          },\n        {\n          \"name\" : \"Mayorista\",\n          \"idPriceList\" : 6,\n          \"price\" : 3700\n          }\n       ]\n    },\n    {\n      \"id\": 3,\n      \"name\": \"Diseño de monedero \",\n      \"description\": \"Diseño de monedero en cuero.\",\n      \"reference\": \"\",\n      \"status\" : \"active\",\n      \"tax\" : [\n        {\n          \"id\" : 6,\n          \"name\" : \"IVA\",\n          \"percentage\" : 16,\n          \"description\" : \"Impuesto de valor agregado\"\n          }\n        ],\n      \"category\" : {\n        \"id\": 54,\n        \"name\" : \"Ventas\"\n        },\n      \"price\" : [\n         {\n          \"idPriceList\" : 1,\n          \"name\" : \"General\",\n          \"price\" : 1200\n         }\n       ]\n    }\n  ]\n }"},{"code":"{\n\t\"code\": 404,\n  \"message\": \"No se encontró la bodega/almacén con id: 9\"\n}","language":"json","status":404}]},"settings":"","examples":{"codes":[{"code":"curl -v -H \"Accept: application/json\" -H \"Content-type: application/json\" -X GET  https://app.alegra.com/api/v1/items/ -u 'usuario:::at:::alegra.co:mitoken'","language":"curl"}]},"method":"get","auth":"required","params":[{"_id":"56afd9393c70b01700facf25","ref":"","in":"query","required":false,"desc":"Desde cual producto/servicio se quiere consultar. Por ejemplo para consultar desde el producto/servicio 20, se envía start=20.","default":"0","type":"int","name":"start"},{"_id":"56b0b7da36d2580d002477d7","ref":"","in":"query","required":false,"desc":"Cantidad de productos/servicios a partir del inicio que se desea retornar. Por defecto retorna 30 productos/servicios. Si este valor es mayor que 30, la aplicación retorna error.","default":"30","type":"int","name":"limit"},{"_id":"56b0b7da36d2580d002477d6","ref":"","in":"query","required":false,"desc":"Orden ascendente o descendente en el cual se quieren retornar los productos/servicios. Opciones disponibles son DESC o ASC. Por defecto es ASC (ascendente).","default":"ASC","type":"string","name":"order_direction"},{"_id":"56b0b7da36d2580d002477d5","ref":"","in":"query","required":false,"desc":"Campo por el cual se desea ordenar, las opciones posibles son name, id, reference, description.","default":"name","type":"string","name":"order_field"},{"_id":"56b0b7da36d2580d002477d4","ref":"","in":"query","required":false,"desc":"Cadena de texto que se quiere utilizar para buscar los productos/servicios que en su nombre o referencia contienen dicho texto. Por ejemplo si se desea buscar los productos/servicios que contengan la palabra cuaderno, se envía query=cuaderno.","default":"","type":"string","name":"query"},{"_id":"56fae61611e13b170054a886","ref":"","in":"query","required":false,"desc":"Incluir en los resultados metadatos.  Se debe tener en cuenta que si se envía este parámetro el objeto que retorna la aplicación incluye un atributo \"metadata\" y otro \"data\" en donde se envían los productos.  Actualmente la información que se envía en metadata incluye el total de productos que tiene registrada la empresa.","default":"","type":"boolean","name":"metadata"},{"_id":"59499e21b9248d0024fe4117","ref":"","in":"query","required":false,"desc":"Identificador de bodega/almacén. Si se especifica este parámetro se retornan únicamente los productos no inventariables y los inventariables que estén en la bodega/almacén.","default":"","type":"int","name":"idWarehouse"}],"url":"/items/"},"isReference":true,"order":2,"body":"Endpoint que retorna los productos y servicios registrados en la cuenta de Alegra. Si no se envía límite de productos/servicios por defecto se envían 30 productos/servicios.  \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Atención\",\n  \"body\": \"Se debe tener en cuenta que el valor máximo para el atributo limit es 30, si se supera ese valor la aplicación retorna el código de error:\\n```\\n{\\n  \\\"code\\\": 903,\\n  \\\"message\\\" : \\\"El límite debe ser menor o igual a 30\\\"\\n}\\n```\"\n}\n[/block]","excerpt":"Endpoint que permite consultar los productos o servicios registrados en la aplicación","slug":"lista-de-productos-o-servicios","type":"endpoint","title":"Lista de productos"}

getLista de productos

Endpoint que permite consultar los productos o servicios registrados en la aplicación

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

start:
integer0
Desde cual producto/servicio se quiere consultar. Por ejemplo para consultar desde el producto/servicio 20, se envía start=20.
limit:
integer30
Cantidad de productos/servicios a partir del inicio que se desea retornar. Por defecto retorna 30 productos/servicios. Si este valor es mayor que 30, la aplicación retorna error.
order_direction:
stringASC
Orden ascendente o descendente en el cual se quieren retornar los productos/servicios. Opciones disponibles son DESC o ASC. Por defecto es ASC (ascendente).
order_field:
stringname
Campo por el cual se desea ordenar, las opciones posibles son name, id, reference, description.
query:
string
Cadena de texto que se quiere utilizar para buscar los productos/servicios que en su nombre o referencia contienen dicho texto. Por ejemplo si se desea buscar los productos/servicios que contengan la palabra cuaderno, se envía query=cuaderno.
metadata:
boolean
Incluir en los resultados metadatos. Se debe tener en cuenta que si se envía este parámetro el objeto que retorna la aplicación incluye un atributo "metadata" y otro "data" en donde se envían los productos. Actualmente la información que se envía en metadata incluye el total de productos que tiene registrada la empresa.
idWarehouse:
integer
Identificador de bodega/almacén. Si se especifica este parámetro se retornan únicamente los productos no inventariables y los inventariables que estén en la bodega/almacén.

Examples


Result Format


Documentation

Endpoint que retorna los productos y servicios registrados en la cuenta de Alegra. Si no se envía límite de productos/servicios por defecto se envían 30 productos/servicios. [block:callout] { "type": "warning", "title": "Atención", "body": "Se debe tener en cuenta que el valor máximo para el atributo limit es 30, si se supera ese valor la aplicación retorna el código de error:\n```\n{\n \"code\": 903,\n \"message\" : \"El límite debe ser menor o igual a 30\"\n}\n```" } [/block]

User Information

Try It Out

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