| Table of Contents |
|---|
Setup Checklist
...
| Table of Contents |
|---|
Setup Checklist
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
1. POS |
|---|
Tasks | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
| Status | ||||
|---|---|---|---|---|
|
|
2. INFRASTRUCTURE TASKS
|
| ||||||||||||
2. Infrastructure Tasks | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
| ||||||||||||||||||
3. |
|---|
Commerce Tasks | |
|---|---|
|
|
|
|
|
Language String, Setting, HTML widget, etc. Task 4 -
| Status | ||||
|---|---|---|---|---|
|
| Status | ||||
|---|---|---|---|---|
|
| |||
1. Configure Retail Product
|
2. Configure Retail Product Attributes
3. Configure Retail Tax
4. Configure Retail Shipping/Delivery
|
|
Prerequisite Tasks
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...
Ensure that Product Header Codes are configured for any retail items. Each size/color combination needs its own PCHproduct header code. Make a note of these codes for Commerce configuration.
Configure retail inventory for retail products.
Configure tax rates for retail products in both Aspenware Commerce and RTP|One. If using RTPConnect, a fixed-rate tax must be created. If using Unity, you have the option to set tax rates by shipping location (different tax rates by region, state/province, or postal code.) The tax rates by region, state/province, or postal code must be configured exactly the same in both Aspenware Commerce and RTP|One. Please refer to the tax setup and rules in the INSERT LINK TO TAXES DOCTaxes documentation.
If shipping fees are needed, set up Product Header Code(s) for those shipping fee items.
If delivery locations are needed, set up delivery locations and methods and make note of these codes.
HINT: For Delivery Location (aka Delivery Detail) codes, you’ll need to retrieve these from the db. Work with your Aspenware representative if you don’t have this access.
Infrastructure Tasks
If you would like to enable order-level shipping charges, Aspenware must configure your RTP|One shipping product header code in Unity rtp-config.json. Please Please provide your Aspenware Representative with the product header code for your general shipping product. (Must be set up prior to selling a product live.)
If you wish to enable the retail inventory sync scheduled task, which updates inventory in Aspenware Commerce from RTP|One on-hand inventory nightly, Aspenware must configure your retail inventory location code in Unity rtp-config.json. Please Please provide your Aspenware Representative with the retail inventory location code you wish to use for the ecomm ecommerce inventory location. (Must be set up prior to selling a product live.) The retail inventory location code does not need to be the same as the sale location code . The (though it can be the same code). The sale location code can continue to be your existing ecomm e-commerce sale location, and the retail inventory code can be any retail store, or the warehouse , if you have a retail warehouse location configured in RTP|One.
| Info |
|---|
NOTE: The inventory sync scheduled task can only be scheduled to run once per day after the RTP|ONE overnight cycle completes. See RTP|ONE retail inventory sync details below. |
Commerce Tasks
If you do not have a ‘Retail Product’ template already set up, configure a retail product template for your store. In Admin, go to System > templates > product template
Name: Retail product
View Path: ProductTemplate.Retail
Display order: {any numeric value}
If you are planning to use discounts for retail products, configure any discounts (See the Discount Configuration to configure.)
Configure tax rates for retail products in both Aspenware Commerce and RTP|One. If using RTPConnect, a fixed-rate tax must be created. If using Unity, you have the option to set tax rates by shipping location (different tax rates by region, state/province, or postal code.) The tax rates by region, state/province, or postal code must be configured exactly the same in both Aspenware Commerce and RTP|One. Please refer to the tax setup and rules in the INSERT LINK TO TAXES DOC
Settings, Language Strings and/or HTML Widgets for this Feature
...
Taxes Configuration Guide.
Detailed Setup Guide
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
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
Configure Retail Product
Configure Retail Product Attributes
Configure Retail Tax
Configure Retail ShippingConfigure Retail Product
Configure Retail Product Attributes
Configure Retail Tax
Configure Retail Shipping/Delivery
1. Configure Retail Product
These instructions walk you through creating the retail product(s) for your store. Products must be created for each unique product being sold in the store, for each size and color combination. Color and size variants will be configured in the Configure Retail Product Attributes section.
| Note |
|---|
IMPORTANT: Do not configure autofulfill Do not configure Autofulfill on any of your retail products, since retail orders must always be fulfilled by the retail order processor fulfillment staff, when that staff person packs and ships the retail item(s). |
Go to Catalog > Products page in Admin.
ClickAdd new to create a new product.
Under the Product Info section update the following fields:
Product name: Enter the name of the product that will be displayed to the guest.
Short description Description and Long Description:
The Short descriptions allowed- appears on the right description appears on the product card only. The short description is not displayed on the PDP.
The Long description appears in the Dynamic Box on the PDP directly above the ‘add to cart.’
Long descriptions are not supported on retail product detail pages.
' button. HTML is supported.
Email Content: This is the content that will display in the email for guests who purchase this product, and will not display on the product detail page.
Click Tools, then Source Code, and paste/enter text.
Click OK to close the source code window and add any additional formatting in the editor.
SKU (Product Header): If there is only one RTP|One Product Header for the retail item (if there are no size or color combinations), enter the RTP|One Product Header in the SKU field at the product level. If the RTP|One Product Headers are defined at the attribute combination level, which is the case for any retail product with more than one size or color, leave the SKU field blank at the product level. You’ll configure the product header codes at the attribute combination level for any product with more than one size or color.
Categories: A product can be organized under one or multiple categories. (See Category configuration for category set up.)
Subcategories for retail (such as shirts, hats, accessories) are not formally supported but might work depending on your configuration.
A multi-category assignment can also be used.
Published: Check to publish the product. If the product is published and belongs to a published category, it will be accessible publicly.
Product Type: ‘Simple’
Product Template: 'Retail product’
Visible individually: Checked
Available start date: Define this if the product should only be available on in the store for a set time period (e.g. Dec. 1 through Dec. 31). The available start date will be the date that the product becomes visible on the site.
Available end date: Define this if the product should only be available on in the store for a set time period (e.g. Dec. 1 through Dec. 31). The available end date will be the date that the product is not visible on the site. (Core Product Only).
All other fields not noted may remain blank.
Click Save and Continue Edit.
| Info |
|---|
NOTE: These time and date settings are based on GMT/UTC, not the store default timezone. |
...
Scroll to the Price section and update the following fields: (It may be collapsed, click + to expand)
Price: If the price is defined at the product level, specify it here. If the price is defined at the attribute combination level (e.g. Color, size, etc. levels), enter a display price, which will be displayed on the product card as the “Starting at” or default price.
This is the price that will appear on the product card that displays within the category
Should be the lowest advertised price or the price of the defaulted attribute combination.
Discounts: Select any applicable discount from the drop-down.
Tax category: Set your tax category if your retail products require product requires taxes.
...
Scroll to the Shipping section update the following fields: (It may be collapsed, click + to expand)
Shipping enabled: Check this box if the product is “shippable.”
Additional shipping charge: Set this to be the price you wish to apply for shipping charges on the product if you are charging for shipping.
It’s possible to have different shipping charges for different products. If this is the desired behavior, refer to Configuration: Delivery/Shipping.
Order-level shipping is now only supported for retail products. Order-level shipping applies the highest-priced shipping charge, and only that one charge, to the entire retail order.
Previously, line-item shipping fees were applied to retail orders, which was not optimal, since shipping charges for each line item were added together and applied to the order, resulting in over-charging shipping and guest complaints. Line-item shipping is no longer supported. Do not configure any retail products to ‘ship separately’.
...
Update the following fields:
Inventory method: Set to ‘Track inventory by product attributes’ if you wish to use the retail sync from RTP|One in order to update Aspenware Commerce inventory daily from RTP|One on-hand inventory levels for each SKU/Product Header code.
Display availability: If you are tracking inventory in Aspenware Commerce, check this, since it will provide meaningful messages to the guest if he/she tries to add more products to the cart than are available in on-hand inventory.
Display stock quantity: If you are tracking inventory in Aspenware Commerce, check this, since it will provide meaningful messages to the guest if he/she tries to add more products to the cart than are available in on-hand inventory.
Allowed quantities: You have the option to set this to allow a guest to add more than 1 item quantity to their cart, it can be set to whatever number of quantities you want to support for add to cart. This WILL NOT update as your inventory is sold/decremented from on-hand.
Leave all other fields as they are.
...
| Noteinfo |
|---|
IMPORTANT: The RTP|ONE retail inventory sync is a scheduled task.
|
Scroll to the Pictures section (It may be collapsed, click + to expand.)
Add images for the product.
Upload the file, and once uploaded, click Add Product Picture.
Dimension recommendations for image sizes:
A square photo that is 1x1 (recommended to be 600x600 pixels) and in .jpeg formSee the HINT below for detailed Retail image specs and guidelines.
The images you add here will display on the PDP as thumbnail options. They will also be available for an association to the attribute values for color options, as shown below.
...
4. Configure Retail Shipping/Delivery
One or more delivery locations must be set up for each delivery method configured.
...
Go to Aspenware Commerce > Delivery to open the Delivery Methods page.
...
...
As in RTP|One, every size and color combination for apparel that has sizes and colors requires an individual SKU (RTP|One product header code) to be entered on the attribute combination for each product. For example, if a shirt has 3 sizes and 3 colors, the admin needs to have 9 SKUs (one for each size/color combo, just like in RTP|One retail inventory).
Colors of the retail product are supported at the attribute value level (not at the attribute combination level). For example, if you wish to have your black shirt show as the guest selects the color black, you will be able to do so by adding the picture at the attribute value level on the color attribute (described below).
| Info |
|---|
NOTE: Add-ons are not supported with retail. |
On the Edit product details screen for the product, scroll to the Product attributes section
To add a new attribute (e.g. Size), click Add a new attribute and select the attribute from the drop-down.
Examples of attributes:
Size
Color
If you do not have these as options in the Attribute drop-down, you will need to add them in Catalog > attributes > product attributes
In order to have a product change the picture to match the color attribute selected, you will need to have both size and color attributes on the product.
...
Scroll down to the Values section and assign the image with the appropriate color attribute you would like it to display.
Click Save and Continue Edit.
...
Within the attribute combination table, attribute combinations are mapped to SKUs (RTP|One product header codes) and prices. To generate the attribute combinations, go to the Attribute combinations tab under the Product attribute section.
Click Generate all possible combinations.
If PHC (SKUS) and/or prices are defined at the attribute combination level, there should now be a combination for every PHC (SKU).
Click Edit next to each attribute combination. Update the following fields:
Stock quantity: You may enter the stock quantity if you wish to test out of stock messaging, but remember that the stock quantity for each SKU will be updated daily from the retail inventory sync schedule task, so any values you enter manually will be overwritten by the sync, if the sync is set up for your store.
Allow out of stock: If you select ‘Allow out of stock’ this will allow your product to oversell beyond the on-hand inventory. If selected, your fulfillment personnel will need to handle the operational matters related to backorders in order to fulfill those retail orders.
SKU (PHC): Enter the correct RTP|One PHC for this attribute combination in the SKU column.
Overridden price: If the product is priced at the attribute combination level, update the Overridden price field with the correct price for that combination.
Click Save.
...
Edit each attribute combination in this manner until all have been updated. Once, you are finished, each attribute combination should have, at a minimum, a unique SKU(PHC) defined.
3. Configure Retail Tax
For resorts using Unity, Aspenware Commerce supports Taxes by shipping location, which will apply the tax rate configured for the shipping address entered by the guest during checkout.
Resorts using RTP|Connect cannot utilize this feature and need to use Fixed Rate taxes, since RTPConnect cannot specify a shipping address when creating an RTP|One order, which is required for tax by shipping location in RTP|One.
For resorts using Unity, if you wish to apply taxes by shipping location, go to Configuration > Tax providers.
Next to ‘Manual,' click Configure.
Select ‘By Country’ by toggling at the top of the page.
Configure tax by location for each region, state/province, or postal code. (This will be the tax that is assigned to/set up in the product shell under ‘Price’ in the first step.)
| Info |
|---|
IMPORTANT: The RTP|One administrator must also configure taxes by shipping location in RTP|One, and each region, province/state, or postal code must match the tax rates you configure in Aspenware Commerce. |
If taxes are NOT priced by location, then you will want to set this up with a flat rate (i.e. flat 7.45% tax). This requires a new tax category, you will assign a tax rate to United States as a whole.
...
HINT: Retail image specs
Image Dimensions:
1200x1200 square
File Size:
100k-160k
Background:
Neutral - white or light gray would work best. White may work best with your brand styling, but if you are going to go with grey I wouldn’t go darker than RGB (242,242,242). You can always change the background in post-processing if you have white to begin with.
Subject Placement:
I would keep the subject of the photo in the center of the square with at least a 10% padding between the product and edge of the photo. On a 1200x1200 photo that translates to a 120px padding. This is going to ensure that even after resizing the browser, the product will never get cut off.
Notes:
The products pictured often look best when they cast a shadow. If you can get a photo with neutral background and shadow you’ll be happiest with the look on your site. This type of product photography can be tough to do consistently, so you may need to do post-processing to get the look you want. The key is that consistent background color. At least the edges of every photo need to blend into the same light color - otherwise, you’ll see a hard line on the site that I don’t think looks as nice and will clash with other on-screen elements.
Please let your Aspenware Service representative know if you have any questions about these specifications.
2. Configure Retail Product Attributes
As in RTP|One, every size and color combination for apparel that has sizes and colors requires an individual SKU (RTP|One product header code) to be entered on the attribute combination for each product. For example, if a shirt has 3 sizes and 3 colors, the admin needs to have 9 SKUs (one for each size/color combo, just like in RTP|One retail inventory).
The colors of the retail product are supported at the attribute value level (not at the attribute combination level). For example, if you wish to have your black shirt show as the guest selects the color black, you will be able to do so by adding the picture at the attribute value level on the color attribute (described below).
| Info |
|---|
NOTE: Add-ons are not supported with retail. |
On the Edit product details screen for the product, scroll to the Product attributes section
To add a new attribute (e.g. Size), click Add a new attribute and select the attribute from the drop-down.
Examples of attributes:
Size
Color
If you do not have these as options in the Attribute drop-down, you will need to add them in Catalog > Attributes > Product Attributes
In order to have a product change the picture to match the color attribute selected, you will need to have both size and color attributes on the product.
...
Scroll down to the Values section and assign the image with the appropriate color attribute you would like it to display.
Click Save and Continue Edit.
...
Within the attribute combination table, attribute combinations are mapped to SKUs (RTP|One product header codes) and prices. To generate the attribute combinations, go to the Attribute combinations tab under the Product attribute section.
Click Generate all possible combinations.
If PHC (SKUS) and/or prices are defined at the attribute combination level, there should now be a combination for every PHC (SKU).
Click Edit next to each attribute combination. Update the following fields:
Stock quantity: You may enter the stock quantity if you wish to test out of stock messaging, but remember that the stock quantity for each SKU will be updated daily from the retail inventory sync schedule task, so any values you enter manually will be overwritten by the sync, if the sync is set up for your store.
Allow out of stock: If you select ‘Allow out of stock’ this will allow your product to oversell beyond the on-hand inventory. If selected, your fulfillment personnel will need to handle the operational matters related to backorders in order to fulfill those retail orders.
SKU (PHC): Enter the correct RTP|One PHC for this attribute combination in the SKU column.
Overridden price: If the product is priced at the attribute combination level, update the Overridden price field with the correct price for that combination.
Click Save.
...
Edit each attribute combination in this manner until all have been updated. Once, you are finished, each attribute combination should have, at a minimum, a unique SKU(PHC) defined.
3. Configure Retail Tax
For resorts using Unity, Aspenware Commerce supports Taxes by shipping location, which will apply the tax rate configured for the shipping address entered by the guest during checkout.
Resorts using RTP|Connect cannot utilize this feature and need to use Fixed Rate taxes, since RTP|Connect cannot specify a shipping address when creating an RTP|One order, which is required for tax by shipping location in RTP|One.
For resorts using Unity, if you wish to apply taxes by shipping location, go to Configuration > Tax providers.
Next to ‘Manual,' click Configure.
Select ‘By Country’ by toggling at the top of the page.
Configure tax by location for each region, state/province, or postal code that requires a unique tax rate. (This will be the tax that is assigned to/set up in the product shell under ‘Price’ in the first step.)
| Info |
|---|
NOTE: The ‘By Country’ tax setting will apply to all tax categories, however, non-retail products cannot be taxed based on shipping location. If non-retail products require tax, also configure those tax categories here, assigning them to the United States, and enter * for both State and Zip so that they are not configured by location. |
| Note |
|---|
IMPORTANT: The RTP|One administrator must also configure taxes by shipping location in RTP|One, and each region, province/state, or postal code must match the tax rates you configure in Aspenware Commerce. |
If taxes are NOT priced by location, then you will want to set this up with a flat rate (i.e. flat 7.45% tax). This requires a new tax category, you will assign a tax rate to United States as a whole.
| Info |
|---|
NOTE: Please refer to the tax set up and rules in the Taxes Documentation, if more guidance in tax set up is necessary. |
4. Configure Retail Shipping/Delivery
One or more delivery locations must be set up for each delivery method configured.
| Info |
|---|
NOTE: Delivery Methods are the initial selection a guest will make during checkout (ie: “Pickup” or “Ship”). Each Delivery Method can house 1 or more Delivery Locations (ie: Delivery Method “Pickup” could house the Delivery Locations “Pickup at Pass Office” and “Pickup at Hotel”.) |
Go to Aspenware Commerce > Delivery to open the Delivery Methods page.
Click Add Delivery Method.
On the Add Delivery Method page, specify the following:
Name: Enter thename of the delivery method shown to customers during checkout selection.
Lead Days: For non-date-based products, such as Retail Products, leave this blank.
Shipping Code: Enter the RTP|One delivery method code that correlates to this delivery method.
Ship To Address: Check this box if this delivery method requires the customer to provide a shipping address at checkout.
Override Shipping Fee: check this. It is ONLY used for Retail Products and required to apply the shipping cost, which will sell the PHC defined in the rtp-config.json Unity file as a separate line item in RTP|One.
Click Add.
Next, click View Delivery Locations.
Click Add Delivery Location to open the Add Shipping Location page. (The terms ‘Delivery’ and ‘Shipping’ are used interchangeably in Aspenware Commerce.)
Enter the following details:
Name: Enter the name of the delivery location,
Description: This can be left blank.
Shipping Method: Select the associated shipping delivery method (added above).
Code: Enter the RTP|One delivery location Code. All other fields can be left blank(known as Delivery Detail in RTP|One)
All other fields can be left blank.
HINT: For Delivery Location (aka Delivery Detail) codes, you’ll need to retrieve these from the db. Work with your Aspenware representative if you don’t have this access.
Click Add.
...
Click Return to Delivery Methods.
To assign delivery methods to products click Assign Delivery Methods to Products, or to assign delivery methods to the ‘Retail’ category, click Assign Delivery Methods to Product Categories.
Choose the appropriate product from the Product dropdown if assigning to Products, or choose the appropriate category from the Product Category dropdown if assigning to Categories.
Under Delivery Methods, select the delivery method(s) that should be available for the selected category or product. Use Ctrl+Click to select multiple methods. If a product should charge delivery fees, make sure the method selected has a location with delivery fees set up associated with it.
Click Add.
| Info |
|---|
NOTE: For additional information on setting up delivery fees, see the Delivery/Shipping Documentation. |
...
Insert excerpt