Lista de materiales (BOM)

La Lista de materiales (BOM — Bill of Materials) es el catálogo de componentes, insumos y materias primas que se necesitan para fabricar un producto terminado, junto con las cantidades requeridas.

Para qué sirve

Define la receta de producción de cada producto: qué materiales se usan, en qué cantidad y con qué versión de la fórmula. Las órdenes de trabajo toman la BOM como referencia para calcular el consumo esperado de inventario.

Vista principal

Cómo acceder

Navegar a Manufactura → BOM en el menú lateral.

Estructura de una BOM

Cada BOM se compone de:

• Producto terminado: el artículo que se va a fabricar.
• Versión: número de versión de la lista (útil cuando la fórmula cambia con el tiempo).
• Líneas de material: lista de insumos con cantidad y unidad de medida.

Ejemplo

BOM: Silla de Madera (PT-001) — v1.0
  Asiento (MP-010)   × 1 unidad
  Respaldo (MP-011)  × 1 unidad
  Patas (MP-012)     × 4 unidades
  Tornillos (MP-013) × 8 unidades
  Barniz (MP-014)    × 0.2 litros

Estados de una BOM

Estado	Descripción
Borrador	En edición, no disponible para órdenes
Activa	Disponible para crear órdenes de producción
Obsoleta	Ya no se debe usar; se mantiene para historial

Acciones disponibles

• Ver: abre el detalle de la BOM con sus líneas de material.
• Activar: cambia el estado de Borrador a Activa.
• Obsoleta: marca la BOM como fuera de uso.
• Eliminar: elimina una BOM en estado Borrador.

Nota sobre el estado actual

Hallazgo QA (2026-04-26):

• Las columnas “Producto” y “Costo Total” aparecen vacías en el listado. Causa: cache.zentto.net/v1/grid-layouts/module-manufactura:bom:list devuelve 500, impidiendo que el grid cargue su configuración de columnas (P0).
• El botón “Ver” en el listado no produce navegación ni abre modal (P2).
• El botón “Activar” aparece visible en BOMs que ya tienen estado Activa (lógica contradictoria, P2).
• El botón “Obsoleta” ejecuta la acción sin diálogo de confirmación (P2).

Flujo del usuario

Vista no técnica del proceso. Pensada para personal de producción 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, tablas y servicios involucrados.

Componente	Tipo	Ubicación
/v1/manufactura/bom	Route Express (GET, POST)	web/api/src/routes/manufactura/bom.ts
/v1/manufactura/bom/:id/activar	Route Express (POST)	web/api/src/routes/manufactura/bom.ts
/v1/manufactura/bom/:id/obsoleto	Route Express (POST)	web/api/src/routes/manufactura/bom.ts
usp_Mfg_BOM_List	Stored procedure (PG + MSSQL)	web/api/sqlweb-pg/includes/sp/
usp_Mfg_BOM_Get	Stored procedure (PG + MSSQL)	web/api/sqlweb-pg/includes/sp/
usp_Mfg_BOM_Create	Stored procedure (PG + MSSQL)	web/api/sqlweb-pg/includes/sp/
usp_Mfg_BOM_Activate	Stored procedure (PG + MSSQL)	web/api/sqlweb-pg/includes/sp/
usp_Mfg_BOM_Obsolete	Stored procedure (PG + MSSQL)	web/api/sqlweb-pg/includes/sp/
mfg.BillOfMaterials	Tabla operativa	web/api/migrations/postgres/
mfg.BOMLine	Tabla operativa	web/api/migrations/postgres/
BomListPage.tsx	Componente Frontend	web/modular-frontend/packages/module-manufactura/src/

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