Skip to main content

Digital Facility Record (DFR)

A DFR identifies a physical facility or location — a factory, warehouse, farm, processing plant, or any site involved in your supply chain.

Why DFRs Come First

Facilities are the foundation of your credential ecosystem. Product passports (DPPs) and traceability events (DTEs) reference facilities. Registering your facilities first means your product credentials can properly link to where things are made, stored, or processed.

Creating a DFR

  1. Navigate to Toolkit > Credentials > Issue
  2. Select DFR as the credential type
  3. Fill in the facility details:
FieldDescriptionRequired
Facility NameHuman-readable name (e.g., "Brisbane Processing Plant")Yes
AddressStreet address of the facilityYes
CityCity/suburbYes
State/ProvinceState or provinceNo
CountryCountryYes
Postal CodeZIP/postal codeNo
LatitudeGeographic latitude (decimal degrees)No
LongitudeGeographic longitude (decimal degrees)No
  1. Review the draft
  2. Click Issue to sign and publish

Using the AI Agent

Instead of filling in every field manually, you can use the AI Agent to generate the credential content from your existing documents and conformity claims.

  1. Create a DFR draft (fill in at least the facility name)
  2. Open the draft in the editor and switch to the AI Agent tab
  3. Upload a facility photo, describe the facility, upload supporting documents (PDFs, specs), and add conformity claims with evidence
  4. Click "Generate with AI Agent" — the AI builds a complete, UNTP-conformant credential from your inputs

For the full walkthrough including how to add conformity claims with PDF evidence or DCC links, see AI Agent & Evidence.

tip

The AI Agent is especially useful for conformity claims — upload an ISO certificate PDF or link to an existing DCC, and the AI extracts all the relevant details (certificate number, issuing body, validity dates) automatically.

Identifiers

DFRs use GLN-13 (Global Location Number) identifiers. These are automatically generated from your organization's 7-digit prefix:

9347823 00001 2
│ │ └── Check digit (GS1 mod-10)
│ └──────── 5-digit counter (auto-incremented)
└──────────────── Your org prefix

You don't need to provide an identifier — DPP Kit generates it for you.

After Issuance

Once issued, the DFR:

  • Gets a GLN-13 identifier assigned
  • Is signed with your organization's DID
  • Is stored in the credential storage service
  • Is registered in the Identity Resolver at the GLN path
  • Appears in your credential list with status Active

Re-issuing DFRs

DFRs always re-issue to the same resolver path, regardless of whether your organization is in pilot or production mode. This is intentional — a facility's identity shouldn't change, only its details should be updated.

Admin Only

Only organization Admins can create DFR credentials. Editors have read-only access to DFRs.