ZplGs1Migration
public static class ZplGs1MigrationGS1 2D migration assistant ("Sunrise 2027"): finds the linear GTIN carrier of each label (EAN-13, UPC-A, EAN-8, UPC-E, GS1-128 with AI (01), ITF-14, GS1 DataBar), adds a QR Code with a GS1 Digital Link URI or a GS1 DataMatrix with the same GTIN (plus batch/lot, dates and serial when the label carries them as GS1 element strings) and keeps the linear barcode, as the transition period requires both. The symbol is placed in free space found on the rendered label: X-dimension within 0.396–0.990 mm (GS1 General Specifications Table 5-46), quiet zone 4X (QR) or 1X (Data Matrix) plus a clearance, never over other fields or into their quiet zones. The result is verified by rendering the migrated label and by running the "sunrise" compliance pack on it.
This is a migration assistant and pre-check. It does not certify the label; check printed labels with a barcode verifier. GS1, GS1 DataMatrix and GS1 Digital Link are trademarks of GS1 AISBL, used here only to name the standards.
Try it online on zplCloud.com: Sunrise 2027 Migration
Fields & Constants
| Field | Type | Description |
|---|---|---|
const MaxModuleMm = 0.99 | double | X-dimension range for 2D symbols at retail POS (GS1 General Specifications 26.0 Table 5-46). |
const MinModuleMm = 0.396 | double | X-dimension range for 2D symbols at retail POS (GS1 General Specifications 26.0 Table 5-46). |
Methods
| Method Signature | Returns | Description |
|---|---|---|
static # Migrate(string zpl, Gs1MigrationOptions? options = default) | Gs1MigrationResult | Analyses zpl and adds the 2D carriers (see the class description). Throws ArgumentException: Invalid options (dpi, module size, Digital Link stem, additional elements). |