Productos y servicios

Endpoint /items

Los productos o servicios representan lo que tu negocio vende y/o compra.

Inventario

Los productos son objetos tangibles que tu empresa tiene disponible para la venta y a los cuales les controlas el inventario. (En la aplicación se conoce como inventariables). Estos deben tener una unidad de medida (metros, cm, litros), una cantidad inicial (el número de productos disponibles inicialmente para la venta) y un costo unitario. Al realizar movimientos con estos productos la aplicación automáticamente actualiza el inventario en cuanto a costo unitario y cantidades.

A un servicio, por el contrario, no se le controla el inventario.

Precio o Listas de precio

Alegra soporta listas de precios, por lo tanto el precio de un producto o servicio puede estar conformado por varias listas de precio. Todas las cuentas de Alegra cuentan con una lista de precios llamada "General", en ésta se registra el precio general del producto. Al consultar un producto o servicio por el API, el precio va a estar conformado por todas las listas de precio. Si se desea consultar el precio general del producto, se debe consultar el precio indicado en la lista de precios General (o identificada con el id 1). Para saber más sobre listas de precio haz clic aquí.

Las listas de precios ayudan a establecer precios especiales para productos y usarlos al momento de crear tus facturas de venta, cotizaciones, notas crédito o facturas recurrentes.

Cuando se registran productos y servicios en Alegra, estos se asocian por defecto a la lista general cuyos precios son la base para calcular el descuento de las nuevas listas a crear.

Las listas de precio se clasifican en dos tipos:

  • Lista de precio de porcentaje %: Con esta lista defines un porcentaje de descuento para todos los productos asociados a ella, tomando como base el precio general.

  • Lista de precio por valor: Con esta lista defines un menor o mayor valor específico para cada uno de los productos y servicios que asocies a ella en el momento de crearlos.

Tipos de productos

Los productos se separan en 4 tipos:

  • Sencillo: producto simple. Ejemplo: Cuadernos
  • Combos: items que contienen otros items. Ejemplo: Kit escolar.
  • Items con variantes: items que comparten ciertas características pero derivan otras. Ejemplo: Camisa referencia POL12 color verde
  • Item Variante: items agrupados por un item padre con características comunes. Ejemplo: Camisa referencia POL12.

Para identificar el tipo de un producto se utiliza el atributo type. Si el producto no contiene el atributo type se encontrará en simple; si está compuesto otros ítems se encontrará kit, si es un item con variantes se encontrará variantParent y es un item variante se encontrará variant.

Cuando un producto es de tipo kit los productos de los que está compuesto se pueden encontrar en el atributo subitems.

Se debe indicar en un combo la bodega que se desea asociar a los productos que lo componen para indicar en el momento que se está haciendo una venta la bodega de la cual salen los productos. Si no se asocia una bodega al crear el combo, éste queda asociado a la bodega principal. Cuando se manejan múltiples bodegas todos los productos dentro del combo deben pertenecer a la misma bodega o almacén.

Categorías

Se puede asociar categorías a los ítems, las cuales permiten agrupar varios items para gestionarlos con mayor facilidad dividiendo los elementos por secciones.

Bodegas o Almacenes

Una bodega o almacén es un espacio donde se guarda la mercancía que posteriormente será comercializada. Cada empresa puede tener distintos almacenes donde administrará el inventario de sus productos.

Campos adicionales

Son campos personalizados que se pueden crear según la necesidad del negocio en recursos particulares como productos.

Variantes

Los atributos variantes son atributos que varían entre productos pero no necesariamente alteran la estructura principal del producto (nombre, precio, impuesto). Los atributos variantes se pueden crear en la aplicación web desde Inventario -> Atributos -> Variantes.

Ejemplo de uso:
La compañía X tiene el producto llamado "Camiseta Polo Hombre" de la cuál tiene unidades en color rojo, azul y verde. La compañía crea un atributo variante llamado "Color" con las opciones "rojo", "azul" y "verde" para indicar que su producto tiene unidades con dichas variantes.

Ajustes de inventario

Un ajuste de inventario es un movimiento de entrada o salida de artículos en el almacén. Es funcional para agregar el inventario inicial, pérdidas o aumentos de mercancía.


Siguiente paso

El detalle completo del API de productos y servicios lo encontrarás aquí: