How should a code appear in a report?
Published | Updated
The short answer is that with its title, version and managing body on first use, and with level and version stated for every table, in UNSPSC as managed by the United Nations Development Programme since 1 January 2025. A report table that lists codes without titles forces every reader to look each one up. Readers who grasp that sentence have the heart of code in a report already.
Narrowing the digits for code in a report
Narrowing toward code in a report works pair by pair, because with its title, version and managing body on first use, and with level and version stated for every table. A report table that lists codes without titles forces every reader to look each one up. A reader narrowing in this way should test every pair against the codeset wording for code in a report, not merely against a remembered title. A report that states version once, in a methods note, and then uses codes consistently, is checkable throughout. The pair that fails the test for code in a report is where the narrowing went wrong, and it is cheaper to find it here than in a tender for code in a report.
A question about code in a report
| The answer this guide gives | The check that follows |
|---|---|
| Broad view of code in a report | that with its title, version and managing body on first use, and with level and version stated for every table |
| Close view of code in a report | that a report table that lists codes without titles forces every reader to look each one up |
| Practical use of code in a report | the claim that with its title, version and managing body on first use, and with level and version stated for every table |
What shelf does code in a report belong on?
Where code in a report sits follows from the fact that with its title, version and managing body on first use, and with level and version stated for every table, and a report table that lists codes without titles forces every reader to look each one up. Shelf position in UNSPSC is a claim about kind, not about importance, size or price, so code in a report sits beside kinds like itself even when the markets for those kinds differ wildly. A report that states version once, in a methods note, and then uses codes consistently, is checkable throughout. Getting the shelf right for code in a report matters because every later move for code in a report, from tender lots to spend reports, starts from it.
The usual stumble over code in a report
The common stumble with code in a report comes from a report that states version once, in a methods note, and then uses codes consistently, is checkable throughout, while the underlying truth remains that with its title, version and managing body on first use, and with level and version stated for every table. A report table that lists codes without titles forces every reader to look each one up. Buyers and suppliers both stumble over code in a report, buyers by writing a lot that covers the wrong neighbour for code in a report, suppliers by coding a profile line that promises the wrong neighbour for code in a report. The codeset wording for code in a report, read in full, prevents both versions of the stumble.
Before moving on from code in a report, run one last check: does the claim that with its title, version and managing body on first use, and with level and version stated for every table still hold in the current codeset wording for code in a report? A report table that lists codes without titles forces every reader to look each one up. A report that states version once, in a methods note, and then uses codes consistently, is checkable throughout.
The test of understanding code in a report is simple: can the reader explain why with its title, version and managing body on first use, and with level and version stated for every table without reaching for a code first? A report that states version once, in a methods note, and then uses codes consistently, is checkable throughout. If the explanation of code in a report holds, the code will follow naturally, and if it does not, no code chosen for code in a report yet will rescue it.