Skip to end of metadata
Go to start of metadata

The Mitek Sapphire File option allows you to import a Mitek Sapphire xml file containing product and customer delivery detail information into a Sales Order. The imported products are compared to your system Product Master File.

If the .xml file contains product details, the following information is imported: the Product No., Quantity, UOM, Unit Price, Disc %, Usage & Tally details (if a tally product).

(info) If the Product No. exists in your Frameworks system, however, there is a product mismatch when the import has completed, a "Resolve Product Mapping" screen is displayed containing products that were imported, however require further attention. Refer to step 8 below.

(info) Multiple imports of the same product are consolidated. If there are multiple tallies for the same product, these are also consolidated.

(info) Products containing Alternate Codes (setup against the Product) in the .xml file will be imported with the Product Code, not the Alternate Code.

If the .xml file contains customer details, the following information is imported: the Customer Order No., Deliver To, Address, Suburb/City & State, Instructions, Contact Name & Contact Phone are imported. (warning) The Customer No. & Date Required fields are not imported.


To import a Mitek Sapphire xml file containing product details and/or customer details, from the home Dashboard perform the following:

1. Click  then type Sales Orders (or select Sales Orders from within the Sales - Transaction Processing navigation tree).

2. Click to create a new Sales Order, then change the Type field to Order.

3. Add the customer number to the Cust No.* field or search for it via .

4. Click  then File Imports then Mitek Sapphire File.

5. Select the appropriate .xml file to upload, then click .

6. A message is then displayed "x lines successfully loaded from <file name>" OR "x lines successfully loaded from <file name>. Leaving <number> unresolved import lines that require attention." Click to close the Import Status window.

i. If you receive message: "x lines successfully loaded from <file name>", proceed with processing the Sales Order as all products were successfully imported.

"x lines successfully loaded from <file name>. Leaving <number> unresolved import lines that require attention.", refer to step 7 below for further information.

7. Click the Resolve Product Mapping icon underneath the button.

(warning) (warning) Note: All unresolved product lines must be addressed before you can proceed with any of the actions available from the top right of the screen (That is, Reprice, Special Buy-Ins, Print Quote etc). (warning) (warning)

8. To resolve invalid imported product mappings, you can either:

i. Create a special code for a product OR

 Creating a special product

To create a special code for a Product, click the Create Special checkbox for the appropriate product line, then:

1. Type or search for the relevant unit of measure to enter into the UOM field.

2. Type or search for the group code to enter into the Product Group field.

3. Type or search for the Supplier ID to enter into the Supplier field.

(tick) If searching for a Supplier via the Supplier Finder , you must enter search criteria for the results to display.

4. Enter the Unit Cost.

5. Enter the Unit Price.

6. Click to create a special code for that product.

7. Repeat steps1 - 6 as required for additional product lines.

ii. Match a particular product line to a different product OR

 Matching a particular product line to a different product

To match a particular product line to a different Product, perform the following:

1. Click the Resolve Product Mapping icon as needed to display the Resolve Product Mapping screen.

2. Click the relevant Product No.

3. Replace it with a different product. Click Search to search for an alternate product.

4. Click to bring that product into the Order.

5. Repeat steps 2 - 4 as required for additional product lines.

iii. Remove a particular product line because it is no longer needed for the Order. Click Blue X to delete the relevant product, then .

9. Resolve all product mappings then click when finished. The remaining products will now be imported into the Order and sorted according to their Usage. The information that is within the usage field is populated from the import file however these can be edited or maintained within the Sales Order grid.

(warning) Note: You are able to save and edit the quote or order as often as you like until you are satisfied with all the lines. When satisfied, click .