Order Processing
   Create Batch
   Batch Name
   Run Report
   Process Orders
      CyberCash
      Other 3rd Party Payment Vendors
   Delete Batch
   Un-batched Orders
   Edit Order
Utilities
   Import Data
      Importing Products From Flat Files
         To Begin
         Product Code
         Product Name
         Thumbnail Image URL
         Fullsized Image URL
         Price
         Weight
         Taxability
         Description

    KoolKat  v1x  Data Import
         Import Look & Feel Settings 
         Create Top-Level Categories 
         Import

    Export Data
       Batch to Export
       Export Orders To File
       If File Exists
       Delimiter
       Export
         Retrieve the Flat File

   Delete Expired Shopping Baskets
   Pack Data Files

Utilities
   Pack Data Files

Existing Site Integration

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.

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.

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. 

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)

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.

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.

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.

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.

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.yourdomain.com/htsdata/koolcat.conf
http://www.yourdomain.com/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.yourdomain.com/htsdata/anyfile
http://www.yourdomain.com/htsdata/anyfile

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.

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. 

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.
 

Pack Data Files
Click on this option to pack the data files for your store.

• 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.