Skip to content

Label Orders

A Label Order is a request to produce printed Labels of one Label Format. Creating an order plans its Labels as Ordered Labels: each has a print sequence number and the values printed on it, such as a serial and a Vlink. An Ordered Label is not yet a Label. It becomes one when the printed Label is enrolled and matched to it, so an order always shows how many of its Labels have arrived, are still outstanding, or were lost along the way.

The Team that creates an order produces its Labels and owns its Vlinks. It holds the resulting Reels until it ships them.

A Label Format describes one physical label design entirely by its Label Slots. A Label Slot is one place on the label that carries an Identifier: its type (DUST, Text, QR, Barcode, Data Matrix or NFC), a name such as “Serial” or “Verify link”, and a key used as its column name in files. Any combination is valid, from a single QR code to two Vlinks, a serial and a DUST marking.

Each Slot says where its value comes from:

SourceValue
VlinkA Vlink minted for the order. A QR Slot carries the full Vlink URL.
Serial SeriesThe next values of a Serial Series.
SuppliedA value you upload with the order, one per Label.
ConstantOne value printed on every Label of the order, chosen per order.
CapturedA DUST marking or NFC chip applied to the label, not printed from a value. Captured Slots have no column in the Print File.

A Slot’s scope says how widely one value repeats. Per Label gives every Label its own value. Shared prints one value on a group of Labels in print order, for example one Vlink per case of 24. Constant uses one value for the whole order.

Open Label Formats to create a Format, edit it, or archive one you no longer order. A Format’s Slots can change until an order uses it; after that only its name, description and Capture Profile can change. The Capture Profile names how an enrollment station photographs and cuts the label.

A Serial Series is a named numbering space for printed serials, such as “DUST Labels”. Several Label Formats can draw from one Series so their numbers never collide. Each order reserves its values up front, and a value is never issued to a different Label.

A Series has one of two patterns:

  • Odometer: segments of letters, digits and fixed text that roll over like an odometer, for example two letters and 00001 to 99999, so AB99999 is followed by AC00001. You can set the first value to issue to continue an existing sequence.
  • Random: fixed-length random codes, sorted into print order.

Because a pattern has a finite capacity, Serial Series shows each Series’ capacity, how many values remain and the next value it will issue. An order that needs more values than remain is refused before anything is generated. A Series’ pattern is fixed once an order has reserved values from it.

An order is one of two kinds. They differ only in when each Vlink gets its real destination.

  • A Stock Order is inventory printed before any customer is known. Its Vlinks start at the order’s placeholder URL and get a real destination later, when the stock is shipped to a customer or by that customer after receipt.
  • A Customer Order is printed for a known customer. Its Vlinks are minted with their final destination.

Each Vlink Slot of an order is either Automatic or Pinned. An automatic Vlink follows the Public Page of the Thread its Label is bound to, then the Team’s default destination, then the placeholder URL. A pinned Vlink holds one URL that later events never move. In DICE a pinned destination comes from a Destination Template: a URL pattern filled in per Label, for example https://example.com/verify?auth_number={auth_number}, where {auth_number} is replaced by that Label’s value.

External References are named per-Label values that are never printed and belong to the customer’s own systems, such as an authentication number their verification page looks up. Each is either Generated (a random identifier per Ordered Label) or Supplied in your upload. External References travel with the Label and appear in the Order Export, never in the Print File.

  1. Open Label Orders and select New order.

  2. Choose the Label Format.

  3. Choose Customer or Stock, name the order, and enter the quantity (up to 2,000,000 Ordered Labels).

  4. Set the destinations: the placeholder URL (required for a Stock Order), Automatic or Pinned for each Vlink Slot, any External References, and the value of each constant Slot.

  5. If the Format has supplied Slots or you added supplied External References, upload a CSV with one row per Label in print order and choose the column for each value. The quantity becomes the number of rows.

  6. Review the order and select Create order.

The order starts as Generating while DICE reserves its serials and mints its Vlinks. The order page shows the progress and updates by itself. When the order is Ready, its downloads are available. If generation fails, the order shows Failed with the reason, and nothing was printed from it.

The order page counts its Ordered Labels by state and lists them in print sequence. Select a count, or use the State filter, to list only that state.

StateMeaning
OutstandingPlanned and not yet enrolled as a Label.
EnrolledIts printed Label was enrolled and matched to it.
MissingClosed: misprinted, torn or spliced out of the Reel. It never becomes a Label.
ReprintedReplaced by an Ordered Label of a Reprint.
VoidClosed: cancelled, it should never have been printed.

The page also shows how many enrolled Labels are still Held by your Team and how many have been Shipped onward.

Each ready order has two CSV downloads:

  • The Print File is what the Labels are printed from: one row per Label in print order and one column per printable Label Slot, each cell holding the exact value to print or encode. A QR Slot’s cell is the full Vlink URL. Closed Ordered Labels are left out. The same file is the expected manifest when the printed Reels are enrolled.
  • The Order Export lists every Ordered Label with its Slot values, External References, Vlink URLs, current destinations and state. It is the file to send a customer for their own records.

Both downloads stream directly to your computer, so even very large orders download without waiting for DICE to prepare them.

A print run that was produced before Label Orders existed can be brought into DICE as an Imported Label Order. Its Ordered Labels come from the print file you upload, and its existing Vlinks are adopted rather than minted again.

  1. Open Label Orders and select Import.

  2. Choose the print file (CSV, one row per Label in print order), its Label Format, the kind, and a name. A Stock import needs a placeholder URL: its adopted Vlinks are moved to it as one recorded change that can be reverted. A Customer import keeps each adopted Vlink pinned at its current destination.

  3. Map the columns. For each printable Label Slot, choose the column that holds it, or leave it as Not in the file. Add any columns to keep as External References.

  4. Select Check file. DICE checks the whole file without changing anything and reports the result.

  5. When the check says Ready to import, select Import. The order is written in the background and opens when it starts.

The check reports:

  • Rows and New Ordered Labels.
  • Legacy Reprints: rows whose serial and Vlink both match an Ordered Label you already have. That range was reprinted reusing its Vlinks, so it is recorded as a Reprint rather than as new Ordered Labels, and a second physical Label with the same QR code is expected there.
  • Repeated values within the file.
  • Conflicts: rows whose serial already belongs to an Ordered Label with a different Vlink.
  • Invalid Vlinks (cells that are not a Vlink URL) and Unknown Vlinks (Vlinks that do not exist).
  • Vlinks already in DICE, by the Team that manages them.
  • Enrolled Labels to link: Labels your Team already holds whose QR code matches an imported Vlink. They are linked to their Ordered Labels on import. Labels held by other Teams are not changed.

If you change the form after a check, check the file again before importing.

Some customers need an unbroken serial sequence, so Labels that were thrown away are reprinted rather than skipped. A Reprint creates a new order in the same lineage for the Ordered Labels you choose:

  • The replacements keep the originals’ serials and External References, so the customer’s numbering and records do not change.
  • Each per-Label Vlink is minted fresh and the original is revoked, so a surviving original never shares a QR code with its replacement. A shared Vlink is kept, because it is also on Labels that were not reprinted.
  • The originals become Reprinted. Any already enrolled as Labels are archived with your reason, except Labels bound to a Thread, which are left alone and reported.
  • The Reprint order has its own Print File with just the replacements, in original order.
  • Ordered Labels that have shipped cannot be reprinted. If any you choose has left your Team, with or without its Vlink, or is in a sent shipment, the Reprint is refused and lists their sequences.

To reprint, open the order, select Reprint, and enter the print sequences as numbers and ranges, for example 12-40, 77, with a reason. Up to 10,000 sequences can be reprinted at a time. The new order opens when it is created, and the original order lists its Reprints.

An Ordered Label that will never become a Label can be closed. Open the order, select Close Ordered Labels, enter the print sequences, choose Missing or Void, and give a reason. Only outstanding Ordered Labels are closed; any sequence that is already enrolled or closed is skipped and listed. Closed Ordered Labels stay on the order as history and leave its Print File.