Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Coming next release

Register and new field for offer

(RTC-41683)

There is 'Offer type' register included in 'Promotion registers' tab. Offer type is described by code, name, description and can be added, edited or deactivated. The first two fields are required. Code must be unique.

Offer type is visible in the offer details and offer tile. 

There are new columns in 'Show offers in a grid' and 'Promotion offers' views: 'Offer type code' and 'Offer type name'.

Export of offers is extended with offer type. Editing name of the offer type is not triggering export of offers that are using this offer types.

Image Added
Offer type register

Image Added
Add offer type

Image Added
Offer type in the offer details view

Improvement

AreaDescription



...

Release 20.08.2024 

AreaDescription
Offer items

Fix: promotion price can be set to 0 (RTC-41237)

Promotion price of offer item can be set to 0. When one of items has price set to 0, offer items grid is loaded properly. It is possible to export such offer item to excel file.

Offline item lists

Changing the item list in the Promotion module when there is no connection to the Item Service (RTC-41204)

If the user want to edit item list through user interface but there is no connection with Item Service, the user receives a message in the red bar. The item list does not change in the promotion offer in order not to lose information about previously added items but there is an information that the selection contains 0 items/variants/models. The display will change if the selection has changed but the items do not change, e.g. the items will be displayed as models. In this case, the columns in the grid will change

If the user wants to edit the item list via an Excel file while the Item Service is not working, the result is as follows: The notification 'Items in offer could not be synced with Item Service' top right corner and message 'Manage item list is not available until offer items are synced. You will be notified once the items are synced.' at the top of the grid are visible. 'Edit item list' button is not available. Imports from 3rd parties work very similarly. The only difference is the lack of notification.

Only offer groups with processed and synced items can be copied.

It's possible to import Excel if model number is not specified but there is external model number in the file.

OfferGroupProcessor job is triggered by default every 5 minutes.

Promotion API

Put request for adding items to the offer (RTC-41208)

PUT request /promotions/[EgPromotionIdentifier]/offers/[EgOfferIdentifier]/items in Promotion Service is supported.
Request body must be as documented in Swagger. For more information and rules regarding API, please refer to description and endpoint schema in 'Promotion Service Gateway API' part of Swagger, as well as 'File-import documentation' (all the business rules of import apply to API).
Items can be imported to offers with mix type supported in 'PUT Offer' request. Maximum 500 items can be sent. Each request with items to offer group result in removing items which were in offer previously. Items and prices lookup is done only in Promotion database. Logic of all lookups is as in OfferGroupProcessor job (it means this work the same as imports and user interface actions). Items are added to offer as 'offline item list' and data is exported to POS. Then, during next scheduled OfferGroupProcessor job run (default 5 minutes cron), such new item list is synced to item service, and previous one is deleted. Offer group items cannot be updated in user interface until item list in item service is synced.
Errors regarding promotion, offer, item, price lookup and contract schema are returned as a part of request response. It also contains upsert status, count of items without price and count of not found items.

System

Fix: duplicates of ExternalModelNo (RTC-42961)

Import of items from Item Service saves item on model level with empty ExternalModelNo if received value is already used by other model in Promotion database. Additionally, release of RTC-41204 does not fail when there are ExternalModelNo duplicates in database (suffix is added to duplicate).

...

It's possible to filter offers in promotion details based on their status: Active, Inactive or Incomplete. There is a picker for that in the offer panel.

Improvement

AreaDescription
System

Performance when adding items to the offer group (RTC-37691)

Added database index to improve performance when adding items to offer group. Size of batch that is saved to the database is set to 2000 by default and can be changed using parameter in configuration of ItemSelectionItemImport job.

...


Offer ID column in Promotion offers

Improvement

AreaDescription
Offer items

Performance of adding items to offer group (RTC-32248)

Improved performance of adding items to offer group. Improved performance of fetching data for 'Items in promotions' page.

...

When promotion is on team level assigned to profile, and item has price in profile, profile price is used.

Improvement

ModuleDescription
Offers

Error handling in segmentation night update (RTC-30740)

When segmentation in offer group is updated, and segmentation has unexpected status, offer group is not updated and offer group items are not deleted in Promotion and not exported with deleted status to POS. Integration job log contains details of error and CompletedWithWarnings status.

...

Parameters of this mix are exported with offer to POS.

Improvement

ModuleDescription
Promotion API

API documentation (RTC-27105)

Business rules section of import documentation contains explanation of "offerItemType enum", "Promotion type" and "Offer code".

...

  • If 'useVoyado' is set to False, everything work as before.
  • If 'useVoyado' is set to True, user is able to create a promotion in Voyado through Promotion module. After creating a coupon offer, promotion in Voyado system is created. Id of promotion in Voyado is saved in the new column named 'VoyadoPromotionId' in the 'Offer' table in the database. Name and dates of promotion in Voyado match name and dates of offer in Promotion module.
    After adding a new offer in user interface, green message about creating promotion in Voyado is displayed at the bottom of the screen. It contains Voyado's promotion's id and name.
    Promotion details in Voyado such as dates and name can be updated by editing offer's name or promotion's date in Promotion module.
    There is no possibility to delete a coupon from the offer.
    When user tries to delete a coupon offer which exists also in Voyado, modal window with information that this promotion won't be deleted in Voyado is shown.
    Copying offers and promotions doesn't include copying Voyado's promotion. Promotion import through API does not send offer to the Voyado system.
    For offers without coupons, flow is the same as before.
    If a request for Voyado fails, orange error message is displayed at the bottom of the screen.

Improvement

ModuleDescription
Export

Identifier of offer group item (RTC-23558)

Export of offer items to POS contains "offerItemNo" field, which is globally unique identifier (GUID) of offer group item.

Offer

Switch between offer groups (RTC-23740)

Items/models/variants/item groups in offer view are displayed properly when switching offer group using buttons in top right corner.

...

'Available days' and 'Excluded dates' can be set for promotion. When one of these parameters is selected, promotion is marked as recurring. 'Available days' are days in a week when offer is available and 'Excluded dates' are dates when promotion is not available for the customer. This does not affect active status of promotion. Recurrence information is displayed in promotion details view. Excluded days are displayed in chronological order. Recurrence can be set when creating new promotion, editing existing one or creating a copy. Values are exported to POS when promotion is active.

Improvement

Module

Description

Offer

Adding items to the offer (RTC-18145)

Performance of adding items to the offer has been improved. Loading items takes a few seconds. After user gets notification, the page is refreshed.

Promotion

Date columns filter (RTC-17338)

For promotions which start or end between 23:00 and 24:00, filtering on columns 'Valid to' and 'Valid from' is working correctly. These columns are located in Promotions, Promotion offers, Items in promotions views and Copy offer modals in Promotion and Promotion offers views.


Offer view (RTC-17479)

When applying filter to the grid in offer view, grid does not automatically scroll to the left. If price panel was closed when applying filters, it stays closed after filtering as well.

...

Copy promotion dialog. Select target promotion from the list, or search promotion 

Improvement

Module

Description

Offers

Item selection for an offer (RTC-17791)

Keyboard can be used to navigate in offer view after adding items to new item selection or updating existing one.

...