Coming next release
Area | Description |
---|---|
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
Area | Description |
---|---|
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. 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
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
Gift Card API can be used for sending personal messages in e-mail and SMS distributions in issue requests.
Improvement
Area | Description |
---|---|
New gift card | Issue of single/multiple "physical" gift card (RTC-29780) Minor improvements to the "New Gift Card" view:
|
Location | Comment |
---|---|
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. |
Gift Card Service | Cancel authorization (RTC-29490) New function to manually cancel transaction with status "Authorizing" in the transaction view of a given giftcard. 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. |
Location | Comment |
---|---|
API | Images API (RTC-13271) Gift Card service has been extended with four requests:
/api/v2/GiftCard/images
/api/v2/GiftCard/image/{imageId}
/api/v2/GiftCard/image/{imageId}/preview
/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. |
Gift Card Service | 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. Each excel export is limited to 100 000 lines in file. |
Location | Comment |
---|---|
Gift Card Service | Gift Card Expirator performance (RTC-26305) GiftCardExpirator has been refactored to expire giftcards in batches. The performance of the expiration has been greatly improved. |
Gift Card Service 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 giftcards. |
Location | Comment |
---|---|
Klarna Gateway Gift Card Service | Extend transaction patch method (RTC-24201) GiftCardService: patch transaction update request's response has been extended with giftcard details. |
Gift Card Service | 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. |
Gift Card Service API | |
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. |
Gift Card Service | GiftcardService Performance (RTC-25709) Added new indexes in database to improve grid performances. |
Support issuing multiple gift cards
(RTC-7642)
Giftcard service has been extended with three requests:
batch issue - creates new giftcards starting from number startingGiftCardNumber; the amount of created giftcards is equal to giftCardCount; for preloaded giftcards, it creates issue transactions in specified range.
batch commit - commit all transactions in given batch.
batch cancel - cancel all transactions from given batch.
The maximum amount of giftcards, 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 giftcards prefix and.
If any giftcard already exists in the specified range, then no giftcards will be created for given parameters startingGiftCardNumber and giftCardCount
Location | Comment |
---|---|
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 giftcard service. |
No currency validation when issuing a gift card
New validation for currency code during issuing preoloaded gift card with support for currency code in lower case.
This also affects saving import files into the database.
Improvements
Location | Comment |
---|---|
Images | Edit validity period (RTC-21182) Image centering (RTC-19702) Image cleanup (RTC-18861) |
Gift Card Module | Handle euro currency on gift card image (RTC-23995) User roles (RTC-19465) Selecting section causes ticking roles below it. Additionally, depending roles are ticked automatically. |
Email templates
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
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
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
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
Location | Comment |
---|---|
Transactions | Issue gift card (RTC-19374) When issuing new giftcard, the profileId is properly assigned to this giftcard 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. |
Klarna Gateway
Added support for the event type discount_delete. This request is responsible for deleting all the data regarding given order_id. The giftcard service is called to cancel all linked redeemed transactions.
For more information see release notes of [Klarna integration]: discount_request.
GiftCardServiceJanitorJob
A database fixing job, running once a day, has been added.
Transactions grid
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
Location | Comment |
---|---|
Gift card imports | Validation on Import (RTC-22167) |
Transactions | ReGive action (RTC-22137) |
Service has been extended for EG Klarna Gateway API
AuthorizeForMinutes propery 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
Location | Comment |
---|---|
API | Fix on Owner and ValidDate in ReGive and ExtendValidity methods (RTC-21000) |
Gift card imports | Default empty value for DefaultCurrencyCode (RTC-20890) |
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
Added parameter for default currency. It is used in the import when currency is not given in the file.
Improvements
Location | Comment |
---|---|
Balance details view | The data for the selected date (date period) is displayed properly in balance details view. |
Image mgmt. | GiftCard management user is able to sort images properly, when hiding expired ones (no blank spaces between not expired images) |
Balance statistics calculator job
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 giftcard 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
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
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
Get GiftCard Image method in v2
API Method is added. With this method a user can receive gift card image in following the order:
- image send in request parameter
- image linked to the gift card
- active periodic image from giftcard's profile
- ordinary image from giftcard's profile
- default image for tenant
- default hardcoded grey image
Mass import of existing gift cards from other sources
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 giftcards in import
Improvements
Location | Comment |
---|---|
Gift Card Mgmt. | Fixes related to managing of Giftcards in Chain Web
|
Grid View |
|
Schedule delivery of digital gift cards
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 giftcards in issue method
- It is possible to issue a giftcard which has not "issue commited 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.