📦 Detalle de Artículo de Inventario
Descripción General
La página de Detalle de Artículo muestra información completa sobre un item del inventario, incluyendo niveles de stock, ubicaciones en almacenes, historial de movimientos y fotos. Esta vista permite gestionar y monitorear cada artículo de forma individual.
Cómo Acceder
- Vaya a Inventario → Artículos
- En la lista de artículos, haga clic en el ícono de ojo (👁) o en el nombre del artículo
- Se abrirá la página de detalle completo
Secciones de la Página
Header (Encabezado)
Información mostrada:
- Nombre del artículo: Título principal
- Código: Identificador único del artículo
- SKU: Stock Keeping Unit (si está definido)
Botones de acción:
- Descargar PDF: Genera reporte en PDF del artículo
- Editar: Abre formulario para modificar el artículo
- Registrar Movimiento: Crea nuevo movimiento para este artículo
Alertas de Stock
El sistema muestra alertas automáticas según el nivel de stock:
Alerta de Stock Agotado (Roja)
- Cuándo aparece: Cuando el stock total es 0
- Mensaje: "Este item está sin stock"
- Color: Rojo (error)
- Acción recomendada: Crear orden de compra o transferir desde otro almacén
Alerta de Stock Bajo (Amarilla)
- Cuándo aparece: Cuando el stock total ≤ stock mínimo definido
- Mensaje: "Stock bajo - Mínimo: [cantidad][unidad]"
- Color: Amarillo (warning)
- Acción recomendada: Planificar reabastecimiento
Tarjetas de Estadísticas
La página muestra 6 tarjetas con información clave:
1. Stock Total
- Qué muestra: Cantidad total en todos los almacenes
- Color:
- Verde: Stock normal
- Amarillo: Stock bajo
- Rojo: Sin stock
- Unidad: Muestra la unidad de medida (UND, KG, LT, etc.)
2. Disponible
- Qué muestra: Stock total - Stock reservado
- Color: Verde (success)
- Significado: Cantidad que puede ser asignada a nuevos proyectos/salidas
3. Reservado
- Qué muestra: Cantidad reservada para proyectos u órdenes
- Color: Amarillo (warning)
- Significado: Stock comprometido pero no salido físicamente
4. Costo Unitario
- Qué muestra: Costo promedio ponderado por unidad
- Color: Azul (primary)
- Formato: Moneda (USD o VES)
- Actualización: Se recalcula automáticamente con cada entrada
5. Valor Total
- Qué muestra: Stock Total × Costo Unitario
- Color: Cyan (info)
- Significado: Valor total del inventario de este artículo
- Formato: Moneda con separadores de miles
6. Almacenes
- Qué muestra: Número de almacenes donde hay stock
- Color: Morado (secondary)
- Significado: Distribución del artículo
Pestañas (Tabs)
La página tiene 4 pestañas con información detallada:
Pestaña 1: Información
Muestra datos generales del artículo divididos en secciones:
Sección: Datos Generales
| Campo | Descripción | Ejemplo |
|---|---|---|
| Código | Identificador único | MAT-001 |
| SKU | Stock Keeping Unit | SKU-MAT-001 |
| Tipo | Clasificación del item | Producto, Material, Herramienta, Equipo, Consumible, Repuesto |
| Estado | Estado actual | Activo, Inactivo, Descontinuado |
| Categoría | Categoría del item | Tubería, Válvulas, Químicos, etc. |
| Unidad | Unidad de medida | UND, KG, LT, M, M3, etc. |
| Marca | Fabricante | Weatherford, Baker Hughes, etc. |
| Modelo | Modelo específico | GC6000, D650, etc. |
| Código de Barras | Barcode para escaneo | 123456789012 |
| Descripción | Detalle completo | Descripción técnica del artículo |
Colores de Tipo:
- PRODUCT (Producto): Azul
- MATERIAL (Material): Verde
- TOOL (Herramienta): Naranja
- EQUIPMENT (Equipo): Morado
- CONSUMABLE (Consumible): Rojo
- SPARE_PART (Repuesto): Cyan
Estados:
- ACTIVE (Activo): Chip verde - Item en uso normal
- INACTIVE (Inactivo): Chip gris - Item temporalmente no disponible
- DISCONTINUED (Descontinuado): Chip rojo - Item que ya no se usa
Sección: Niveles de Stock
Configuración de control de inventario:
| Campo | Descripción | Cuándo Usar |
|---|---|---|
| Stock Mínimo | Nivel mínimo antes de alerta | Define cuándo aparece alerta amarilla |
| Stock Máximo | Nivel máximo recomendado | Evita sobrestock |
| Punto de Reorden | Nivel que dispara reorden | Cuándo crear requisición automática |
| Cantidad a Pedir | Cantidad estándar de pedido | Cuánto pedir al llegar al punto de reorden |
Ejemplo de configuración:
Stock Mínimo: 50 UND
Stock Máximo: 500 UND
Punto de Reorden: 100 UND
Cantidad a Pedir: 200 UND
Interpretación:
- Si stock ≤ 50: Alerta de stock bajo
- Si stock ≤ 100: Crear requisición de 200 unidades
- No comprar si stock > 500
Sección: Trazabilidad
Control avanzado de inventario:
| Campo | Descripción | Cuándo Activar |
|---|---|---|
| Seguimiento por Serie | Cada unidad tiene número de serie único | Equipos costosos, activos críticos |
| Seguimiento por Lote | Grupos de unidades con mismo lote | Químicos, materiales con vencimiento |
Ejemplo de uso:
- Serie: Bombas ESP, motores, equipos electrónicos (cada uno con S/N)
- Lote: Aceites, químicos, cemento (lote de fabricación)
Pestaña 2: Stock por Almacén
Muestra distribución del artículo en todos los almacenes.
Tabla de Stock
| Columna | Descripción | Información |
|---|---|---|
| Almacén | Nombre y código del almacén | Click para ir al detalle del almacén |
| Tipo | Tipo de almacén | MAIN, SECONDARY, TRANSIT, PROJECT |
| Ubicación | Ubicación específica dentro del almacén | Pasillo, rack, nivel |
| Cantidad | Stock total en ese almacén | Número en negrita |
| Reservado | Cantidad reservada | Color amarillo |
| Disponible | Cantidad - Reservado | Color verde, en negrita |
| Valor | Cantidad × Costo Unitario | Valor en ese almacén |
Tipos de Almacén:
- MAIN (Principal): Almacén central principal
- SECONDARY (Secundario): Almacenes auxiliares
- TRANSIT (Tránsito): Almacenes temporales
- PROJECT (Proyecto): Almacenes en proyectos específicos
Funcionalidades:
- Click en nombre del almacén → Abre detalle del almacén
- Suma automática de totales
- Identificación visual de almacenes con stock bajo
Ejemplo de vista:
Almacén Central (ALM-001)
Tipo: MAIN | Ubicación: Pasillo A, Rack 3
Cantidad: 250 | Reservado: 50 | Disponible: 200
Valor: $12,500.00
Almacén Campo Libertad (ALM-LIB)
Tipo: PROJECT | Ubicación: Bodega Principal
Cantidad: 80 | Reservado: 0 | Disponible: 80
Valor: $4,000.00
Pestaña 3: Movimientos
Historial de todos los movimientos del artículo.
Tabla de Movimientos
| Columna | Descripción | Información |
|---|---|---|
| Código | Código del movimiento | MOV-IN-2025-001, MOV-OUT-2025-045 |
| Fecha | Fecha del movimiento | Formato: DD/MM/YYYY |
| Tipo | Tipo de movimiento | Chip con color según tipo |
| Origen | Almacén de origen | Nombre del almacén (si aplica) |
| Destino | Almacén destino | Nombre del almacén (si aplica) |
| Cantidad | Cantidad movida | Número en negrita + unidad |
| Descripción | Detalle del movimiento | Texto truncado (máx 200 caracteres) |
Tipos de Movimiento:
| Tipo | Color | Icono | Descripción |
|---|---|---|---|
| ENTRY | Verde | ↓ | Entrada al inventario |
| EXIT | Rojo | ↑ | Salida del inventario |
| TRANSFER | Azul | → | Transferencia entre almacenes |
| ADJUSTMENT_IN | Verde | ↓ | Ajuste positivo (conteo) |
| ADJUSTMENT_OUT | Amarillo | ↑ | Ajuste negativo (conteo) |
| RETURN | Morado | ↓ | Devolución al inventario |
| RESERVATION | Gris | ⇄ | Reserva de stock |
| RELEASE | Gris | ⇄ | Liberación de reserva |
Información mostrada:
- Movimientos ordenados por fecha (más recientes primero)
- Máximo 50 movimientos recientes
- Link a detalle completo de movimientos
Ejemplo de movimiento:
MOV-IN-2025-045
Fecha: 15/01/2025
Tipo: ENTRADA (verde)
Origen: -
Destino: Almacén Central
Cantidad: 100 UND
Descripción: Recepción desde OC-2025-030 - Proveedor ABC
Pestaña 4: Fotos
Galería de imágenes del artículo.
Funcionalidades
Subir Fotos:
- Click en "Subir Archivo"
- Seleccione imagen (JPG, PNG, PDF)
- Agregue descripción (opcional)
- Seleccione categoría: PHOTO, DOCUMENT, SPECIFICATION, etc.
Ver Fotos:
- Miniaturas en cuadrícula
- Click en miniatura → Vista ampliada
- Descarga de imagen original
- Información de subida (usuario, fecha)
Eliminar Fotos:
- Botón de eliminar en cada foto
- Confirmación antes de eliminar
- Solo usuarios con permisos pueden eliminar
Categorías de Archivos:
- PHOTO: Fotos del producto
- DOCUMENT: Documentos relacionados
- SPECIFICATION: Especificaciones técnicas
- CERTIFICATE: Certificados
- WARRANTY: Garantías
- MANUAL: Manuales de uso
Ejemplo de uso:
Foto 1: Bomba ESP vista frontal
Categoría: PHOTO
Subido por: Juan Pérez
Fecha: 10/01/2025
Foto 2: Placa de características
Categoría: SPECIFICATION
Subido por: María González
Fecha: 10/01/2025
Casos de Uso
Caso 1: Verificar Stock Antes de Asignar a Proyecto
Escenario: Ingeniero necesita 50 tubos de 3" para proyecto
Pasos:
- Buscar artículo "Tubo 3 pulgadas"
- Abrir detalle del artículo
- Verificar tarjeta "Disponible": 120 UND
- Revisar pestaña "Stock por Almacén"
- Identificar almacén más cercano al proyecto
- Click en "Registrar Movimiento"
- Crear salida de 50 unidades
Resultado: Stock disponible suficiente, movimiento registrado
Caso 2: Identificar Necesidad de Reabastecimiento
Escenario: Alerta de stock bajo en aceite hidráulico
Pasos:
- Abrir detalle del artículo
- Ver alerta amarilla: "Stock bajo - Mínimo: 200 LT"
- Verificar tarjeta "Stock Total": 180 LT (amarillo)
- Revisar "Punto de Reorden": 250 LT
- Verificar "Cantidad a Pedir": 500 LT
- Crear requisición de compra de 500 litros
Resultado: Reabastecimiento planificado antes de agotarse
Caso 3: Rastrear Movimientos de Equipo Costoso
Escenario: Auditoría de bomba ESP valorada en $45,000
Pasos:
- Buscar bomba por código o serie
- Abrir detalle del artículo
- Verificar "Seguimiento por Serie": Sí
- Ir a pestaña "Movimientos"
- Revisar historial completo:
- Entrada desde OC-2025-030 (15/01/2025)
- Conversión a activo ACT-ESP-125 (20/01/2025)
- Instalación en pozo LIB-023 (25/01/2025)
- Verificar fotos y documentación
Resultado: Trazabilidad completa desde compra hasta instalación
Caso 4: Distribuir Stock Entre Almacenes
Escenario: Almacén central tiene exceso, campo necesita stock
Pasos:
- Abrir detalle del artículo
- Ir a pestaña "Stock por Almacén"
- Verificar distribución:
- Almacén Central: 450 UND (exceso)
- Almacén Campo: 20 UND (bajo)
- Click en "Registrar Movimiento"
- Tipo: TRANSFER
- Origen: Almacén Central
- Destino: Almacén Campo
- Cantidad: 100 UND
Resultado: Stock balanceado entre almacenes
Consejos Útiles
Para Control de Stock
✅ Configure niveles de stock para todos los artículos críticos
✅ Revise alertas diariamente en el dashboard
✅ Mantenga actualizado el costo unitario
✅ Use punto de reorden para automatizar requisiciones
✅ Verifique disponible antes de comprometer stock
Para Trazabilidad
✅ Active seguimiento por serie para equipos costosos
✅ Use seguimiento por lote para materiales con vencimiento
✅ Suba fotos de todos los equipos importantes
✅ Documente especificaciones técnicas
✅ Revise movimientos periódicamente
Para Valoración
✅ El costo unitario se actualiza automáticamente con promedio ponderado
✅ Valor total refleja la inversión en ese artículo
✅ Revise valoración mensualmente para auditorías
✅ Compare costos entre diferentes proveedores
Preguntas Frecuentes
¿Por qué el stock disponible es menor que el total?
El stock reservado se resta del total. Esto ocurre cuando hay proyectos u órdenes que han comprometido material pero aún no lo han retirado físicamente.
¿Cómo se calcula el costo unitario?
Se usa costo promedio ponderado: cada entrada actualiza el costo según la fórmula:
Nuevo Costo = (Stock Anterior × Costo Anterior + Cantidad Nueva × Costo Nuevo) / Stock Total
¿Puedo ver movimientos de hace más de un mes?
La pestaña muestra los 50 movimientos más recientes. Para ver historial completo, vaya a Inventario → Movimientos y filtre por el artículo.
¿Qué significa "Seguimiento por Serie"?
Cada unidad tiene un número de serie único. Útil para equipos costosos donde necesita rastrear cada pieza individualmente.
¿Puedo editar el stock directamente?
No. El stock solo se modifica mediante movimientos. Use ADJUSTMENT_IN o ADJUSTMENT_OUT para corregir diferencias de conteo.
¿Cómo agrego fotos del producto?
Vaya a la pestaña "Fotos", click en "Subir Archivo", seleccione la imagen, agregue descripción y categoría, luego guarde.