Skip to main content
Trazea’s inventory management system is the core of the platform, enabling precise control of spare parts across multiple workshop locations with complete traceability.

​
Overview

Each location (sede) maintains its own independent inventory with real-time stock levels, physical warehouse positions, and configurable minimum thresholds. Every inventory change is automatically logged for full audit compliance.

Multi-Location Stock

Independent inventory per location with position tracking

Low Stock Alerts

Automatic notifications when items fall below minimum

New Item Indicators

Visual markers for recently added inventory

Complete Audit Trail

Every change logged with user, timestamp, and details

​
Inventory Item Structure

Each inventory item contains both stock information and spare part details: 
interface InventoryItem {
  // Inventory-specific fields
  id_inventario: string;
  id_localizacion: string;
  stock_actual: number;
  posicion: string;              // Physical warehouse position
  
  // Spare part information
  id_repuesto: string;
  referencia: string;
  nombre: string;
  cantidad_minima: number;
  descontinuado: boolean;
  tipo: string;
  fecha_estimada: string;        // Expected restock date
  url_imagen: string;
  estado_stock: string;
  fecha_ingreso_inventario: string;
  nuevo_hasta: string | null;    // "New" indicator expiry
}

​
Key Features

​
Stock Status Tracking

Each item automatically displays its stock status:
  • Normal: Stock above minimum threshold
  • Low Stock: Below cantidad_minima - triggers alerts
  • Out of Stock: Zero quantity available
  • Discontinued: Item no longer stocked
Low stock alerts are automatically sent to users assigned to that location when any item falls below its configured minimum.

​
New Item Indicators

Recently added inventory items are marked as “new” for a configurable period using the nuevo_hasta field. This helps staff quickly identify recent additions during physical checks.

​
Physical Position Tracking

The posicion field stores the physical warehouse location (e.g., “A-3-2” for aisle A, rack 3, shelf 2), making it easy for staff to locate items quickly.

​
Verification Counter

The veces_contado field tracks how many times an item has been physically audited, helping identify items that may need more frequent verification.

​
User Workflows

​
Viewing Inventory

1

Access Inventory

Navigate to the Inventory section from the main menu
2

Filter by Location

Select your assigned location to view its inventory
3

Apply Filters

Filter by stock status, item type, discontinued status, or new items
4

Search Items

Use the search bar to find items by reference or name

​
Adding Inventory

1

Select Spare Part

Choose from the spare parts catalog
2

Set Quantity

Enter the initial stock quantity
3

Assign Position

Specify the physical warehouse location
4

Set Minimum

Configure the minimum stock threshold for alerts
5

Save

System creates inventory record and logs the creation
Only users with the appropriate permissions can add or modify inventory. Check your role permissions if you cannot access these features.

​
Updating Stock

When stock quantities change:
  1. Manual Adjustments: Staff can adjust quantities with a reason
  2. Automatic Updates: System updates stock when:
    • Requests are dispatched or received
    • Technician movements are recorded
    • Physical counts are completed
    • Warranties are processed

​
Viewing Movement History

For any inventory item, users can view its complete timeline: 
interface TimelineEvent {
  fecha: string;
  tipo_evento: 'CONTEO' | 'GARANTIA' | 'MOVIMIENTO_TECNICO' | 'AJUSTE_MANUAL';
  titulo: string;
  operacion: string;
  estado: string;
  usuario_responsable: string;
  tecnico_asociado: string | null;
  observaciones: string | null;
  informacion_adicional: string | null;
  orden: string | null;
}
This provides complete traceability showing:
  • Physical counts and discrepancies
  • Warranty claims involving the item
  • Technician loadouts and returns
  • Manual adjustments with justification

​
Audit Logging

Every inventory change is recorded in logs_inventario with:
  • User responsible: Who made the change
  • Previous quantity: Stock before change
  • New quantity: Stock after change
  • Operation type: What caused the change
  • Timestamp: Exact date and time
  • Details: Additional context or notes
{
  "id_log": "uuid",
  "id_inventario": "uuid",
  "id_usuario": "user-uuid",
  "cantidad_anterior": 10,
  "cantidad_nueva": 8,
  "tipo_operacion": "MOVIMIENTO_TECNICO",
  "detalles": "Carga técnico Juan - Orden #1234",
  "fecha": "2026-03-04T10:30:00Z"
}

​
Permissions

Inventory access is controlled by role-based permissions:
ActionRequired Permission
View inventoryview_inventory
Add itemscreate_inventory
Update quantitiesedit_inventory
Adjust stockadjust_stock
View audit logsview_audit_logs
Delete itemsdelete_inventory

​
Pagination and Performance

Inventory lists are paginated for performance: 
interface InventoryParams {
  page?: number;
  limit?: number;
  order_by?: string;
  direction?: 'asc' | 'desc';
  search?: string;
  estado_stock?: string;
  descontinuado?: boolean;
  is_new?: boolean;
}
Default page size is typically 50 items, with sorting available by any column.

​
Best Practices

Regular Counts

Perform physical counts regularly to verify system accuracy

Set Minimums

Configure appropriate minimum thresholds to prevent stockouts

Update Positions

Keep warehouse positions updated when items are relocated

Review Alerts

Monitor and respond to low stock notifications promptly

Build docs developers (and LLMs) love

Get started for freeTalk to us