Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.voyado.com/llms.txt

Use this file to discover all available pages before exploring further.

Reward vouchers can be imported by file (CSV, UTF-8).
Each import file should not contain more than 20,000 rows.

​
The file

Column nameDescription
*MemberKeyKey (hard-coded to attribute memberNumber)
*PromotionNameName of the campaign that the voucher might be part of
*CreatedOnCreation date
*ExpiryDateExpiration date
*ValidFromValid-from date, can differ from creation date
*RewardVoucherValuesDefines how a check amount is converted into the currencies that the customer currently uses
*BonusPointsAmount of reward points converted
*ValueValue of the reward voucher
*UniqueCodeVoucher’s unique code, preferrably another series than what Engage is using to prevent duplicates. If left blank, Engage will add a number from its own series
*UsedIf the voucher has already been used (1 or 0)
UsedByField to say who used the voucher (optional)
UsedStoreIdField to show which store received the voucher (optional)
UsedByInvoiceExternalIdField to specify which invoice the voucher was used on (optional)
Mandatory fields are marked with *.

​
Example

MemberKeyPromotionNameCreatedOnExpiryDateValidFromRewardVoucherValuesBonusPointsValueUniqueCodeUsedUsedByUsedStoreIdUsedByInvoiceExternalId
201Q1 bonus2018-01-19 10:36:57.0002018-07-19 10:36:57.0002018-01-19 10:36:57.000SEE NOTE1000100A00011679INVOICE-1
16Q4 bonus2017-11-19 10:36:57.0002018-05-19 10:36:57.0002017-11-19 10:36:57.000SEE NOTE1000100A00020567INVOICE-2
The values for RewardVoucherValues will be something like:
[{"Currency":"EUR","Amount":5.00},
{"Currency":"NOK","Amount":50.00},
{"Currency":"SEK","Amount":50.00}]
The file should then be placed on your client FTP inside a folder named BonusCheckImport. File example You can download examples as CSV and Excel on the example files page. Starting the import There is no scheduled job to process the file. It must instead be triggered manually by your Voyado team. The result, including the validation check, will be shown in the integration log under Data migration.