app.shipment_trackers
TableRow level security on
A shipment followed through one carrier connection (UPS, FedEx or DHL): the latest normalized status, estimated delivery and delivery time. One live tracker per shipment. Logistics writers start and stop tracking; only the integration runner writes status.
Primary key: id
| Column | Type | Nullable | Description |
|---|---|---|---|
| id | uuid | No | Primary key, UUID v7. |
| org_id | uuid | No | Owning org, derived from app.shipments on insert; never accepted from the caller and never changed.References app.organizations.id |
| shipment_id | uuid | No | Shipment tracked.References app.shipments.id |
| integration_connection_id | uuid | No | Carrier connection that reports it.References app.integration_connections.id |
| tracking_number | text | No | Carrier tracking number, from the shipment unless given. |
| tracking_status | app.tracking_status | No | Latest normalized status. Written by the runner. |
| carrier_status_text | text | Yes | Latest status as the carrier words it. Written by the runner. |
| estimated_delivery_at | timestamp with time zone | Yes | Carrier's estimated delivery. Written by the runner. |
| delivered_at | timestamp with time zone | Yes | When the carrier reported delivery. Written by the runner. |
| last_checked_at | timestamp with time zone | Yes | When the runner last asked the carrier. |
| deleted_at | timestamp with time zone | Yes | Soft delete time. A row with deleted_at set is ignored by every access helper. |
| 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 |