{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/items","auth":"required","params":[{"name":"name","type":"string","default":"","desc":"Nombre del producto o servicio. Longitud máxima permitida: 150.","required":true,"in":"body","ref":"","_id":"56b0cbcbce5f410d0056c9c7"},{"name":"description","type":"string","default":"","desc":"Descripción del producto o servicio. Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cf"},{"name":"reference","type":"string","default":"","desc":"Referencia del producto o servicio. Longitud máxima permitida: 45.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ce"},{"name":"reference (Costa Rica)","type":"object","default":"","desc":"Para Costa Rica, el atributo reference es un objeto compuesto por los siguientes atributos: `type(string)` tipo de referencia. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica). `reference (string)` código de referencia establecido para el producto.","required":false,"in":"body","ref":"","_id":"5bcf90edbd89df0013d59723"},{"name":"price","type":"mixed","default":"","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.","required":true,"in":"body","ref":"","_id":"56b0cd936d004b17008065cd"},{"name":"category","type":"object","default":"","desc":"Objeto categoría que contiene el id de la categoría de Alegra a la cual se desea asociar el producto o servicio. Si no se envía este atributo el producto o servicio queda asociado a la categoría de Ventas.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cc"},{"name":"inventory","type":"object","default":"","desc":"Indica los atributos del inventario del producto. Si es un servicio este atributo se debe omitir. Este objeto debe contener los siguientes atributos: `unit (string, obligatorio)`: 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, obligatorio)`: Costo unitario del producto. `initialQuantity (number, obligatorio)`: Cantidad inicial del producto.  Si se desea distribuir el producto en bodegas 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 (integer, obligatorio)` : Identificador de la bodega; `initialQuantity (integer, obligatorio)` : Cantidad inicial del producto en la bodega, `minQuantity (integer)`: Cantidad mínima configurada para el producto en la bodega, `maxQuantity (integer)`: Cantidad máxima configurada para el producto en la bodega.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cb"},{"name":"tax","type":"mixed","default":"","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.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ca"},{"name":"type","type":"string","default":"simple","desc":"Indica el tipo de producto. Las opciones posibles son simple o kit","required":false,"in":"body","ref":"","_id":"5dbb3c2ac48917002e61bab4"},{"name":"customFields","type":"array_object","default":"","desc":"Arreglo con objetos que representa los campos adicionales del ítem. El objeto debe estar compuesto por los siguientes atributos: `id (int)` Id del campo adicional. `value (string)` valor a asignar en el campo adicional para el item..","required":false,"in":"body","ref":"","_id":"59e65ceb2bea95002e474379"},{"name":"productKey","type":"string","default":"","desc":"Para México, Costa Rica y Colombia, representa el número de la clave de producto o ClaveProdServ, debe contener 8 dígitos. Para Colombia, representa el código de producto o servicio, debe contener 8 dígitos, si no lo conoces haz clic [aquí](https://ayuda.alegra.com/agrega-el-c%C3%B3digo-de-producto-a-tus-%C3%ADtems-de-venta).","required":false,"in":"body","ref":"","_id":"5a01dd53078c7300287f5eea"},{"name":"subitems","type":"array_object","default":"","desc":"Indica los subitems de un kit. Obligatorio si el atributo type del producto es kit. Array que indica los items que componen un kit. Por cada subitem que se desee agregar se debe indicar la cantidad del item que compone el kit y el atributo item, el cual es un objeto que contiene el atributo id que indica el identificador del producto que se desea asociar al producto.","required":false,"in":"body","ref":"","_id":"5dbb3c2ac48917002e61bab3"},{"name":"kitWarehouse","type":"object","default":"","desc":"Indica la bodega asociada al Kit. Se debe enviar solo si el producto es de tipo kit Si no se envía se asocia la bodega principal.","required":false,"in":"body","ref":"","_id":"5dbb3c2ac48917002e61bab2"},{"name":"tariffHeading","type":"string","default":"","desc":"Para Costa Rica, indica la partida arancelaria de un ítem. Longitud permitida: 12.","required":false,"in":"body","ref":"","_id":"5e2f673b6817ad019be07a1c"},{"name":"itemCategory","type":"object","default":"","desc":"Indica la categoría de ítem a asociar. Se debe tener en cuenta si la categoría de ítem está activa para asociar el ítem.","required":false,"in":"body","ref":"","_id":"5e30be1a073c9f00117fdedf"},{"name":"variantAttributes","type":"array_object","default":"null","desc":"Arreglo con objetos que representa los atributos variantes del ítem. Obligatorio si el atributo type del producto es variantParent. El objeto debe estar compuesto por los siguientes atributos: `id (int)` Id del atributo variante. `options(array of objects)` Array de objetos con los ids de las opciones a agregar en el item.","required":false,"in":"body","ref":"","_id":"5f0cfd76a33e050011caf3ee"},{"name":"itemVariants","type":"array_object","default":"null","desc":"Arreglo con objetos que representan los items variantes de un item padre (item con variantes). Obligatorio si el atributo type del producto es variantParent. El objeto debe estar compuesto por los siguientes atributos: `inventory (object)` Objeto que representa la distribución del item variante en el inventario, el atributo `initialQuantity` es obligatorio . `variantAttributos(array of objects)` Array de objetos que representan los atributos variantes asociados al item variante.","required":false,"in":"body","ref":"","_id":"5f0cfd76a33e050011caf3ed"},{"name":"accounting","type":"mixed","default":"","desc":"Objeto que contiene las cuentas de inventario y compras inventariables de los items inventariables. Las opciones disponibles son: inventory e inventariablePurchase. Se puede enviar solo el id de la cuenta contable o como objeto","required":false,"in":"body","ref":"","_id":"5f9095e7a890db00183a3fc0"}],"results":{"codes":[{"status":200,"language":"json","code":"{\n  \"id\": 5,\n  \"name\": \"Consultoría diseño de billeteras\",\n  \"description\": \"\",\n  \"reference\": \"\",\n  \"tax\" : [],\n  \"category\" : {\n  \t\"id\": 54,\n  \t\"name\" : \"Ventas\"\n  },\n  \"price\" : [\n  \t{\n  \t\t\"idPriceList\" : 1,\n  \t\t\"name\" : \"Principal\",\n  \t\t\"price\" : 1200\n  \t}\n  ]              \n}","name":""},{"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}"},{"name":"Producto creado perú","status":201,"language":"json","code":"{\n  \"id\": 5,\n  \"name\": \"amiseta S\",\n  \"description\": \"\",\n  \"reference\": \"\",\n  \"tax\" : [],\n  \"category\" : {\n  \t\"id\": 54,\n  \t\"name\" : \"Ventas\"\n  },\n  \"price\" : [\n  \t{\n  \t\t\"idPriceList\" : 1,\n  \t\t\"name\" : \"Principal\",\n  \t\t\"price\" : 1200\n  \t}\n  ],\n  \"inventory\": {\n    \"unit\": \"unit\"\n  }\n}"},{"code":"{\n    \"message\": \"Debes especificar un item variante con los siguientes atributos variantes: Color: Rojo,Talla: XS\",\n    \"code\": 1088\n}","language":"json","name":"Item con variantes faltantes","status":400},{"code":"{\n    \"id\": \"9\",\n    \"category\": {\n        \"id\": \"5063\",\n        \"name\": \"Ventas\"\n    },\n    \"hasNoIvaDays\": false,\n    \"name\": \"Camiseta\",\n    \"description\": null,\n    \"reference\": null,\n    \"status\": \"active\",\n    \"price\": [\n        {\n            \"idPriceList\": 1,\n            \"name\": \"General\",\n            \"type\": \"amount\",\n            \"price\": \"70000.0000\"\n        }\n    ],\n    \"inventory\": {\n        \"unit\": \"unit\"\n    },\n    \"tax\": [],\n    \"customFields\": [],\n    \"productKey\": null,\n    \"type\": \"variantParent\",\n    \"variantAttributes\": [\n        {\n            \"id\": \"1\",\n            \"name\": \"Color\",\n            \"status\": \"active\",\n            \"options\": [\n                {\n                    \"id\": \"1\",\n                    \"value\": \"Rojo\"\n                },\n                {\n                    \"id\": \"2\",\n                    \"value\": \"Verde\"\n                }\n            ]\n        },\n        {\n            \"id\": \"2\",\n            \"name\": \"Talla\",\n            \"status\": \"active\",\n            \"options\": [\n                {\n                    \"id\": \"4\",\n                    \"value\": \"XS\"\n                },\n                {\n                    \"id\": \"5\",\n                    \"value\": \"M\"\n                }\n            ]\n        }\n    ],\n    \"itemVariants\": [\n        {\n            \"id\": 10,\n            \"category\": {\n                \"id\": \"5063\",\n                \"name\": \"Ventas\"\n            },\n            \"hasNoIvaDays\": false,\n            \"name\": \"Camiseta / Rojo / XS\",\n            \"description\": null,\n            \"reference\": null,\n            \"status\": \"active\",\n            \"price\": [\n                {\n                    \"idPriceList\": 1,\n                    \"name\": \"General\",\n                    \"type\": \"amount\",\n                    \"price\": \"70000.0000\"\n                }\n            ],\n            \"inventory\": {\n                \"initialQuantity\": 10,\n                \"initialQuantityDate\": \"2020-07-13\",\n                \"unit\": \"unit\",\n                \"unitCost\": 35000,\n                \"availableQuantity\": 10,\n                \"warehouses\": [\n                    {\n                        \"name\": \"Principal\",\n                        \"observations\": null,\n                        \"isDefault\": true,\n                        \"address\": null,\n                        \"status\": \"active\",\n                        \"id\": \"1\",\n                        \"costCenter\": null,\n                        \"initialQuantity\": \"10.00\",\n                        \"availableQuantity\": \"10.00\",\n                        \"minQuantity\": null,\n                        \"maxQuantity\": null\n                    }\n                ]\n            },\n            \"tax\": [],\n            \"customFields\": [],\n            \"productKey\": null,\n            \"type\": \"variant\",\n            \"variantAttributes\": [\n                {\n                    \"id\": \"1\",\n                    \"name\": \"Color\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"1\",\n                            \"value\": \"Rojo\"\n                        }\n                    ]\n                },\n                {\n                    \"id\": \"2\",\n                    \"name\": \"Talla\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"4\",\n                            \"value\": \"XS\"\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"id\": 11,\n            \"category\": {\n                \"id\": \"5063\",\n                \"name\": \"Ventas\"\n            },\n            \"hasNoIvaDays\": false,\n            \"name\": \"Camiseta / Rojo / M\",\n            \"description\": null,\n            \"reference\": null,\n            \"status\": \"active\",\n            \"price\": [\n                {\n                    \"idPriceList\": 1,\n                    \"name\": \"General\",\n                    \"type\": \"amount\",\n                    \"price\": \"70000.0000\"\n                }\n            ],\n            \"inventory\": {\n                \"initialQuantity\": 10,\n                \"initialQuantityDate\": \"2020-07-13\",\n                \"unit\": \"unit\",\n                \"unitCost\": 35000,\n                \"availableQuantity\": 10,\n                \"warehouses\": [\n                    {\n                        \"name\": \"Principal\",\n                        \"observations\": null,\n                        \"isDefault\": true,\n                        \"address\": null,\n                        \"status\": \"active\",\n                        \"id\": \"1\",\n                        \"costCenter\": null,\n                        \"initialQuantity\": \"10.00\",\n                        \"availableQuantity\": \"10.00\",\n                        \"minQuantity\": null,\n                        \"maxQuantity\": null\n                    }\n                ]\n            },\n            \"tax\": [],\n            \"customFields\": [],\n            \"productKey\": null,\n            \"type\": \"variant\",\n            \"variantAttributes\": [\n                {\n                    \"id\": \"1\",\n                    \"name\": \"Color\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"1\",\n                            \"value\": \"Rojo\"\n                        }\n                    ]\n                },\n                {\n                    \"id\": \"2\",\n                    \"name\": \"Talla\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"5\",\n                            \"value\": \"M\"\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"id\": 12,\n            \"category\": {\n                \"id\": \"5063\",\n                \"name\": \"Ventas\"\n            },\n            \"hasNoIvaDays\": false,\n            \"name\": \"Camiseta / Verde / XS\",\n            \"description\": null,\n            \"reference\": null,\n            \"status\": \"active\",\n            \"price\": [\n                {\n                    \"idPriceList\": 1,\n                    \"name\": \"General\",\n                    \"type\": \"amount\",\n                    \"price\": \"70000.0000\"\n                }\n            ],\n            \"inventory\": {\n                \"initialQuantity\": 10,\n                \"initialQuantityDate\": \"2020-07-13\",\n                \"unit\": \"unit\",\n                \"unitCost\": 35000,\n                \"availableQuantity\": 10,\n                \"warehouses\": [\n                    {\n                        \"name\": \"Principal\",\n                        \"observations\": null,\n                        \"isDefault\": true,\n                        \"address\": null,\n                        \"status\": \"active\",\n                        \"id\": \"1\",\n                        \"costCenter\": null,\n                        \"initialQuantity\": \"10.00\",\n                        \"availableQuantity\": \"10.00\",\n                        \"minQuantity\": null,\n                        \"maxQuantity\": null\n                    }\n                ]\n            },\n            \"tax\": [],\n            \"customFields\": [],\n            \"productKey\": null,\n            \"type\": \"variant\",\n            \"variantAttributes\": [\n                {\n                    \"id\": \"1\",\n                    \"name\": \"Color\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"2\",\n                            \"value\": \"Verde\"\n                        }\n                    ]\n                },\n                {\n                    \"id\": \"2\",\n                    \"name\": \"Talla\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"4\",\n                            \"value\": \"XS\"\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"id\": 13,\n            \"category\": {\n                \"id\": \"5063\",\n                \"name\": \"Ventas\"\n            },\n            \"hasNoIvaDays\": false,\n            \"name\": \"Camiseta / Verde / M\",\n            \"description\": null,\n            \"reference\": null,\n            \"status\": \"active\",\n            \"price\": [\n                {\n                    \"idPriceList\": 1,\n                    \"name\": \"General\",\n                    \"type\": \"amount\",\n                    \"price\": \"70000.0000\"\n                }\n            ],\n            \"inventory\": {\n                \"initialQuantity\": 10,\n                \"initialQuantityDate\": \"2020-07-13\",\n                \"unit\": \"unit\",\n                \"unitCost\": 35000,\n                \"availableQuantity\": 10,\n                \"warehouses\": [\n                    {\n                        \"name\": \"Principal\",\n                        \"observations\": null,\n                        \"isDefault\": true,\n                        \"address\": null,\n                        \"status\": \"active\",\n                        \"id\": \"1\",\n                        \"costCenter\": null,\n                        \"initialQuantity\": \"10.00\",\n                        \"availableQuantity\": \"10.00\",\n                        \"minQuantity\": null,\n                        \"maxQuantity\": null\n                    }\n                ]\n            },\n            \"tax\": [],\n            \"customFields\": [],\n            \"productKey\": null,\n            \"type\": \"variant\",\n            \"variantAttributes\": [\n                {\n                    \"id\": \"1\",\n                    \"name\": \"Color\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"2\",\n                            \"value\": \"Verde\"\n                        }\n                    ]\n                },\n                {\n                    \"id\": \"2\",\n                    \"name\": \"Talla\",\n                    \"status\": \"active\",\n                    \"options\": [\n                        {\n                            \"id\": \"5\",\n                            \"value\": \"M\"\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}","language":"json","name":"Producto con variantes creado","status":201}]},"settings":"","examples":{"codes":[{"code":"{\n  \"name\": \"Consultoría diseño de billeteras\",\n\t\"price\" : 1500\n}","language":"json","name":"Servicio"},{"code":"{\n  \"name\": \"Cartera\",\n  \"description\": \"Cartera de cuero color café\",\n  \"reference\": \"CAR-195\",\n  \"category\" : {\n    \"id\" : 54\n    },\n  \"inventory\": {\n    \"unit\" : \"piece\",\n    \"unitCost\" : 2560,\n    \"initialQuantity\" : 160,\n    \"minQuantity\": 100\n    },\n   \"itemCategory\": {\n        \"id\": \"3\",\n        \"name\": \"Accesorios\",\n        \"description\": \"De lujo\",\n        \"status\": \"active\"\n    },\n  \"tax\" : [\n    {\n      \"id\" : 6\n    }\n  ],\n  \"price\" : [\n    {\n      \"price\" : 4050\n      },\n    {\n      \"idPriceList\" : 2,\n      \"price\" : 3900\n    },\n    {\n      \"idPriceList\" : 6\n    }\n  ],\n  \"customFields\": [\n    {\n    \t\"key\": \"barcode\",\n      \"value\": \"ABCD1234\"\n    }\n  ]\n}","language":"json","name":"Producto completo"},{"code":"{\n  \"name\": \"Cartera\",\n  \"description\": \"Cartera de cuero color café\",\n  \"reference\": \"CAR-195\",\n  \"category\" : {\n    \"id\" : 54\n    },\n  \"inventory\": {\n    \"unit\" : \"piece\",\n    \"unitCost\" : 2560,\n    \"warehouses\": [\n      {\n        \"id\": 1,\n        \"initialQuantity\": 10,\n        \"minQuantity\": 6\n      },\n      {\n        \"id\": 2,\n        \"initialQuantity\": 20,\n        \"maxQuantity\": 30\n      },\n      {\n        \"id\": 3,\n        \"initialQuantity\": 100,\n        \"minQuantity\": 80,\n        \"maxQuantity\": 120\n      }\n    ]\n  },\n  \"tax\" : [\n    {\n      \"id\" : 6\n    }\n    ],\n  \"price\" : [\n    {\n      \"price\" : 4050\n      },\n    {\n      \"idPriceList\" : 2,\n      \"price\" : 3900\n    },\n    {\n      \"idPriceList\" : 6\n    }\n  ]\n}","language":"json","name":"Producto con bodegas"},{"code":"{\n  \"name\": \"Camiseta S\",\n  \"inventory\": {\n    \"unit\": \"unit\"\n  },\n  \"price\": 1200\n}","language":"json","name":"Producto simple Perú"},{"code":"{\n\t\"name\" : \"Item 5\",\n\t\"price\" : 10000,\n\t\"inventory\": {\n  \t\"unit\": \"unit\"\n  },\n}","language":"json","name":"Producto simple Argentina"},{"name":"Producto Kit","language":"json","code":"{\n    \"name\": \"Kit de cuadernos escolares\",\n    \"price\": 70000,\n    \"type\": \"kit\",\n    \"subitems\": [\n        {\n            \"quantity\": \"1.00\",\n            \"item\": {\n                \"id\": 1\n            }\n        },\n        {\n            \"quantity\": \"5\",\n            \"item\": {\n                \"id\": 1\n            }\n        }\n    ],\n    \"kitWarehouse\": {\n        \"id\": \"1\"\n    }\n}"},{"code":"{\n\t\"name\": \"Camiseta\",\n\t\"price\": 70000,\n\t\"type\": \"variantParent\",\n\t\"inventory\": {\n\t\t\"unit\": \"unit\",\n\t\t\"unitCost\": 35000\n\t},\n\t\"variantAttributes\": [\n\t\t{\n\t\t\t\"id\": 1,\n\t\t\t\"options\": [\n\t\t\t\t{\n\t\t\t\t\t\"id\": 1\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"id\": 2\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"id\": 2,\n\t\t\t\"options\": [\n\t\t\t\t{\n\t\t\t\t\t\"id\": 4\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"id\": 5\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t],\n\t\"itemVariants\": [\n\t\t{\n\t\t\t\"inventory\": {\n\t\t\t\t\"initialQuantity\": 10\n\t\t\t},\n\t\t\t\"variantAttributes\": [\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"1\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"1\",\n\t\t\t\t\t\t\t\"value\": \"Rojo\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"2\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"4\",\n\t\t\t\t\t\t\t\"value\": \"XS\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"inventory\": {\n\t\t\t\t\"initialQuantity\": 10\n\t\t\t},\n\t\t\t\"variantAttributes\": [\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"1\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"1\",\n\t\t\t\t\t\t\t\"value\": \"Rojo\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"2\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"5\",\n\t\t\t\t\t\t\t\"value\": \"M\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"inventory\": {\n\t\t\t\t\"initialQuantity\": 10\n\t\t\t},\n\t\t\t\"variantAttributes\": [\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"1\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"2\",\n\t\t\t\t\t\t\t\"value\": \"Verde\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"2\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"4\",\n\t\t\t\t\t\t\t\"value\": \"XS\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t{\n\t\t\t\"inventory\": {\n\t\t\t\t\"initialQuantity\": 10\n\t\t\t},\n\t\t\t\"variantAttributes\": [\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"1\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"2\",\n\t\t\t\t\t\t\t\"value\": \"Verde\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"id\": \"2\",\n\t\t\t\t\t\"options\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"id\": \"5\",\n\t\t\t\t\t\t\t\"value\": \"M\"\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}","language":"json","name":"Producto con variantes"}]},"method":"post"},"next":{"description":"","pages":[]},"title":"Crear producto","type":"endpoint","slug":"crear-producto-o-servicio","excerpt":"","body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"La unidad de medida es obligatoria en Perú, Costa Rica y Argentina\",\n  \"body\": \"Para Perú, Costa Rica y Argentina, es necesario enviar el objeto **inventory** con el atributo **unit**. \\n\\nLos valores posibles son: \\n\\n- Perú: unit, centimeter, meter, inch, centimeterSquared, meterSquared, inchSquared, mililiter, liter, gallon, gram, kilogram, ton, pound, piece, service.\\n\\n- Costa Rica: service, unit, second, minute, hour, day, centimeter, milimeter, meter, inch, meterSquared, meterCubic, mililiter, liter, gallon, gram, kilogram, ton, onza.\\n\\n- Argentina: service, unit, kilogram, meter, meterSquared, meterCubic, liter, gram, mililiter.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Creación de items con variantes (variantParent)\",\n  \"body\": \"Para items con variantes se debe enviar un item variante por cada una de las combinaciones de los atributos variantes del item padre. Por ejemplo:  La compañía X tiene un item que contiene los atributos variantes \\\"COLOR\\\" y \\\"TALLA\\\" con las opciones \\\"Color: Blanco\\\", \\\"Color: Rojo\\\", \\\"Talla: XS\\\", \\\"Talla: M\\\". Esto quiere decir que el item padre, contendrá 4 items variantes (un item Blanco XS, otro Blanco M, otro Rojo XS y otro Rojo M)\"\n}\n[/block]","updates":["59e4b68dd6befe0026e28cd0"],"order":3,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"56b0cbcbce5f410d0056c9c6","parentDoc":null,"editedParams":true,"editedParams2":true,"createdAt":"2016-02-02T15:31:23.817Z","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"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":43,"createdAt":"2016-01-29T20:57:39.712Z"},"category":{"sync":{"isSync":false,"url":""},"pages":["56d5f18b31857e2500db0d4b"],"title":"Productos o servicios","slug":"productos-o-servicios","order":1,"from_sync":false,"reference":true,"_id":"56b3b8ea9f97020d0012d936","__v":1,"createdAt":"2016-02-04T20:47:38.572Z","project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d"},"user":"56abd213d4432d1900eed227","project":"56abd2434e4b730d009eb10a","__v":39,"githubsync":""}

postCrear producto


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

name:
required
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. Longitud máxima permitida: 45.
reference:
object
Para Costa Rica, el atributo reference es un objeto compuesto por los siguientes atributos: `type(string)` tipo de referencia. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/costa-rica). `reference (string)` código de referencia establecido para el producto.
price:
required
mixed
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.
category:
object
Objeto categoría que contiene el id de la categoría de Alegra a la cual se desea asociar el producto o servicio. Si no se envía este atributo el producto o servicio queda asociado a la categoría de Ventas.
inventory:
object
Indica los atributos del inventario del producto. Si es un servicio este atributo se debe omitir. Este objeto debe contener los siguientes atributos: `unit (string, obligatorio)`: 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, obligatorio)`: Costo unitario del producto. `initialQuantity (number, obligatorio)`: Cantidad inicial del producto. Si se desea distribuir el producto en bodegas 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 (integer, obligatorio)` : Identificador de la bodega; `initialQuantity (integer, obligatorio)` : Cantidad inicial del producto en la bodega, `minQuantity (integer)`: Cantidad mínima configurada para el producto en la bodega, `maxQuantity (integer)`: Cantidad máxima configurada para el producto en la bodega.
tax:
mixed
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.
type:
stringsimple
Indica el tipo de producto. Las opciones posibles son simple o kit
customFields:
array of objects
Arreglo con objetos que representa los campos adicionales del ítem. El objeto debe estar compuesto por los siguientes atributos: `id (int)` Id del campo adicional. `value (string)` valor a asignar en el campo adicional para el item..
productKey:
string
Para México, Costa Rica y Colombia, representa el número de la clave de producto o ClaveProdServ, debe contener 8 dígitos. Para Colombia, representa el código de producto o servicio, debe contener 8 dígitos, si no lo conoces haz clic [aquí](https://ayuda.alegra.com/agrega-el-c%C3%B3digo-de-producto-a-tus-%C3%ADtems-de-venta).
subitems:
array of objects
Indica los subitems de un kit. Obligatorio si el atributo type del producto es kit. Array que indica los items que componen un kit. Por cada subitem que se desee agregar se debe indicar la cantidad del item que compone el kit y el atributo item, el cual es un objeto que contiene el atributo id que indica el identificador del producto que se desea asociar al producto.
kitWarehouse:
object
Indica la bodega asociada al Kit. Se debe enviar solo si el producto es de tipo kit Si no se envía se asocia la bodega principal.
tariffHeading:
string
Para Costa Rica, indica la partida arancelaria de un ítem. Longitud permitida: 12.
itemCategory:
object
Indica la categoría de ítem a asociar. Se debe tener en cuenta si la categoría de ítem está activa para asociar el ítem.
variantAttributes:
array of objectsnull
Arreglo con objetos que representa los atributos variantes del ítem. Obligatorio si el atributo type del producto es variantParent. El objeto debe estar compuesto por los siguientes atributos: `id (int)` Id del atributo variante. `options(array of objects)` Array de objetos con los ids de las opciones a agregar en el item.
itemVariants:
array of objectsnull
Arreglo con objetos que representan los items variantes de un item padre (item con variantes). Obligatorio si el atributo type del producto es variantParent. El objeto debe estar compuesto por los siguientes atributos: `inventory (object)` Objeto que representa la distribución del item variante en el inventario, el atributo `initialQuantity` es obligatorio . `variantAttributos(array of objects)` Array de objetos que representan los atributos variantes asociados al item variante.
accounting:
mixed
Objeto que contiene las cuentas de inventario y compras inventariables de los items inventariables. Las opciones disponibles son: inventory e inventariablePurchase. Se puede enviar solo el id de la cuenta contable o como objeto

Examples


Result Format


Documentation

[block:callout] { "type": "warning", "title": "La unidad de medida es obligatoria en Perú, Costa Rica y Argentina", "body": "Para Perú, Costa Rica y Argentina, es necesario enviar el objeto **inventory** con el atributo **unit**. \n\nLos valores posibles son: \n\n- Perú: unit, centimeter, meter, inch, centimeterSquared, meterSquared, inchSquared, mililiter, liter, gallon, gram, kilogram, ton, pound, piece, service.\n\n- Costa Rica: service, unit, second, minute, hour, day, centimeter, milimeter, meter, inch, meterSquared, meterCubic, mililiter, liter, gallon, gram, kilogram, ton, onza.\n\n- Argentina: service, unit, kilogram, meter, meterSquared, meterCubic, liter, gram, mililiter." } [/block] [block:callout] { "type": "warning", "title": "Creación de items con variantes (variantParent)", "body": "Para items con variantes se debe enviar un item variante por cada una de las combinaciones de los atributos variantes del item padre. Por ejemplo: La compañía X tiene un item que contiene los atributos variantes \"COLOR\" y \"TALLA\" con las opciones \"Color: Blanco\", \"Color: Rojo\", \"Talla: XS\", \"Talla: M\". Esto quiere decir que el item padre, contendrá 4 items variantes (un item Blanco XS, otro Blanco M, otro Rojo XS y otro Rojo M)" } [/block]

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