There is no register of Grade A vanilla. No body awards it, no test confirms it, and the top Indonesian statutory grade permits moisture as high as the upper thirties by percentage — so a buyer who writes “Grade A” expecting beans in the low thirties has no argument when a lot arrives much wetter and the supplier points out, correctly, that it is still Grade A. In a dispute, nobody asks what you meant by the grade. They ask what the document says. And “Grade A” says almost nothing an arbitrator could enforce.
“Grade A” is a compliment, not a specification: no international standard defines it, grading conventions vary by supplier and region, and the statutory grade allows a wide moisture range. To hold a shipment to your expectations, replace the grade label with numeric criteria — moisture range, vanillin minimum on a stated basis, length and count, defect allowances — each with a test method, a point of measurement, and a consequence when it is missed. A specification with those four things is enforceable; a grade label is not.
This is not a legal lecture; it is a practical one. The gap between a grade name and a specification is the gap between a dispute you can win and one you cannot, and it is written — or left unwritten — before the order ever ships. The good news is that closing it is a matter of discipline, not expense.
Why “Grade A” Fails the Moment It Matters
Grade letters are trade shorthand. One exporter’s Grade A is another’s second band; the same pod can change grade by moving warehouse; and the statutory grades that do exist define wide envelopes, not the tight targets buyers have in mind. When you write “Grade A, 25 kg” on an order, you have written a hope. The supplier can deliver anything that plausibly falls under that label and be within their rights, because you never defined the numbers that separate what you wanted from what you feared. The proof is in the published numbers: ask four reputable sources what moisture a Grade A bean carries and you get four different answers — 25–30 percent, 30–35 percent, 25–35 percent, and, for Madagascar gourmet sub-grades, 30–38 percent. They are all defensible, because no single body sets the line. Two real standards do exist — Indonesia’s SNI 01-0010-2002, whose top grade permits moisture into the upper thirties, and the international ISO 5565, which defines the vanillin and moisture test methods — but each describes bands and methods, not one meaning for the letter A.
Every parameter in a specification needs four things or it is decoration: a number, a method, a point of measurement, and a consequence. If any one is missing, you have written a hope, not a specification.
Apply that test to “Grade A.” Number? None — a letter is not a number. Method? None. Measurement point? None. Consequence? None. It fails all four. Now apply it to “moisture 25–30 percent, measured by the stated method on a drawn sample at the loading warehouse, lots outside the range subject to rejection or price adjustment per the schedule.” That line passes all four, and it is the difference between leverage and argument.
The Four Things Every Line Needs
A target or a range, not a label. “Moisture 25–30 percent,” not “dry.” “Vanillin ≥ 1.6 percent, dry basis,” not “high vanillin.” The number is what a stranger can test against.
How the number is measured. A moisture figure means nothing without the method behind it, because different methods give different readings on the same lot. Name the method, or name the laboratory.
Where and when the number is taken — at the supplier’s warehouse before loading, on arrival, or both. Risk and condition change in transit, so the measurement point decides whose problem a change is.
What happens when the line is missed: rejection, rework, or a price adjustment by a defined formula. A specification with no consequence is a wish list the supplier can ignore without penalty.
Write every parameter — moisture, length and count, vanillin and the marker profile, appearance and frost, defects and their allowance, cleanliness and residues, packing and net weight — to that standard, and you have a document that settles disputes instead of starting them. Miss one element on one line, and that is the line the dispute will turn on.
The Agreement and the Specification Do Different Jobs
Two documents work together. The specification sheet defines what you are buying in numbers, for a given type of lot. The quality agreement sets the standing terms every order refers to — how samples are drawn so they survive a dispute, which laboratory is the referee when two labs disagree, where risk changes hands, how rejection and price adjustment work, and how the terms carry across seasons as an annex rather than a renegotiation. A repeat buyer needs both: the agreement once, the specification per lot type.
Quality Agreement
The standing terms: sampling, methods and the referee laboratory, risk transfer, rejection and remedy, and an annex model so next season’s crop means a new annex, not a new contract.
Specification — gourmet whole bean
Numeric criteria for culinary whole beans: moisture, length and count, appearance and suppleness, defect allowances, packing and net weight.
Specification — extraction grade
Numeric criteria for extraction lots, where vanillin on a stated basis, residues and microbiology carry more weight than cosmetic appearance.
Incoming Inspection Record
What was measured on arrival, against the specification, so acceptance or rejection rests on a document, not a memory.
Notice of Non-Conformity
The written notice that preserves your rights when a lot misses — sent correctly and on time, because most claims are lost on notice, not on merit.
Retained Sample Log
The record of the retained third of each sample, so a later dispute can be tested against sealed, agreed material.
Once you accept a lot — by using it, or by letting the inspection window lapse without notice — your leverage largely evaporates. The quality agreement’s inspection and notice clauses exist to protect the window in which you can still act. Know when your clock starts, because it often starts earlier than you think.
Rejection, Rework, and the Formula That Beats a Negotiation
The most valuable clause is the one that says what happens when a lot misses. Without it, a near-miss becomes a negotiation conducted at your weakest moment — goods in hand, money largely paid, production waiting. With it, the outcome is mechanical: a lot a few points over the moisture ceiling triggers a price adjustment by a pre-agreed formula; a lot past a hard limit is rejected; a borderline lot is accepted at a defined discount. The formula is agreed when both sides are calm, so it is not re-litigated when one side is not.
Buyers often write careful numeric criteria and then leave out what happens when a number is missed, assuming good faith will settle it. Good faith settles nothing once money and goods are at stake. The remedy — rejection, rework, or a price-adjustment formula — is the half of the specification that gives the numbers teeth.
Sampling and the Referee Lab: Where Numbers Are Decided
A numeric specification is only as good as the sample it is tested on and the laboratory that tests it, which is why the quality agreement spends as much care on process as on parameters. Sampling has to be defined so it survives a dispute: how the sample is drawn, from how many points in the lot, and who witnesses it. A retained third — a sealed portion of the sample kept by each side — means that when a question arises later, there is agreed material to test rather than two parties arguing from memory. Without a defined sampling method, a supplier can truthfully say your rejection rests on an unrepresentative handful, and the specification you wrote so carefully never gets to do its job.
The second half is the referee clause. Two accredited laboratories can return different figures on the same lot, within the bounds of measurement uncertainty, and a specification that does not say whose result governs simply relocates the dispute from the beans to the labs. A referee clause names, in advance, a third laboratory whose result is binding, and splits the cost by who was closer to right. It converts a potential standoff into a procedure — which is the whole philosophy of the document: decide the hard questions while everyone is calm, so none of them has to be decided while everyone is not.
Carrying It Across Seasons
Vanilla is a seasonal crop, and this season’s moisture band or defect allowance may not fit next season’s harvest. A specification baked into the body of a signed contract forces a full renegotiation every year. A specification held in an annex that the standing agreement refers to lets you reissue one page when the crop changes, while the hard-won terms — sampling, referee lab, remedy formula, risk transfer — stay put. This is how repeat buyers avoid starting from zero each season.
The Quality Agreement and Specification Sheet supplies all six documents as editable Word templates — the agreement, two specification sheets, and the inspection, non-conformity and retained-sample records — and explains every clause and parameter: the number to use, why that number, the method and measurement point, and the consequence. It turns “Grade A” into something a supplier signs and a shipment is held to, before the dispute you are trying to avoid ever has a chance to start.
Frequently Asked Questions
Why isn’t “Grade A” enough to specify vanilla in a contract?
Because no international standard defines Grade A, grading conventions differ by supplier and region, and the statutory grade permits a wide moisture range. A supplier can deliver a much wetter lot than you expected and still be within “Grade A,” leaving you no enforceable argument in a dispute.
What makes a vanilla specification enforceable?
Every line needs four things: a number or range, a test method, a point of measurement, and a consequence when the line is missed. A line with all four — for example a moisture range, measured by a named method on a drawn sample at loading, with rejection or price adjustment for lots outside it — can be tested and enforced; a grade label cannot.
What is the difference between a quality agreement and a specification sheet?
A specification sheet defines what you are buying in numbers for a given lot type. A quality agreement sets the standing terms every order refers to — sampling, the referee laboratory, risk transfer, rejection and remedy, and an annex model for seasonal changes. Repeat buyers usually need both.
How should a vanilla specification handle a lot that just misses the numbers?
With a pre-agreed remedy: a price-adjustment formula for a lot slightly over a ceiling, rejection for a lot past a hard limit, and acceptance at a defined discount for a borderline lot. Agreeing the formula while both sides are calm prevents a near-miss from becoming a negotiation at your weakest moment.
Why should vanilla specifications live in an annex rather than the contract body?
Because vanilla is seasonal, and this year’s moisture band or defect allowance may not fit next year’s crop. Holding the specification in an annex that the standing agreement references lets you reissue one page each season while keeping the hard-won terms — sampling, referee lab, remedy formula, risk transfer — in place.
Does writing a vanilla specification require a lawyer?
The templates can be drafted and adapted without one, but sale-of-goods law differs by country, so a lawyer in your own jurisdiction should review the agreement before you rely on it. The specification numbers and methods are a procurement exercise; the enforceability of the surrounding terms is where legal review earns its cost.
What does a specification protect that a grade label does not?
It protects the gap between what you wanted and what the grade allows. A grade label lets a supplier deliver anything plausibly under that label; a numeric specification with methods, measurement points and consequences defines exactly what the shipment must be and what happens if it is not, turning a hope into an enforceable standard.
Further reading: ISO 5565 — vanilla specification