{"_id":"57586e72f71f5c19002d1868","user":"56abd213d4432d1900eed227","project":"56abd2434e4b730d009eb10a","editedParams":true,"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"},"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"},"__v":2,"parentDoc":null,"editedParams2":true,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-06-08T19:13:54.177Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"code":"","language":"text"}]},"settings":"","examples":{"codes":[]},"method":"put","auth":"required","params":[{"_id":"57586f926a65ec0e0041545f","ref":"","in":"path","required":true,"desc":"Identificador del producto o servicio que se desea editar. Se debe enviar en la URL","default":"","type":"int","name":"id"},{"_id":"56b0cbcbce5f410d0056c9c7","ref":"","in":"body","required":false,"desc":"Nombre del producto o servicio. Longitud máxima permitida: 150.","default":"","type":"string","name":"name"},{"_id":"56b0cd936d004b17008065cf","ref":"","in":"body","required":false,"desc":"Descripción del producto o servicio. Longitud máxima permitida: 500.","default":"","type":"string","name":"description"},{"_id":"56b0cd936d004b17008065ce","ref":"","in":"body","required":false,"desc":"Referencia del producto o servicio.  Tener en cuenta que la aplicación no permite crear dos productos con la misma referencia.  Longitud máxima permitida: 45.","default":"","type":"string","name":"reference"},{"_id":"56b0cd936d004b17008065cd","ref":"","in":"body","required":false,"desc":"Estado de la producto o servicio, las opciones posibles son: active o inactive.  Se debe tener en cuenta que un producto o servicio que se encuentre inactivo no se puede editar; si se desea editar, se debe enviar entre los atributos que se van a editar el estado en active.","default":"","type":"string","name":"status"},{"_id":"56b0cd936d004b17008065cc","ref":"","in":"body","required":false,"desc":"Indica los atributos del inventario del producto, si se desea convertir un servicio a producto inventariable se debe enviar esta propiedad con los atributos del inventario.  Para editar una propiedad en particular del inventario se puede enviar solo ese atributo. Este objeto puede contener los siguientes atributos: `unit (string)`: Unidad de medida del producto. Los valores posibles son: unit, centimeter, meter, inch, centimeterSquared, meterSquared, inchSquared, mililiter, liter, gallon, gram, kilogram, ton, pound, piece, service, notApplicable; `unitCost (number)`: Costo unitario del producto. `initialQuantity (number)`: Cantidad inicial del producto.   Si se desea distribuir el producto en bodegas o modificar las bodegas del producto se debe adicionar un array con objetos warehouse, el cual contiene las bodegas en las cuales se desea distribuir el inventario.  Cada objeto warehouse debe contener los siguientes atributos: `id` : Identificador de la bodega; `initialQuantity` : Cantidad inicial del producto en la bodega.","default":"","type":"string","name":"inventariable"},{"_id":"56b11166135ec20d00bafa04","ref":"","in":"body","required":false,"desc":"Objeto categoría que contiene el id de la categoría de Alegra a la cual se desea asociar el producto o servicio.","default":"","type":"string","name":"category"},{"_id":"56b0cd936d004b17008065cb","ref":"","in":"body","required":false,"desc":"Array de objetos que indica las listas de precio asociadas al producto o servicio.  Los objetos deben contener: `idPriceList (number, obligatorio)`:identificador de la lista de precios; `price (double)` : precio en la lista.  Para indicar el precio general del producto/servicio se puede enviar únicamente un objeto con atributo de price.  Para listas de precio de porcentaje se puede omitir el atributo price. Si no se desea asociar el producto/servicio a una lista de precios se puede enviar el precio del producto o servicio directamente.","default":"","type":"string","name":"price"},{"_id":"56b0cd936d004b17008065ca","ref":"","in":"body","required":false,"desc":"Array con objeto que tiene como atributo el id del impuesto que se desea asociar al producto/servicio. Se puede enviar el id del impuesto directamente.","default":"","type":"string","name":"tax"}],"url":"/items/:id"},"isReference":true,"order":4,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos.\",\n  \"body\": \"\"\n}\n[/block]\nPor ejemplo para editar el nombre y cambiarle el estado a un producto o servicio se debe enviar el siguiente JSON:\n\n```JSON\n{\n\"name\" : \"Nuevo nombre  de mi producto\",\n\"status\" : \"active\"\n}\n```\n\n\nPara eliminar algún dato del producto o servicio enviar el atributo en null, así:\n```JSON\n{\n\"reference\" : null\n}\n```\n\nSe retorna el producto que se ha modificado.","excerpt":"","slug":"editar-productos-o-servicios","type":"endpoint","title":"Editar productos o servicios"}

putEditar productos o servicios


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

id:
required
integer
Identificador del producto o servicio que se desea editar. Se debe enviar en la URL

Body Params

name:
string
Nombre del producto o servicio. Longitud máxima permitida: 150.
description:
string
Descripción del producto o servicio. Longitud máxima permitida: 500.
reference:
string
Referencia del producto o servicio. Tener en cuenta que la aplicación no permite crear dos productos con la misma referencia. Longitud máxima permitida: 45.
status:
string
Estado de la producto o servicio, las opciones posibles son: active o inactive. Se debe tener en cuenta que un producto o servicio que se encuentre inactivo no se puede editar; si se desea editar, se debe enviar entre los atributos que se van a editar el estado en active.
inventariable:
string
Indica los atributos del inventario del producto, si se desea convertir un servicio a producto inventariable se debe enviar esta propiedad con los atributos del inventario. Para editar una propiedad en particular del inventario se puede enviar solo ese atributo. Este objeto puede contener los siguientes atributos: `unit (string)`: Unidad de medida del producto. Los valores posibles son: unit, centimeter, meter, inch, centimeterSquared, meterSquared, inchSquared, mililiter, liter, gallon, gram, kilogram, ton, pound, piece, service, notApplicable; `unitCost (number)`: Costo unitario del producto. `initialQuantity (number)`: Cantidad inicial del producto. Si se desea distribuir el producto en bodegas o modificar las bodegas del producto se debe adicionar un array con objetos warehouse, el cual contiene las bodegas en las cuales se desea distribuir el inventario. Cada objeto warehouse debe contener los siguientes atributos: `id` : Identificador de la bodega; `initialQuantity` : Cantidad inicial del producto en la bodega.
category:
string
Objeto categoría que contiene el id de la categoría de Alegra a la cual se desea asociar el producto o servicio.
price:
string
Array de objetos que indica las listas de precio asociadas al producto o servicio. Los objetos deben contener: `idPriceList (number, obligatorio)`:identificador de la lista de precios; `price (double)` : precio en la lista. Para indicar el precio general del producto/servicio se puede enviar únicamente un objeto con atributo de price. Para listas de precio de porcentaje se puede omitir el atributo price. Si no se desea asociar el producto/servicio a una lista de precios se puede enviar el precio del producto o servicio directamente.
tax:
string
Array con objeto que tiene como atributo el id del impuesto que se desea asociar al producto/servicio. Se puede enviar el id del impuesto directamente.

Documentation

[block:callout] { "type": "warning", "title": "Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos.", "body": "" } [/block] Por ejemplo para editar el nombre y cambiarle el estado a un producto o servicio se debe enviar el siguiente JSON: ```JSON { "name" : "Nuevo nombre de mi producto", "status" : "active" } ``` Para eliminar algún dato del producto o servicio enviar el atributo en null, así: ```JSON { "reference" : null } ``` Se retorna el producto que se ha modificado.

User Information

Try It Out

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