🌅 GS1 "Sunrise 2027" - 2D Barcodes, GS1 Element String, and GS1 Digital Link URI support

[hangy]

What

Smooth App should support 2D barcodes - more specifically "GS1 DataMatrix" and "GS1 QR Code".

This includes support for barcodes that contain the GTIN in more formats than the current barcode.

• GS1 DataMatrix with GS1 element string with just a GTIN: (01)3274080005003
• GS1 DataMatrix with GS1 element string with just additional information, for example best before (15), and weight in kg with three decimals points (3103):

  (01)3274080005003
  (15)230501
  (3103)000123
  

• DataMatrix or QR Code only GTIN: A GS1 Digital Link URI: https://www.example.org/01/3274080005003
• DataMatrix or QR Code with same information as in the above GS1 element string: A GS1 Digital Link URI: https://www.example.org/01/3274080005003/15/230501/3103/000123

Why

GS1 has plans to replace the current EAN/UPC barcodes by DataMatrix and QR Code barcodes to support storing more data in the barcode. Traditional and 2D barcodes will be used in parallel for a while after this, but GS1 apparently intends to stop issuing new non-2D codes starting 2027.

GS1 links

• Global 2D Programme - Foundational FAQs (PDF)
• Get Ready for Sunrise 2027
• GS1 US Sunrise 2027 One Pager
• Two-dimensional (2D) barcodes
• GS1 US Advanced Data Carrier for
  Point-of-Sale (POS) Getting Started Guid
• GS1 Application Identifiers (used as the identifiers in the data string/uri)

Who for

All users of Smooth App will profit from this. Users of ProductOpener have already spotted products in the wild that did not have a traditional EAN barcode on the box mid-2023.

How

Different GS1 barcode types have been implemented in the search API already. Internally, they're normalized to the EAN. It would be great if the app could search for products using the full barcode, so that the server API can extract values from the AIs. However, the value of barcodes with a lot of Application Identifiers is not easily human-readable, so it's probably better to show the GTIN to end-users, and potentially extract data from the AIs (ie. best before, lot number) as human-readable additional information separately.

GS1 provides official parsers for validation of barcodes. The engine is provided as a C library, and can probably integrated as a native library in Dart/Flutter similarly to zxing.

Tasks

Beta Give feedback

1. Ensure the current scanner can scan QRcodes, but only GS1 QRcodes
2. Create or find a Dart package to validate GS1 QrCodes payload - https://pub.dev/packages?q=gs1 - https://pub.dev/packages/gs1_barcode_parser
3. Pass the barcode part to the current API
4. (Product addition) Prepopulate Weight on product addition using the GS1 Qr Code payload
5. (Product addition) Prepopulate Best Before on product addition using the GS1 Qr Code payload
6. (Product addition) Prepopulate regular barcode on product addition using the GS1 Qr Code payload
7. (Product addition) Prepopulate official product url on product addition using the GS1 Qr Code payload
8. (Product addition) Prepopulate Batch/Lot on product addition using the GS1 Qr Code payload
9. (Product addition) Prepopulate Serial Number on product addition using the GS1 Qr Code payload
10. (Product addition) Prepopulate Net Weight on product addition using the GS1 Qr Code payload
11. (Product addition) Mention the GS1 QR Code as data source in the edit comment
12. (Product addition) Add a label or a folksonomy engine property mentionning the product has a GS1 QR code

Part of

• 🤳🥫 Scanning (tracker) #526

[teolemon]

@hangy from my understanding of what you wrote, and what we can do / should do on mobile
Question: "weight in kg with three decimals points (3103)" how does that work for light products ?

### Tasks
- [ ] Ensure the current scanner can scan QRcodes, but only GS1 QRcodes
- [ ] Create or find a Dart package to validate GS1 QrCodes payload
- [ ] Pass the barcode part to the current API
- [ ] (Product addition) Prepopulate Weight on product addition using the GS1 QrCodes
- [ ] (Product addition) Prepopulate Best Before on product addition using the GS1 QrCodes
- [ ] (Product addition) Prepopulate regular barcode on product addition using the GS1 QrCodes
- [ ] (Product addition) Prepopulate official product url on product addition using the GS1 QrCodes
- [ ] (Product addition) Prepopulate Batch/Lot on product addition using the GS1 QrCodes
- [ ] (Product addition) Prepopulate Serial Number on product addition using the GS1 QrCodes
- [ ] (Product addition) Prepopulate Net Weight on product addition using the GS1 QrCodes

[hangy]

@hangy from my understanding of what you wrote, and what we can do / should do on mobile Question: "weight in kg with three decimals points (3103)" how does that work for light products ?

The GS1 has way, ways more AIs available. We can/have to choose which to use client-side. If it's lighter than can be described by those decimals, they might use 3105, which is defined as n.nnnnn kg.

In your task list, you write about GS1 QR Codes. I think it's important to note that GS1 DataMatrix is at least as important as QR Code, if not more important.

[teolemon]

https://pub.dev/packages/gs1_barcode_parser

[hangy]

https://pub.dev/packages/gs1_barcode_parser

Appears to be pretty limited. I think it doesn't support GS1 Data URIs