Digital Facility Record
Please note that this content is under development and is not ready for implementation. This status message will be updated as content development progresses.
Artifacts
Are maintained at https://test.uncefact.org/vocabulary/untp/dfr/0/about
Stable Releases For Implementation
Version 1.0 stable release for production implementation is due in June 2025 after formal public review
Release for Pilot Testing
Version 0.6.0 release artifacts can be used for pilot testing.
Latest Development Version
Latest development versions are used to reflect lessons learned from pilots but should not be used for either pilot testing or production purposes.
Ontology
The ontology for the Digital Facility Record is available in JSON-LD format and can be retrieved via content negotiation from:
https://test.uncefact.org/vocabulary/untp/dfr/0/
Example:
curl https://test.uncefact.org/vocabulary/untp/dfr/0/ -H 'Accept: application/ld+json'
Version History
History of releases is available from the Version history page.
Default Render Template
A UNTP digital facility record may be rendered in any format desired by the issuer. However a default Template Design is provided here and includes mapping of visual rendering elements to the Logical Data Model.
Sample Credential
URL | QR | Description |
---|---|---|
Sample Battery Manufacturing Facility Record | A sample digital facility record as a JWT envelope signed Verifiable Credential. The URL (or QR scan) resolved to a hosted verifier that displays a human readable version. Raw JSON data can be viewed via the JSON tab and the full credential can be downloaded via the download button. |
Overview
The digital facility record (DFR) is issued by the owner or operator of a production or manufacturing facility and is the carrier of facility data and sustainability information for an identified facility in the value chain. It is very similar to the digital product passport except that it describes a facility rather than a product. The DFR is discoverable in the same way as a DPP - namely by resolving the facility ID to an Identity Resolver service that will return links to facility records. The sustainability performance metrics are also at the facility annual total level rather than at the product level. In many value chains, facility level information may be sufficient to meet the due diligence requirements of buyers and so the facility record can be used independently of the product passport. However product passports should reference the facility at which the product was produced. Where both facility and product information are available, verifiers can perform an approximate mass-balance assessment for quantity based criteria such as GHG emissions. For example, the total individual emissions recorded in all products shipped from a facility should approximately equal the reported annual emissions of the facility.
Conceptual Model
TBA
Requirements
The digital facility record is designed to meet the following detailed requirements as well as the more general UNTP Requirements
ID | Name | Requirement Statement | Solution Mapping |
---|---|---|---|
DFR-01 | Resolvable ID | Each facility must have at least one resolvable identifier that can be used in digital product passports and other data exchanges so that verifiers can always access the latest facility data. | Facility.id |
DFR-02 | Process categories | The DFR should support any number of industry process classifications using codes from a defined classification scheme (eg UN-CPC) | Facility.processCategory |
DFR-03 | Geo-Location | The DFR should should provide a means to specify both a geo-location point (aka pin) and a boundary geometry (aka polygon) so that verifiers can geo-locate supplier facilities | Facility.locationInformation |
DFR-04 | Owner / operator | The DFR should specify the owner and/or operator entity of the facility using one or more globally unique and resolvable entity identifiers. | Facility.operatedByParty is a UNTP Party structure that meets this need. |
DFR-05 | Declarations | The DFR MUST provide a means to include any number of conformity declarations so that it can provide simple single point to aggregate all claims about the facility in one place | The FacilityRecord.conformityClaim array is designed to meet this need |
DFR-06 | Conformity Topic | The DFR MUST provide a simple mechanism to express the sustainability/circularity/conformity topic for each claim so that similar claims can be grouped and the high level scope easily understood. | The Claim.conformityTopic code list is designed to meet this need |
DFR-07 | Metrics | The DFR MUST provide a simple mechanism to quantify a conformity claim (eg carbon intensity, water consumption, etc) and to express any accuracy range. | The Claim.declaredValue is designed to meet this need |
DFR-08 | Criteria | The DFR MUST provide a means to reference a standard or regulation as well as the specific criteria within that standard or regulation - so that claims can be understood in terms of the criteria against which they are made. | The Claim.referenceRegulation, Claim.referenceStandard and Claim.assessmentCriteria is designed to meet this need |
DFR-09 | Evidence | The DFR MUST provide a means to reference independent conformity assessments that support and verify the claims being made. The related evidence SHOULD be digitally verifiable but MAY be a simple document or web page. The confidence level attached to the evidence should be clear. | The Claim.conformityEvidence property references a relevant digital conformity credential |
Logical Model
The Digital Facility Record is an assembly of re-usable components from the UNTP core vocabulary.
Core Vocabulary Documentation
The UNTP core types vocabulary defines the uniquely identified Linked Data entities such as Product, Location, Facility, Party, Standard, Regulation, Criteria, Declaration, Attestation, Endorsement. These entities provide the building blocks for construction of the Digital Facility Record.
DFR Documentation
The DFR documentation provides a technology-neutral definition of classes, properties and code lists in the DFR model.
Implementation Guidance
This section provides sample JSON-LD snippets for each DFR component with guidance on their purpose and usage.
Verifiable Credential
Digital Facility Records are issued as W3C Verifiable Credentials. Please refer to DPP VC Guidance for information about the use of the verifiable credentials data model for UNTP. The issuing party for the VC should be the facility owner or operator.
Facility Record
The credentialSubject
is a FacilityRecord object. It comprises
- An identifier
id
unique to this record instance, typically represented as a URI. - A nested facility object containing detailed information about the physical site.
- A list of conformityClaim objects about the facility made by the facility owner or operator.
"credentialSubject": {
"type": [
"FacilityRecord"
],
"id": "example.com/facility-record/1234",
"facility": {},
"conformityClaim": []
}
Facility
The Facility object nested within FacilityRecord comprises
- An identifier for the facility. This could be a self-issued DID, or an ID managed by an industry association such as a member/facility register, or a global location scheme. Whatever the facility identifier scheme, facility IDs should be resolvable and verifiable.
- The registered id of the facility.
- A short description of the facility.
- The registered name of the facility.
- Details of the identification scheme used to identify the facility.
- The country in which this facility is operating.
- One or more industry process categories, preferably using a global standard classification scheme such as UN ISIC.
- The operatedByParty for the facility, typically identified using a national business register or a global business identifier scheme.
- An optional list of additional identifiers
facilityAlsoKnownAs
from other schemes. - The semi-structured address for the facility.
- The geolocation information for the facility (using PlusCodes and GeoJSON).
"facility": {
"type": [
"Facility"
],
"id": "https://samplefacilityregister.org/1234567",
"registeredId": "1234567",
"description": "LiFePO4 Battery plant number 7",
"name": "Example facility 7",
"idScheme": {
"type": [
"IdentifierScheme"
],
"id": "https://examplefacilityregister.org",
"name": "A facility register"
},
"countryOfOperation": "AU",
"processCategory": [
{
"type": [
"Classification"
],
"id": "https://unstats.un.org/unsd/classifications/Econ/isic/2720",
"code": "2720",
"name": "Manufacture of batteries and accumulators",
"schemeID": "https://unstats.un.org/unsd/classifications/Econ/isic",
"schemeName": "UN Standard Industry Classification"
}
],
"operatedByParty": {
"type": [
"Identifier"
],
"id": "https://abr.business.gov.au/ABN/View?abn=90664869327",
"name": "Example Company Pty Ltd.",
"registeredId": "90664869327",
"idScheme": {
"type": [
"IdentifierScheme"
],
"id": "https://abr.business.gov.au",
"name": "Australian Business Number"
}
},
"facilityAlsoKnownAs": [..],
"address": {
"streetAddress": "level 11, 15 London Circuit",
"postalCode": "2601",
"addressLocality": "Acton",
"addressRegion": "ACT",
"addressCountry": "AU"
},
"locationInformation": {..}
}
Location
Facility location is a value object (i.e. it does not have a unique identifier). It's purpose it to locate the facility in a geographic area with whatever degree of resolution required. A location object must include at least one of the following geolocation properties:
- An open location code (also know as Plus Codes). Plus codes are essentially a grid reference and can define an small area that is virtually a pin location (eg https://plus.codes/8CGRC78W+MM) or a much larger area (eg Roughly Madrid city - https://plus.codes/8CGRC700+) by removing digits after the "+" and replacing grid digits with an even number of trailing zeros.
- A geoLocation as a GeoJSON Point as a decimal latitude / longitude pair.
- A geoBoundary as a GeoJSON Polygon that defines any closed boundary (or collection of closed boundaries) as a sequence of lat/long pairs where the first and last pair represent the same point.
"locationInformation": {
"plusCode": "https://plus.codes/8CGRC78W+MM",
"geoLocation": {
"type": "Point",
"coordinates":[
40.416688,
-3.703313,
]
},
"geoBoundary": {
"type": "Polygon",
"coordinates": [
[
[100.0, 0.0],
[101.0, 0.0],
[101.0, 1.0],
[100.0, 1.0],
[100.0, 0.0]
]
]
}
}
Conformity Claims
Conformity information is included in the Digital Facility Record as an array of UNTP Claim structures. The same structure is re-used for conformity information in Digital Product Passports. Please refer to the DPP Conformity Information section for further information and examples.