Crear ítem

Endpoint que permite crear un producto o servicio

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Nombre del producto o servicio. Longitud máxima permitida: 150.

string

Descripción del producto o servicio. Longitud máxima permitida: 500.

string

Referencia del producto o servicio. Longitud máxima permitida: 45.

required

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.


Valor con el precio del producto

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.

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.


id del impuesto a asociar

string
enum

Indica el tipo de producto. Las opciones posibles son product, service, variantParent y kit

Allowed:
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.

customFields
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.

subitems
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.

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 objects

Arreglo con objetos que representa los atributos variantes del ítem. Obligatorio si el atributo type del item 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.

variantAttributes
accounting
object

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

Responses

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json