Artículos

Los artículos son la entidad central del módulo de Inventario. Representan los productos, materias primas, insumos o servicios que la empresa comercializa o utiliza internamente.

Vista de lista

La pantalla principal de artículos muestra un listado paginado con búsqueda y filtros avanzados.

Filtros disponibles

Filtro	Descripción
Búsqueda general	Busca por código, nombre o descripción
Categoría	Filtra por categoría del artículo
Marca	Filtra por marca
Línea	Filtra por línea de producto
Estado	Activo / Inactivo
Tipo	Producto, Servicio, Materia prima, Producto terminado
Con existencia	Muestra solo artículos con stock > 0

Crear un artículo

Para crear un nuevo artículo:

1. Navegue a Inventario → Artículos.
2. Haga clic en Nuevo artículo.
3. Complete los campos obligatorios (marcados con *).
4. Agregue información adicional en las pestañas correspondientes.
5. Haga clic en Guardar.

Campos principales

Campo	Tipo	Obligatorio	Descripción
Código	Texto	Sí*	Código único del artículo. Puede ser autogenerado.
Nombre	Texto	Sí*	Nombre descriptivo del artículo
Descripción	Texto largo	No	Descripción detallada
Categoría	Selector	Sí*	Categoría principal. Ver Catálogos.
Marca	Selector	No	Marca del artículo
Línea	Selector	No	Línea de producto
Clase	Selector	No	Clasificación adicional
Tipo	Selector	Sí*	Producto, Servicio, Materia prima, Producto terminado
Unidad de medida	Selector	Sí*	Unidad principal (UND, KG, LT, etc.)
Método de costeo	Selector	Sí*	Promedio, PEPS o Último costo
Precio de venta	Numérico	No	Precio base de venta
Costo referencial	Numérico	No	Costo unitario referencial
Impuesto (IVA)	Selector	Sí*	Tasa de impuesto aplicable
Código de barras	Texto	No	Código EAN/UPC
Peso	Numérico	No	Peso en kg
Volumen	Numérico	No	Volumen en m³

Pestañas del formulario

General

Datos básicos del artículo: código, nombre, categoría, marca, línea, tipo.

Precios y costos

Precio de venta, listas de precios, método de costeo, costo referencial, margen.

Impuestos

Configuración de IVA y otros impuestos aplicables al artículo.

Imágenes

Carga de imágenes del producto. Soporta múltiples imágenes con una imagen principal.

Inventario

Configuración de stock mínimo, stock máximo, punto de reorden por almacén.

Campo	Descripción
Stock mínimo	Cantidad mínima deseada. Alerta cuando baja de este nivel.
Stock máximo	Cantidad máxima recomendada.
Punto de reorden	Cantidad que dispara la sugerencia de compra.
Ubicación predeterminada	Bin/ubicación por defecto en el almacén (si usa WMS).

Serial / Lote

Activar trazabilidad por serial o lote. Ver Seriales y Lotes.

Proveedores

Asociar proveedores al artículo con código de proveedor, tiempo de entrega y costo.

Editar un artículo

1. Busque el artículo en la lista o use la búsqueda.
2. Haga clic en el artículo para abrir el detalle.
3. Modifique los campos necesarios.
4. Haga clic en Guardar cambios.

Nota

El código del artículo no se puede modificar una vez que tiene movimientos asociados.

Vista de detalle

La vista de detalle muestra toda la información del artículo organizada en secciones:

• Resumen — Datos generales y foto principal.
• Existencias — Stock actual por almacén con valorización.
• Movimientos — Historial de entradas, salidas, ajustes y transferencias.
• Compras — Historial de compras y proveedores.
• Ventas — Historial de ventas.

Activar / Desactivar artículos

Para desactivar un artículo sin eliminarlo:

1. Abra el detalle del artículo.
2. Haga clic en Acciones → Desactivar.
3. Confirme la acción.

Precaución

Desactivar un artículo lo oculta de los selectores en ventas y compras, pero no elimina su historial ni sus existencias.

Importación masiva

Para importar artículos desde un archivo Excel:

1. Vaya a Inventario → Artículos → Importar.
2. Descargue la plantilla Excel.
3. Complete la plantilla con los datos de sus artículos.
4. Suba el archivo y revise la vista previa.
5. Confirme la importación.

Tip

Asegúrese de que las categorías, marcas y unidades de medida existan antes de importar. Puede crearlas en Catálogos.

Secciones relacionadas

• Catálogos — Categorías, marcas, líneas y unidades
• Almacenes — Gestión de almacenes
• Seriales y Lotes — Trazabilidad por serial/lote
• Movimientos — Historial de movimientos

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de operación, contabilidad, ventas o administración.

Editable en draw.io: descarga el SVG → en draw.io: File → Import from → Device → selecciona el SVG. Cada nodo queda editable.

Flujo técnico

Vista técnica para desarrolladores: endpoints, stored procedures/funciones, tablas y servicios involucrados.

Componente	Tipo	Ubicación
/v1/inventory/items	Route Express	web/api/src/routes/inventario/items.ts
usp_inv_Item_List	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
usp_inv_Item_Get	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
usp_inv_Item_Insert	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
usp_inv_Item_Update	Stored procedure (SQL Server + función PG)	web/api/sqlweb*/includes/sp/
inv.Item	Tabla central de artículos	web/api/migrations/postgres/...
inv.Category	Tabla de categorías (FK)	web/api/migrations/postgres/...
inv.Brand	Tabla de marcas (FK)	web/api/migrations/postgres/...
inv.UOM	Tabla de unidades de medida (FK)	web/api/migrations/postgres/...
inv.Quant	Tabla de stock por almacén	web/api/migrations/postgres/...
inv.ItemSupplier	Tabla de proveedores por artículo	web/api/migrations/postgres/...
ArticulosListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-inventario/src/

Editable en draw.io: descarga el SVG → File → Import from → Device.