Adding a GS1 Digital Link

Now that the projects, products, and redirections for your products have been set up in an EVRYTHNG account, the next step you can take to increase the value for both your brand and your consumers is to replace the previously mentioned short URL QR code with one containing a GS1 Digital Link.

This new standard encodes GS1 Application Identifiers such as GTIN (01) or Serial (21) with a URL containing the equivalent data. A URL such as this is much more valuable, since it can be systematically read by a PoS or inventory management system as well as a consumer's mobile phone and redirect to a dynamic experience using the EVRYTHNG Platform! If you'd like to discover more about the Digital Link make sure you have a look at our playground.

Setting up this feature for your products takes only a few steps:

  • Ensuring a redirection is set for the product.
  • Setting up GS1 AI data on an EVRYTHNG product.
  • If serialized Digital Links are required, setting up AI data on each individual product Thng.

Check Redirection

In order to create a GS1 Digital Link for a product, it must first have a redirection describing some experience or web app that a user identifying the product with a QR code scan will be taken to by their browser. A common example is some product-specific nutritional or safety information.

If the product you want to add a Digital Link to does not currently have a redirection set (i.e: no QR codes are visible in its Product Details page in the Dashboard), follow the steps in Redirections and Actions to set one up.


SKU Level Digital Links on Products

A GS1 Digital Link utilising the EVRYTHNG Platform can support several of the most common GS1 application identifiers, describing data about the product, such as its GTIN or CPV numbers.

A simple EVRYTHNG GS1 Digital Link will contain just one of these, but for the full value of serialised identities to be applied to this area, each Thng linking to a product with a GTIN must also have a GS1 Serial. For the purposes of this walkthrough, both cases will be covered.

The first step is to add the correct namespaced identifiers for the GTIN (01) to your product using its id. Here we assume it has no identifiers currently:

curl -H "Content-Type: application/json" \
  -H "Authorization: $OPERATOR_API_KEY" \
  -X PUT 'https://api.evrythng.io/v2/products/:productId' \
  -d '{
    "identifiers": {
      "gs1:01": "05000157089906"
    }
  }'

Once the request is complete, you should be able to see the 'GS1 Digital Link' tab appear on the right side of the Product Details page, containing the product's Digital Link URL and equivalent QR code. Note that as always, you can also set these identifiers via the Dashboard as well.

The product now has its own GS1 Digital Link with a QR code ready for printing on packaging! You can change the URL the redirection points to at any time, or even use some Redirector rules to make this a dynamic destination based on factors such as locale, time, extra data etc.


Serialised GS1 Digital Links on Thngs

Once a Thng's product has its GTIN information set up, a similar item must be added to each Thng's identifiers to set its GS1 Serial number (21). If this serialised mode of GS1 Digital Link is being used, ensure that the Thng's redirection is set up first.

curl -H "Content-Type: application/json" \
  -H "Authorization: $OPERATOR_API_KEY" \
  -X PUT 'https://api.evrythng.io/v2/thngs/:thngId' \
  -d '{
    "identifiers": {
      "gs1:21": "43786"
    }
  }'

Once the Thng has been updated, and its product correctly configured with a GTIN, the Thng Details page in the Dashboard will show a similar view of the GS1 Digital Link for the Thng on the right hand side:


Wrapping Up

After following through this walkthrough, you should have gained an insight into how some of the various basic resource types of the EVRYTHNG Platform can play a useful role in an example tagged products scenario. To recap:

  • Projects are used to limit access and visibility of resources.
  • Applications represent remote apps/integrations, and are used to give access to users of the app.
  • Products represent classes of objects, and are used to share metadata across instances.
  • Thngs are the main data containers, and are used to be the physical counterpart of real-world objects, products, and devices.
  • Actions are used to represent discrete events or alerts/notifications.
  • Dashboard widgets can be customized to display insightful summaries of actions by their various types and locations.
  • Adding two more pieces of data to unlock a GS1 Digital Link QR code for use on universal packaging.