Create a lot template
Create a new lot/serial format template at version 1. The format_string is validated for the target.
Authorizations
Body
Request body for POST /lots/templates/.
Human-readable template name.
1 - 128Token format, e.g. LOT-{YYYY}{JJJ}-{####}. Validated against the target field's constraints.
1 - 256Which GS1 field the identifiers populate. Only lot can currently generate runs.
lot, serial Optional free-text notes.
2000Alphabet identifier or literal characters.
64Optional check character appended after token expansion.
none, mod10, iso7064_11_2 When the counter resets to its starting value.
never, daily, weekly, monthly, on_product_change, on_count_reached, manual Required when reset_condition=on_count_reached: the count that triggers a reset.
x >= 1How the counter is partitioned across products/dates/tags.
global, per_product, per_product_per_date_bucket, tag Counter value used after a reset (first sequence emitted).
x >= 1Soft-retry budget per identifier for random-source tokens before a hard collision.
0 <= x <= 50Response
Created
A saved generation recipe (latest version).
Template id (22-char shortuuid). Use in /lots/templates/{id}/ paths.
Human-readable template name.
Which GS1 field the identifiers populate.
lot, serial Token format, e.g. LOT-{YYYY}{JJJ}-{####} renders as LOT-2026123-0001.
Alphabet identifier or literal characters. Defaults to GS1 AI 82.
Optional check character appended after token expansion.
none, mod10, iso7064_11_2 When the counter resets to its starting value.
never, daily, weekly, monthly, on_product_change, on_count_reached, manual How the counter is partitioned (the scope_key shape).
global, per_product, per_product_per_date_bucket, tag Counter value used after a reset (first sequence emitted).
Soft-retry budget per identifier for random-source tokens before a hard collision.
Current template version. Bumps on a format-affecting edit while in use.
Archived templates cannot generate until unarchived.
Creation timestamp (ISO-8601).
Last-modified timestamp (ISO-8601).
Optional free-text notes.
Counter value that triggers a reset when reset_condition=on_count_reached.
Reserved for row-per-version chains; null in the current in-place versioning scheme.