Coffee Contract Quality Tolerances: Moisture, Defects, Score Variance and Lot Substitution

Short answer

A green coffee contract should turn quality claims into testable acceptance rules. Terms such as “Fine Robusta,” “specialty quality,” or “same as approved sample” are not precise enough by themselves. A buyer should define how moisture is measured, which physical defects are permitted, how sensory performance will be evaluated, how much variation is acceptable between the approved sample and the shipment, whether lot substitution is allowed, and what happens if arrival QC fails.

There is no single universal tolerance table that works for every transaction. The correct specification depends on the coffee, processing method, destination, buyer use case, testing method and commercial agreement.

Why written tolerances matter

Green coffee is often purchased before the buyer physically receives the lot. A roaster may approve a sample weeks before shipment. During that period the coffee can be exposed to storage, humidity, packaging, transport and handling conditions that may affect its measured or perceived quality.

A professional contract should therefore answer three separate questions:

1. What quality was promised?
2. How will that quality be measured?
3. What remedy applies if the delivered coffee does not conform?

Without all three, the buyer and seller may be arguing about different definitions of quality.

1. Moisture should be measurable and repeatable

Moisture is a common green-coffee measurement, but a contract should not list a number without defining the test method. Different meters, calibration practices, sample temperatures and environments can produce different readings.

A stronger contract identifies the acceptable range, testing equipment or method, sampling procedure, testing stage and dispute procedure. For example, the parties can agree that moisture is checked at pre-shipment and again at arrival, with an independent laboratory used if the measurements materially disagree.

The objective is not simply to produce a number. It is to create a result that both sides can reproduce.

2. Defect limits need a named grading method

“Clean coffee” is commercial language, not a complete specification. A buyer should identify the grading protocol, sample size and defect categories that matter for the transaction.

Physical defects may include black or sour beans, insect damage, immature beans, broken beans, husk, parchment or foreign matter. Different defects carry different sensory and operational risks.

A useful clause can define maximum defect counts, foreign-matter rules, screen or size requirements, and who performs the official grading if the parties disagree.

For Fine Robusta, this is particularly important because the word “Fine” should not be treated as a substitute for measurable physical preparation.

3. Cup score must be tied to a protocol

A sensory score is an evaluation result, not a fixed physical property. Roast development, grind, water chemistry, cup preparation and evaluator calibration all influence the result.

A contract that says only “minimum 84 points” leaves important questions unanswered. Which protocol? How many cups? How many evaluators? Which roast conditions? What happens if one cup shows a serious defect?

The contract should define the agreed sensory procedure and the acceptable difference between the approved sample and the delivered lot.

4. “Same as sample” needs a sample identity

The phrase “shipment to match approved sample” is weak unless the contract identifies the sample. Buyers and sellers should know whether the reference is an offer sample, type sample, pre-shipment sample or retained sample.

A stronger system gives the reference sample a code, lot number and date. Both parties should retain sealed material where practical. If a dispute occurs, the reference can be evaluated again under controlled conditions.

5. Lot substitution requires explicit rules

A replacement lot may sometimes be proposed because of production shortfall, quality deterioration, allocation changes or logistics problems. But substitution should never happen silently.

A buyer should define whether substitution is prohibited, permitted only with written approval, or permitted only after a new sample is evaluated.

For traceable Cambodian Fine Robusta, lot substitution can affect not only cup quality but also origin, producer story, process and commercial positioning.

6. Tolerances must connect to remedies

A quality specification is incomplete if it does not explain what happens after a failure.

Possible remedies include re-testing, independent evaluation, negotiated allowance, sorting or reconditioning, partial claim, replacement, or rejection where the governing contract permits it.

The remedy should reflect the seriousness of the non-conformity. A small screen-size deviation should not automatically be treated the same as mold contamination, wrong origin or unauthorized substitution.

7. Arrival QC should have a deadline

Claims should be raised within a defined inspection window. The contract can specify where sampling occurs, how the sample is drawn, which evidence must be retained, how quickly the seller must be notified and whether the seller can witness a re-test.

This does not make claims easier. It makes valid claims auditable.

Buyer contract checklist

Before committing to a green coffee lot, a buyer should be able to answer:

1. What exact lot is being purchased?
2. What physical specification applies?
3. How is moisture tested?
4. Which defect protocol applies?
5. Which sensory protocol applies?
6. What variance from the approved sample is acceptable?
7. Is substitution allowed?
8. What is the arrival inspection window?
9. Who resolves testing disagreements?
10. Which remedies are available?

Bottom line

The best green coffee contracts do not rely on adjectives. They convert quality into measurable obligations. Moisture, defects, sensory performance, reference samples, substitution and arrival QC should operate as one connected acceptance system.

For buyers, this reduces the risk of paying for quality that cannot be verified. For suppliers, it reduces subjective claims after shipment. For both sides, the objective is repeatability.

Primary references

• Specialty Coffee Association — Coffee Standards
• Coffee Quality Institute — Fine Robusta and Q Coffee evaluation resources
• ISO green coffee defect references where contractually applicable

_Editorial note: This article explains procurement and quality-control structure and is not legal advice._