app.shipment_tracking_events
TableRow level security on
Append-only carrier scan history of a tracked shipment, normalized. A scan is recorded once.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.shipment_trackers on insert; never accepted from the caller and never changed.References app.organizations.id |
| shipment_tracker_id | uuid | No | Tracker the scan belongs to.References app.shipment_trackers.id |
| tracking_status | app.tracking_status | No | Normalized status of the scan. |
| carrier_status_code | text | No | Carrier's own status code. |
| description | text | No | Scan description as the carrier words it. |
| location_text | text | Yes | Where the scan happened. |
| occurred_at | timestamp with time zone | No | When the scan happened. |
| created_at | timestamp with time zone | No | When the row was inserted. Set by the database. |
| created_by | uuid | Yes | Person who inserted the row, or null for a platform process. Set by the database.References app.people.id |
| updated_at | timestamp with time zone | No | When the row last changed. Set by the database. |
| updated_by | uuid | Yes | Person who last changed the row, or null for a platform process. Set by the database.References app.people.id |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |