Quality Checks

Overview #

Quality checks are automated rules that validate extracted shipment data. They run automatically after document processing and flag potential issues before your team reviews the shipment.

How Checks Work #

Each check receives the extracted pallet data and returns one of three results:

Checks run in parallel and complete within seconds.

Automatic AI Cross-Check #

Some checks reconcile the extracted data against the totals the document itself declares — for example, whether the sum of per-pallet box counts matches the declared total box count (and the same for weights). A mismatch usually means a few figures were misread during extraction, which is most common with scanned packing lists where the original scan is faint or the table is dense.

When a reconciliation check fails, Trackberry doesn't just flag it — it automatically re-reads the original document with a secondary AI and tries to correct the data before you ever see a failure:

1. It re-reads the packing list and, where it can match pallets, patches just the figures that were misread.
2. If the pallet identifiers themselves were garbled, it rebuilds the packing list from the fresh AI read — but only if that read reconciles cleanly, and only when you haven't made manual corrections to the packing list.

While this verification is running, the shipment shows a "Verifying documents…" status in place of preliminary check results, and the document displays a short progress label (e.g. "Discrepancies found — re-checking with secondary AI…"). Once the second pass settles, the final check results appear. This keeps transient, about-to-be-fixed failures from flashing on screen.

The cross-check only runs during automatic processing — a manual Run Checks re-run validates the current data without incurring additional AI processing.

Configuring Checks #

Enabling/Disabling Checks #

1. Go to Settings > Checks in your organization
2. Toggle individual checks on or off
3. Changes take effect immediately for new shipments

Available Check Types #

Trackberry includes several built-in checks:

Completeness Check #

Ensures all required fields are present in the extracted data:

• Pallet number
• Produce name
• Calibre
• Box count
• Weight

Weight Validation #

Verifies that box weights fall within expected ranges for the produce type. Flags outliers that might indicate extraction errors.

Calibre Consistency #

Ensures calibre values match known standards for the produce type. For example, avocados typically have specific calibre ranges.

Duplicate Detection #

Identifies potentially duplicate pallets within a shipment — same pallet number, produce, and calibre appearing more than once.

Invoice Total #

Compares the sum of extracted invoice line item prices against the declared total on the invoice document. Uses a 1% tolerance to account for rounding differences. Fails when the calculated total diverges from the declared total by more than 1%, helping catch cases where the AI misread a price or missed line items. Skipped when no invoice data is available.

Invoice Matches Packing List #

Cross-references the packing list against the commercial invoice for the same shipment — both describe the same physical goods, so they should agree. Compares:

• Produce — flags a failure when the packing list and invoice name completely different produce (e.g. one says Avocado, the other Asparagus), and a warning when they partially overlap.
• Box count — warns when the packing list's total boxes and the invoice's total quantity disagree by more than a small tolerance.

This check never changes your data — it only flags a discrepancy for your team to review, since it can't tell which document is correct. See the Invoice Pricing guide for more.

See the Invoice Pricing guide for more on invoice data.

Automatic Data Completion #

When the packing list is missing a value the invoice states — box weight, variety, or pack format — Trackberry fills it in automatically from the matching invoice line. The packing list is always treated as the source of truth: this only fills in blanks, it never overwrites a value already on the packing list or one your team entered manually. Filled-in values are marked as such and can always be edited afterwards.

Re-Running Checks #

Checks can be re-run manually:

1. Open the shipment page
2. Click Run Checks in the actions menu
3. All enabled checks execute against the current data
4. Results update in real-time

This is useful after: - Superseding a document with corrected data - Enabling new checks that weren't active when the shipment was first processed - Updating check configuration

Check Results in the Shipment View #

Check results appear prominently on the shipment page:

• A summary bar shows the overall status (all pass / warnings / failures)
• Each check shows its individual result with details
• Failed checks include an explanation of what was flagged
• Click on a check result to see which specific pallets triggered it