- Reference Guide
- Miva Reference Guide
- PageBuilder
-
- Customers - Create a Customer Account
- Customers - Customers Batch List
- Customers - Customer Dashboard
- Customers - Customer Tax Exempt
- Customers - Shop as Customer
- Customers - Last Password Changed
- Customers - Customer Quick Add
- Customers - Business Accounts
- Customers - Customer Settings
- Customers - Availability Groups
-
- Creating a New Order
- Working with Orders
- Order and Order Item Statuses
- Processing Returns and Refunds
- Address Validation
- Recalculate Shipping
- Item Lookup
- Payment Transactions List
- Authorization Failures
- Unship Shipments/Split Shipped Shipments
- Add/Edit Subscriptions
- Batch Capture Progress Dialog
- Transactions
-
- Expanded Search Rules (Full Text Search)
- Copy Price Group
- Geographic Shipping Restrictions
- Exclusion Rule Caching
-
- Price Groups - Global Settings
- Price Groups - Qualifying/Discounting
- Price Groups - Structure/Priorities/Relationships
- Price Groups - Legacy
- Price Groups - Add-on Product
- Price Group - Basket Discount
- Price Group - Basket Discount (Specific Products)
- Price Groups - Buy X Get Y
- Price Groups - Markup from Cost
- Price Groups - Product Discount
- Price Groups - Customer Specific Pricing
- Price Groups - Specific Sale Price
- Price Groups - Shipping Discount (Entire Order)
- Price Groups - Shipping Discount (Discounted Products Only)
- Price Groups - Volume Pricing
- Price Groups - Using Coupons
- Price Groups - Via Template Code
- Marketing Settings
-
- Sort Order History by Status
-
- Page Builder - Upgrade Process
- Page Builder - General Overview
- Page Builder - Creating a New Page
- Page Builder - Page Settings
- Page Builder - Navigation Drop Down
- Page Builder - Mobile Tablet Desktop Preview
- Page Builder - Scheduling in Page Builder
- Page Builder - Pushing Your Page Live
- Page Builder - Template Branch Preview
- Page Builder - Components Overview
- Page Builder - Markdown Authoring
- Page Builder - Global Components
- Page Builder - Hero Banner Component
- Page Builder - Text Banner Component
- Page Builder - Image Across Component
- Page Builder - Text Area Component
- Page Builder - Image and Text Component
- Page Builder - Video Component
- Page Builder - Hero Slider Component
- Page Builder - Rich Text Editor Component
- Page Builder - Product Carousel Component
- Page Builder - Featured Product Component
- Page Builder - Category Carousel Component
- Page Builder - Quick Order Flex Component
- Page Builder - Combination Facet Flex Component
- Page Builder - Accordion Component
- Page Builder - Contact Form Component
- Page Builder - Enhanced Product List
- Page Builder - Header-Footer
- Page Builder - Component Text Settings
- Page Builder - Style Guide
- Copy Page
-
-
- Manage Quotes - Overview
- Manage Quotes - Installation
- Manage Quotes - Quote Page Templates
- Manage Quotes - Using Manage Quotes
- Manage Quotes - Quote Notes
- Manage Quotes - Working with Quotes
- Manage Quotes - Excluding Quotes from Price Groups
- Manage Quotes - Quote Expiration and Follow Up Emails
- Manage Quotes - Price Groups
- Manage Quotes - Quoted Shipping
- Miva Connect
Try our new AI assistant by clicking the chat icon in the lower right corner.
- Miva Docs
- Reference Guide
- Colorado Retail Delivery Fee
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:
- - If the order is being shipped Colorado
- - And the basket as at least 1 taxable item
- - And the customer is not Tax Exempt
- - 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
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.
Example of Retail Delivery Fee on order after it has been applied during checkout
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:
- - Apple Pay
- - PayPal Express Checkout (PayPal Commerce Platform)
- - 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.
Example Settings to configure the fee using the Miscellaneous Fee Module
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.
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.