Tracking numbers

Configuration

Tracking numbers

Every request gets two tracking numbers, and every sample gets its own. This page explains how they are built, when they are assigned and how to change the format.

Who this is for: Laboratory owners and administrators · You need: the "Manage company profile" permission to change request numbering, and "Manage forms" to change sample numbering

The idea in short

A tracking number is the number a request or sample is known by. Each request has two:

Number Who uses it Can it change?
Internal number Your lab, day to day. Yes. You can edit it on the request, as long as it stays unique.
External number Your customer. It goes on what you send out. No. It never changes after the request is created.

Both numbers are built from a format: a pattern of fixed text and tokens, such as {dd}{mm}{yy}-{form_code}-{seq_day_form}. Each token is replaced with a value (a date part, the form's code or a count) when the number is assigned.

You set the formats once for the whole company. They apply to requests on every form.

When numbers are assigned

  • Request numbers are assigned when the request is first saved. If the number is already used by another request in your company, the request is refused with "That tracking number is already in use for this company."
  • Sample numbers are assigned when a sample is added or saved. A sample is never renumbered. If a sample is removed, its number is not reused and leaves a gap.

On the request's edit page, the Tracking numbers section shows both numbers. Internal tracking number can be edited and is required. The External tracking number shows "Assigned when the request was created; it never changes."

Both numbers are the first columns in the Requests list, and the list's search also finds requests by tracking number.

Format templates

How to change the request number format

  1. Open Settings and click the Company tile.
  2. Scroll to Request numbering.
  3. Click into Internal number format or External number format.
  4. Type fixed text, or click a token button next to Insert into: to add a token at the cursor. The buttons insert into the field you last clicked.
  5. Watch the preview under the field. It shows the number the first request today would get.
  6. Click Save changes.

Leave a field blank to use the default format, {dd}{mm}{yy}-{form_code}-{seq_day_form}. The preview then says "(default format)".

📷 Screenshot: the Request numbering section with the token buttons and the live preview

Tokens

Token Meaning
{dd} Day of the month, two digits
{mm} Month, two digits
{yy} Year, two digits
{yyyy} Year, four digits
{form_code} The code of the request's form
{seq_day_form} Count of today's requests on this form
{seq_month_form} Count of this month's requests on this form
{seq_month} Count of all this month's requests
{seq_year_form} Count of this year's requests on this form
{seq_year} Count of all this year's requests

Padding with zeros. Add :width to a token to pad it with zeros: {seq_day_form:4} gives 0001. The count tokens are padded to 3 digits when you give no width.

Examples

For the third request on form LAB1 on 25 August 2026:

Format Number
{dd}{mm}{yy}-{form_code}-{seq_day_form} (default) 250826-LAB1-003
{yyyy}/{seq_month} 2026/047 (if it is the 47th request this month)
{form_code}-{yy}{mm}-{seq_month_form:4} LAB1-2608-0012 (if it is the 12th request on LAB1 this month)
{seq_year}/{yyyy} 482/2026 (if it is the 482nd request this year)

The live preview

The preview reads "First request today on form LAB1:" followed by the number, using the code of your most recent form. Use it to check the format before saving.

If the format has no count token, a warning appears: "No sequence token — the second request of a day would get the same number and be refused." Add {seq_day_form}, {seq_month_form}, {seq_year_form}, {seq_year} or {seq_month}.

Sample numbers

Samples are numbered per form, not per company. Open the form and go to the Item numbering section (see Forms). It has:

Field Default What it builds
Item internal number format {internal_number}-{seq_item:2} The sample's internal number, for example 250826-LAB1-003-01.
Item external number format {external_number}-{seq_item:2} The sample's external number, the one printed on the test report.
Item shortcode format blank (for example {alpha_order}) A short label for the sample, for example a, b. Left blank, no shortcode is made.
Component internal number format {sample_number}.{seq_child} Internal numbers for components of a sample, for example 250826-LAB1-003-01.1.
Component external number format {sample_external_number}.{seq_child} External numbers for components, built on the sample's external number.
Component shortcode format blank A short label for each component.

The sample tokens are:

Token Meaning
{internal_number} / {external_number} The request's internal or external number
{sample_number} / {sample_external_number} The parent sample's internal or external number (for components)
{seq_item} The sample's position in the request: 1, 2, 3 …
{seq_child} The component's position under its sample
{alpha_order} A letter for the position: a, b, … z, aa, ab …

You can also use the request tokens ({dd}, {form_code}, {seq_day_form} and so on). They take the request's own date and counts, so they are the same for every sample in the request. {seq_item} and {seq_child} are not padded unless you add a width.

Rules

Rule What happens
A number already in use The request (or sample) is refused. Change the number or the format.
No count token in the format Two requests on the same day get the same number, and the second is refused.
An unknown token, such as a typo It is left in the number exactly as typed. Check the preview.
Changing the format Only new requests get the new format. Existing numbers stay as they are.
Counters Every count advances with every request, whatever format is in use, so you can switch formats at any time without restarting or repeating counts.
Counters behind the numbers in use After importing requests, new numbers can collide with imported ones. Use Sync counters under Settings → Company → Request numbering. It raises today's, this month's and this year's counts past the highest number already in use, and never lowers them. Save a changed format before you sync.
Starting with numbers already used elsewhere If you start in LIMS part-way through a month (or day) with requests already numbered on paper or in another system, set Next number under Settings → Company → Request numbering. Pick the counter your format uses (this year or this month, on a form or for all forms, or today on a form), and enter the number the next request should get. You can correct a number that is too high, but not set one at or below a number a request already carries. Only the current day, month and year can be set.

Tips

  • Keep a count token in every format, and check the preview for typos before saving.
  • Avoid {seq_month} in the external number: it tells customers how many requests you received this month.
  • Give each form a short, clear code. It appears in every number built with {form_code}.
  • If you correct an internal number by hand, keep the same pattern so the list stays easy to sort and search.
↑↓ to move ↵ to open esc to close