Try our new AI assistant by clicking the chat icon in the lower right corner.


Colorado Retail Delivery Fee

Overview

Starting July 1st 2022, Colorado started imposing a Retail Delivery Fee per shipment to Colorado. You can read more about this fee here to see if it applies to your business:

https://tax.colorado.gov/retail-delivery-fee

Supporting this Fee in Miva

This fee can easily be added to any Colorado order using the following template code. This code has the following logic:

  1. - If the order is being shipped Colorado
  2. - And the basket as at least 1 taxable item
  3. - And the customer is not Tax Exempt
  4. - Then insert a separate basket charge in the basket for fee amount found at https://tax.colorado.gov/retail-delivery-fee

This code should be added anywhere on the OSEL page in Miva, such as the page Header.

Note

Be sure to update the ADD_FEE_AMOUNT_HERE value in the snippet with the correct value found at https://tax.colorado.gov/retail-delivery-fee



OSEL ADMIN

Example of the template code placed in the OSEL header.

Note

If your store offers in store pickup in Colorado or digital products such as gift cards or digital downloads, this fee is not required. Additional logic could be applied to this charge to not add it if those scenariors apply to you. Please contact your developer to customize this logic if this applies to you.

Once the fee is added it will show in the basket contents on the final step of checkout (OPAY) and be shown as a separate line item in the order as well as confirmation emails.

OSEL Frontend

Example of Retail Delivery Fee on order after it has been applied during checkout

Order Processing

Example of the Fee on the Order from within the Miva admin

Limitations to this Solution

Since this fee gets added via template code logic on OSEL (Payment and Shipping Selection) page during the Miva Checkout, if your site has 3rd Party Checkouts which bypass Miva's Checkout process this fee will not be applied.

This fee will also not be applied to orders created within the admin or via the JSON API.

Examples include:

  1. - Apple Pay
  2. - PayPal Express Checkout (PayPal Commerce Platform)
  3. - Amazon Pay (though this code can be added to this Checkout Experience)

Alternate Solution - Miscellaneous Fee Module

If you're not comfortable editing template code, there is a module-based solution using the Miscellaneous Fee module

https://apps.miva.com/miscellaneous-fee.html

This module allows you to setup the fee in the module configuration settings and does not require any template code updates.

Note

When using this module, it does not have a way to limit/restrict the fee for non-taxable items or non-taxable customers. The fee will always be added to every Colorado order. If you have non-taxable (wholesale) customers or non-taxable products that ship to CO, the template code solution above will be a more robust solution.

Note

When using this module, it does not have a way to limit/restrict the fee based off shipping method. The fee will always be added to every Colorado order. If you have features like gift certificates, digital downloads, or store pickup the template code solution above will be a more robust solution.

misc fee

Example Settings to configure the fee using the Miscellaneous Fee Module


order charges

Display of the Fee on the Order

AvaTax & TaxJar

TaxJar

TaxJar does not view this fee as a tax and therefore is not supporting it. If you currently using TaxJar, you will need to implement one of the solutions above.

AvaTax

Avatax is supporting this fee, but it will require some changes to Miva's integration to AvaTax.

https://help.avalara.com/Frequently_Asked_Questions/AvaTax_FAQ/ACTION_NEEDED%3A_Colorado_Retail_Delivery_Fee_begins_July_1%2C_2022

While we do have plans to update the Miva integration with AvaTax to support this, it won't be completed by July 1, 2022. It is recommended you implement one of the solutions above to support this in the near term.

Longer Term Support for 3rd Party Checkouts

Since the solutions above don't handle 3rd party checkouts (Apple Pay, PayPal Express Checkout via PayPal Commerce Platform) we are exploring additional solutions where the tax module themselves can assess this fee. This would allow the fee to be applied when Apple Pay or PayPal call Miva to calculate Taxes. We will send out additional communication when these changes are supported.

Looking for Developer Docs?

We have a whole section for that, including: Developer Training Series, Template Language docs, Module Development tutorials and much, much more.

Head to the Developer Section

This website uses cookies to identify visitors, track visitors to our website, store login session information and to remember your user preferences. By continuing to use this site you agree to our use of cookies. Learn More.

This website uses cookies. By continuing to use this site you agree to our use of cookies. Learn More.

Accept

Copyright © 1997 – 2021 Miva©, Miva Merchant©, MivaPay©, MivaCon© Miva, Inc. All Rights Reserved.