Versions Compared

Key

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

Setup Checklist

...

1. POS TASKS

RTP|One

...

If products are taxed exclusively, setup Product Headers for exclusive tax, ensuring it matches what is configured in Aspenware Commerce.

Status
colourRed
titleRequired

...

If products are taxed exclusively, setup Product Headers for exclusive tax, ensuring it matches what is configured in Aspenware Commerce.

Status
colourRed
titlerequired

...

Status
colourBlue
titleoptional

Siriusware

  • If products are taxed inclusively, setup Item(s) for Siriusware inclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    Status
    colourRed
    titlerequired

  • If products are taxed exclusively, setup Item(s) for Siriusware exclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    Status
    colourRed
    titlerequired

  • If you wish to display itemized taxes, ensure that the corresponding products in Siriusware must also be configured with only one tax, at the matching rate.

    Status
    colourBlue
    titleoptional

...

Status
colourYellow
titlePrerequisite

...

2. COMMERCE TASKS

Language String, Setting, HTML widgets

Setting

...

Ensure that shoppingcartsettings.displaytax is set to ‘True.’

Status
colourBlue
titleoptional

...

If configuring taxes by shipping location, set ecommercesettings.taxes.displayitemized to 'True.'

Status
colourBlue
titleoptional

...

Table of Contents

Setup Checklist

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

  • Go to Configuration > Tax Categories.

  • Scroll down to the Add new record section.

  • Enter a Name for the new tax category and Display Order.

  • Click Add new record.

  • Go to Configuration > Tax providers page in Administration.

  • Click Configure next to the Manual (Fixed or By Country/State/Zip) provider.

  • The Tax category created in the previous step will be shown in the Tax category list

  • Click Edit and enter the Rate.

  • Click Update to save. 

  • Return to the Tax providers list and if the updated provider is not already set as the primary provider, click Mark as primary provider for Manual (Fixed or By Country/State/Zip). 

3. Apply Tax Setting to Products

1. POS Tasks

RTP|One

  • If products are taxed inclusively, setup Product Headers for inclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    Status
    colourRed
    titleRequired

  • If products are taxed exclusively, setup Product Headers for exclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    Status
    colourRed
    titlerequired

  • If your resort uses Unity AND you wish to apply taxes by shipping location (only supported for Retail products), the RTP|One administrator must 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.

    Status
    colourBlue
    titleoptional

Language Strings


Set shoppingcart.totals.taxlabel to ‘Tax (Estimate)’

Siriusware

  • If products are taxed inclusively, setup Item(s) for Siriusware inclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    Status
    colourRed
    titlerequired
    Set checkout.totals.tax to ‘Tax’
    titlerequired

  • If products are taxed exclusively, setup Item(s) for Siriusware exclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    Status
    colourRed
    titlerequired

  • Set Messages.Order.TaxRateLine to ‘Tax {0}:’ If you wish to display itemized taxes, ensure that the corresponding products in Siriusware must also be configured with only one tax, at the matching rate.

    Status
    colourBlue
    titleoptional

2. Create Tax Settings

Status
colourYellow
titlePrerequisite

1. Create Tax Rules

Status
colourRed
titleRequired

  • Go to Configuration > Settings > Tax Settings

  • On the Tax settings page, scroll down to the Tax Displaying tab.

    1. To setup exclusive tax, enter the following:

      1. Allow customers to select tax display type: Uncheck  

      2. Tax display type: Select ‘Excluding tax’ 

    2. To setup inclusive tax, enter the following:

      1. Allow customers to select tax display type: Uncheck 

      2. Tax display type: Select ‘Including tax’ 

  • Click Save.

Yellow
titlePrerequisite

2. Commerce Tasks

Language Strings, Settings, HTML widgets

Settings

  • Ensure that ‘shoppingcartsettings.displaytax’ is set to ‘True.’

    Status
    colour

Red
  • Blue
    title

required
optional

  • If configuring taxes for Itemized Taxes, set ‘ecommercesettings.taxes.displayitemized’ to 'True.' (Only supported for Exclusive tax)

    Status
    colourBlue
    titleoptional

  • If configuring taxes by shipping location, set ‘taxSettings.DisplayTaxRates’ to 'True.' (Only supported for Retail products)

    Status
    colourBlue
    titleoptional

  • Language Strings

    4. Display Itemized Taxes to Guest
    • Set ‘shoppingcart.totals.taxlabel’ to ‘Tax (Estimate)’

      Status
      colourRed
      titlerequired

    • Set ‘checkout.totals.tax’ to ‘Tax’

      Status
      colourRed
      titlerequired

    • Go to the Catalog > Products and Search for the desired product. 

    • Click Edit.

    • Scroll down to the Price section on the page.

    • Ensure that Tax exempt is unchecked. 

    • From the Tax category drop-down, select the tax category that applies to the product.

    • Click Save at the top of the Edit product details page.

    • Set ‘Messages.Order.TaxRateLine’to ‘Tax {0}:’

      Status
      colourBlue
      titleoptional

    Status
    colourYellow
    titlePrerequisite

    1. Create Tax Rules to be either Inclusive or Exclusive

    Status
    colourRed
    titleRequired

    2. Create Tax Settings

    Status
    colourBlueRed
    titleoptional

  • Ensure that itemized taxes in your store are enabled (See Settings above) so that Tax Category Name is used for tax labels displayed in the store.

  • Tax Category Name is configurable, so the administrator can choose a meaningful label to display to the guest. To configure a tax category name, go to Configuration > Tax Categories.

  • Click Edit to update the names as desired.

  • Click Update.  

  • Add the applicable tax to all taxable products in your store.

    required

    • Create Tax Category

    • Configure rate for each Tax Category

    • Assign a primary Tax Provider

    3. Apply Tax Setting to Products

    Status
    colourRed
    titlerequired

    4. Display Itemized Taxes to Guest

    Status
    colourBlue
    titleoptional

    Status
    colourGreen
    titleDetailed Setup

    ...

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

    POS Tasks

    RTP|One

    • If products are taxed exclusively, setup Product Headers Header(s) for exclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    • If products are taxed exclusivelyinclusively, setup Product Headers for exclusive Header(s) for inclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    • If your resort used uses Unity AND you wish to apply taxes by shipping location, the RTP|One administrator must 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 you wish to display itemized taxes, ensure that the corresponding products in RTP|One must also be configured with only one tax, at the matching rate.

    Siriusware

    • If products are taxed inclusively, setup Item(s) for Siriusware inclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    • If products are taxed exclusively, setup Item(s) for Siriusware exclusive tax, ensuring it matches what is configured in Aspenware Commerce.

    • If you wish to display itemized taxes, ensure that the corresponding products in Siriusware must also be configured with only one tax, at the matching rate.

    ...

    • To display tax in the cart during checkout, go to Configuration > Settings > All Settings (advanced) and add the following setting and value if it doesn’t already exist. 

    ...

    • (Optional) To enable itemized taxes in your store, go to Settings > All Settings (Advanced), search for the ecommercesettings‘ecommercesettings.taxes.displayitemizeddisplayitemized’ setting and set it to True‘True’. Click Update. If you also want the Tax Category Name to be displayed on the confirmation letter, set TaxSettings‘TaxSettings.DisplayTaxRatesDisplayTaxRates’ to ‘True’ as well.

    Setting

    Value

    ecommercesettings.taxes.displayitemized

    True

    taxSettings.DisplayTaxRates

    True

    ...

    • To configure the language string for the tax component of the shopping cart, go to Configuration > Languages, select to Edit English, and select the String resources tab. Add the following language strings if they don’t exist:

    ...

    • (For Displaying Itemized Taxes) If you use a % at the end of the tax category name be sure to edit the following Language String to remove the % from the Value. Go to Configuration>Languages select to Edit English, and select the String resources tab. Search for the following string and configure as shown (remove the %.)

    String resource

    Value

    Messages.Order.TaxRateLine

    Tax {0}:

    Tax {0}:

    Detailed Setup Guide

    Insert excerpt
    AE:Detailed Setup Guide Excerpt
    AE:Detailed Setup Guide Excerpt
    nopaneltrue

    1. Create Tax Rules

    2. Create Tax Settings

    3. Apply Tax Setting to Products

    4. Display Itemized Taxes to Guest (Optional)

    Info

    NOTE: For information on tax setup within the retail configuration, see the Retail Configuration Documentation section within the appropriate Legacy Documentation for your POS.

    1. Create Tax Rules

    This step configures whether the store will use and display inclusive tax or exclusive tax across the store. 

    Info

    NOTE: An online store can only display inclusive or exclusive tax to customers and doesn’t support displaying tax for both products with inclusive tax and exclusive tax. If both tax types (inclusive and exclusive) are required, it is recommended to set up the store for exclusive tax and to price products that are inclusive of tax with inclusive tax in RTP|One only. In this scenario, exclusive tax will be calculated and displayed to the customer in the online store, but products with inclusive tax will not show the inclusive tax on the shop; however, if the price of the product in the shop is inclusive of tax and the product in the POS is setup for inclusive tax will not show the inclusive tax on the shop, taxes for these products will be calculated correctly in the POS.

    Determine which of the following two options are desired for your store:

    1. Exclusive Tax: Exclusive tax amount is available for display in the cart, checkout and confirmation pages and email. The order total is the sum of the subtotal and tax on the order.

    2. Inclusive Tax: Inclusive tax amount is available for display in the cart, checkout and confirmation pages and email. The order total is the sum of the subtotal and the tax on the order included in the price of the products.

    • Go to Configuration > Settings > Tax Settings

    • On the Tax settings page, scroll down to the Tax Displaying tab.

      1. To setup exclusive tax, enter the following:

        1. Allow customers to select tax display type: Uncheck  

        2. Tax display type: Select ‘Excluding tax’ 

      2. To setup inclusive tax, enter the following:

        1. Allow customers to select tax display type: Uncheck 

        2. Tax display type: Select ‘Including tax’ 

    • Click Save.

    2. Create Tax Settings

    • Go to Configuration > Tax Categories.

    • Scroll down to the Add new record section.

    • Enter a Name for the new tax category and Display Order.

    • Click Add new record.

    • Go to Configuration > Tax providers page in Administration.

    • Click Configure next to the Manual (Fixed or By Country/State/Zip) provider.

    Info

    NOTE: Unless configuring tax for Retail products, set this to 'Fixed rate.'

    • The Tax category created in the previous step will be shown in the Tax category list

    • Click Edit and enter the Rate.

    • Click Update to save. 

    • Return to the Tax providers list and if the updated provider is not already set as the primary provider, click Mark as primary provider for Manual (Fixed or By Country/State/Zip). 

    3. Apply Tax Setting to Products

    • Go to the Catalog > Products and Search for the desired product. 

    • Click Edit.

    • Scroll down to the Price section on the page.

    • Ensure that Tax exempt is unchecked if the product is taxed. 

    • From the Tax category drop-down, select the tax category that applies to the product.

    • Click Save at the top of the Edit product details page.

    4. Display Itemized Taxes to Guest (Optional)

    Aspenware Commerce supports displaying itemized taxes to the guest. Using this feature enables the Aspenware Commerce Administrator to break out taxes store to display taxes broken out by tax category in the cart, order summary, and confirmation letter. Follow these steps to enable itemized taxes and customize your tax category names.

    ...

    • Ensure that itemized taxes in your store are enabled (See Settings above) so that Tax Category Name is used for tax labels displayed in the store.

    • Tax Category Name is configurable, so the administrator can choose a meaningful label to display to the guest. To configure a tax category name, go to Configuration > Tax Categories.

    • Click Edit to update the names as desired.

    • Click Update.

        

    • Add the applicable tax to all taxable products in your store (See Step 3 above.) For example, if lift, lesson, and pass products all carry a tax rate of 5%, and rental products are taxed at 12%, you need to configure two taxes tax categories and assign the 5% tax to lift, lesson, and pass products, and the 12% tax to rental products.

    Info

    NOTE: Aspenware Commerce supports one tax per product, so ensure you have one tax rate configured for all your applicable tax rates for each product type.

    ...