How to Document a Green Coffee Quality Claim So the Seller Can Actually Verify It

Short answer

A useful green coffee claim should make the problem reproducible. The seller should be able to identify the shipment, understand how the sample was drawn, see which specification failed, review the test evidence and repeat the evaluation if necessary.

A statement such as “the coffee is bad” is not a quality claim. It is an opinion.

Start with shipment identity

Record the contract or purchase reference, supplier, origin, lot code, container reference, bag count, arrival date and warehouse location.

This information prevents confusion when multiple coffees from the same supplier are in transit or storage.

Record the condition before sampling

Photograph damaged bags, water staining, broken liners, condensation, contamination or seal problems before the lot is moved or altered.

If packaging condition is relevant to the failure, the seller needs evidence of the shipment as received.

Explain how the sample was drawn

A claim is weaker when the buyer cannot show that the sample represents the shipment. Record how many bags were sampled, where they were located and whether a retained sample was sealed.

Representative sampling is especially important for heterogeneous physical defects or localized moisture problems.

Separate physical and sensory evidence

Create distinct records for physical analysis and cupping. Physical evidence may include moisture, defects, odor, color, size or other contracted criteria.

Sensory evidence should include roast date, protocol, cup count, evaluators and notes on any repeatable defects or material profile change.

Compare directly with the contract

The claim should identify the exact requirement that appears to have failed. Quote or reference the relevant specification rather than relying on a general expectation.

Examples include moisture outside the agreed range, defect count beyond the allowed level, wrong lot identity, unauthorized substitution or a material sensory deviation from the approved reference.

Include the approved sample comparison

Where a pre-shipment sample was approved, compare the arrival result with the retained reference under similar evaluation conditions.

Record what changed: cleanliness, dominant flavor, body, sweetness, aftertaste, defect presence or overall commercial suitability.

Distinguish preliminary from confirmed findings

The first test may indicate a problem without proving it. State clearly whether the result is preliminary, repeated or independently verified.

This distinction reduces unnecessary escalation and shows the seller that the buyer is following a controlled process.

State the requested next step

A claim notice should explain what the buyer wants to happen next. That may be a joint re-test, independent analysis, allowance discussion, replacement proposal or another remedy permitted by the contract.

The seller should not have to guess what action is being requested.

Build a claim file

A complete file can include:

• purchase contract or PO;
• lot and shipment details;
• photos;
• sampling record;
• physical test results;
• cupping sheets;
• retained sample IDs;
• reference-sample comparison;
• written timeline;
• requested remedy.

Why good documentation improves relationships

Evidence-based claims are easier for serious suppliers to investigate. They also help identify whether the root cause occurred during processing, preparation, storage, export, transport or destination handling.

A well-documented claim can therefore improve the next shipment rather than simply close the current dispute.

Bottom line

The strongest green coffee quality claim is specific, reproducible and connected to the contract. It tells the seller what happened, how it was measured, why it matters and what the buyer wants to do next.

That standard protects both sides and makes resolution faster.

_Editorial note: This is operational guidance, not legal advice._