Ir al contenido
EN

Catálogos maestros

Los catálogos maestros son los datos de referencia que clasifican y organizan los artículos del inventario. Deben configurarse antes de crear artículos.

CatálogoDescripciónObligatorio en artículo
CategoríasClasificación principal del artículo
MarcasMarca o fabricanteNo
LíneasLínea de producto dentro de una marcaNo
ClasesClasificación adicional transversalNo
TiposNaturaleza del artículo (producto, servicio, etc.)
Unidades de medidaUnidad en que se mide el artículo

Las categorías son la clasificación principal de los artículos. Soportan jerarquía (categoría padre / subcategoría).

Lista de categorías de inventario con estructura jerárquica

Nota de calidad: la carga de categorías puede fallar por error en cache.zentto.net/v1/grid-layouts (HTTP 500). Si la lista aparece vacía, recarga la página. Bug registrado.

Electrónica
├── Computadoras
│ ├── Laptops
│ └── Escritorio
├── Periféricos
│ ├── Teclados
│ └── Monitores
└── Componentes
├── Procesadores
└── Memorias RAM
  1. Vaya a Inventario → Catálogos → Categorías.
  2. Haga clic en Nueva categoría.
  3. Complete los campos:
CampoTipoObligatorioDescripción
CódigoTextoSí*Código único de la categoría
NombreTextoSí*Nombre de la categoría
Categoría padreSelectorNoPara crear subcategorías
DescripciónTextoNoDescripción adicional
Cuenta contableSelectorNoCuenta de inventario asociada
EstadoToggleActiva / Inactiva
  1. Haga clic en Guardar.

Al crear un artículo, seleccione la categoría más específica (hoja del árbol). Esto permite generar reportes agrupados por cualquier nivel de la jerarquía.

Las marcas identifican al fabricante o marca comercial del artículo.

  1. Vaya a Inventario → Catálogos → Marcas.
  2. Haga clic en Nueva marca.
  3. Complete:
CampoTipoObligatorioDescripción
CódigoTextoSí*Código único
NombreTextoSí*Nombre de la marca
LogoImagenNoLogo de la marca
EstadoToggleActiva / Inactiva
  1. Guarde.

Lista de marcas de inventario con código y nombre

Las líneas representan subdivisiones dentro de una marca. Por ejemplo, la marca “Samsung” puede tener las líneas “Galaxy S”, “Galaxy A”, “Galaxy Tab”.

  1. Vaya a Inventario → Catálogos → Líneas.
  2. Haga clic en Nueva línea.
  3. Complete:
CampoTipoObligatorioDescripción
CódigoTextoSí*Código único
NombreTextoSí*Nombre de la línea
MarcaSelectorNoMarca asociada
DescripciónTextoNoDescripción adicional
EstadoToggleActiva / Inactiva
  1. Guarde.

Las clases son una clasificación adicional transversal que permite agrupar artículos de diferentes categorías bajo un criterio común.

Ejemplo: La clase “Importado” puede aplicarse a artículos de cualquier categoría (electrónica, ropa, alimentos).

  1. Vaya a Inventario → Catálogos → Clases.
  2. Haga clic en Nueva clase.
  3. Complete:
CampoTipoObligatorioDescripción
CódigoTextoSí*Código único
NombreTextoSí*Nombre de la clase
DescripciónTextoNoDescripción
EstadoToggleActiva / Inactiva
  1. Guarde.

Los tipos definen la naturaleza fundamental del artículo y determinan su comportamiento en el sistema:

TipoAfecta inventarioDescripción
ProductoBien físico que se compra y vende
ServicioNoServicio que se factura pero no tiene stock
Materia primaMaterial para producción
Producto terminadoResultado de un proceso de manufactura
Producto en procesoEn medio de un proceso productivo
InsumoMaterial de consumo interno
Activo fijoNoBien de la empresa (se gestiona en Contabilidad)

Lista de líneas de productos de inventario con código, nombre y marca asociada

Las unidades de medida definen cómo se cuantifica cada artículo.

CódigoNombreGrupo
UNDUnidadCantidad
PARParCantidad
DOCDocenaCantidad
KGKilogramoPeso
GRGramoPeso
LBLibraPeso
LTLitroVolumen
MLMililitroVolumen
GLGalónVolumen
MTMetroLongitud
CMCentímetroLongitud
M2Metro cuadradoÁrea
M3Metro cúbicoVolumen
CJCajaEmpaque
BLBultoEmpaque
PQTPaqueteEmpaque
  1. Vaya a Inventario → Catálogos → Unidades de medida.
  2. Haga clic en Nueva unidad.
  3. Complete:
CampoTipoObligatorioDescripción
CódigoTextoSí*Abreviatura (ej: KG)
NombreTextoSí*Nombre completo (ej: “Kilogramo”)
GrupoSelectorSí*Cantidad, Peso, Volumen, Longitud, Área, Empaque
Factor de conversiónNuméricoNoFactor respecto a la unidad base del grupo
EstadoToggleActiva / Inactiva
  1. Guarde.

Lista de unidades de medida agrupadas por tipo con código y nombre

Si un artículo se compra en cajas pero se vende por unidad, configure la conversión:

  • Unidad de compra: Caja (CJ)
  • Unidad de venta: Unidad (UND)
  • Factor: 1 CJ = 24 UND

Esta conversión se configura a nivel de artículo en la pestaña de unidades.

  1. Defina los catálogos antes de crear artículos — Tener las categorías, marcas y unidades listas facilita la carga.
  2. Use códigos consistentes — Defina una convención de codificación y manténgala.
  3. No cree categorías demasiado específicas — Prefiera una jerarquía de 2-3 niveles.
  4. Revise periódicamente — Desactive catálogos que ya no se usan.
  5. Asigne cuentas contables a categorías — Esto automatiza la contabilización.

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

Flujo del usuario — Inventario · Catálogos

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

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

Flujo técnico — Inventario · Catálogos

ComponenteTipoUbicación
/v1/inventory/categoriesRoute Expressweb/api/src/routes/inventario/categories.ts
/v1/inventory/brandsRoute Expressweb/api/src/routes/inventario/brands.ts
/v1/inventory/linesRoute Expressweb/api/src/routes/inventario/lines.ts
/v1/inventory/uomsRoute Expressweb/api/src/routes/inventario/uoms.ts
usp_inv_Category_ListStored procedure (SQL Server + función PG)web/api/sqlweb*/includes/sp/
usp_inv_Category_InsertStored procedure (SQL Server + función PG)web/api/sqlweb*/includes/sp/
usp_inv_Brand_ListStored procedure (SQL Server + función PG)web/api/sqlweb*/includes/sp/
usp_inv_Brand_InsertStored procedure (SQL Server + función PG)web/api/sqlweb*/includes/sp/
usp_inv_Line_ListStored procedure (SQL Server + función PG)web/api/sqlweb*/includes/sp/
usp_inv_UOM_ListStored procedure (SQL Server + función PG)web/api/sqlweb*/includes/sp/
inv.CategoryTabla de categorías con jerarquía (self-FK)web/api/migrations/postgres/...
inv.BrandTabla de marcasweb/api/migrations/postgres/...
inv.ProductLineTabla de líneas de productoweb/api/migrations/postgres/...
inv.UOMTabla de unidades de medida con factor de conversiónweb/api/migrations/postgres/...
inv.ItemTabla destino de las FKs de catálogosweb/api/migrations/postgres/...

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