Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Setup Checklist

Insert excerpt
AE:Set-up ChecklistAE:
Set-up Checklist
nopaneltrue

1. POS TASKS

Create

RTP

Authorization type for 1 risk

|One Tasks

  • The Authorization Type needs to be set up in RTP|One and you need to copy down the code. This authorization will be created in RTP|One when guest signs the 1Risk waiver.

    Status
    colourRed
    titleRequired

  • The Authorization Type needs to be assigned to the product component.

    Status
    colourRed
    titleREQUIRED

  • If lift access needs to be blocked before a waiver is signed, ask your Aspenware Representative about getting Aspenware’s Auto-Hotlist product installed in your environment.

    Status
    colourBlue
    titleOptional

Status
colourYellow
titlePrerequisite

Create Siriusware liability?

Siriusware Tasks

  • The Liability Form needs to be setup in Siriusware and you need to copy down the ‘Form ID.’

    Status
    colourRed
    titleRequired

  • The Liability Form needs to be linked to the Siriusware item.

Status
colourYellow
titlePrerequisite

2.

INFRASTRUCTURE

1Risk TASKS

Configure waiver(s) in 1Risk -

Status
colourRed
titleRequired

  • For each waiver, copy down 1RiskID (provided by 1Risk). Contact 1Risk’s Charles Mickley (cmickley@1risk.com)

    Status
    colourRed
    titleRequired

  • If using optional email link waiver signing configuration, also get the waiverFormid (provided by 1Risk)

    Status
    colourBlue
    titleOptional

Info

NOTE: 1Risk requires a fee and additional time to implement this Aspenware integration.

Status
colourYellow
titlePrerequisite

Copy down your unique 1Risk URL (provided by 1Risk’s Charles Mickley (cmickley@1risk.com)

Status
colourRed
titleRequired

Status
colourYellow
titlePrerequisite

3. COMMERCE TASKS

Commerce Task 3

Define Settings -

Status
colourRed
titleRequired

Expand
titleExample of Commerce Task
Confirm that the Aspenware Commerce products that will have inventory assigned to them are fully configured with the correct attributes -

  • waiversettings.1riskpos set to RTP|One or Siriusware

  • waiversettings.1riskurl set to the 1Risk URL (provided by 1Risk)

  • waiversettings.1risksecret set to a “secret” (any value you decide)

  • waiversettings.1riskdateformat set to ‘mm/dd/yyyy’ or 'dd/mm/yyyy’

Status
colourYellow
titlePrerequisite

Install the Waivers plugin

Status
colourRed
titleRequired

Status
colourYellow
titlePrerequisite

Language String, Setting, HTML widget, etc. Task 4 -

Products need to be created in Aspenware Commerce.

Status
colour

Blue

Red
title

optionalexpand

REQUIRED

Status
colourYellow
title

Example of Setting Task​Ensure the setting ‘ecommercesettings.productinventory.cachetime’ is set to your desired cache time -

PREREQUISITE

1. Review Considerations Prior to Configuration (See Below)

Status
colour

Blue

Red
title

optional

REQUIRED

Status
colourYellow
title

PrerequisiteConfiguration Task 5

PREREQUISITE

2. Configure New 1Risk Waiver in Aspenware Commerce -

Status
colourRed
titleRequired

Status
colour

expand

Green
title

Example of Configuration TaskInventory is mapped to product or product variant in the Inventory Pool plugin

Detailed Setup

3. Assign Waivers to Products

Status
colourRed
title

RequiredCode is entered

REQUIRED

  • Select the waiver(s) that should be applied to each product.

Status
colour

Red

Green
title

RequiredIf using location in RTP, location code is entered

DETAILED SETUP

4. Configure 1Risk Waiver to be optionally completed from a CTA on order confirmation email.

Status
colour

Red

Blue
title

RequiredIf multi day product, number of days is defined

optional

  • Configure language strings for this configuration.

  • Make sure your order confirmation has the token %Order.Waivers% added to it.

Status
colour

Red

Green
title

RequiredIf using non default lock time of 900 seconds, the desired lock time is configured

DETAILED SETUP

5. Enable the 1Risk Email Feature.

Status
colourBlue
titleoptional

  • Configure waiversettings.1riskemailapiendpoint and waiversettings.1riskemailapisecret in Configuration > Settings >All settings (advanced)

  • Configure Send waiver emails and Minor Age in Aspenware Commerce > Waivers.

  • Customize feature-specific language strings in Configuration > Languages (see table below in #5 for string names).

Status
colourGreen
title

Detailed Setup

detailed setup

Prerequisite Tasks

Insert excerpt
AE:Prerequisites Tasks ExcerptAE:
Prerequisites Tasks Excerpt
nopaneltrue

POS Tasks

  • POS Task that must be completed first

Infrastructure Tasks

  • Infrastructure Task that must be completed first. Remove section if not required

Commerce Tasks

  • AW Commerce task that must be completed first

Settings, Language Strings and/or HTML Widgets for this Feature

...

Settings

  • AW Commerce Settings that must first be completed

Language Strings

  • AW Commerce Language Strings that must first be completed

HTML Widgets

  • AW Commerce HTML Widgets that must first be completed

Detailed Setup Guide

  1. Step 1 Header

  2. Step 2 Header

1. Step 1 Header

  • First bullet should provide navigation instructions i.e. Catalog >Attributes >Product attributes

    1. Sub-bullet for step 1. Every step and click should be detailed so that someone could follow with little prior experience.

      1. Sub-bullet for step a. Include screenshots of the step and use skitch to mark up screenshots. It can be downloaded here: https://www.techspot.com/downloads/5705-skitch.html

Expand
titleExample of content within a section
  • From the Aspenware Commerce Plugins>Age Range page in Admin, click View Add Range Types in the upper right corner.

  • Click Add Age Range Type.

  • Enter a name and description for the age range type.

  • To set the date used to compare the customer’s age to the required age range, select:

    1. Calculate from Trip Start (this age range type is likely already configured), or 

    2. Calculate from Today’s Date (age range based on purchase date), or

    3. Specify the Calculation Start Date; the customer’s age on this date will be used to determine if they are eligible for the product based on the age ranges

  • Click Add.

  • Age Range Types can be edited and inactivated, but they cannot be hard deleted without contacting Aspenware. 

  • Age Range types that are set to Calculate from Trip Start or Today’s Date will never need to be edited, unless you would like to edit the name. Age Range Types that are calculated from a fixed date however, will need to be edited each year to adjust for the current year.

Image Removed

 

Hint: Age Range Types should also be adjusted year over year. If age ranges are calculated based on Trip Start, then they will not need to be updated.

Once completed for all required age range types move on to create Age Range.

Info

Note: When possible use notes, warnings, and hints within info panel macros. See https://aspenware.atlassian.net/wiki/pages/resumedraft.action?draftId=781156460 for more details on these.

2. Step 2 Header

  • First bullet should provide navigation instructions i.e. Catalog >Attributes >Product attributes

    1. Sub-bullet for step 1

      1. Sub-bullet for step a

...

DELETE CONTENT AFTER THIS LINE

go to the Glossary page and add the key terms Excerpt Include that you added for your configuration guide.

To add the feature terms to the Glossary, navigate to the glossary and add a header for your feature using an H2. Select the + and then select …view more. Search for Excerpt Include and in the Page Containing the Excerpt search for “Configuration: [FEATURE]” select to hide panel, preview and add.

How-to Guide of this page can be found here: [Internal] Configuration page Setup Guide

...

1. POS Tasks

  • RTP|One Tasks

    • The Authorization Type needs to be set up in RTP|One and you need to copy down the code. It should be set to active, ‘Display Online’ needs to be checked, a comment should be defined, the ‘Age Range’ should be set as ‘18-no maximum age’, the authorization text HTML should be configured, and the override security level should be set to 0.

    • The Authorization Type needs to be assigned to the product component.

    • When a waiver is signed in 1Risk using the Aspenware Commerce Checkout flow configuration, it also creates an Authorization Profile in the guest’s Customer Manager Profile for the guest within RTP|One.

      Image Added
    • When a waiver is signed in 1Risk using the Aspenware Commerce Checkout flow configuration, it also creates a liability in the guest's profile in Customer Manager within RTP|One.

      Image Added
  • Siriusware Tasks

    • The Liability Form needs to be set up in Siriusare and you need to copy down the ID. The expiration date should be set and copied down, and the minimum age to accept should be set at 18. Set Liability text and HTML to your preferences.

    • Image Added

      The Liability Form needs to be linked to the Siriusware item.

    • When a waiver is signed in 1Risk using the Aspenware Commerce Checkout flow configuration, it also creates a liability in the Guest Activity for the guest within Siriusware.

      Image Added

2. 1Risk Tasks

  • Configure waiver(s) in 1Risk. You need to copy down the waiver 1RiskID (provided by 1Risk) for each waiver.

  • Copy down the ‘waiverFormid’ (provided by 1Risk). This will only be used for the optional waiver configuration for more details on this configuration option, see Step 1 in the Detailed Setup Guide section.

  • Copy down your resort’s 1Risk URL (provided by 1Risk).

  • When a waiver is signed in 1Risk using either the required Aspenware Commerce Checkout flow configuration or the optional Order Confirmation Link configuration, the 1Risk Waiver is stored in 1Risk.

    Image Added
Note

IMPORTANT: This setup must be done in 1Risk and the 1Risk waiver ID and 1Risk URL, which will be used in configuration below, are provided by 1Risk. Contact Charles Mickley cmickley@1risk.com to obtain these values.

3. Commerce Tasks

Products need to be created in Aspenware Commerce. For help setting up products, see detailed instructions on setting up products.

Settings

Before setting up specific waivers, there are several settings that are required to be set properly for 1Risk waiver integration to work. Go to Configuration > Settings. Search for the setting below and define the value according to the table below.

Description

Setting

Value

Defines POS that will be integrated to for waiver and updates field titles in the Waiver plugin in Aspenware Commerce to use POS specific terms.

waiversettings.1riskpos

IF Siriusware set to SW

IF RTP|One set to RTP

Enable’s the resort’s 1Risk configured waivers to be retrieved.

waiversettings.1riskurl

Enter the 1Risk URL provided by 1Risk (see step above)

The secret is used by the app to encrypt the data. Once set, this will not have to be configured again or used to integrate any other platforms.

waiversettings.1risksecret

Set to a “secret” (any value you decide)

Set date format configured in your 1Risk environment.

waiversettings.1riskdateformat

Set to desired date format. Options include:

  • ‘mm/dd/yyyy’

  • 'dd/mm/yyyy’

  • mm-dd-yyyy

  • dd-mm-yyyy

  • If using the “optional” 1Risk waiver configuration option, The ‘Requires 1Risk’ Product Classification must be added as a classification if not already set up as a product classification.

    1. To set the ‘1Risk Waiver in Email Confirm’ Product Classification up as a new classification go to Aspenware Commerce>Product Classifications and select Add Classification and define the following fields as follows

      1. Name: 1Risk Waiver in Email Confirm

      2. Description: Assign this classification to core products that will leverage optional 1Risk waiver signing in the confirmation email. Do not assign if product is assigned to 1Risk Waiver in the Waiver plugin.

      3. Select the checkbox for Requires 1Risk.

      4. Click Add.

Detailed Setup Guide

  1. Review Considerations Prior to Configuration

  2. Configure New 1Risk Waiver within Aspenware Commerce

  3. Assign 1Risk Waivers to Products

  4. (Optional) Configure 1Risk Waiver to be completed from a CTA on the order confirmation email

1. Review Considerations Prior to Configuration

  1. Do you need to have a record of the waiver being signed in your POS (RTP|One or Siriusware)? If so, checkout waiver configuration is the best option. Follow steps 2 and 3 below.

  2. If answer to 1 is ‘no,’ are you going to require waiver signature for all online orders with products that are assigned waivers? If so, set up waivers to require waiver completion as part of checkout. Follow steps 2 and 3 below.

  3. If answer to 1 and 2 are ‘no,’ are you planning to offer waiver signature as an optional task for all online orders with products that are assigned waivers? If so, set up waivers to offer waiver completion as a CTA on the order confirmation email. Follow step 4 below.

Note

IMPORTANT: While 1Risk waivers can be configured either be captured in the checkout flow or as a follow-up task after the order has been completed, there is no option to “skip waiver and sign it later” option in the checkout. Waiver signing for a product is configured to be completed either as a required task during checkout or an optional task after an order is completed.

2. Configure New 1Risk Waiver within Aspenware Commerce

  • Go to the Aspenware Commerce > Waivers.

  • Click Add Waiver to open the Add waiver page.

  • Fill in the following fields (Optional fields are marked with an asterisk here) 

    1. Title: Enter the title of the waiver. This name will be visible to guests at checkout.

    2. POS Code, depending on which POS is selected in the the setting ‘waiversettings.1riskpos,’ one of the following fields will appear:

      1. RTP Authorization Type Code: This is the code fromRTP|One (See prerequisite steps above).

      2. Siriusware Form ID: This is the ID of the Siriusware Liability form (See prerequisite steps above).

    3. Collect CC Info: Do not check - not supported for 1Risk

    4. CC Agreement Required: Do not check - not supported for 1Risk

    5. E-signature required: Do not check, not supported for 1Risk (Signing rules come from 1Risk config)

    6. Enable Agree Checkbox: Do not check, not supported for 1Risk (Signing rules come from 1Risk config)

    7. Enable Wet Signature: Do not check, not supported for 1Risk (Signing rules come from 1Risk config)

    8. Capture Waiver HTML: Do not check, not supported for 1Risk (Capture rules come from 1Risk config)

    9. Display in My Account: Do not check, not supported for 1Risk

    10. Consolidate Releases: Do not check, not supported for 1Risk

    11. Is Resort Charge Waiver: Do not check, not supported for 1Risk.

    12. Validate signature: Do not check, not supported for 1Risk.

    13. Start Effective Date: Enter the date that indicates when the release or waiver is valid. (To test this feature, the date must be earlier than today’s date.)

    14. End Effective Date: Enter the date that indicates when the release or waiver is no longer valid. Typically, this is set to the season end date. (To test this feature, the date must be later than today’s date.)

    15. Link Text: Leave blank, not applicable

    16. Custom Comment:

      • If RTP|One is your POS, options for custom comments include saving the Authorization Type Code {AuthTypeCode}, Signer Name {Signer}, Signed Date {SignedDate}, Browser Name {BrowserName}, and Brownser Version {BrowserVersion} Any words not in curly brackets will also show in the custom comments field. (See Figures A and B.)

      • If Siriusware - Leave blank, not applicable

    17. 1Risk ID: Define value provided by 1Risk for the 1RiskID of the waiver. (See prerequisite task above)

    18. Text area: Enter “Signed in 1Risk”

  • Click Save

Figure

Feature Description

Example (Click to Expand)

Figure A

Custom Comment: In RTP|One only, if there are entries in this field, custom comments will be viewable in the guest’s authorization profile as shown.

Image Added

Figure B

Custom Comment: This example shows the tokens entered in the Custom Comment field.

Image Added

3. Assign 1Risk Waivers to Products

  • Go to Aspenware Commerce > Waivers in Administration.

  • Click Assign Waiver to Products.

    Image Added
  • Select the waiver(s) that should be applied to each product from the Assigned Waiver drop-down(s). Each product can be assigned up to four waivers. If an add-on product requires a separate waiver, then assign the add-on product the desired waiver.

...

4. (Optional) Configure 1Risk Waiver to be completed from a CTA on the order confirmation email

Products can be set up to send guests a link to complete 1Risk waivers upon order completion within the order confirmation email. A 1Risk waiver link is sent to a guest in their order confirmation email if the guest has a product, or products, in their order that are set up to require waivers. 

  • Go to Plugins > Product Classifications > Add Assignment and select the Category containing the product requiring 1Risk waiver signing from the dropdown.

  • Select the desired product from the Product dropdown.

    • If waiver collection is specific to a particular attribute combination and does not apply to the entire product, check the desired product attributes.

  • In the Classification table, Check the Assign checkbox for ‘1Risk Waiver Option in Email Confirm.’

  • In the SKU field for Requires 1Risk Waiver classification, enter the 1RiskID from 1Risk (see prerequisite tasks).

  • In the Value field for Requires 1Risk Waiver classification, enter the waiverFormid, which is the shorter string and is an integer. 

...

  • Click Add.

  • Assignments for Products to Require 1Risk Waiver can be removed by selecting Delete.

  • To update text that appears in the confirmation email within the table where guests sign their waivers, go to the Configuration > Languages page in Admin, clickEdit in the English row.

  • From the Edit Language details - English page, click to open the String Resources section.

  • The following languages are related to waiver signing in the confirmation table. 

Description

String Resource

Current Value

Placement

Email Confirmation with Waivers

messages.order.waivers.name

Products requiring waivers in your order

Email Confirmation Table Header

Email Confirmation with Waivers

messages.order.waivers.waiver

Waivers to sign

Email Confirmation Table Header

Email Confirmation with Waivers

messages.order.1riskwaiver

Sign Waiver

Email Confirmation Table Link to Waiver

  • Next, go to Content Management>Message Templates, and click Edit to edit the ‘OrderPlaced.CustomerNotification’ email template. 

  • To edit the email HTML, go to Tools>Source Code and adjust the HTML from there in the Source code window. Paste the token '%Order.Waivers%' below into your HTML in the appropriate place.

5. (Optional) Enable 1Risk Email Feature

Warning

Not supported for Siriusware.

  • Configure settings specific to this feature by going to Configuration > Settings > All settings (advanced) and searching for the following settings:

    1. waiversettings.1riskemailapiendpoint is the endpoint that Aspenware calls to retrieve the proper URL from 1Risk that will be delivered in the email template

      1. Click Edit.

      2. Enter the value provided by 1Risk to your resort.

    2. waiversettings.1riskemailapisecret is the special value that gives access to the 1Risk resort waivers.

      1. Click Edit.

      2. Enter the value provided by 1Risk to your resort.

        Image Added

  • Go to Aspenware Commerce > Waivers.

    1. Find the waiver you would like to add email to and click Edit.

    2. Scroll down to the 1Risk Waivers section and complete the following fields:

      1. Send waiver emails checkbox: Checking this box will enable the email feature.

      2. Minor Age textbox: Enter the age for which the waiver-signer is considered a minor and must be signed by a legal guardian (this should match the minor age set in your 1Risk admin tool). Note that If no age is entered, then all waivers will be considered adult waivers and therefore require emailing if the participant is not the logged-in user.

    3. Click Save.

      Image Added
  • Customize feature-specific language strings in Configuration > Languages and click English.

    • Under String Resource, search for the following strings to configure:

Language String

Default Value

Example

Aspenware.Waivers.EmailSentText

Email Sent!

Image Added

Aspenware.Waivers.EmailSendButtonText

SEND

Image Added

Aspenware.Waivers.EmailMinorDisplayEmailText

Not {first} {last}'s legal guardian? %Email% this waiver

Image Added

Aspenware.Waivers.EmailMinorSignWaiverText

Are you {first} {last}'s legal guardian? %Sign% this waiver now

Image Added

Aspenware.Waivers.EmailMinorResendEmailText

Didn’t receive the email? Resend the email

Image Added

Aspenware.Waivers.EmailAdultDisplayEmailText

{first} {last} must sign this waiver

Image Added

Aspenware.Waivers.EmailAdultResendEmailText

Didn’t receive the email? Resend the email

Image Added