Quality Checks

Goal #

Configure automated rules that validate extracted shipment data, so problems surface before your team reviews a shipment rather than after a customer does.

Checks answer one question: does this paperwork add up? They compare your extracted data against itself and against the totals the documents declare. They never assess the produce — for that, see Quality Inspection Reports.

Before you start #

• Admin or Owner role. Members can see check results but not change which checks run.
• At least one processed shipment, if you want to see checks in action — checks run against extracted data, so there must be some.

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 on invoice data.

Transport Reference Consistency #

Detects conflicting AWB (Air Waybill) or B/L (Bill of Lading) numbers across different sources: the email subject line vs OCR extraction from transport document pages. This prevents issues where OCR misreads a transport reference on one page but the correct reference was provided in the email.

How it works: - Extracts transport references from the email subject (when AWB/MAWB keywords present) - Collects OCR results from each transport document page - Compares all values and flags discrepancies

Results: - Pass — All sources agree on the same reference number - Warning — 2 different values found (likely OCR error on one page) - Fail — 3+ different values found (severe data quality issue requiring review)

Prioritization: When conflicts are detected, the check recommends the most reliable value: 1. Email subject (plain text, most reliable — no OCR errors) 2. Majority vote (if multiple pages agree) 3. Later pages (often have clearer printing)

Why email subject is prioritized: Email subjects are plain text copied directly from carrier systems by shippers, making them more reliable than vision-based OCR that can misread digits on scanned/faxed documents (e.g., “006” misread as “057”).

Fix options: - Edit transport reference manually to correct value - Use the recommended value from email/majority - Re-upload a clearer transport document

Note: AWB numbers taken from email subjects are protected from OCR overwrites. If the email contained a valid AWB, that value stands even when a transport document page extracts a different number — the check flags the conflict for your review rather than silently replacing it.

Quality checks validate that your own extracted data is internally consistent. For an independent, third-party assessment of the produce itself (condition score, defects, photos), see the Quality Inspection Reports guide.

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

Resolving Issues #

Not every flagged issue is fixed in Trackberry. Sometimes you call the shipper, confirm the figure was right all along, and the check has nothing left to tell you. Admins and owners can clear those:

• Skip a single check — on any failing or warning check, mark it resolved on its own.
• Mark all resolved — a link above the check list, shown only when there are open issues. It clears every failing and warning check on the shipment in one action, after a confirmation prompt.

Either way the check is recorded as manually resolved by you, with your email and the time — nothing is silently erased. Clearing the last issue lets the shipment validate itself automatically if it was being held back.

The Health Column #

On the shipments list, check results share the Health column with monitoring alerts, so one dot answers both “does the paperwork add up?” and “is this shipment still moving?”

Hover the dot for a popover that lists monitoring alerts first, then each quality check with its status and message. The dot shows the worse of the two, and a dashed ring around it means monitoring has something to say.

See Shipment Monitoring for the other half of that column.