Digital Data Management (DDM)

End-user guide to OpenEPCIS Digital Data Management — curate GS1 master data, publish digital product passports, manage resolver links and analyze scans.

What is Digital Data Management?

Every product tells a story: what it is, who makes it, what it contains, how to use it, how to recycle it. Today that story is scattered — some of it printed on the packaging, some in a retailer's database, some in a PDF on the manufacturer's website. Regulation is now pulling it together: the EU's Ecodesign for Sustainable Products Regulation (ESPR) requires a digital product passport for more and more product groups — a machine-readable, always-current record of the product, reachable directly from the product itself.

Digital Data Management (DDM) is the OpenEPCIS application for exactly this job. It is where you write the product's story once, as structured GS1 master data, and where everything derived from that single record is managed: the public passport page a consumer reaches by scanning the QR code, the links the scan can lead to, the rules about who may see which detail, and the statistics about how the passport is actually used in the wild.

The key idea to hold on to is that DDM never asks you to maintain the same fact twice. A product's description, its country of origin, its certificates — each lives in one place, the master-data record. The passport page renders from it. The resolver derives links from it. The GS1 network is fed from it. When the record changes, everything downstream follows.

How a scan becomes a passport

To understand the application, it helps to walk once along the path a single scan takes:

Data flow from the DDM catalog workspace through the Catalog API and GS1 Digital Link resolver to the public passport page and scan analyticsData flow from the DDM catalog workspace through the Catalog API and GS1 Digital Link resolver to the public passport page and scan analytics

It starts long before the scan, in the catalog workspace, where you describe the product. DDM stores that description in the OpenEPCIS Catalog as GS1 Web Vocabulary data — the same vocabulary the whole GS1 world speaks, so nothing you enter is locked into this one application.

The address printed into the QR code is a GS1 Digital Link: a normal web address built from the product's GS1 identifier, for example https://id.your-domain.com/01/09521000551015. The 01 is GS1's code for "what follows is a GTIN". This construction is the quiet foundation of everything else: because the product's identifier is also a web address, anything in the world that knows the GTIN can find the product's data — no app required, no proprietary lookup service, just a URL.

That address does not point at a fixed page. It points at the resolver, a small routing service that keeps, for every identifier, a list of typed destinations — the product information page, a sustainability report, safety instructions. This list is called the linkset, and the indirection it provides is deliberate: the QR code on the packaging is printed once and lives for years, but where it leads can be changed any day, in DDM, without touching the packaging.

By default the resolver sends a scanning consumer to the public passport page, which renders the master-data record — but only the parts your access policy makes public. The same address shows more to a signed-in business partner and more again to an authority, which is how one printed code can serve three very different audiences.

Figure 1: Where the loop ends — the passport page a consumer reaches by scanning the code

Finally, every scan leaves a trace in Scan Analytics — deliberately anonymous, aggregated statistics that answer questions like "where is this product being scanned?" and "what information do scanners look for that we don't offer yet?".

A vocabulary for reading this guide

A few terms appear on every page of this guide, so here they are once, in plain language. The identifier a passport hangs on — a product's GTIN, a company's or location's GLN — is called the anchor. The record behind an anchor is its passport; the curated profile that decides which fields that passport offers (generic product, battery, textile, packaging…) is its passport type. The typed destinations the resolver serves for an anchor form its linkset. And every field of a passport carries an access tierPublic, Authorized only or Restricted — which decides who gets to see its value.

The guide, chapter by chapter

ChapterWhat it covers
Getting StartedSigning in, the catalog workspace, search, columns, your profile and roles
Managing ProductsThe product list, creating products with a passport type, bulk import
The Passport EditorTabs, field types, GPC picker, validation, access levels, versions
Organizations & PlacesGLN records, primary locations, public GLN pages
Linksets & GS1 Digital LinkThe link explorer, ownership model, templated links
Public Passport PagesThe demo gallery, the passport viewer, templates, what consumers see
Passport TemplatesField obligations, hidden fields and creation defaults per passport type
Field Access ControlAccess tiers, persona preview, reviewer feedback
Resolver DomainsServing GS1 Digital Links from your own hostname via CNAME
GS1 Germany SyncService tokens, the key pool, Verified by GS1, outbound publication
Scan AnalyticsScan statistics, insights and the privacy report

DDM is one module of the OpenEPCIS platform; how it relates to the EPCIS repository, the resolver and the vocabulary tooling is described in the platform overview.

Want to click along while you read? A public demo of the passport side runs at demo.epcis.cloud — the demo gallery works without an account.

When something goes wrong

DDM translates every API failure into a plain-language message, so an error you see on screen should already tell you what to do. For reference, the most common ones:

MessageWhat happened
Unable to connect to the serverA network problem between your browser and DDM — check your connection and retry.
Your session has expiredLog in again; the app returns you to where you were.
You don't have permission to …Your account lacks the role for that action — see roles and contact your administrator.
The submitted data is invalidA field failed server-side validation; the form highlights what to fix.
The item could not be foundThe record was moved or deleted — often by a colleague; refresh the list.
An item with this ID already existsThe GTIN/GLN is already taken in your tenant — identifiers are unique.
Too many requestsRate limiting kicked in; wait a moment and try again.
The server encountered an unexpected error / temporarily unavailableA backend problem; retry in a few minutes, then contact support.

One safety net is worth knowing from day one: every list page offers Open by GTIN (or GLN). Even when a list will not load, a record can always be opened directly by its identifier.

Last updated: