Release 14.10.2024

Improvements

AreaDescription
General

Unsaved changes warning (RTC-41899)

The unsaved changes warning in New gift card view is improved.


Gift Card Service (RTC-43213)

GiftCardService is updated to .NET 8.


Gift card transactions view performance (RTC-33646)

The performance of the Gift card Transactions grid is improved.


Documentation

GiftCard API documentation (RTC-44537)

The GiftCard service documentation in Swagger is updated with more information about transaction types.

Release 13.08.2024

Improvements

AreaDescription
Profiles

SMS distribution templates (RTC-41448)

The Distributor job supports specifying different SMS distribution messages for different profiles.



Release 10.07.2024

Issue multiple digital gift cards & import emails from Excel

(RTC-26333)

Multiple digital gift cards can be created and issued to a list of email addresses.

Email addresses can be registered manually, or imported from Excel.
An empty Excel template can be downloaded, filled out and imported.

The quantity of Gift cards must be the same as the number of email addresses in the import.
The user is notified if the quantities do not match.

The Excel template contains only one column; Email address.
Maximum 10,000 rows can be imported in the same import.

Improvements

AreaDescription
Transaction

Gift card transaction note (RTC-40825)

The full text of the transaction note is displayed when the mouse pointer is placed over the note column.

General

Multiple clicks creates duplicated gift cards (RTC-41462)

Multiple clicks on the Create button no longer creates duplicated gift cards.


Release 07.05.2024

Create Note when deactivating or activating Gift card

(RTC-36251)

When a gift card is deactivated or activated, the user can input a comment to why it was deactivated.
The note can be seen in the Gift Card transaction tab and on the Gift Cards 5 last transactions.



 image-2024-04-26-10-28-55-035.png

Improvements

AreaDescription
System

Update Last used date (RTC-33597)

Last used date is updated when doing redeem transactions and balance corrections.


Gift card overview

Improvement in Gift card overview (RTC-33647)

The performance when opening the gift card's overview page has been greatly improved, so that everything loads faster.

 

General

Inactive gift cards (RTC-39349)

  • Inactive gift cards can not be distributed.
  • Distributed gift cards with manually cancelled issue are removed from the system.


Release 15.12.2023

AreaDescription
System

Phone number selector (RTC-34250)

Prefix in the phone number selector is prefilled with country code obtained to the store related to the gift card, when owner phone number is empty.  


Gift cards can be issued in Estonia (RTC-36762)

Gift cards issued from stores in Estonia (profiles with country set to Estonia) have Estonian texts on the gift card.

Gift cards per profile (RTC-36243)

With configuration parameter named "Gift Card Usage Area", user is able to limit access for redeem and recharge transactions to the same profile or country as store that the specific gift card has been issued in.


Release 24.08.2023

Import section in gift card's history view

(RTC-17448)

Transaction types shows "Newly imported" and "Import updated". Import section is available in gift card's history view and contains grid with all import transactions made during single import.

Improvement

AreaDescription
Distribution

Fix: Send gift card emails when the currency code is not set (RTC-33422)

When the currency code of a gift card is not set, sending an email works correctly.


Email template for reminding customer (RTC-31612)

The RemindPIN gift card email template type is renamed to Resend, and will be used for resend and recharge distributions.

Gift card validation

Invalid validation requests (RTC-33413)

The GiftCard/Get requests return proper error messages if request parameters were invalid.


Release 21.08.2023

AreaDescription
Distribution

Resend gift card (RTC-32783)

Adding new email is blocked for "resend gift card" and adding new mobile number is blocked for "PIN code reminder". If email/mobile is missing, then Resend/Remind PIN button is hidden.


Fix: Include correct gift card images while sending multiple emails (RTC-33421)

While sending multiple gift card emails in a short amount of time, included gift card images correspond to ones in the web service.

Gift card transactions

Export to Excel ( RTC-33595)

Gift cards transactions' export to Excel works properly when excelBlobStorageSasConnectionString parameter is set up.

Import

ProfileId filled when store number is present in imported file (RTC-32581)

"ProfileId" field is no longer taken into account during importing gift cards. ProfileId is filled according to the store number field.

Issue gift card

Fix: Issue multiple gift cards in management fails when number starts with zero (RTC-33061)

Issuing multiple gift cards in management, for all numbers (including leading zeros) works correctly.

Multi-country

Multi-country: Gift card image text (RTC-32312)

The text on gift card's image is displayed in the culture, which is based on the profile's country code.
If profile's country code is empty or not supported (e.g. PL), then the image is displayed in the culture equal to the user's language.


Multi-country: GiftCard service and EmailTemplateDistributor job (RTC-32296)

The text on gift card's image is displayed in the culture, which is based on the profile's country code.
If profile's country code is empty or not supported (e.g. PL), then the image is displayed in the culture equal to the value of the parameter "Gift card image language".

The changes are applied in:

  • EmailTemplateDistributor job
  • Service requests:
    • /api/v2/GiftCard/giftcardNumber/img
    • /api/v2/GiftCard/image/{imageId/preview


Multi-country: Currency code based on store country when importing gift cards (RTC-32305)

"ProfileId" and "CurrencyCode" fields are not validated and taken into account during import of gift cards. "ProfileId" is filled, based on the profile of the defined store.  "CurrencyCode" is filled based on country code of the profile related to the store. If profile's country code related to the store is NULL or the country code is not supported, then currency code is determined by "DefaultGiftCardCulture" parameter.


Multi-country: Currency based on profile country (RTC-32307)

Gift Cards' currency is dependent on profile country code during issuing gift cards in the management and in the service as well. When issuing gift card using the service, then currency code set in the request is no longer considered. For issuing transactions, if profile related to the store has country code defined, then currency code is assigned on this basis. If profile's country code related to the store is NULL or the country code is not supported, then currency code is determined by "DefaultGiftCardCulture" parameter.


PIN Code Reminder for country code (RTC-24072)

Country code picker is available in "PIN code reminder" and "Change owner" modals. Supported countries: Norway, Sweden, Denmark, Finland, Austria, Germany, Poland

Store


Store picker (RTC-32908)

User is able to search for stores by inputting store number or store name.

System

Stability improvement (RTC-32076)

CreateLock saves priority equal to datetime ticks value during request. It boosts performance and assures that timeout on CreateLock will not occur.


Gift card balance (RTC-32355)

The data in Gift Card balance grids is grouped by store profiles.

Gift Card grids:

  • The store number column is merged with store name into a single column.
  • The Excel export modal and exported Excel file names are properly translated.


Release 27.06.2023

AreaDescription
Email messages

Fix for line breaks in emails (RTC-32066)

The personal messages with line breaks are properly displayed in emails.

Email templates

Improvements to gift card mails (RTC-31580)

When gift card is being sent by an e-mail, then in the received message, the amount field contains two decimals and date field shows only the date (without time).

System

Multi-country: Import of countries (RTC-32293)

Store groups' country codes are imported from Store Service to the GiftCard Service.


Technology framework (RTC-29202)

GiftCardService is migrated to .NET 6.


Release 26.05.2023

AreaDescription
Images

Fix for default image (RTC-32118)

'Default' image option has been removed from issue digital gift cards view.

System

Fix for pin code (RTC-32151)

Pin codes equal to null are allowed for Balance, Recharge and Redeem requests when the apps is verified.
In other cases requests are failed and 'Pin Code' must not be empty. message is logged.


Health check (RTC-27329)

By using a  health check endpoint in our Gift Card API you can check if GiftCard Management is available.


Release 17.05.2023

Issue single "digital" gift card

(RTC-26326)

A single "digital" gift card can be issued in Gift Card Management, and the gift card will then be sent to the receiver.

Send gift cards with personal message

(RTC-26334)

Gift Card API can be used for sending personal messages in e-mail and SMS distributions in issue requests.

Improvement

AreaDescription
New gift card

Issue of single/multiple "physical" gift card (RTC-29780)

Minor improvements to the "New Gift Card" view:

  • Default number of gift cards - single gift card is now set as default.
  • Empty space was removed in the gift card number field in single issue.
  • Text in success notification was improved.
  • When some validation error occurs, user is no longer moved to the gift cards' grid.


Released 10.02.2023

AreaDescription
Change Tracking

Export transaction changes (RTC-27668)

TransactionExport job was added to GiftCardServiceIntegration and it exports every new or modified transaction to the Service Bus and saves it into blob container named batchtoprocess to Giftcard.Transaction.Export event.

Required configuration

Enable "TransactionExport" job in GiftCardServiceIntegration package with default configuration.

GiftCardService

Cancel authorization (RTC-29490)

New function to manually cancel transaction with status "Authorizing" in the transaction view of a given gift card. 
Path: Financials / Gift Cards / Tab for transactions. 

When selected transaction that meets the correct condition for cancellation, the option "Cancel authorization" is visible under under '...' button. 

This new function requires GiftCards.ManuallyCancelAuthorization permission.


Release 27.01.2023

AreaDescription
API

Images API (RTC-13271)

Gift Card service has been extended with four requests:

  • images - return all images uploaded to service as a data set
/api/v2/GiftCard/images
  • imageId - returns image uploaded to service based on its ID
/api/v2/GiftCard/image/{imageId}
  • imageId preview - returns gift card preview to service based on given image ID
/api/v2/GiftCard/image/{imageId}/preview
  • profile reference - returns all images for specific profile uploaded to service as a data set
/api/v2/GiftCard/images/profile/{profileReference}

Implemented changes support also assigning image to the gift cards in issue requests. Moreover, gift card management and distributor e-mail support displaying images assigned to the gift cards.

GiftCardService

Transactions grid (RTC-27029)

New fields added to the transaction grid, "Issuing store name" and "Issuing store number". 


Export Gift Card transactions to Excel (RTC-28575)

"Export to Excel" functionality has been to Transactions view. The button is active only when filtering is applied in the grid.
The data is exported by FileExporter job (new job in GiftCardServiceIntegration package) to the "giftcard" blob container.

Each excel export is limited to 100 000 lines in file.


Release 02.11.2022

AreaDescription
GiftCardService

Gift Card Expirator performance (RTC-26305)

GiftCardExpirator has been refactored to expire giftcards in batches. The performance of the expiration has been greatly improved.

Job's configuration

Two new parameters are available in job's configuration:

  • Batch size - number of gift cards to be expired in one run of the procedure;
  • Execution maximum - number of gift cards to be expired in single job's execution.                                                                      
GiftCardService
Klarna Gateway

Creating redeem transaction with 0 amount (RTC-24608)

Redeem transaction with 0 amount were still being created for empty Gift Cards. After changes, redeem transactions with 0 amount are not created for all of the gift cards.


Release 19.09.2022 

AreaDescription

Klarna Gateway
GiftCardService



Extend transaction patch method (RTC-24201)

GiftCardService: patch transaction update request's response has been extended with gift card details.
KlarnaGateway: discount_confirm request's response has been extended with appropriate gift card data basing on patch transaction update request's response from GiftCardService.

GiftCardService

Errors logged twice in responses (RTC-24466)

Giftcard service was logging duplicated errors in responses for some cases in connection to validation of the path of parameters giftCardNumber, startingGiftCardNumber or giftCardsCount. Developer removed duplicate validation.

GiftCardService API

Multiple issue method route change (RTC-25286)

Updated url of requests and also request body. 

The url of the multiple issue request has been changed:

From:

/api/v2/GiftCard/{startingGiftCardNumber}/{giftCardCount}/transaction/issue

To:

/api/v2/GiftCard/transaction/issueMultiple

Also request's body has been changed - "startingGiftCardNumber" and "giftCardsCount" fields have been added, the rest of fields is stored in "giftCardDetails":

{
  "startingGiftCardNumber": "string",
  "giftCardsCount": 0,
  "giftCardDetails": {
    "validFromUtc": "2022-08-29T05:33:04.426Z",
    "validToUtc": "2022-08-29T05:33:04.426Z",
    "imageId": "string",
    "typeNumber": 0,
    "typeName": "string",
    "authorizeForMinutes": 0,
    "owner": {
      "phoneNumber": "string",
      "emailAddress": "string",
      "countryCode": "string",
      "pinCode": "string"
    },
    "amount": {
      "amount": 0,
      "currencyCode": "string"
    },
    "options": {
      "autogeneratePinCode": true,
      "authorizeAndCommitAtOnce": true,
      "preloaded": true,
      "forceWhenExpired": true
    },
    "origin": {
      "storeNumber": 0,
      "cashregisterNumber": "string",
      "cashierNumber": "string",
      "userId": "string",
      "receiptId": "string",
      "source": "string"
    },
    "distributionOptions": {
      "delayUntilUtc": "2022-08-29T05:33:04.426Z"
    }
  }
}

 

Gift Card Service
Import 

GiftCard Service/Import from SVS (RTC-25672)

ExpiresAtUtc and PinCode fields are not cleared while cancelling issue transactions of the preloaded giftcards.

GiftCardService

GiftcardService Performance (RTC-25709)

Added new indexes in database to improve grid performances. 


Release 14.07.2022

Support issuing multiple gift cards

(RTC-7642)

GiftCardService has been extended with three requests:

  • batch issue - creates new gift cards starting from number startingGiftCardNumber; the amount of created gift cards is equal to giftCardCount; for preloaded gift cards, it creates issue transactions in specified range.
Request
/api/v2/GiftCard/{startingGiftCardNumber}/{giftCardCount}/transaction/issue
  • batch commit - commit all transactions in given batch.
Request

/api/v2/GiftCard/transaction/issue/{batchTransactionId}/batchCommit

  • batch cancel - cancel all transactions from given batch.
Request
/api/v2/GiftCard/transaction/issue/{batchTransactionId}/batchCancel

The maximum amount of gift cards, that could be created in single request, is equal to 1000 - possible values of giftCardCount are from 2 to 1000.
startingGiftCardNumber cannot be overlapping with autogenerated gift cards prefix and.

If any gift card already exists in the specified range, then no gift cards will be created for given parameters startingGiftCardNumber and giftCardCount.

Improvement

AreaDescription
Gift Card Module

Finnish and Austrian Cultures (RTC-24131)

Finnish ("fi-FI") and Austrian ( "de-AT") cultures are supported in email distribution jobs and in GiftCardService.
Images in gift card management still support Norwegian, Swedish and English cultures only.


Release 23.06.2022

No currency validation when issuing a gift card

(RTC-20709)

New validation for currency code during issuing preloaded gift card with support for currency code in lower case.

This also affects saving import files into the database. 

Improvements

AreaDescription
Images

Edit validity period (RTC-21182)

Adding possibility to rename or edit validity period of temporary image from Gift Card management. 
User can upload temporary image and modify it's name and date and save changes without uploading new image. 


Image centering (RTC-19702)

Image on a gift card is centered and isn't out of the screen on a mobile device.
User don't have to scroll sideways in horizontal mode on a mobile view.


Image cleanup (RTC-18861)

Image cleanup job (name of job: ImageCleaner) for removal of unused images in Azure Storage and BD. Unused images or images deleted from the Management level are removed from the database and Azure. Storage after ImageCleaner job execution.

Gift Card Module

Handle euro currency on gift card image (RTC-23995)

The images for gift cards in euro currency are properly displaying "€" sign.
When an image has English culture, then the euro currency sign is displayed to the left of the gift card's amount.
When an image has Norwegian or Swedish culture, then the kroner currency sign is displayed to the right of the gift card's amount.


User roles (RTC-19465)

Providing compatibility of user roles view and description for GiftCardService in line with other cloud modules. Dividing them on category and sections. 

Selecting section causes ticking roles below it. Additionally, depending roles are ticked automatically. 


Release 31.05.2022

Email templates

(RTC-22947)

Email templates NewGiftCard, RegiveGiftCard and RemindPIN can be registered in MessageDistributionService in GiftcardManagement in general settings. The user needs to press 'Register templates in MDS' in this purpose.
By default one template of each type NewGiftCard, RegiveGiftCard and RemindPIN is created. Those cannot be assigned to any profile.
New templates can be specified for a specific profiles by pressing 'Add new template' button and setting up profile number.

Enable and disable distribution types

(RTC-21021)

It is possible to enable/disable distribution of 3 types (Recharge, Regive and Issue) when working with Gift Card Service. Applies only to service. No changes in distributions in management. By default values of parameters IssueDistributionEnabled, ReGiveDistributionEnabled, RechargeDistributionEnabled are set to false. To activate distribution the value of the parameters has to be changed to true.

New Email Distributor job for distributing emails with templates

(RTC-21020)

EmailTemplateDistributor has been added to the GiftCardServiceIntegration package. It is responsible for distributing emails with usage of templates and new image resolver.
To use this job, email templates needs to be set up and registered in MessageDistributionService, check related story Define base for the template used in MDS.

Start using new image resolver in gift card details view

(RTC-19375)

Giftcard images are resolved in the new flow. Profiles have dedicated images - ordinary (basic) image for profile or proper ones specified for time period only.

Improvements

AreaDescription
Transactions

Issue gift card (RTC-19374)

When issuing new gift card, the profileId is properly assigned to this gift card basing on the store number from the issue request.

GiftCardService

The performance of the cancel/update/commit requests has been improved (RTC-22229)

Index on TransactionId in [CloudScrip].[Transaction] table has been added.


Release 29.04.2022

Klarna Gateway

(RTC-20554)

Added support for the event type discount_delete. This request is responsible for deleting all the data regarding given order_id. The GiftCardService is called to cancel all linked redeemed transactions.
For more information see release notes of [Klarna integration]: discount_request.

GiftCardServiceJanitorJob

(RTC-20491)

A database fixing job, running once a day, has been added.

Transactions grid

(RTC-19297)

Grid with all transactions has been added. Separated permission is needed to access it. Grid contains data from all columns from Transactions DB table (except GiftCardId and table primary key).

Improvements

AreaDescription
Gift card imports

Validation on Import (RTC-22167)

Validation of files in importing has been changed to support all csv files, not only excel/csv files.

Transactions

ReGive action (RTC-22137)

When performing a ReGive action - distribution is created for the new owner.


Release 16.03.2022

Service has been extended for EG Klarna Gateway API

(RTC-20549)

AuthorizeForMinutes property has been added to issue/recharge/redeem methods - it allows to time bound a transaction.
Optional Source property has been added to TransactionOrigin model in all related requests.
An Update transaction method has been added - that allows to remove or extend time period from issue/recharge/redeem transactions.
Outdated transactions are cancelled by added cloud LIP job - AuthorizationCanceler.

Staging cleanup job

(RTC-20387)

Added job to cleanup staging tables rows older than configured value.

Improvements

AreaDescription
API

Fix on Owner and ValidDate in ReGive and ExtendValidity methods (RTC-21000)

When performing ReGive action on gift card proper owner values (OldOwnerClaim and NewOwnerClain) are saved in transaction details.

When using ExtendValidity method proper ValidDate values (OldValidUtc and NewValidUtc) are saved in transaction details.

Gift card imports

Default empty value for DefaultCurrencyCode (RTC-20890)

Import of gift card with no currency code in import file works fine also when DefaultCurrencyCode parameter has default value.


Release 18.02.2023

Default filter and columns persistence

Active gift cards are displayed by default in gift card list view. Columns persistence is added as well (application remebers what columns user want to see when opening grid next time).

Default environment currency

(RTC-20647)

Added parameter for default currency. It is used in the import when currency is not given in the file.

Improvements

AreaDescription

Balance details view

The data for the selected date (date period) is displayed properly in balance details view.

Image managementGift Card management user is able to sort images properly, when hiding expired ones (no blank spaces between not expired images).


Release 17.01.2022

Balance statistics calculator job

(RTC-18796)

BalanceStatisticsCalculator job calculates values for each store for the previous day and then inserts statistics into [CloudScrip].[DailyBalance] table. Those statistics are displayed in the gift card balance views.
During the job execution below statistics are calculated:

  • Balance(Outstanding balance) - Sum of balances of active and valid gift card;
  • ExpiredAmount - Sum of balance amount for active but expired gift cards which expired 'yesterday';
  • IssuedAmount - Sum of the amount of commited issue transactions which were issued 'yesterday';
  • RedeemedAmount - Sum of the amounts of commited redeem transactions which were redeemed 'yesterday';-
  • BalanceCorrections - Count of balance corrections transactions made 'yesterday';
  • RegiftedCount - Count of regive operations for current date made 'yesterday'.

Balance statistics view

(RTC-18797)

With this view, a user of Gift Card Management will have an overview of daily sum of gift card balances per store and total.

Detailed balance statistics view

(RTC-18798)

With this view, a user of Gift Card Management will have an overview of the following transactions per store for a selected period:

  • Issued amount
  • Paid amount
  • Expired amount
  • Balance corrections count
  • Number of regifted gift cards

Gift Card API

(RTC-19706)

Get GiftCard Image method in v2

API Method is added. With this method a user can receive gift card image in following the order:

  1. Image send in request parameter.
  2. Image linked to the gift card.
  3. Active periodic image from gift card's profile.
  4. Ordinary image from gift card's profile.
  5. Default image for tenant.
  6. Default hardcoded grey image.


Release 03.12.2021

Mass import of existing gift cards from other sources

(RTC-16987)

It is possible to perform a mass import of giftcards from other sources. The following is enabled:

  • Import of gift cards from csv file.
  • Mass import of gift cards is possible from Gift card imports view in management module.
  • User can upload a file which will be processed and gift cards  will be added or updated in database.
  • If gift card is active or has NotPreloaded type, issue confirmed transaction is created with data given in the file.
  • Dedicated user role is needed to reach Gift card imports view.
  • Support of preloaded gift cards in import

Released 02.12.2021

Area Description
Gift Card management

Fixes related to managing of Gift cards in Chain Web

  • Monetary values in grids are now aligned to the right in the column and displayed with two decimals.
  • Transaction status "Not applicable" is not displayed in the status column.
  • In the "Remind Pin Model" the label is changed to only include "Mobile". Changes have been applied to all languages.
Grid View
  • Selection of columns in grid is saved and remembered.
  • In gift card's transactions view, columns chosen by the user are displayed, when opening view again previous setting are saved and remembered.

Schedule delivery of digital gift cards

(RTC-16991)

Gift Card Service

Schedule delivery of digital gift cards.

User is able to schedule delivery of gift cards to any future date when issuing or regiving.

Support preloaded gift cards in issue method

(RTC-17703)

  • It is possible to issue a gift card which has not "issue committed transaction and PreloadedType is Preloaded or PreloadedWithValue.
  • If "Preloaded", all values sent in request are saved in DB.
  • On "PreloadedWithValue" it is possible to perform issue only when amount in request equals amount in the DB.
  • Issuing that giftcard does not change the PreloadedType.




  • No labels