Configuration: Product Shell
Setup Checklist
1. POS Tasks |
|
RTP|One - The product must be a fully configured product in the POS system and able to be sold in ONE|Resort.
| Prerequisites |
Siriusware - The Item must be a fully configured product in the POS system and should be able to be sold on Sales.
| PrerequisiteS |
2. Infrastructure Tasks |
|
Unity - Connectivity between Aspenware Commerce and the POS system has been fully established through Unity. Required | PrerequisiteS |
3. Aspenware Commerce Tasks |
|
Store Configuration
| PrerequisiteS |
Product Editor Screen Product Info dropdown
Price dropdown
Shipping dropdown
Inventory dropdown
Pictures dropdown
SEO dropdown
Save and Continue Edit button
| Detailed setup |
Prerequisite Tasks
1. POS Tasks
RTP - The product must be a fully configured product in the POS system and able to be sold in ONE|Resort.
General tab
Product is active
The appropriate security level is set at or below the Aspenware User security level.
Sales Locations
Appropriate Sales Location for Aspenware is assigned
Components
Required Component(s) for the product have been added.
Sales Channels
The appropriate Sales Channel for Aspenware has been added.
Pricing
Pricing date ranges and/or pricing seasons are valid for the product dates being utilized.
Rules
Optionally add any rules the product may require, ie Customer Required, PUB/Skiosk, Min/Max Age, etc.
Siriusware - The Item must be a fully configured product in the POS system and should be able to be sold on Sales.
Salespoint Type
Item is available to be sold from Web Sales
Restrictions
Available Sales Dates has the Item priced for the current season
Items
Item is added to the Item Tree being used by the Online Salespoint
2. Infrastructure Tasks
Connectivity between Aspenware Commerce and the POS system has been fully established through Unity. This should have been completed during the implementation of your store.
3. Aspenware Commerce Tasks
The Category that the product will appear under needs to be created and published.
Optional features such as Roles, Multiple Stores, Discounts, and Tax Category, etc must be configured in advance to be applied to the product.
4. Settings, Language Strings, and/or HTML Widgets for this Feature
Detailed Setup Guide
NOTE: It is recommended to save often by clicking Save and Continue Edit in the top menu bar. This will ensure your work is saved in the event you accidentally close or navigate away from the page.
HINT: Image examples below can be clicked to enlarge for easier viewing.
1. Create a New Product
The Products page can be used to create new products, edit existing products, and delete products.
To create a product, go to Catalog > Products > Add new
Ensure the top left slider is displayed as Advanced. If Basic is showing then click Basic and Advanced will now show.
NOTE: If you click the Settings button you can configure the Basic view to hide unused fields as the Advanced view will show fields that are not used by Aspenware Commerce. If the Basic view is configured improperly, it can hide the required fields.
2. Complete Required Product info fields
Enter the required product info in the Product info fields. If the Product info drop-down is not expanded, click Product info to display the fields in this section.
NOTE: The Product info fields control the name displayed for the product on both the product card and PDP, the short description on both the product card and PDP, the long description on the PDP, the email content that goes to guests when the product is purchased, the SKU sent to the POS when this is a simple product, the category(s) the product is displayed under, whether the product is published and visible to guests or not, whether the product is a normal ski product or retail product, optionally what roles have access to the product, optionally which stores will display the product, optionally when the product is available for purchase, and optionally when the product is taken off display and cannot be purchased.
Product name: The value input here appears on the product card and PDP. Only {alphanumeric}
values are accepted.
NOTE: If you plan to integrate with Kount, you are limited to 254 characters/254 byte for the product name. Kount will throw an error message and prevent the sale of the product if the name exceeds the limit.
Placement | Click to expand |
---|---|
Product card example | |
PDP example | |
WARNING: Using unspossted characters in product names can cause the site to not load. For example a long dash “-” used in the product name could potentially cause the site not to load for certain users. See the image example and ensure the bottom long dash is not used. |
Short and long description: The short description appears on the product card and directly below the product name on the PDP. The long description only appears on the PDP and is separated in this field by manually typing in the pipe character “|”. Both short and long descriptions can utilize most aspects of HTML, but HTML is only visible on the PDP.
Placement | Click to expand |
---|---|
Product card example | |
PDP example |
Email description: Click Tools > Source code and in the pop-up window add your HTML text. Once complete click Ok. The Email description box is the content that displays on order confirmation emails when a guest buys a specific product. If a guest purchases different products in a single order then each product’s email description box’s content is included in the order confirmation email. The email description does not display on the PDP and will never appear on order confirmation emails for add-on products.
Placement | Click to expand |
---|---|
Email example |
SKU: Enter the POS product ID in the SKU field. When a guest completes an order this will map to the specified product ID in the POS and sell the guest that product. If the product requires multiple product IDs, (different product IDs based on age-range for example), then leave the SKU field blank as this will be mapped later at the attribute combination level.
NOTE:
For RTP, use the product header code (PHC).
For Siriusware, use Department, Category, Index (DCI) by separating each section with a | ie Department|Category|Item.
Categories: Click this field to select the category(s) or sub-category(s) that this product should fall under. Only categories that have already been created will appear here. If you are creating an add-on product then select a hidden category. (see category configuration section if you need to add a new category or a hidden category).
Placement | Click to expand |
---|---|
Category example |
Published: If checked, this product will be accessible on the site. If the category it is associated with is also published. If unchecked, this product will not be accessible on the site.
Product Tags: Add text that will appear as a “chip” on the product card. Text for separate chips may be separated by commas or by pressing Enter after the chip text within this field. Note the following nuances with this feature:
Unique text “chips” will be separate and stacked.
If too much text is input for a chip it will cut off the ending text and display as “…”
There are some themes that don’t display product tags well. If this is the case for your resort’s store, you may need to update the theme to utilize product tags. Contact your Aspenware Representative (support@aspenware.com) to discuss a theme update.
Once a text value has been set, the ordering cannot be changed. For example, if I have two “chips” stating “Buy Now” and “2022" then they will forever be in that order. They cannot be changed even with the exact same text listed in the opposite order (i.e. “2022” first and “Buy Now” second).
Placement | Click to Expand |
---|---|
Product Tag Example |
Product type: Leave as “Simple”.
Product template: Leave as “Simple product”. If you are setting up a Retail product, set to “Retail” and refer to the documentation on setting up a retail product.
Customer roles: If any guest should be able to view this product, leave the field blank. If this product should only be visible to specific guests, select the corresponding role(s) associated with those guests.
Limited to stores: If you are running only one store, leave blank. If you are running multiple stores and want this product only visible to guests on specific stores(s), select the corresponding store(s) the product should be displayed on.
Available start date (UTC): Optionally defines the date & time in UTC the product will become visible on the site. Leave as blank if you want the product to be visible immediately. To set a date click the Calendar icon and select your desired date, to set a time click the Clock icon and set your desired time.
Available end date (UTC): Optionally defines the date & time in UTC the product will become not visible on the site. Leave as blank if you do not want an automated date & time to remove the product for purchase. To set a date click the Calendar icon and select your desired date, to set a time click the Clock icon and set your desired time.
NOTE: The following fields from this section are not used:
Manufacturers: This field is not used, leave blank.
GTIN (global trade item number): This field is not used, leave blank.
Manufacturer part number: This field is not used, leave blank.
Show on home page: This field is not used, leave unchecked.
Visible individually: This field is not used, leave checked.
Vendor: This field is not used, leave the field as “No vendor”.
Require other products: This field is not used, leave unchecked.
Allow customer reviews: This field is not used, leave unchecked.
Mark as new: This field is not used, leave unchecked.
Admin comment: This field is not used, leave unchecked.
Enter the required product info in the Price fields. If the Price drop-down is not expanded, click Price to display the fields in this section.
NOTE: The Price fields control the price displayed on the product card when the theme is configured to display pricing on product cards, the price can define the selling price sent to the payment provider and POS if this is a simple product, and optionally tax can be assigned to the product.
Price: If this is a simple product, enter the product’s price here. This will be the selling price sent to the payment provider and POS system. If the store’s theme is configured to display a price on the product card, this will also display as the price on the product card.
Old Price: If the product will be dynamically priced, this can be used to set a window rate or base price. Once set, the dynamic pricing savings display function on the PDP will display the “old price” crossed out and the current price beside it. If no old price is set, then this feature will not be enabled. The old price can also be set on a non-dynamically priced product by entering a price here. Old price is particularly useful for those products which are not dynamically priced/whose prices remain stable, yet guests receive a discount by buying online. For more information on enabling/disabling the Savings Display on the PDP, see the relevant section in Configuration: Reimagined Dynamic Pricing.
Placement | Click to expand |
---|---|
PDP example |
|
Product Card example |
|
NOTE: Old price is static and will not change based on different attribute selections made on the PDP. If “Old price” is a greater value than the attribute price it will always display regardless of attribute selection.
Placement | Click to expand |
---|---|
PDP example |
Discounts: Leave blank if you are not offering discounts on this product. If you are offering discounts on this product, select the desired discount(s) you have pre-configured from this drop-down.
Tax exempt: If the product is tax-exempt check this box. If the product has tax then uncheck this box.
Tax category: Appears when “Tax exempt” is unchecked. Select a pre-configured tax category to apply that tax rate to this product.
Placement | Click to expand |
---|---|
Shopping cart example |
NOTE: The following fields from this section are not used:
Product cost: This field is not used, leave as 0.0000.
Disable buy button: This field is not used, leave as unchecked.
Disable wishlist button: This field is not used, leave as unchecked.
Available for pre-order: This field is not used, leave as unchecked.
Call for price: This field is not used, leave as unchecked.
Customer enters price: This field is not used, leave as unchecked.
PAngV (base price) enabled: This field is not used, leave as unchecked.
Telecommunications, broadcasting and electronic services: This field is not used, leave as unchecked.
Add new tier price : Unused fields, do not click.
4. Complete Required Shipping fields
Enter the required product info in the Shipping fields. If the Shipping drop-down is not expanded, click Shipping to display the fields in this section.
NOTE: These fields are only used to set up a retail product.
Shipping enabled: Leave unchecked. If setting up a retail product see the Retail product configuration guide.
5. Complete Required Inventory fields
Enter the required product info in the Inventory fields. If the Inventory drop-down is not expanded, click Inventory to display the fields in this section.
NOTE: These fields are optionally used to limit the quantity of a specific product that guests can add to their cart.
Inventory method: Leave as “Don’t track inventory”. If setting up a retail product see the Retail product configuration guide.
Minimum cart qty: Enter the minimum product quantity a guest must select to add this product to their cart. If a value greater than 1 is entered and the “Allowed quantities” setting below is not configured, then guests will not be able to add the product to their cart.
Maximum cart qty: Enter the maximum product quantity a guest may add of this product to their cart.
Allowed quantities:
If left blank, then guests will only be able to add one product to their cart at a time by clicking the “add to cart button” on the PDP.
If looking to add inventory limitations, enter comma-separated numeric values. This allows guests to add multiple products to their cart at a time, this also dictates the exact value range of product quantities a guest can add to their cart. For example, “1,2,3,5” would only allow the guest to add those exact values to their cart, meaning they could not add a total of 4 or 6 of the same product to their cart. This also only restricts cart values to the core product or each unique product combination. From the example above, a guest could add 5 Adult Passes to their cart and also add 5 Child Passes to their cart and complete checkout since those are interpreted as different products. This also does not prevent a guest from going through checkout multiple times to get around cart quantity restrictions.
Placement | Click to expand |
---|---|
PDP example | |
PDP error adding non-configured values |
NOTE: The following fields from this section are not used:
Warehouse: This field is not used, leave as “None”.
Not returnable: This field is not used, leave as unchecked.
6. Upload Images in Pictures fields
If the Pictures drop-down is not expanded, click Pictures to display the fields in this section. The Picture fields control the image used on the product card and PDP when the resort’s theme is set up to display here. As described in the product attribute feature configuration article, this is also where icon images are saved so they can later be added to selected attribute values for display on the PDP.
NOTE: the main image(s) will only appear on the PDP if this is part of your resort’s specified theme. Recommended product image sizes depend on your store’s theme. To determine which theme option your store uses, please see item 12 within the https://hub.aspenware.net/main/marketing-required-theme-decisions-assets#:~:text=12.%20Select%20PDP%20image%20display page
If your store uses the image slider or no product image on the PDP, then recommended product image dimensions are 1700 x 700 px and 275 KB
If your store uses dynamic PDP hero replacement, then recommended product image dimensions are as follows:
Tall hero image dimensions must be 1920 x 700px and 275 KB
Medium & Short hero image dimensions must be 1920 x 550px and 275 KB
Optional product icon images are 40 x 40 px.
TIP: For a free tool for reducing image sizing go to https://tinypng.com. It can often be used with no noticeable degradation in quality to reduce an image size.
Step 1 (Required): Adding a product image
Upload a file: Click Upload a file then select an image from your computer to upload. (See above note for recommended specs)
Alt: Leave as blank
Title: Leave as blank
Display order: Leave as 0
Add product picture: Click Add product picture and the initial image is now saved to this product.
Step 2 (Required): Adding product image(s)
If your theme is a single static image: Repeat Step 1 above with the same image already used. You must also repeat the “Upload a file” step even though it looks like you can simply click the “Add product picture” button.
If your theme scrolls through multiple images on the PDP: Repeat Step 1 but you may choose a different image that guests can scroll through on the PDP. You must also repeat the “Upload a file” step even though it looks like you can simply click the “Add product picture” button.
Step 3 (Optional): Adding icon image(s)
Upload a file: Click Upload a file then select an image from your computer to upload. (specs: 40 x 40 px.)
Alt: type “icon” in this field
Title: type “icon” in this field
Display order: type “20” in this field
Add product picture: Click Add product picture
NOTE: You do not need to repeat these steps for icon images and you can upload several different icon images. To be visible, icons must be assigned to attribute values, and configuration to accomplish this is covered in the Product Attribute Values Configuration document.
7. Skip the Product attributes fields
NOTE: If the Product attributes drop-down is not expanded, click Product attributes to display the fields in this section. These fields are used to create a product with attributes and configuration to accomplish this is covered in the Product Attribute Values Configuration guide.
8. Skip the Specification attributes fields
NOTE: If the Specification attributes drop-down is not expanded, click Specification attributes to display the fields in this section. These fields are used to apply special rules and features to the product and configuration to accomplish this is covered in the Specification Attribute Values Configuration guide.
9. Skip the Gift card fields
NOTE: This area of the store is not used.
10. Skip the Downloadable product fields
NOTE: This area of the store is not used.
11. Skip the Rental fields
NOTE: This area of the store is not used.
12. Skip the Recurring product fields
NOTE: This area of the store is not used.
13. Complete the SEO fields
If the SEO drop-down is not expanded, click Seo to display the fields in this section.
NOTE: These fields are used to define the last portion of the product’s URL and for the meta-text on the product card if your theme has meta-text enabled.
Search engine friendly page name: Enter the value that will define the ending portion of the product’s URL.
Meta title: Enter the value that will appear on the product card when the store’s theme is configured to show meta-text. Character limits depend on the theme’s font size/styling and the guest’s screen size.
Placement | Click to expand |
---|---|
Product Card example |
NOTE: The following fields from this section are not used:
Meta keywords: This field is not used, leave blank.
Meta description: This field is not used, leave blank.
14. Skip Related product fields
NOTE: If the Related Products section is not expanded, click Related Products to display the fields in this section. This is covered in the Related Products Configuration guide.
15. Skip Cross-sells fields
NOTE: If the Cross-Sell section is not expanded, click Cross Sell to display the fields in this section. This is covered in the Cross-Sell Configuration Guide.
16. Skip Purchased with orders fields
NOTE: If the Purchased with orders drop-down is not expanded, click Purchased with orders to display the fields in this section. No configuration is needed. These fields are used to show past order information for this product.
17. Skip Product vouchers fields
NOTE: If the Product vouchers drop-down is not expanded, click Product vouchers to display the fields in this section. These fields are used to set up features relating to vouchers and configuration to accomplish this is covered in the Product Voucher Configuration guide.
18. Click the Save and Continue Edit button
Click Save and Continue Edit in the top menu bar to save the changes you have made.
NOTE: The best practice is to continually click Save and Continue Edit as you work through the product setup. Once saved, your product should appear on the store under the category you selected. There you can review/test and come back to the product editor page to make changes as needed.