- Address Validation
- Recalculate Shipping
- Item Lookup
- Payment Transactions List
- Authorization Failures
- Unship Shipments / Split Shipped Shipments
- Add/Edit Subscriptions
- Batch Capture Progress Dialog
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 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
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.
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.
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:
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.
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
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.
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.