Skip to main content

Overview

The Batch type represents a grouping or category of related articles in the SIGEAC warehouse system. Batches organize inventory items by characteristics such as category, brand, ATA code, and storage requirements.

Type Definition

export type Batch = {
  id: number;
  name: string;
  slug: string;
  description: string;
  category: string;
  ata_code: string;
  brand: string;
  is_hazarous: boolean;
  unit: Unit;
  min_quantity: number;
  zone: string;
  warehouse_id: number;
  warehouse_name: string;
};

Fields

id
number
required
Unique identifier for the batch
name
string
required
Display name of the batch
slug
string
required
URL-friendly identifier for the batch (lowercase, hyphenated)
description
string
required
Detailed description of the batch and its contents
category
string
required
Category classification for the batch (e.g., “Fasteners”, “Electronics”, “Hydraulics”)
ata_code
string
required
Air Transport Association (ATA) chapter code for aviation categorizationCommon ATA codes include:
  • 21-00-00: Air Conditioning
  • 32-00-00: Landing Gear
  • 53-00-00: Fuselage
  • 71-00-00: Power Plant
brand
string
required
Primary brand or manufacturer associated with items in this batch
is_hazarous
boolean
required
Indicates if items in this batch are hazardous materials requiring special handlingWhen true, additional safety protocols and storage requirements apply.
unit
Unit
required
Default unit of measurement for items in this batch
min_quantity
number
required
Minimum quantity threshold for restock alertsWhen total quantity of articles in this batch falls below this value, the system triggers a restock notification.
zone
string
required
Physical storage zone or location code within the warehouse (e.g., “A-12-B”, “RACK-05-SHELF-3”)
warehouse_id
number
required
Foreign key reference to the warehouse where this batch is stored
warehouse_name
string
required
Name of the warehouse for quick reference (denormalized for performance)

Article Relationship

Articles belong to batches through the batch_id foreign key:
export type Article = {
  // ... other fields
  batches?: Batch;
  batch_id?: number;
};

DispatchRequest Batch Details

When dispatching articles, the batch information includes extended details:
{
  id: string;
  name: string;
  category: string;
  article_count: number;
  min_quantity: number;
  articles: {
    article_id: string;
    serial: string;
    part_number: string;
    quantity: string;
    unit: Convertion[];
  }[];
}

Example Data

Standard Batch

{
  "id": 78,
  "name": "Hydraulic System Seals",
  "slug": "hydraulic-system-seals",
  "description": "O-rings, gaskets, and seals for hydraulic systems",
  "category": "Seals & Gaskets",
  "ata_code": "29-10-00",
  "brand": "Parker Aerospace",
  "is_hazarous": false,
  "unit": {
    "id": 1,
    "value": "EA",
    "label": "Each",
    "registered_by": "system",
    "updated_by": "admin",
    "created_at": "2023-01-15T08:00:00Z",
    "updated_at": "2023-01-15T08:00:00Z"
  },
  "min_quantity": 50,
  "zone": "B-08-C",
  "warehouse_id": 3,
  "warehouse_name": "Main Warehouse - Miami"
}

Hazardous Materials Batch

{
  "id": 142,
  "name": "Aircraft Cleaning Solvents",
  "slug": "aircraft-cleaning-solvents",
  "description": "Industrial-grade cleaning solvents and degreasers",
  "category": "Chemicals",
  "ata_code": "12-00-00",
  "brand": "Henkel",
  "is_hazarous": true,
  "unit": {
    "id": 5,
    "value": "L",
    "label": "Liter",
    "registered_by": "admin",
    "updated_by": "admin",
    "created_at": "2023-01-15T08:00:00Z",
    "updated_at": "2023-01-15T08:00:00Z"
  },
  "min_quantity": 20,
  "zone": "HAZ-STORAGE-01",
  "warehouse_id": 3,
  "warehouse_name": "Main Warehouse - Miami"
}

Use Cases

Inventory Organization

Batches help organize large inventories by grouping similar items:
  • By Function: All fasteners in one batch, all electrical components in another
  • By ATA Code: Organize by aircraft system (e.g., all landing gear parts)
  • By Brand: Group items from the same manufacturer for easier vendor management

Restock Management

The min_quantity field enables automated restock alerts:
if (batchArticles.totalQuantity < batch.min_quantity) {
  triggerRestockNotification(batch);
}

Safety Compliance

The is_hazarous flag ensures proper handling:
  • Special storage requirements
  • Additional documentation for hazmat shipments
  • Safety equipment requirements for handling
  • Regulatory compliance tracking

Build docs developers (and LLMs) love