Release 14.10.2024

Improvements

...

Area	Description

Import

General

Unsaved changes warning

ProfileId filled when store number is present in imported file

(RTC-

32581

41899)

"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 giftcard'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.

...

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

...

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.

Image Added

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

Image Added

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

...

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 Added

 Image Added

Improvements

...

Release 15.12.2023

...

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

...

Release 21.08.2023

...

Release 27.06.2023

...

Release 26.05.2023

...

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

...

Released 10

...

.02.2023

...

Location

Area

Comment

Description
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. Info title Required configuration

:

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

Gift Card Service

GiftCardService

Cancel authorization (RTC-29490) New function to manually cancel transaction with status "Authorizing" in the transaction view of a given

giftcard

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.  Info This new function requires GiftCards.ManuallyCancelAuthorization permission.

...

Release 27

...

.01.2023

...

Location

Area

Comment

Description

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.

Gift Card Service

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

...

Location

Area

Comment

Description

Gift Card Service

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. Expand title Technical 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.Gift Card Service

- 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

giftcards

gift cards.

19 Sep 2022 

...

Release 19.09.2022 

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

/api/v2/GiftCard/transaction/issueMultiple

{
  "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"
    }
  }
}

...

Release 14

...

.07.2022

...

Support issuing multiple gift cards

(RTC-7642)

Giftcard service GiftCardService has been extended with three requests:

• batch issue - creates new giftcards gift cards starting from number startingGiftCardNumber; the amount of created giftcards gift cards is equal to giftCardCount; for preloaded giftcardsgift cards, 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 giftcardsgift 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 giftcards gift cards prefix and.

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

Improvement

...

Release 23

...

.06.2022

...

No currency validation when issuing a gift card

(RTC-20709)

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

This also affects saving import files into the database. 

Improvements

...

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

...

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 giftcard service 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

...

Release 16

...

.03.2022

...

Service has been extended for EG Klarna Gateway API

(RTC-20549)

AuthorizeForMinutes propery AuthorizeForMinutes property has been added to issue/recharge/redeem methods - it allows to time bound a transaction.
Optional Source property 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

...

...

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

...

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 giftcard 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 Image send in request parameter.
2. image Image linked to the gift card.
3. active Active periodic image from giftcardgift card's profile.ordinary
4. Ordinary image from giftcardgift card's profile.
5. default Default image for tenant.
6. default 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 giftcards gift cards in import
  
  

...

Released 02

...

.12.2021

...

...

Area

Location

Description

Comment

Gift Card

Mgmt.

management

Fixes related to managing of

Giftcards

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

giftcard

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

...

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 giftcard gift card which has not "issue commited transaction and PreloadedType is Preloaded or PreloadedWithValuecommitted 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.

...