Key Concepts

Organizations #

An Organization is the top-level entity in Trackberry. It represents a company, team, or trading operation. Everything — shipments, members, settings — belongs to an organization.

• Each organization has a unique slug used in URLs (trackberry.ag/your-slug/...)
• Users can belong to multiple organizations
• Settings, checks, and approved senders are scoped per organization

Shipments #

A Shipment represents a batch of fresh produce moving from origin to destination. Shipments have a lifecycle:

Documents #

Documents are files attached to a shipment — typically packing lists, quality reports, or phytosanitary certificates. Trackberry supports:

• PDF — Parsed via automated text and table extraction
• Excel (.xlsx) — Direct structured table reading
• Images (.jpg, .png) — Processed with OCR

Each document goes through an extraction pipeline that produces structured pallet data.

Pallets #

A Pallet is a unit of produce within a shipment. Each pallet has attributes extracted from documents:

Key pallet attributes:

pallet_number   — Unique identifier on the pallet
produce_name    — What's on the pallet (e.g., "Hass Avocado")
category        — Produce type classification
calibre         — Size grading (e.g., "12", "14", "16")
boxes           — Number of boxes on the pallet
box_weight_kg   — Weight per box in kilograms

Quality Checks #

Checks are automated validation rules that run against extracted shipment data. Examples:

• Weight check — Verify total weight matches expected range
• Calibre check — Ensure calibre values are within product specs
• Completeness check — Flag missing required fields

Checks produce results: pass, warning, or fail. A shipment must pass all required checks before approval.

Members & Roles #

Users join organizations through Memberships, each with a role:

• Member — Read access to shipments and data
• Admin — Can manage settings, members, approved senders, and checks
• Owner — Full access including organization-level settings

Approved Senders #

Approved Senders are email addresses or domains authorized to send documents to your organization. Documents from unapproved senders are flagged for review.

Pre-allocations #

A Pre-allocation assigns a number of boxes from a packing line to a specific customer (allocatee) before the shipment arrives. This lets you plan distribution in advance. Pre-allocations are tracked per packing line and cannot exceed the line's box count.

Public Tracking #

Organizations can enable Public Tracking Pages to share a live, unauthenticated view of any shipment. External parties can view the tracking map, transport details, and selected documents — and subscribe to email updates when the status changes.

Shipment Messages #

Every email sent to your organization about a shipment is stored as a Shipment Message. Trackberry uses AI to analyze each message and extract:

• Category — Arrival notice, delay notice, inspection notice, customs update, etc.
• Urgency — Info, warning, or critical
• Summary — A one-line description of the key information
• Dates — ETAs, delivery dates, and inspection dates mentioned in the email
• Suggested status — Whether the email implies the shipment has arrived or departed

Messages appear on the shipment page and provide a complete conversation history alongside the structured shipment data.

Delay Predictions #

For shipments with active tracking, Trackberry uses AI to monitor real-time disruptions (weather, strikes, congestion, infrastructure issues) at each location along the route. When elevated risk is detected, a Delay Predictions panel appears on the shipment page with risk factors and estimated delay impact.

Audit Log #

Every significant action is recorded in the Audit Log — document uploads, approval decisions, setting changes, member management, and inbound email updates. The audit log provides full traceability for compliance.