Loymax, 2024

Gift certificate template sets


The template set contains templates of identifiers and number of certificates

Each certificate can have several identifiers: a number, a barcode, a QR-code and three magnetic strips. The pattern set can contain any combination of these identifiers, but at least one must be specified. The template set also limits the number of certificates that will be issued with a given set of identifiers. This limitation is called dial capacity.

Section Money Certificates > Template Sets displays all template sets created in the system. Template sets can be filtered by Title, State (archived and unarchived), Loyalty Program and Partner.

The template set can be edited edit.PNG only if it is not added to any certificate issues. If a pattern set is used in at least one issue, you can view information view_info.PNG about the pattern set.

Non-archival set of templates can be sent to the archive archive.png, and the archive - restore from the archive recover.png.

To create a new set of templates, click Create at the top of the section.

In the window for creating a new set of templates, fill in the following fields:

  • Template set name;
  • Loyalty program, within the framework of which it is supposed to use this set of templates;
  • Partner, for which this template set is created;
  • Set capacity is the number of certificates that can be generated by the given set of templates.

Then click Add template and select one or more identifiers. For each identifier in the set, you must specify the template by which the identifier value will be generated. The template uses special meta variables.

To generate unique certificate identifiers, each template must contain mandatory meta variables. Optional metavariables can be used as desired. The order in which the metavariables are arranged in the template is not important. Any characters can be used between them (!"№;%:?*()_+-=).

Met variableDescription
Mandatory metavariables
$Emission.Id(<length>)Provides the ID of the current certificate issue and adds zeros to the specified length. For example, if Id=1 and length = 5, then the meta variable will return the value 00001.
$Emission.Counter()The value is generated by the counter unique within certificate release. The length of the value is calculated automatically based on the specified capacity in the pattern set.
Unnecessary metavariables
$Emission.Number()

This metavariable can be used only if the template for the certificate number is already defined in the template set. The meta variable returns the value that was generated for the certificate number. It can also be used in conjunction with other meta-variables.

For example, based on the pattern for the certificate number $Emission.Id(5)$Emission.Counter() the number 00001001 was generated. If the barcode pattern $Emission.Number() is specified, it will return the same value 00001001.

Thus, the $Emission.Number() may be used instead of the combination $Emission.Id(5)$Emission.Counter() in all templates except the one for the certificate number.

$Emission.Random(<length>)Met variable adds a random number to the number.
$Emission.CheckDigitAlgorithm(Ean13/Luhn16)Adds the check digit to the number. In the template it is necessary to specify one of the check digit types - Ean13# or Luhn16#. A meta variable is added at the end of the pattern.

Examples of money certificate number templates

Template Set Capacity - 5000

To generate 5000 certificates, we recommend using a template like 25$Emission.Id(2)$Emission.Counter()$Emission.Random(4)$Emission.CheckDigitAlgorithm(Ean13).

An example of a certificate number with this pattern: 2501000551854, where:

  • 25 is the beginning of the number;
  • 01 is the id of the certificate issue;
  • 0005 is number of the certificate in the issue;
  • 5185 is a random number;
  • is a check digit calculated by Ean13 algorithm.

Template Set Capacity - 10000

For 100,000 certificates, we recommend using a template like 2599$Emission.Random(4)$Emission.Id(2)$Emission.Counter()$Emission.CheckDigitAlgorithm(Luhn16).

An example of a certificate number with this pattern: 2599138902000034, where:

  • 2599  is the beginning of the number;
  • 1389  is a random number;
  • 02  is an id of certificate issue;
  • 00003  is the certificate number in the issue;
  • 4 is the check digit calculated using the Luhn16 algorithm.

News
Version history
Tags
Glossary
Site