2026 customs changesWhat it means

How to Read the Quality Score

What a document's Quality score and its colours say, how to see what the score is made of, and why a document is in Review.

Every document CargoLint reads shows a Quality score and a colour. Both come from the problems in its Document Issues panel, so the number, the colour and the list always tell the same story.

Before you start

  • You have documents that have been processed
  • You understand basic document types (invoices, packing lists, etc.)
  • You know how to access the review queue

Steps

1. Find the score

The Quality score shows in the Quality score column of the Documents list and the review queue, and at the top of a document’s Document Issues panel. It starts at 100% and each problem found takes off its cost: 10% for a warning, 20% for a problem that needs fixing, down to 0%. Notes cost nothing.

2. Read the colour

  • Green: nothing wrong was found
  • Amber: there is at least one warning, worth a look
  • Red: at least one problem needs fixing

The colour follows the worst problem, so a document with one problem that needs fixing is red even when its score is 80%. A document of a kind CargoLint recognizes but does not read shows Not scored.

3. See what the score is made of

Hover the score to see each problem it counts and what it takes off, for example “2 warnings: -10%, -10%”. HS code problems count once per document, at their worst level; each line still shows its own HS state in Document Issues.

4. Check the coloured fields

Each field box uses the same colours: green when nothing is wrong with it, amber for a warning, red for a problem that needs fixing. Hovering a box lists the problems about that field and their cost. A missing required field shows on its empty box.

5. Know why a document is in Review

A document goes to Review when:

  • Its problems add up: one problem that needs fixing, or two warnings, from any source: how it was read, unclear reads, the document checks or the HS codes. That is a Quality score below 90%, so a document waiting in Pending Approval scores 100% or 90% and is never red
  • HS codes to confirm: suggested codes are never applied automatically; a reviewer confirms each one
  • A degraded scan: the values may contain misread characters
  • A blocking finding: an exact sanctions match, a CITES Appendix I species, or a check that did not complete
  • A shipment finding that needs fixing: a consistency check found a conflict that needs fixing between this document and another in the same shipment. A warning shows on the document without holding it

The Documents list shows the reason under the score, and Document Details and the review editor show it in Document Issues. A problem in the document itself, such as a field it really lacks or totals that do not add up, counts like any other; the reviewer decides what happens next, for example asking whoever issued the document for a corrected copy.

6. Look at unclear reads

The AI rates how clearly it read each line, party and key header field. A value it says may be garbled shows amber; a value it is guessing shows red. They count like any other problem: a guessed value, or two values that may be garbled, send the document to Review.

Unclear reads often come from:

  • Handwriting or text printed at an unusual angle
  • A blurry, faded or low-contrast scan
  • Values with special characters or formatting
  • Values with more than one reading (for example, a date written “03/04/2026” reads as March 4th in the US and April 3rd in most other countries; when the documents do not say which country they ship from, CargoLint keeps such a date as written and says why)

Improving the scan quality (see Scanning Tips) often clears unclear reads.

Tip: An amber or red box is a pointer to where to look, not a ruling that the value is wrong. Comparing it against the original document settles it.

Tip: A green document has no problem CargoLint found. It is not a guarantee that every value is right, so spot-checking a few documents each day still pays off.

What’s next