Importing Your Store into UltraCart

UltraCart provides two import utilities to help you migrate your existing online store:
one for WooCommerce and one for Shopify. Both utilities are accessed from
Home → Configuration in the UltraCart merchant console.

Each importer can bring over customers, items (products), your catalog structure, and
historical orders. Shopify additionally supports importing blog articles. Imports can be
run more than once — you can start with customers and items, verify the results, and
then re-run the utility to bring over catalog and orders.

WooCommerce Import

What it does

The WooCommerce importer connects to your live WooCommerce store over the REST API
using a set of API keys. Depending on the options you select it will:

Pull your customers into UltraCart's customer database.
Pull your products (including variations) into UltraCart's item catalog.
Pull your product categories and build them into an UltraCart StoreFront catalog,
with products placed into the appropriate categories.
Pull your historical orders and re-create them as placed orders in UltraCart so
your reporting and customer order history carry forward.

The importer will show live progress as it runs and produces a log you can review.

Before you start — generate WooCommerce API credentials

UltraCart authenticates against WooCommerce using a REST API key pair, not your
normal WordPress admin login. To generate one:

Log in to your WordPress / WooCommerce admin.
Go to WooCommerce → Settings → Advanced → REST API.
Click Add Key, give it a description, choose a user with sufficient
permissions, and set permissions to Read (or Read/Write).
WooCommerce will display a Consumer Key (starts with ck_) and
Consumer Secret (starts with cs_). Copy both — the secret will not be shown
again.

Full WooCommerce documentation:
WooCommerce REST API

Filling out the configuration screen

Field	What to enter

Field	What to enter
API Username	Your WooCommerce Consumer Key. Must begin with `ck_`.
API Password	Your WooCommerce Consumer Secret. Must begin with `cs_`.
Hostname	The hostname of your WooCommerce store (for example `www.mystore.com`). Do not include `<https://`> or a trailing path.

When you submit the form, UltraCart will do a quick credential check against your
WooCommerce site. If the keys or hostname are wrong, you will see an error and nothing
will be imported.

Checkbox options

Import Customers — Imports every customer record from WooCommerce into
UltraCart's customer database.
Import Items — Imports every product (and each variation of a variable product)
as an UltraCart item. Existing items that were previously imported from WooCommerce
are matched by their WooCommerce product/variation ID and will not be duplicated.
Import Catalog into StoreFront — Imports WooCommerce product categories and
builds them into a StoreFront catalog, associating the imported items with the
correct categories. This option requires selecting a target StoreFront from the
drop-down. You must also import items (either in this run or a prior run) for the
catalog to be populated.
Import Orders — Imports historical orders from WooCommerce. Each imported order
is tagged with its original WooCommerce ID so it is not imported twice if you re-run.

You must select at least one of the four checkboxes.