Cold Chain

What is the cold chain?

The cold chain is the uninterrupted temperature control from production to consumption. If a cold equipment goes out of the safe temperature range, the product may be compromised.

Configure an asset for cold chain

From the Dashboard

1. Go to Assets and select your cold equipment
2. In the edit section, enable Cold Chain
3. Configure:
   • Minimum temperature: Safe lower limit (e.g., -22 degrees C)
   • Maximum temperature: Safe upper limit (e.g., -16 degrees C)
   • Unit: degrees C or degrees F
   • Grace period: Minutes allowed out of range before critical alert (1-120 min)

From the API

PATCH /api/v1/assets/{asset_id}
{
  "cold_chain_enabled": true,
  "temperature_min": -22,
  "temperature_max": -16,
  "temperature_unit": "C",
  "excursion_grace_minutes": 15
}

Temperature Excursions

When a sensor reports a temperature outside the configured range:

1. An excursion is created with: current temperature, deviation, direction (above/below)
2. It is continuously updated with: duration, peak deviation
3. Severity escalates: Warning (within grace period) -> Critical (grace period expired)
4. It resolves automatically when the temperature returns to the normal range

View excursions

GET /api/v1/cold-chain/excursions?asset_id=xxx&resolved=false

Response:

{
  "excursions": [
    {
      "id": "exc_001",
      "asset_id": "asset_freezer01",
      "started_at": "2026-03-30T10:15:00Z",
      "current_temp": -14.2,
      "limit_breached": "high",
      "peak_deviation": 3.8,
      "duration_minutes": 12,
      "severity": "warning",
      "resolved": false
    }
  ]
}

Fleet view

GET /api/v1/cold-chain/status

Returns all assets with cold chain enabled and their current excursion status.

{
  "assets": [
    {
      "asset_id": "asset_freezer01",
      "name": "Warehouse A Freezer",
      "current_temp": -14.2,
      "range": [-22, -16],
      "status": "excursion",
      "excursion_duration_minutes": 12
    },
    {
      "asset_id": "asset_cooler01",
      "name": "Production Cold Room",
      "current_temp": 3.1,
      "range": [0, 5],
      "status": "ok",
      "excursion_duration_minutes": null
    }
  ]
}

Connection with HACCP

If a cold chain asset also has an HACCP CCP configured, both systems evaluate in parallel:

• Cold chain: Records excursions with duration and severity
• HACCP CCP: Evaluates against regulatory limits and triggers corrective action workflow

Both feed from the same data — the same temperature event flows through the entire pipeline.

Notifications

When an excursion is detected, Rela sends automatic notifications:

• WhatsApp: Immediate message to the responsible technician with equipment name, current temperature and deviation
• Email: Notification with full details and link to the dashboard
• Escalation: If the excursion is not resolved within the grace period, it escalates to the supervisor