Miva Docs: Miva 10 Reference Guide

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

Miva Docs
Reference Guide
Miva 10 Reference Guide | Order Processing

Address Valdation

Miva 10 introduces native address validation which supports validating against USPS or UPS data. Once enabled, the address the customer enters during checkout will be validated in real-time and the customer will be presented with any suggested changes before they continue.

By default only the validated shipping address is presented to the customer however, it's possible to have both the shipping address as well as the billing address validated and let the customer choose both.

Setup and Configuration

Miva supports two data sources for Address Validation by default. UPS and USPS, One of these two shipping modules must be installed for the address validation to work. Shipping rates do not need to be displayed to use address validation.

Once either of the shipping modules has been installed in a store, enabling address validation can be done under Shipping Settings -> Setting -> Shipping Rules.

Note: A valid shipping module must be installed to see options in the Address Validation list.

In addition to choosing the data source, there are two additional options which are both selected by default:

Validate Addresses at Checkout – If enabled when the customer enters their address during checkout (OCST) and clicks continue, they will be required to pick a validated address before continuing to the next page.

Validate Customer Address – If enabled, when a customer is logged in and adds a new address in their address book, Miva will first validate the address before saving and force the customer to choose a validated address (or accept the original).

Template Changes

Template changes are required for address validation to work. Default CSSUI template changes for address validation can be found here: https://www.miva.com/template-changes

Since Miva 10 now ships with and defaults to the Shadows ReadyTheme, the template changes it implements for Address Validation are likely what most customers will want to implement.

Shadows stores the Address Validation code in a Content Section Theme Component:

This item should be added to the following pages:

		
<mvt:item name="readytheme" param="contentsection( 'address_validation' )" />

OCST, ACAD, ACED, CADE, CADA

Customer Experience

With address validation enabled, when a customer enters their billing and shipping address, it will via validated against the data source (USPS, UPS) set in the configuration.

By default in the Shadows ReadyTheme, this information displays in a modal lightbox on the page, however its possible to customize this layout and experience.

If more than one address is sent back, multiple suggested addresses will be displayed:

If enabled, the customer address will also be validated when a logged-in customer adds an address to their address book.

Admin Address Validation

Miva 10 also supports address validation when manually creating or editing an order from within the Miva admin:

Note: With address validation enabled, any change to the customer information in the admin will re-trigger the address validation.

When adding a customer account manually via the Miva admin, there is an option to validate an address:

International Address Validation

Currently, both USPS and UPS offer address validation for only US addresses. International address validation is not supported at this time.

Building Custom Address Validation Integrations

The Miva address validation API is extensible to allow for custom integration to any address validation service. Below is an example of the function required to implement the address validation feature in your module:

10.01.00 Address Validation Bug Fix

10.01.00 fixes a UPS bug where incorrect permissions were being issued to the UPS Access Key in the setup Wizard. Now in 10.01.00 there is a link you can click to request address validtion permissions. Once granted you can see the status as Active. For all new setups of the UPS module, the correct permissions for Address Validation will automatically be created and no additional steps are needed.

Stores which use UPS and upgrade to 10.01.00 will be presented with a link to relaunch the UPS Developer Kit Registration in order to request Address Validation permissions.

Recalculate Shipping

Miva 10 creates a new button for the ability to re-calculate shipping. This is used to request new shipping rates, as well as request a new Tax charge if an order has changed:

When a new shipping rate is selected, it will be added to the order and the tax will be re-calculated.

Recalculate Sales Tax

The Miva Admin now provides users with a dedicated button on the order detail screen that allows them to force the tax on the order to be recalculated. Previously, tax was always recalculated when shipping was recalculated, and this still occurs, but now users have a dedicated button to force just the tax to be recalculated.

This update allows users to manually change shipping or other charges, and then force the tax to be recalculated to reflect those changes.

For stores using a third-party tax service like TaxJar or Avalara, using the Recalculate Tax button will send the current state of the order to those services, which will send back the correct sales tax.

Clear Shipping on Cancelled Order

The Miva Admin can automatically clear shipping costs when an order is canceled. Previously, when an order was canceled, the user would have to go into the admin and manually remove the shipping charge, or set it to zero, so that the order reflected a zero dollar transaction.

With this update, users can enable “Remove Shipping from Cancelled Orders” in the Marketing Settings tab, Discount Options section, and the admin will automatically remove the shipping for cancelled orders.

This setting is off for upgraded stores, and will need to be manually configured, but it on for new Miva installs.

Item Lookup

Miva 10 introduces a brand new way to add an item to any order. If an item as attributes, they will automatically be displayed as drop-down menus once a valid item is selected:

Having the attributes displayed as drop-down menus gives a better experience if the available attribute/option values are unknown.

Customer attributes are still allowed to be added in required.

Payment Transactions List

Miva 10 now gives access to a list of all payment transactions across every order. This includes authorizations, captures, voids, and refunds. This full list of payment transactions gives you an easy way to export payment data across all orders.

There are also batch actions you can run for:

Capture
Refund
Void

The full bill to and ship to fields are available as on-demand columns so you can build a view with the most relevant data to you.

Authorization Failures

This change will extend the existing authorization failure to capture additional information from the basket and display it on the Authorization Failures batchlist within Order Processing.

Order Processing > Authorization Failures

Also a new column has been added to the Review Baskets batch list for payment failures.

Review Baskets - Payment Faliure Column
Review Baskets Payment Failures

Unship Shipments / Split Shipped Shipments

There is now more flexibility when working with shipments in Miva 10. Shipments have been expanded to include two new features:

1. Remove Items From Shipments

Any shipment which has not been marked as shipped can have items removed. When you select an item that is part of a shipment, there is now a “Remove From Shipment” button to take the item out of the shipment and back into a pending state.

2. Split Shipped Shipments

This is useful when a shipment has 2 or more of the same item and only one of them is being returned. This feature will take the shipped shipment and split it out into multiple shipments and then one can be marked as returned.

Single Shipment with 2 items

2 Shipped Shipments Each with 1 item

Now that there are two shipped shipments, one of them can be Returned without impacting the other item.

Add/Edit Subscriptions

The Add/Edit subscription dialog in the admin has been re-designed for better usability and easier use.

This includes a new item lookup as well as a new date/time picker.

Batch Capture Progress Dialog

Improved handling has been added when doing bulk actions such as capturing on a group of orders. This includes a brand-new batch capture progress indicator for better visibility into progress and errors.