Artículos de Stock

Los artículos de stock representan saldos de inventario físico de recursos en sitios específicos. Cada artículo de stock rastrea cuánto de un recurso particular existe en una ubicación particular.

Estructura de Artículos de Stock

Página de artículos de stock mostrando saldos de inventario actuales en diferentes sitios

Campos Principales:

• Recurso - Referencia a definición de recurso (ej. "Cable Cat6")
• Sitio - Ubicación de almacenamiento (almacén, vehículo, persona)
• Volumen - Cantidad/amount actual
• UOM - Unidad de medida (debe coincidir con UOMs soportados del recurso)

Metadatos:

• Número de Lote/Batch - Seguimiento opcional para lotes de recepción
• Fecha de Expiración - Para materiales con vida útil
• Propiedades - JSON flexible para seguimiento personalizado (notas de daño, info de proveedor, etc.)

Cómo Funcionan los Artículos de Stock

Actualizaciones Automáticas de Saldo

Los volúmenes de artículos de stock se actualizan automáticamente a través de transacciones:

• Recepción - Aumenta volumen (llega nuevo inventario)
• Transferencia - Reduce volumen fuente, aumenta volumen destino
• Consumo - Reduce volumen (trabajo de campo agota stock)
• Ajuste - Corrección manual (establece nuevo volumen, registra razón)

Nunca edites volúmenes manualmente - crea transacciones en su lugar.

Un Recurso, Múltiples Artículos de Stock

Un solo recurso puede tener muchos artículos de stock en diferentes sitios:

Recurso: "Cable Cat6" (metros)
  Artículo de Stock A: 500m en Almacén Central
  Artículo de Stock B: 50m en Sitio de Campo 12
  Artículo de Stock C: 10m en vehículo de John (sitio personal)
  Artículo de Stock D: 25m en vehículo de Jane (sitio personal)

Esto habilita:

• Visibilidad de inventario específico del sitio
• Transferencias peer-to-peer entre trabajadores
• Alertas de stock mínimo por ubicación

Creación de Artículos de Stock

Creación Manual:

1. Navegar a Inventario → Artículos de Stock
2. Hacer clic en "Agregar Artículo de Stock"
3. Seleccionar recurso y sitio
4. Volumen inicial establecido vía transacción receipt (no entrada directa)

Creación Automática vía Recepción:

1. Crear transacción tipo receipt en sitio destino
2. Si no existe artículo de stock para esa combinación recurso + sitio:
   • Artículo de stock creado automáticamente
   • Volumen establecido al amount de recepción
3. Si artículo de stock ya existe:
   • Volumen aumentado por amount de recepción

Creación Automática vía Transferencia: Cuando se escanea QR de recogida:

• Stock reducido en fuente (artículo de stock existente)
• Nuevo artículo de stock creado en sitio personal del destinatario (si no existe)
• O artículo de stock existente del destinatario aumentado

Visibilidad de Stock

Saldo en Tiempo Real:

• Niveles de stock se actualizan instantáneamente con transacciones
• Sin caché o actualizaciones retrasadas
• Crítico para validación de recogida QR (debe saber disponibilidad actual)

Filtrado por Sitio:

• Ver todo stock en almacén central
• Ver inventario personal del trabajador
• Ver inventario de vehículo
• Búsqueda cross-sitio para disponibilidad de recurso

Alertas de Stock Bajo:

• Establecer nivel mínimo de stock en definición de recurso
• Alerta se activa cuando cualquier artículo de stock cae por debajo del umbral
• Ayuda a gestionar reabastecimiento

Ciclo de Vida de Artículos de Stock

Ciclo de Vida Típico:

1. Recepción - Inventario llega al almacén (transacción de recepción)
2. Apartar - Planificado para asignación (sin transacción aún, solo planificación)
3. Recogida - Trabajador escanea código QR (transacción de transferencia a sitio personal)
4. Consumo - Trabajador completa tarea, envía reporte (transacción de consumo)
5. Devolución - Materiales no usados devueltos (transacción de transferencia de vuelta al almacén)

Saldo Cero: Los artículos de stock con volumen = 0 aún existen en base de datos:

• Preserva historial de transacciones
• Muestra qué sitios mantuvieron previamente el recurso
• Puede ser reabastecido con nueva recepción

Artículos de Stock Protegidos

Si el recurso tiene requiresProtection: true:

• No se puede transferir artículo de stock directamente
• Debe crear asignación con código QR de recogida
• Escanear QR valida autorización
• Transacción registra identidad del escáner y ubicación GPS

Recogidas Parciales Soportadas:

• Asignación solicita 10 unidades
• Solo 5 disponibles → trabajador toma 5
• pickupRemaining de asignación actualizado
• El mismo QR puede ser escaneado nuevamente cuando se reabastezca

Transacciones de Artículos de Stock

Ver todas las transacciones que afectan un artículo de stock:

• Navegar a vista de detalle del artículo de stock
• Pestaña "Historial de Transacciones" muestra:
  • Todas las recepciones, transferencias, consumos, ajustes
  • Quién realizó la acción
  • Cuándo y dónde (GPS para transferencias)
  • Cambios de volumen (de → a)

Esto proporciona registro de auditoría completo para cumplimiento y conciliación.

Mejores Prácticas

Organizar por Tipo de Sitio:

• Almacén central = punto primario de reabastecimiento
• Sitios de preparación de campo = almacenamiento temporal cerca de áreas de trabajo activas
• Sitios personales (trabajadores/vehículos) = inventario móvil para uso inmediato

Conteos de Ciclo Regulares:

• Crear transacciones de ajuste para corregir discrepancias
• Incluir campo de razón (ej. "Conteo físico 2026-02-10")
• Comparar historial de transacciones para identificar patrones de pérdida

Minimizar Ajustes Manuales:

• Usar recepciones/transferencias/consumos cuando sea posible
• Los ajustes deberían ser excepción, no rutina
• Ajustes frecuentes indican problemas de proceso (robo, errores de reporte)

Planificar, No Reservar:

• Las asignaciones muestran plannedStock (pronóstico de demanda)
• NO reservas duras (otros trabajadores aún pueden recoger)
• Permite flexibilidad cuando cambian prioridades
• La asignación real ocurre en tiempo de escaneo QR