# Generate Gift Codes in Bulk

There are certain scenarios in which you may want to generate a lot of gift codes and purchasing individually isn't ideal.

We have a way for you to import a file with pre-generated gift codes to facilitate that task.

## To get started

* First you'll need to generate a CSV file with the list of gift codes and other attributes defined below
  * Check if there are maximum character and regular expression restrictions defined in your redemption flow before generating the codes
* Request access from Limio to access the CSV ingestion bucket

## Prepping the file

1. **Check the file size to upload**\
   For reliability and performance we recommend that a file has *no more than 5,000 records*. Bigger files can cause data loss.
2. **Check the file structure**\
   Make sure the headers match as these are case sensitive. NB: the table below describes which fields are mandatory
3. **Name the file correctly**\
   Files to be uploaded for the general migration process need to have the following prefix: `Limio_gift_code_`.

## Processing the file

* Upload the file into the right CSV bucket (ie: SHARD.csv-ingestion.limio.com)
  * You can get this information from your Limio contact.
* Limio splits the file into batches of 1,000 and if your original file had 5,000 records for example, you'll see multiple files in the bucket being processed.
* Once the process is finished they'll be moved to the *processed* folder.

## Checking the outcome

* You can check progress by going into your Subscriptions page in the Limio Commerce app (<https://yourdomain.prod.limio.com/objects/subscriptions/limio>) which will show the orders that have been processed.
* Once the files have finished processing you'll see events for the associated events in the *Events* section in the Limio Commerce app.
  * Any errors will also appear in the *Events* section.

### CSV file structure

| string           | yes | Subscription unique identifier - can be the source (legacy) value. It will also be used as Order Number to prevent duplicates if importing again same record. **IMPORTANT**: it needs to be the subscriptionNumber field exported to **Zuora** since is going to work as link for the integration |
| ---------------- | --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| string           | yes | **Zuora** account id, used to link to an existing customer uploaded (it could be in Limio or uploaded via other migration file)                                                                                                                                                                   |
| string           | yes | It’s the code that the redeemer will use to get the subscription                                                                                                                                                                                                                                  |
| string           | yes | Defines the path of the Limio offer to be mapped into the subscription. Example: “/offers/digital/annual”                                                                                                                                                                                         |
| string (int)     |     | The original quantity for the gift code. If not specified 1 is assumed                                                                                                                                                                                                                            |
| string (int)     |     | The already used quantity for the gift code. If not specified 0 is assumed                                                                                                                                                                                                                        |
| string (isodate) |     | Expiry date for the gift code/voucher, format: YYYYMMDD. If not specified there will be no expiry                                                                                                                                                                                                 |