Skip to main content
Unit defines how the quantity of the product should be interpreted either using a GOBL lower-case key (e.g. ‘kg’), or UN/ECE code upper-case code (e.g. ‘KGM’).

​
Schema ID

https://gobl.org/draft-0/org/unit

​
Values

ValueTitleDescription
mgMilligrams
cgCentigrams
gMetric grams
kgMetric kilograms
tMetric tons
mmMillimetres
cmCentimetres
dmDecimetresA unit of length equal to one-tenth of a metre.
mMetres
lmLinear metresThe running length in metres of a uniform-width product (e.g. carpet, fabric, cable), billed per metre regardless of width.
kmKilometres
inInches
ftFeet
lftLinear feetThe running length in feet of a uniform-width product (e.g. lumber, trim, cable), billed per foot regardless of width.
mm2Square millimetres
cm2Square centimetres
dm2Square decimetres
m2Square metres
acAcresA unit of area equal to 43,560 square feet.
haHectaresA unit of area equal to 10,000 square metres.
mm3Cubic millimetres
cm3Cubic centimetres
dm3Cubic decimetres
m3Cubic metres
mlMillilitres
clCentilitres
dlDecilitres
lLitres
klKilolitres
wWatts
kwKilowatts
kwhKilowatt Hours
rateRateA unit of quantity expressed as a rate for usage of a facility or service.
yrYearsA unit of time equal to twelve months.
monMonthsUnit of time equal to 1/12 of a year of 365,25 days.
wkWeeksA unit of time equal to seven days.
dayDays
sSeconds
hHours
minMinutes
piecePiecesA unit of count defining the number of pieces (piece: a single item, article or exemplar).
itemItemsA unit of count defining the number of items regarded as separate units.
pairPairsA unit of count defining the number of pairs (pair: item described by two’s).
dozenDozensA unit of count defining the number of units in multiples of 12.
assortmentAssortmentsA unit of count defining the number of assortments (assortment: a collection of items or components of a single product packaged together).
serviceService UnitsA unit of count defining the number of service units (service unit: defined period / property / facility / utility of supply).
jobJobsA unit of count defining the number of jobs.
activityActivitiesA unit of count defining the number of activities (activity: a unit of work or action).
tripTripsA unit of count defining the number of trips (trip: a journey to a place and back again).
groupGroupsA unit of count defining the number of groups (group: set of items classified together).
outfitOutfitsA unit of count defining the number of outfits (outfit: a complete set of equipment / materials / objects used for a specific purpose).
kitKitsA unit of count defining the number of kits (kit: tub, barrel or pail).
baseboxBase BoxesA unit of area of 112 sheets of tin mil products (tin plate, tin free steel or black plate) 14 by 20 inches, or 31,360 square inches.
pkBulk PacksA unit of count defining the number of items per bulk pack.
oneOneA single generic unit of a service or product.
bagBags
boxBoxes
binBins
canCans
tubTubs
caseCases
trayTrays
portionPortions
setSetsA unit of count defining the number of sets (set: a number of objects grouped together).
rollRolls
cartonCartons
cylinderCylinders
barrelBarrels
jerricanJerricansJerrican, cylindrical
carboyCarboys
demijohnDemijohns
bottleBottles
6packSix Packs
canisterCanisters
pkgPackagesStandard packaging unit.
pktPackets
bunchBunches
bdlBundles
blkBlocks
tetrabrikTetra-Briks
palletPallets
reelReels
sackSacks
sheetSheets
envelopeEnvelopes
lotLot
unitUnitA type of package composed of a single item or object, not otherwise specified as a unit of transport equipment.

​
Validation Rules

FieldTestValidation Code / Message
Unit
  • Matches ^[A-Z0-9]$, or one of [mg, cg, g, kg, t, mm, cm, dm, m, lm, km, in, ft, lft, mm2, cm2, dm2, m2, ac, ha, mm3, cm3, dm3, m3, ml, cl, dl, l, kl, w, kw, kwh, rate, yr, mon, wk, day, s, h, min, piece, item, pair, dozen, assortment, service, job, activity, trip, group, outfit, kit, basebox, pk, one, bag, box, bin, can, tub, case, tray, portion, set, roll, carton, cylinder, barrel, jerrican, carboy, demijohn, bottle, 6pack, canister, pkg, pkt, bunch, bdl, blk, tetrabrik, pallet, reel, sack, sheet, envelope, lot, unit]
GOBL-ORG-UNIT-01
Unit must be a valid value or UN/ECE code