Configuration: Pass Media Selection (Reload)
- Jenni Buonanni
- Leigh Bush
- Danny Koressel
Setup Checklist
1. POS Tasks |
|
|---|---|
RTP tasks
| Prerequisite |
Siriusware tasks
| Prerequisite |
2. Pick Up Box Tasks (Please use Pick Up Box Guide) |
|
If resort uses RTP:
| Prerequisite |
If resort uses Siriusware:
| Prerequisite |
If resort uses Siriusware AND if PUBs are configured to print from ‘Aspenware Commerce order id’.
| Prerequisite |
If resort uses Siriusware AND if PUBs are configured to print from ‘ww_saleid’.
| Prerequisite |
3. Aspenware Commerce Tasks |
|
Configure simple media product(s) - Required | Prerequisite |
Configure core and add-on access product(s) (i.e. lift ticket, passes, etc.) that will be later setup as requiring media selection (reload) - Required | Prerequisite |
Update all the following settings to your desired rules - Required
| Prerequisite |
RTP task: Configure media filtering in Pass Media plugin. | Prerequisite |
Update language strings if the default value is not desired. - optional | Prerequisite |
Assign ‘Media Priorities’ to Media products - Required | Detailed Setup |
Create ‘Media Assignments’ for Access products - Required | Detailed Setup |
Prerequisite Tasks
1. POS Tasks
RTP|ONE specific tasks include:
Configure lift and pass product headers and confirm they have properly configured required access components.
If configuring a product to allow media selection, when creating that product in RTP, the media component should not be a required component but an optional component on the lift/pass product.
Create separate product header(s) for media. Media product header(s) must have a required media component.
Create distinct media product headers if some media is 2 step printing, likely RFID pass media, and other media is 1 step printing, likely ticket media.
If a product header must include media and the guest should not have the option to reload when purchasing this specific product header, set up the product header with a required media component in addition to the access component(s). This may be desired for some products only - like season passes that may include media components. If using reload and media selection via Aspenware Commerce, this configuration should be rare.
Ensure Media is set up with RTP Pass Media Prefix. This becomes helpful when resorts want to only allow reload for certain products in RTP. Aspenware does not currently support the ability to assign a prefix by product within Aspenware Commerce, however, we do support having multiple prefixes to choose from for multiple products. Prefixes on Aspenware products may not restrict reloading to one Aspenware product over another - it's either reloadable or not.
Siriusware specific tasks include:
Configure lift and pass products (DCIs) in Siriusware and confirm they have a properly configured access setup.
Create a separate general DCI for media which will be added to the online order to account for the cost of new media. The issuance of media will be based on whether a WTP number is included in the online sale and is generated from the main SW DCI. If the WTP number is included, a reload is trigged. If the WTP is not included, SW will issue new media.
2. Pick Up Box Tasks (Only if resort uses PUBs)
Sirisuware specific tasks are detailed in the Pick Up Box Configuration guide:
Create the following product classifications if they aren’t already added:
Is Axess PUB
Is Axess PUB With New Media
For core product(s) configured with media, assign ‘Is Axess PUB with New Media’ product classification
For media product(s) and core product(s) not configured with reload, assign ‘Is Axess PUB’ product classification
Specific tasks if resort uses Siriusware AND if PUBs are configured to print from ‘Aspenware Commerce order id’ are detailed in the Pick Up Box Configuration guide:
Add QR code or Barcode HTML to OrderPlaced.CustomerNotification message template
Specific tasks if resort uses Siriusware AND if PUBs are configured to print from ‘ww_saleid’ are detailed in the Pick Up Box Configuration guide:
Create the ‘Send Complete Notification’ if it isn’t already added
Assign ‘Send Complete Notification’ product classification to core product(s)
Setup and/or edit ‘OrderCompleted.CustomerNotification' message template to include QR code with ww_saleid.
RTP|ONE specific tasks are detailed in the Pick Up Box Configuration guide:
Requires Axess ‘Smartlink’ contract and configuration before Commerce configuration can start.
Add a QR code to your order confirmation email template
CLOUD CUSTOMERS: For configuring your email template in version 3.2 or later, please see the Updating Email Template instructions for configuring your email templates.
3. Commerce Tasks
Create a Simple Product in Aspenware Commerce with no product attributes for media. It should be priced at whatever the media fee is (typically $5) and titled whatever your media card name is, for example, J Card, SugarXpress Card, MyThredbo Card, etc.
The SKU (PHC) should be the media product header/DCI that should be sold in the POS when access products are purchased as non-reload.
If the product is taxed in RTP, define a corresponding tax category on the media product in Aspenware Commerce.
If media used for pass sales is a different product in the POS or sold at a different price from ticket media, create 2 unique media products and assign a SKU and price.
Configure your core and add-on access product (lift ticket, passes, etc.)that will be later setup as requiring media selection (reload). Start the product configuration process using the configuration guide here.
Must have required assignment configured.
3. Settings, Language Strings, and/or HTML Widgets for this Feature
Settings
The following AW Commerce Settings must first be completed
Setting | Value | RTP Notes | Siriusware Notes |
customersettings.showmedianumber | True or False | In order to show media number associated to the household member, set the setting ‘customersettings.showmedianumber’ to 'True.' | In order to show media number associated to the household member,, set the setting ‘customersettings.showmedianumber’ to 'True.' |
customersettings.displayrfid | True or False | If RFID number is the primary number printed on the card, rather than pass media number, the setting ‘customersettings.displayed’ should be set to ‘True.’ If pass media is the primary printed number, set to ‘False.’ | The setting ‘customersettings.displayrfid’ should be set to ‘True.’ |
mediaisvalidtype | PassMediaCode | Define whether reload eligibility on the PDP is based on the presence of a pass media profile or RFID profile using the setting ‘mediaisvalidtype’ and set the value to ‘PassMediaCode' or 'RFID’. | The setting ‘mediaisvalidtype’ should be set to 'PassMediaCode'. |
checkout.media.showallmediacards | True or False | If a guest can have multiple cards associated to their account that are either active, or can be automatically activated at the gate, there is a setting that allows the guest to see all of the card numbers associated to their account. 1. Set this to 'True' to allow guests to see multiple media cards that are associated to their account. If a guest has multiple cards associated to their profile, it will display like this.   2. Set this to ‘False’ to only allow guests to see a single active card if they have media associated to their account. If a guest has media, the single active card will display like this:
| The setting 'checkout.media.showallmediacards' should be set to ‘False.’ If a guest has media, the single active card will display like this:
|
customersettings.canaddmedia | True or False | The setting ‘customersettings.membercanaddmedia’ should be set to 'True' if temporary customer media should be able to be added and linked to guest profiles for reload in checkout. | The setting ‘customersettings.membercanaddmedia’ should be set to ‘True’ if anonymous media should be able to be added and linked to guest profiles for reload in checkout. |
customersettings.membercanaddmedia | True or False | The setting ‘customersettings.membercanaddmedia’ should be set to 'True' if temporary customer media should be able to be added and linked to guest profiles for reload in checkout. | The setting ‘customersettings.membercanaddmedia’ should be set to ‘True’ if anonymous media should be able to be added and linked to guest profiles for reload in checkout. |
customersettings.medianumberinputmask |
| In the setting ‘customersettings.medianumberinputmask’ use the # symbol to indicate the number of characters in your PassMediaCode. You can also use other characters to create separation in long numbers or to match what is printed on cards. For example:
| In the setting ‘customersettings.medianumberinputmask’ use the# symbol to indicate the number of characters in your PassMediaCode. You can also use other characters to create separation in long numbers or to match what is printed on cards. For example:
|
For RTP, configure media filtering: If only certain pass media prefixes or type codes should be eligible for reloading, define these prefixes from the Aspenware Commerce Plugins>Pass Media page. Skip this if you do not limit reload for certain pass media prefixes or type codes.
Add each pass media prefix value that is a valid lift access prefix as its own entry. When pulling back media for display and when determining reload eligibility, only pass media with a prefix that matches prefixes configured in this plugin will be returned and considered.
Add each pass media type code that is a valid lift access prefix as its own entry. When pulling back media for display and when determining reload eligibility, only pass media with a pass media type code that matches codes configured in this plugin will be returned and considered.
IMPORTANT: You will either want to set up pass media prefix or Pass Media Type code filters, but not both.
Language Strings
There is specific error messaging that displays when an error occurs attempting to associate media to a customer. The customer-facing messaging is configured with language strings.
String resource | Default Value | Description |
AssignMedia.ResponseMessage.Error.MediaAlreadyExistsOnAccount | This card is already associated to this account. | Displays when media code that is entered is already associated with the customer. |
AssignMedia.ResponseMessage.Error.MediaIsAlreadyAssignedToAnotherUser | This card is assigned to another customer. This card may be attached to another account under your name. If you wish to use this card and continue using this account, call us at {NUMBER}. If you wish to proceed using another account, please log out and create another account through the find me by pass number {link} to proceed attaching a product to this card, otherwise add a new card. | Displays when media code that is entered is associated with another known customer. |
AssignMedia.ResponseMessage.Error.MediaHasInvalidCode | Invalid code. | Displays when media code that is entered is invalid. |
AssignMedia.ResponseMessage.Error.UnableToAddMediaToUser | There was an issue linking this card to the customer. Please contact customer service if you wish to proceed linking this customer card. | Displays when failure during the merge of the temp customer into the customer |
There is specific copy that displays on the ‘Media’ step of checkout. The customer-facing messaging is configured with language strings.
String resource | Default Value | Description |
account.login.checkout.media.steptitle | Pass Media | Name for the media linking step in the breadcrumb list for checkout |
account.login.checkout.media.title | Pass Media | Title for the media linking step in checkout |
account.login.checkout.media.text | "Your order contains products that require a {Peak Pass” ...." | Description for the media linking step in checkout. Include info that is specific to how media works at your resort |
account.login.checkout.media.name | {Peak Pass} | Name of your distinct media card (i.e. JCard, ONE PASS, SugarXpress Card) |
account.login.checkout.media.reloadprice | FREE | Display to show that the reload option is free (i.e. FREE or $0) |
account.login.checkout.media.addcardhelpertitle | One card is all it takes | Title to give more information on reload and adding new media to a guest in checkout |
account.login.checkout.media.addcardhelpertext | You can use any of these cards for all your products at {RESORT NAME}. | Title to give more information on reload and adding new media to a guest in checkout |
account.addmedia.numberlabel | Media Number | When adding a new temporary card to a guest, the label above the field to enter the RFID number. |
account.addmedia.addnumberbutton | Add Card | When adding a new temporary card to a guest, the label for the CTA button to add the card after RFID has been entered. |
ccount.login.checkout.media.emptytext | Media not printed | What to show for cards if they haven’t been printed |
{Peak Pass} | Card label on contact cards | |
account.login.checkout.media.subhead.addmedia | Media Card(s) will be added to your order | Subheading beneath “Add New Media” |
account.login.checkout.media.subhead.reload | Reload existing Media Card(s) | Subheading beneath Reload existing Media Card(s) |
Detailed Setup Guide
Assign Media Priority to Media Products
Assign Media Selection to Access Products
1. Assign Media Priority to Media Products
Go to Aspenware Commerce > Pass Media and select View Media Priorities.
Choose the Product from the drop-down that is set up to book a separate media product (configured in prerequisite tasks above).
Assign the product a Priority, 1 being the highest priority. The priority will be used to determine which pass media product will be added for a customer who is checking out with multiple products that require different types of pass media
If this is the only media product, assign a priority of 1.
If there are multiple media products, assign the media product with the highest priority, typically season pass media (2 step printing media), to a 1, and then lesser priority media, typically daily lift ticket media (1 step printing media), to a 2, or higher.
IMPORTANT: Do not set the priority to 0. It will not function properly unless the priority number is greater than or equal to 1.
2. Assign Media Selection to Access Products
From the Pass Media page select View Media Assignments to configure media assignments.
Choose a Product from the drop-down that requires media selection. The dropdown is in alphabetical order.
(Optional) Check any attribute values if the associated access product is specific to certain attribute selections.
For RTP|ONE only: Check Includes Media only if the RFID media component should be a required component of the core product header and is not booked as a separate product header. If Includes Media is checked, skip all other fields and Add the media assignment.
For Siriusware only: enter the Siriusware Department code to restrict only media from this department to be reloaded for this product.
For Siriusware only: enter the Valid Seasons Count to restrict only media from this season count to be reloaded for this product.
If Includes Media is not checked, and in most cases, from the Media Product dropdown, choose the associated pass media product.
Select Add.