Return to Main
Index
Fulfillment
Modules
Unlike the Payment and Shipping modules, only one
Fulfillment module may be selected per store. Click on the
small blue arrow next to Fulfillment Module to expand the
sub-menu.
Add
Fulfillment Module
Click on Add Fulfillment Module and select the
module from the drop-down menu. Click on the Add button to
add the module to your store.
Email
Merchant Notification
This module allows you to setup an email which
will be sent to a single email address, or a list of email
addresses, along with a custom message about each order.
The portions of the email that you may configure are displayed
in this form.
 | From |
Customer's Billing Email Address
Select this option if you wish the return
address on the email to be the customer's email address.
Other:
Choose this option and enter a specific
email address you wish to be displayed in the From field of
your notification email.
| To |
Enter the email address (or multiple email
addresses, separated by a comma) of those you wish to
receive notification of orders. This might be yourself,
and/or selected employees.
| CC:
(optional) |
Enter the email address (or multiple email
addresses, separated by a comma) of those you wish to
receive a copy of the notification of orders. This might be
yourself, and/or selected employees.
Return to Main
Index
Back to Top
| Add Angle Brackets to Email... |
Select this box if you want angle brackets
added to email addresses.
| Subject |
Enter the subject for your emails
here. Use text only, no HTML.
| Mail Host |
Enter a valid SMTP server here.
| Header Text
(Precedes Order Information) |
Enter header text here. This will be
displayed above all information collected from the order
form except for credit card information. See the
section on Order Processing for how to collect that
information. Use plain text only, no HTML.
Order Processing
New Orders placed in your store are first displayed
in a list under Un-batched Orders.
'You then Create Batch from those orders, and
then perform your other processing procedures.
Create Batch
To create a batch from the unbatched orders, click
on Create Batch. Enter a name for the batch in the field
provided. This may be any name you choose, or a number
you select. The date the batch is created will be displayed along
with the name you designate.
Return to Main
Index
Back to Top
Batch Name
Your newly created batch will be listed by the
name you give it beneath Create Batch. Click on the small
blue arrow next to the Batch Name to expand it's sub-menu.
Run Report
Click on Run Report to display the Report
form. Select Standard Batch Report from the drop-down list
and click on the Run button. A report of the orders in the
batch will be displayed for printing and/or viewing.
Process Orders
Click this option to display a list of orders in
the current batch that need to be processed. Next to each
order will be two buttons, Process, and Mark as
Processed. What occurs when these buttons are selected
depends on what payment modules you are using. If you have
selected the Check and/or Credit Card with Simple Validation
modules the system simply marks the order as processed. It
does NOT bill a credit card account.
CyberCash
If you have a CyberCash account and have the
CyberCash payment module installed and setup, then it will
perform credit card authorizations, or validations, at
the time the order is submitted. However, they do not do
the actual credit card billing until you Process the order
from the Process Orders option in the Administration interface
(admin.mv)
Return to Main
Index
Back to Top
Other
3rd Party Payment Processing Vendors
Currently, all other payment processing
modules require that you use their system for processing
orders. Detailed instructions for how to setup and
process these modules is available from each vendor
separately.
Delete Batch
Use this link to delete a batch and all of the
orders it contains. Deletions are permanent and cannot be
reversed.
Un-batched
Orders
Click on the small blue arrow next to Un-batched
Orders to display all orders currently un-batched.
Once you create a batch for the orders in Un-batched Orders, they
will be removed from this file and displayed in the batch you
created..
Edit Order
To view or edit an order click on the listing to
load the Edit Order screen for that order. When you are
finished viewing and/or editing the order, click on the Update
button to save any changes. Click on the Delete button to
delete the order.
Return to Main
Index
Back to Top
Utilities
Click on the small blue arrow next to Utilities to
expand it's sub-menu.
Import Data
You may import data directly into your Miva
Merchant either from flat files, or from an existing KoolKat
system.
Importing Products From Flat Files
This option allows you to import your products
from existing flat text files rather than entering them one at a
time. Your flat file may be created in any plain text,
spreadsheet or database editor which can write to a plain text
file. These editors include but are not limited to the following:
Microsoft Excel/Access
FileMaker Pro
SimpleText
Wordpad (save as ASCII test)
VI or VIM
HotMetaL Pro
BBEdit
NotePad
DOS Edit
To Begin
Look at the Add Product form in Miva Merchant.
Following is a list of the fields from that form that can be
filled with an import, and the types of data that will work in
each.
Product Code
Text, including spaces, and or numbers. No
HTML
Product Name
Text, including spaces, and or numbers. No
HTML
Thumbnail
Image URL
Text, file path characters. No HTML, no
quote marks or apostrophes.
Fullsized
Image URL
Text, file path characters. No HTML, no
quote marks or apostrophes.
Return to Main
Index
Back to Top
Price
Decimal numeric data only. No currency
punctuation such as dollar signs, and no text.
Weight
Decimal numeric data only. No text
Taxability
"Yes", "True" (not case
sensitive) and positive whole numbers will mean that the item IS
taxable.
Any other text string, a blank field, zero, and
any numbers other than positive whole numbers will mean that the
item is NOT taxable.
Description
Text, HTML, or any other code understood by a
browser such as Javascript.
In addition to the above fields, you may add
a field containing the category code of an existing Category.
(You MUST create the Category in Miva Merchant before importing
the data for this to work) Otherwise, all products will be
imported into the Uncategorized Products file.
Note: Attribute information can not
be imported with a flat file import.
Return to Main
Index
Back to Top
Import Products
Once you have your file ready, click on the Import
Products From Flat File link to display the Import Products form.
 | Data File |
If the file is already on your server in the top
Miva Data directory, select Import Products From a File Already
on the Server, and enter the full name of the file only.
Be sure to add the file extension. For example filename.dat or
filename.txt. If your file is not in the top Miva Data
directory you must enter the full path to the file, including
the file name. For example, import_files/directory/filename.dat
| Upload
Product Flat File |
If the file is on your local computer select
this option, and click on the Browse button. Browse
the files on your local computer to your flat file, and click
Open. Click Next and the file will be uploaded to
the proper location on your server automatically.
| Delimiter |
Be default Miva Merchant will look for a tab
delimiter between the data fields in each record. If your import
file uses a different delimiter between fields, select Other
and enter the exact delimiter used for your file into the entry
field.
| Next |
Click on the Next button to pull up the
next form you must fill out. Note that the path to the
data file will be at the top of this form.
If
Products Being Imported Already Exist
If you are importing products into an empty store,
leave this setting at the default Keep the Existing Products as
there will be no existing products to be concerned about.
Otherwise, you should designate how possible
duplications are handled.
Keep
Existing Products
Select this option to import products that are
not already in your store, and leave the existing products as
they are.
Replace
the Existing Products
This will replace existing product records with
the new data imported for all products that have matching
product codes. Any null, or empty fields in the new
product data imported will overwrite existing fields with a
blank. This option will not "update" specific fields.
The entire record will be replaced.
Caution!
Do NOT use this option if attribute
information has been added to the products in Miva
Merchant. Attribute information will be erased.
Use the Update The Existing Products option instead.
Return to Main
Index
Back to Top
Update
The Existing Products
Use this form to select the specific fields you
wish to update. Select *Skip* for those fields you do not
want updated. Only the information in the selected fields
that is different from the existing file will be changed.
Everything else will be left as is. Note: You MUST always
select the Product Code FIRST as this is the field that Miva
Merchant will use to search for and identify each record to
update.
KoolKat
v1x Data Import
If you have an existing KoolKat system you can
migrate it into Miva Merchant quickly and easily. This
import utility will rewrite the KoolKat data in a new format, but
the data itself will not be altered. However, even though this
process is simple, you may wish to make a backup copy of
your KoolKat files before you begin.
Click on the KoolKat v1x Data Import link to
pull up the import form.
Path to koolcat.conf
Your koolcat.conf file is the file you will
migrate. However, you must follow the directions for this
carefully.
| IF your koolcat.conf file is inside a
top level miva directory (htsdata or mivadata) that is
directly under your home directory and not inside another
subdirectory, then leave this field blank. |
Example: If the path to your
koolcat.conf looks something like either of the following
examples, leave the field blank.
http://www.yourdomainname.org/htsdata/koolcat.conf
http://www.yourdomainname.org/mivadata/koolcat.conf
| IF your koolcat.conf file is inside a
sub-directory of htsdata or mivadata, then enter the path
to that sub-directory, but do NOT include the name of the
file itself, koolcat.conf |
Example: If the path to your
koolcat.conf file is inside a file named "anyfile"
that is inside a top level miva directory, you would enter
something like one of the following:
http://www.yourdomainname.org/htsdata/anyfile
http://www.yourdomainname.org/htsdata/anyfile
Return to Main
Index
Back to Top
Import Look & Feel Settings For:
If you wish to import the KoolKat Look and Feel
Settings (color scheme background text etc,) for your store,
then leave the Stores box checked.
If your store is configured for KoolKat Look
and Feel and you want to use the graphics currently in your
KoolKat catalog, be sure the Catalogs box is checked as
well.
Important Note: If you use
graphics in your KoolKat catalog, and want those graphics to be
imported and used for your Miva Merchant catalog you MUST
go to Edit Store and set your store to KoolKat Look and Feel
before you perform your migration. If you do not do this, and
your store is in Miva Merchant Look and Feel when you perform
the migration, all graphics will be discarded the first time you
switch from Miva Merchant Look and Feel to KoolKat Look and
Feel. However, setting it to KoolKat Look and Feel first
will make the graphic migration permanent, and you will be able
to switch back and forth as often as you like afterward.
Create
Top-Level Categories For Each Catalog
You may have more than one catalog in your
KoolKat system, each with multiple categories. This option tells
Miva Merchant how to handle your catalogs.
This box is checked by default. It will turn
each of your KoolKat catalogs into top-level categories, with
each of the catalog categories listed as sub-categories beneath
it.
If you have only one catalog in your KoolKat
system you will most likely want to uncheck this box to avoid
creating unnecessary categories.
If you have multiple catalogs in your KoolKat
system and want all categories in all catalogs to be parallel,
top-level categories, uncheck this box.
Return to Main
Index
Back to Top
Import
When you have finished making your selections on
the import form, click the Import button to perform the import.
Export Data
Click on the small blue arrow to expand the
sub-menu. There will be one option, Export Orders To Flat
File.
Click on it to pull up the Export Orders to Flat
File form. This will allow you to export a selected batch
to a flat file in either the htsdata or mivadata folder on your
server.
 | Batch to
Export |
Select the batch to export from the drop-down
menu.
| Export
Orders To File |
Enter a name for your file in the entry field.
| If File
Exists |
If this file name already exists select
whether you wish this file added to the existing one, or if
you wish this file to replace the existing one.
| Delimiter |
Choose a delimiter. This is what
will separate the different items of information in the file.
For example, a tab, or a comma are common delimiters. This may
depend on the type of program you will be using.
| Export |
Click this button to export the file.
Retrieve
the Flat File
Using FTP transfer the orders.dat file
from the htsdata or mivadata folder on your server onto your
local computer. You may then open it in a text editor such
as Notepad. You may also open the file in a spreadsheet
program such as Excel, or a data management program. Refer
to the instructions for your software for how to handle and
process flat data files.
Return to Main
Index
Back to Top
Delete
Expired Shopping Baskets
Click on this option to delete expired shopping
baskets from your server.
Pack Data Files
Click on this option to pack the data files for
your store.
Utilities
Click on the small blue arrow to expand the
Utilities sub-menu.
Pack Data Files
Click on this option to pack the data files for
your store.
Existing Site Integration
Integrating Miva Merchant into your existing website
is as simple as adding the relevant hyperlinks to your web
pages.
| First, setup your Miva Merchant system, and
add your products. |
| Then, click on your store name to pull up the
Edit Store form. |
| Click on the small web icon at the top
of the form. A window will open displaying all of the
hyperlinks for your store. You can click on the links to see
exactly where they will take you....and your customers. |
| Copy/paste those links to your web pages where
you want them to be. This will connect your website to the
Miva Merchant pages. |
| Do the same for other edit pages in Miva
Merchant, such as categories and products. |
Return to Main
Index
Back to Top |