Import Vouchers

If you don't want to create vouchers individually, but instead create multiple vouchers in bulk, you can use the import function. When importing vouchers, you need to upload a CSV file containing all the necessary information. Each line of this CSV file will then be generated as a unique voucher in the system.

Once you upload the file, the column headers in your CSV must be matched to the corresponding fields in our system. If your CSV headers already use the correct field names, the system will automatically link them for you.

To start a voucher import, go to the Vouchers module. Click the Import option in the upper right corner and select the CSV file you want to upload. Afterward, you’ll see additional settings where you can link the field names as described above.

You can find a sample import file here.

You can find a sample import file here. Visual step by step guide

Import File

The following variables can be stored in the CSV file. We also explain the meaning of the field as well as the possible contents. More information about the variables can be found in the voucher code creation.

The file must meet the following requirements:

1. File format: CSV (semi-colon delineated)

2. File size: Any

3. Column names: Best case, the columns of the CSV should have the exact name of the internal fields they will be linked to during import. This is because they will be directly linked when the file is selected, so they do not have to be selected individually.

4. Structure: one line must correspond to a single voucher.

5. Mandatory fields:

   1. Amount

Note: Only the Amount is mandatory. All other fields can be left blank if necessary. The fields correspond to the fields which can be filled in the manual voucher code creation.

Voucher Code import file

amount

the amount of the voucher in seller’s currency

code

code used to redeem the voucher. If not specified, a random 8 char code will be generated. Duplicated codes skipped

validUntil

the ISO date until this voucher can be redeemed

Import Process

To perform a voucher code import, select the Import button via the Discounts and Vouchers module. Alternatively, the ticket import can also be triggered via the same process in the Jobs module.

Perform the following steps for the import:

Click Import to start the import. You will be automatically redirected to the Jobs module.

In the Jobs module you have the possibility to download a file of the successful imports. If there are any records that could not be imported successfully, you can also download a file with all failed records.

Import Errors

After performing an import, you will be automatically redirected to the Jobs module. There you have the possibility to download all successful and all failed records. You can access the Jobs module later by clicking on your vivenu account name in the lower-left corner of the dashboard. Failed records are those promo codes that could not be imported for certain reasons. In the right column of each failed record file, you will find the so-called Error reason.