UN/CEFACT Web Vocabulary (Vocab)

The Vocab is a linked-data vocabulary for the international supply chain: the shared classes, properties and code lists spanning seven domains: trade, transport, finance, regulatory, production, conformity and a shared core.

To understand the ontology, its architecture, how to use it and how to contribute, visit the Vocab documentation site.

Content negotiation. Every domain, class, property, code list and code value is dereferenceable at its own URL as HTML, Turtle or JSON-LD. Request a representation with an Accept header:

curl -H "Accept: text/html"           https://test.uncefact.org/vocabulary/Consignment
curl -H "Accept: application/ld+json" https://test.uncefact.org/vocabulary/Consignment
curl -H "Accept: text/turtle"         https://test.uncefact.org/vocabulary/Consignment
Vocab domains

Click any domain to see the classes and code lists in that domain.

Classes (92)

ClassDomainDefinition
AccountfinanceA financial account that is the source or destination of payments.
AddresscoreA postal/physical address of a party or location.
AircrafttransportAn air transport means (adds e.g. tail number, flight-specific properties).
AllowanceChargetradeAn allowance (deduction) or charge (addition) affecting a trade price or settlement.
AssessmentconformityA specific assessment activity carried out to demonstrate, or to contribute towards a demonstration, that specified requirements are fulfilled. The object of conformity assessment is identified by the object type, currently product, facility or organisation.
AttestationconformityA statement of the outcome of one or more related conformity assessment activities conducted for the purpose of demonstrating that specified requirements are fulfilled. It has a broader intent than the ISO/IEC 17000 term attestation, which refers to the issuance of statements of conformity.
AuthorityEndorsementconformityThe authority-derived recognition under which a conformity attestation is issued, for example an accreditation, a government mandate, or a peer recognition. Renames the former Endorsement, which the scheme no longer references, so its sole use is now the attestation's authorisation.
BookingtransportA transaction recording the reservation of transport services for a consignment.
CargoDetailsregulatoryThe cargo-item lines within a cargo report.
CharacteristicsconformityA declaration of conformance with one or more criteria from a specific scheme.
ClaimproductionA performance claim about a product, facility or organisation, made against a defined criterion.
ConformityProfileconformityA versioned description of a conformity scheme, or subset of a conformity scheme, in terms of broad scheme activity elements, without including the detailed assessment criteria. A conformity profile may be as broad as differentiating environmental from safety assessment streams, or as granular as representing specific standards.
ConsignmenttransportA separately identifiable collection of consignment items moved from one consignor to one consignee under one transport contract.
ConsignmentItemtransportA quantity of goods grouped by tariff code/packaging for transport — the lowest level within a consignment.
ContactPointcoreAn addressable channel for communicating with a party (telephone, email, web, messaging), with its number or URI and use type.
CriterionconformityA specific rule within a standard or regulation (e.g. a carbon-intensity calculation rule).
DangerousGoodstransportGoods which may contain a substance which poses risks to people and/or the environment during transportation which is regulated by dangerous goods regulations.
DeclarationDetailsregulatoryThe customs item lines within a declaration (one tariff code each). Maps to WCO GoodsItem.
DeliveryTermstradeConditions agreed between the parties with regard to the delivery of goods (e.g. an Incoterms rule and its named place).
DimensioncoreOverall length, width, height, weight and volume of an item.
DutyTaxFeeregulatoryA customs duty, tax or fee assessed on a declared goods item.
EmissionproductionA calculation of the pollution (including noise, heat, and radiation etc.) discharged into the environment by a residential, commercial, or industrial facility or by a means of transport, such as a vessel, aircraft or truck.
EventcoreA punctual occurrence at a point in time: the supertype of the domain-specific events (production make/move/modify, transport arrive/depart/load/discharge). It carries the metadata common to all events — time, location, responsible party, subject and type — while domain-specific detail lives on its subclasses. An event is also how a change in its subject entity's lifecycle state is recorded.
FacilitycoreThe physical site (e.g. farm or factory) where a product or materials are produced, handled or stored.
FinanceAgreementfinanceA contract under which a financial institution funds a trade.
ForecastTermstradeA set of terms and conditions by which a supply chain forecast has been or will be made.
GeoCoordinatescoreA geographic point defined by latitude and longitude (WGS 84).
GovernmentRegistrationregulatoryThe recording of items or details for a governmental purpose.
IdentifiercoreA single identifier issued for an entity within a scheme: the registered value plus the issuing scheme, with an optional label.
IdentifierSchemecoreAn identifier registration scheme for products, facilities, or organisations.
ImagecoreA binary image encoded as base64 text with its media type.
InsurancefinanceCover protecting cargo/trade value against loss.
IOTDeviceproductionAn IOT (Internet of Things) piece of mechanical or electronic equipment which can collect, report and autonomously transmit digital data.
LicenceregulatoryA permit from an authority to own or use something, do a particular thing, or to conduct a trade.
LifecycleEventproductionAn event describing a step in a product's lifecycle (make, move, modify); the supertype of MakeEvent, MoveEvent and ModifyEvent. It specialises the core Event, inheriting the common event metadata (eventTime, eventLocation, responsibleParty, eventClassifier, eventSubject, eventTypeCode). Generic event semantics (aggregation, transformation, EPCIS bizStep/disposition) are out of scope — use GS1 EPCIS where those are needed.
LinkcoreA URL link plus associated metadata (name, type, hash).
LocationcoreA place — address and/or geo-location of a point, area or boundary.
MakeEventproductionTransformation (manufacture/production) of input products into output products.
MarkingtransportAn inscription, stamp or label on packaging, such as to indicate date, ownership, quality, manufacture or origin.
MaterialproductionDetails about the origin or source of a material that a product is made from.
MaterialUsageproductionA record of a material a facility consumes and the period over which it does so. An identity-less value object.
MeasurecoreA numeric value together with its unit of measure.
ModifyEventproductionIntervention (e.g. repair) on a product without changing its identity.
MonetaryAmountcoreA monetary value together with its currency.
MoveEventproductionTransfer (shipment) of products from one facility to another.
OrganisationcoreAn organisational party.
PartycoreAn actor in the supply chain. Roles (buyer, seller, carrier, importer, …) are properties whose range is Party, not subclasses.
PartyRolecoreA party in the role it plays relative to a referencing entity (party + role, optionally on-behalf-of). An identity-less value object, not a party-register entry.
PaymentfinanceA transfer of funds settling a trade obligation.
PaymentMeansfinanceThe means by which a payment will be or has been made for trade settlement purposes.
PaymentTermstradeThe terms of payment for a trade (due date, discount and penalty terms).
PerformanceconformityA claimed, assessed or required performance level, defined by a measure and/or a score against a metric.
PeriodcoreA period of time (e.g. a month, quarter or year).
PersoncoreAn individual party.
ProcessDeclarationconformityA declaration covering one process area, or one distinct scope within a process area, against applicable international standards.
ProductproductionDetailed information regarding a product, including its identity, provenance and characteristics.
ProductBatchproductionA group of products considered or dealt with together.
ProductionProcessproductionA naturally occurring or designed sequence of operations or events in order to produce something.
ProductPackageproductionDetails of product packaging. Distinct from TransportPackage (transport-domain wrapping).
RegisteredIdentitycoreThe registration of a party's identity in an official register (the subject of a Digital Identity Anchor).
RegulationregulatoryThe rule under which import/export is permitted or controlled. Vocab-distinctive: WCO references procedures, not the rule itself.
RegulatoryProcedureregulatoryA customs/regulatory procedure applied to the clearance of a consignment (import, export, transit), under a regulation.
SchemeconformityThe set of rules and procedures that describes the objects of conformity assessment, identifies the specified requirements and provides the methodology for performing conformity assessment (intended to align with ISO/IEC 17000:2020 Clause 4.9). Since conformity assessment schemes, programs and systems are not differentiated here, the term may encompass any of these.
SchemeDeclarationconformityA first-party statement by a scheme owner describing the governance, development and delivery arrangements of its conformity scheme, made with reference to applicable international standards. Its object is the scheme itself, not an assessed product, facility or organisation.
ScoreconformityA single score (code, definition, rank) within a scoring framework.
ScoringFrameworkconformityA scoring framework used for performance-level assessments against a criterion.
SealtransportA security seal affixed to transport equipment.
SensorDataproductionA sensor data recording associated with a lifecycle event.
ServicetransportA service associated with a transport movement.
ServiceChargetransportA charge made for a logistics related service.
ShipmenttradeAn identifiable collection of trade items transported together from seller (consignor) to buyer (consignee).
ShipmentPackagetradeThe packaging grouping trade items within a shipment.
ShippingMarkstransportPhysical markings or labels on individual packages or transport units for logistics purposes.
StandardconformityA published specification (e.g. ISO 14000) against which conformity is assessed.
SupplyChainInventorytradeSupply chain goods and materials held in stock.
SupplyPlantradeSpecification of the delivery quantities and date/time values in a supply schedule.
TradeAgreementtradeThe sales contract by which a buyer and seller agree the supply of goods or services.
TradeDocumentcoreA thin anchor for an exchanged business document: a grouping of domain concepts identified by a documentType code. Its structure is defined in downstream schemas, not in this vocabulary.
TradeItemtradeThe lowest level of commercial information in a trade — a product/service line with code, quantity and unit price.
TradePricetradeA sum of money for which something is or may be bought or sold for trade purposes.
TradeSettlementtradeThe financial settlement terms and totals of a trade agreement.
TradeTaxtradeA tax applied to a trade agreement or trade item.
TransportCalltransportAn ordered stop of a transport means along a movement (arrive/load/unload/depart), with a sequence number and location.
TransportEquipmenttransportEquipment used to hold, protect or secure cargo (container, ULD, trailer).
TransportEventtransportA punctual transport occurrence at a transport call — arrival, departure, loading or discharge — planned, estimated or actual. It specialises the core Event: time, classifier, responsible party, subject and type come from Event, while atCall links it to the stop in the movement's itinerary where it occurs. Scheduled and actual times are both recorded as events (via eventClassifier), so the call itself carries no time.
TransportLegtransportThe span between two consecutive transport calls; the segment a consignment is assigned to.
TransportMeanstransportThe device conveying goods.
TransportMovementtransportThe physical carriage of goods for transport purposes — a voyage, flight, trip or journey.
TransportPackagetransportA self-contained wrapping or container holding goods for transport (box, barrel, pallet).
TransportRoutetransportA planned route (itinerary and schedule) over which transport movements are performed.
TrucktransportA road transport means (adds e.g. gross vehicle mass, registration).
VesseltransportA waterborne transport means (adds e.g. draft, IMO number).

Code lists (115)

Code listDomainConcepts
Address Format Typecore3
Address Typecore8
Adjustment Reasontrade105
Aggregation Typeconformity7
Allowance Charge Idtrade105
Allowance Charge Reasontrade105
Assessment Levelconformity3
Assessment Object Typeconformity3
Assessor Levelconformity4
Attestation Typeconformity9
Cargo Categorytransport9
Cargo Operational Categorytransport25
Cargo Type Classificationtransport25
Certificate Typeconformity3
Charge Paying Party Roletrade21
Commitment Leveltrade25
Communication Channelcore47
Consignment statustransport4
Contact Typecore104
Countrycore249
Criterion Statusconformity3
Currencycore179
Customs Duty Regime Typeregulatory5
Dangerous Goods Classtransport21
Dangerous Goods Packaging Leveltransport4
Dangerous Goods Regulationtransport24
Delivery Termstrade13
Delivery Terms Functiontrade8
Dimension Typecore24
Document Statuscore51
Document typecore822
Endorsement Typeconformity5
Event typecore0
Financial Account Typefinance2
Financial Adjustment Reasonfinance81
Financial Institution Rolefinance2
Freight Charge Tariff Classtransport14
Government Actionregulatory10
Harmonized System (HS)core0
Improvement Indicatorconformity3
ISIC (International Standard Industrial Classification)core0
ISO 3166-2 (country subdivisions)core0
ITU-T E.164 country calling codescore0
Languagecore185
License Typeregulatory7
Line Statustransport119
Location Functioncore315
Logistics Statustransport336
Marking Instructiontransport50
Measured Attributecore292
Optional Criteriaconformity4
Organization Function Typecore6
Package Typetransport405
Packaging Leveltransport6
Packaging Markingtransport52
Party rolecore46
Party Typecore5
Payment Guarantee Meansfinance12
Payment Meansfinance84
Payment Means Channelfinance16
Payment Methodfinance52
Payment Termsfinance7
Payment Terms Event Time Referencefinance5
Payment Terms Typefinance79
Price Typetrade39
Priority Descriptioncore6
Product IDGranularityproduction3
Product Statusproduction9
Refund Methodfinance3
Registry Typecore6
Responsible Government Agencyregulatory19
Responsible Government Agency Involvementregulatory8
Scheme Alignment Levelconformity3
Scheme Authorityconformity3
Scheme Endorsement Levelconformity4
Scheme Process Areaconformity5
Seal Conditiontransport5
Sealing Party Roletransport7
Statuscore352
Tax Categorytrade22
Tax Exemption Reasontrade32
Tax Typetrade56
Temperature Typetransport9
Time Referencecore65
Transport Contract Movementtransport33
Transport Equipment Categorytransport98
Transport Equipment Fullnesstransport13
Transport Equipment Haulage Arrangementstransport2
Transport Equipment Legal Statustransport2
Transport Equipment Movement Statustransport4
Transport Equipment Operational Statustransport23
Transport Equipment Size Typetransport42
Transport equipment statustransport4
Transport Equipment Supplier Party Roletransport7
Transport Means Directiontransport9
Transport Means Typetransport134
Transport Modetransport10
Transport Movement Stagetransport30
Transport Movement Typetransport5
Transport Service Categorytransport23
Transport Service Conditiontransport39
Transport Service Payment Arrangementtransport4
Transport Service Prioritytransport4
Transport Service Requirementtransport66
UN number (Dangerous Goods)core0
UN/LOCODEcore0
Unit of measurecore1383
UNTP Conformity Topic Classificationconformity101
UNTP Performance Metrics Vocabularyconformity79
Validation Document Statuscore2
Vocab any codecore0
Vocab code list scopecore3
Vocab object naturecore2
Vocab term statuscore4
Workflow Statuscore24