DataImportGuidelines
DataImportGuidelines
2 Company Import 5
3 Parts Import 22
4 Bills of Materials 38
5 Resources 40
6 Routings 43
7 Batches 49
8 Sales Orders 53
9 Purchase Orders 57
12 Common Mistakes 64
123insight Data Import Guidelines Page | 3
V9.05 (22 April 2014)
This document provides you with the fields and formats required for you to prepare your key data for subsequent import in to 123insight.
As stated on the front page, these guidelines are aimed at those users who have attended our System Admin & Finance Course and it is something that we
would strongly recommend.
Company data
Part data
Bills of materials
Resources
Routings
Batches
Open sales orders
Open purchase orders
You will learn more on each of the above as you work through these guidelines.
The data import toolkit is for importing new records only and cannot be used for updating existing records.
For a successful import you only need to complete the mandatory information but there are plenty of other fields that can be completed.
123insight Data Import Guidelines Page | 4
V9.05 (22 April 2014)
When using our tables provided, the Column will refer to the column heading in Excel, the Field Name, Example, Type and Comments are there to
guide you as to what data is expected and the Key indicates the key (unique) field(s) of the table.
The rows highlighted in yellow on our tables indicate a mandatory field. These MUST be completed in the worksheets for the import to be
successful. Any field not highlighted in yellow can be left blank if you do not wish to import that piece of information but cannot be re-
imported at a later date.
Names of all the excel worksheets should exactly match with the worksheet name given in this document.
All email addresses and websites are checked for correct format.
Before starting the company import, please be aware that company information cannot be imported with Access Integration switched on.
This worksheet is mandatory for successful import of company information. Remember, the yellow fields within this table denote mandatory
information.
C Customer Code INS001 Text (10) Accounts Ledger Code – must be unique
D Supplier Code SRC001 Text (10) Accounts Ledger Code – must be unique
E Potential Customer Prospect Text (50) Is required when a company is defined as a potential
Category Code customer. You must have CRM+ to use this field.
F Potential Supplier Awaiting QA Check Text (50) Is required when a company is defined as a potential
Category Code supplier. You must have CRM+ to use this field. This code
must be defined in the system first.
H Country Code GB Text (4) Yes Does not need to exist in the system first – the import will
create new country codes.
K Email [email protected] Text (100) The general company email address, personal email
addresses may be held in the contacts table.
You may have noticed that the main company address is not included here; the addresses data is entered on a separate worksheet.
123insight Data Import Guidelines Page | 8
V9.05 (22 April 2014)
If a company is defined as other company category type then its data should be stored in the same spreadsheet
as the main company data but in a worksheet called “other category”.
This data has a one-to-one relationship with the “company” worksheet. This worksheet is not mandatory for successful import of company information.
Remember, the yellow fields within this table denote mandatory information.
B Other Category Code Partner Text (50) This code must be defined in the system first and cannot be
a code that is marked as either potential customer or
potential supplier.
123insight Data Import Guidelines Page | 9
V9.05 (22 April 2014)
If a company is defined as a customer then their data should be stored in the same spreadsheet as the main
company data but in a worksheet called “customer”.
It contains the customer details for a company defined as a customer. This data has a one-to-one relationship with the “company” worksheet. This worksheet
becomes mandatory if a company is flagged as a customer. Remember, the yellow fields within this table denote mandatory information.
B Currency GBP Text (4) Yes The currency you will invoice this customer in. The currency
code does not need to exist in the system first. The import
will create new currency codes.
C Tax Code T1 Text (10) Yes Default tax code. The tax code does not need to exist in the
system. The import will create new tax codes.
D Nominal Code 1000 Text (25) Default nominal code. The nominal code does not need to
exist in the system. The import will create new nominal
codes, flagged as sales.
H Settlement Disc Term If payment is made within Text (250) Required for invoices as this text will display on the invoice.
15 days of invoice date.
I Discount Matrix Row 1 Number Discount matrix defined for customer inside discount matrix
form.
J Account Manager 10002 Number Clock number of the employee. Employee must have
customer account manager rights set up. Without CRM+,
this field is not valid.
K Transit Days 5 Number The number of days it typically takes to transport goods to
this customer.
R EEC VAT Delivery EXW Text (3) Only required if submitting intrastats.
U Division XYZ Co. Ltd. Text (50) Division code will be checked for mandatory validation if the
“Trade as Multiple Division” option is found ticked in Sales
Options.
123insight Data Import Guidelines Page | 11
V9.05 (22 April 2014)
V Customer Mapping Partner Text (20) Should exist as a predefined value within the system.
Type
If a company is defined as a supplier then their data should be stored in the same spreadsheet as
the main company data but in a worksheet called “supplier”.
It contains the supplier details for a company defined as a supplier. This data has a one-to-one relationship with the “company” worksheet. This worksheet
becomes mandatory if a company has been flagged as a supplier. Remember, the yellow fields within this table denote mandatory information.
B Currency GBP Text (4) The currency code does not need to exist in the system. The
import will create new currency codes.
C Tax Code T1 Text (10) Yes Default tax code. The tax code does not need to exist in the
system. The import will create new tax codes.
D Nominal Code 2000 Text (25) Default nominal code. The nominal code does not need to
exist in the system. The import will create new nominal
codes, flagged as purchase.
E Account Manager 10002 Number Clock number of the employee. Employee must have
supplier account manager rights set up in the system first.
M EEC VAT Delivery EXW Text (3) Only required if submitting intrastats.
Address data for each company is to be stored in the same spreadsheet as the main
company data but in a worksheet called “addresses”.
This data has a one-to-one relationship with the “company” worksheet. This worksheet is mandatory for successful import of company information.
Remember, the yellow fields within this table denote mandatory information.
Please note: if you are using fixed addresses, you may not be able to follow our example detailed below. Please see our Common Mistakes chapter
on page 58 for more detail.
I Country Code Text (4) If not supplied then the default country code will be selected.
J Main Address Y Boolean Flags whether this is the main address of the company or
not. At least one must be flagged as a main address.
123insight Data Import Guidelines Page | 15
V9.05 (22 April 2014)
M Delivery Address Y Boolean Marks this address as the default delivery address.
N Alternate Delivery Y Boolean Marks this address as an alternate delivery address (for
Address customers).
O Alternate Order Y Boolean Marks this address as an alternate order address (for
Address suppliers).
You may define as many addresses as you like to be stored against a company record. Just enter a line per each address in the excel worksheet.
123insight Data Import Guidelines Page | 16
V9.05 (22 April 2014)
Contacts data for each company are to be stored in the same spreadsheet as
the main company data but in a worksheet called “contacts”.
This data has a one-to-one relationship with the “company” worksheet. This worksheet is not mandatory for successful import of company information.
Remember, the yellow fields within this table denote mandatory information.
B Title Mr Text (10) This title must first be defined in the system.
C Forename James Text (50) Forename and surname together must be unique for the
company.
D Surname Brown Text (50) Forename and surname together must be unique for the
company.
G Email [email protected] Text (100) This will be used when emailing sales documents where the
sales document has been linked to this contact.
The mailing address for a contact will be picked up from the address table. First inserted address for a company will become the mailing address
and if not the correct address, would require a manual change within 123insight.
123insight Data Import Guidelines Page | 18
V9.05 (22 April 2014)
This worksheet is not mandatory for successful import of company information. Remember, the yellow fields within this table denote mandatory
information.
B Text Text
E Del. Note Header Y Boolean Should be marked as Y if the text is to be shown on the del.
note header, N if not.
I ITT Header N Boolean Should be marked as Y if the text is to be shown on the ITT
header, N if not.
123insight Data Import Guidelines Page | 19
V9.05 (22 April 2014)
K Advice Note Header N Boolean Should be marked as Y if the text is to be shown on the
advice note header, N if not.
P Del. Note Footer N Boolean Should be marked as Y if the same text is to be shown on
the del. note footer.
V Advice Note Footer N Boolean Should be marked as Y if the same text is to be shown on
the advice note footer.
Quick reference
Company worksheet:
Customer worksheet:
123insight Data Import Guidelines Page | 21
V9.05 (22 April 2014)
Supplier worksheet:
Addresses worksheet:
Contacts worksheet:
Text worksheet:
This excel worksheet is mandatory for successful import of part information. Remember, the yellow fields within this table denote mandatory information.
C Unit of Measure EACH Text (15) The unit of measure does not need to exist in the system.
The import will create it.
D Default Location STORES Text (20) Default Location is not mandatory for Non Stock and
(Location Code) Phantom parts. Also known as Location Code.
E Product Group ABC123 Text (10) The product group code must first be defined in the system
and will be mandatory if it’s been made mandatory in
Accounting Options.
F ABC Code A A–Z
H Sales Nominal 3000 Text (25) Nominal assigned by default when this part is sold. This
code does not need to exist in the system, the import will
create this code.
I Purchase Nominal 4000 Text (25) Same as above but for purchases.
L Sales Lead Time 4 Number Number of days to quote by default at sales order entry if
there is not enough stock to satisfy the sale.
O User Analysis Code 02 P478 Text (50) Example use = Category Code for reporting
X User Analysis Code 11 This part must be handled Text These next 10 fields are totally free format unlimited text
with care as it contains fields.
asbestos.
AL To be left blank
123insight Data Import Guidelines Page | 25
V9.05 (22 April 2014)
AM To be left blank
AN Default Bin Location R1C1 Text (20) Bin location. Will be mandatory if it’s made mandatory in
Stock Options.
AO Disallow Sales N Boolean Yes or No. If set to yes then will not allow the part to be
selected for sales order.
AU Serial Number Flat Bed Trailers Text (100) Check for the existence of the serial number.
Description
AV RoHS Compliant Y Boolean Flag to set part as RoHS Compliant.
AW Awaiting Sales Review Y Boolean Flag to set part as awaiting sales review.
Method information is to be stored in the same excel spreadsheet as the main parts data but in a worksheet called
“methods”. This data has a one-to-many relationship with main parts data.
Each part must have a current method defined. This worksheet is mandatory for successful import of part information.
Manufactured
Purchased
Phantom
B Part Number 566/2553 Text (25) Yes Part number must exist on the parts worksheet.
D Min Batch Size 1 Number If entered against a purchased part, supplier details
becomes mandatory.
F Split Works Order to N Boolean If yes, then multiple works orders are generated, each for
Reflect Order Multiple exactly the order multiple, otherwise one works order is
generated.
123insight Data Import Guidelines Page | 27
V9.05 (22 April 2014)
H Responsibility Code B8 Text (20) A code to the buyer or planner responsible for this part.
J Reorder Level 5 Number Reorder level value should be defined as per the precision
for the unit of measure defined for the part.
123insight Data Import Guidelines Page | 28
V9.05 (22 April 2014)
To be stored in the same excel spreadsheet as the main parts data but in a worksheet called “versions”.
Each method must have a current version defined. This worksheet is mandatory for successful import of part information.
B Part Number 566/2553 Text (25) Yes Part number must exist on the parts worksheet.
C Method Type Manufactured Text (25) Must match the method type for the above part number as
defined on the methods worksheet.
To be stored in the same excel spreadsheet as the main parts data but in a worksheet called “issues”.
This data has a one-to-many relationship with the main parts data. This worksheet is not mandatory for successful import of part information.
To be stored in the same excel spreadsheet as the main parts data, but in a worksheet called
“customers”.
This data has a one-to-many relationship with the main parts data. This worksheet is not mandatory for successful import of part information.
B Customer Code GEN001 Text (10) Yes This customer code must first be defined in the system.
This data has a one-to-many relationship with main parts data. This worksheet is not mandatory for successful import of part information.
B Supplier Code SRC001 Text (10) Yes This supplier code must first be defined in the system.
Etc…..
G Suppliers Unit of BOX Text (15) The unit in which the supplier provides these parts. This unit
Measure of measure does not need to exist in the system. The data
import will create this for you.
H Conversion Factor 10 Number Conversion factor between the suppliers unit of measure and
the main parts unit of measure.
box.
The conversion factor will default to one if none is defined in
the worksheet.
To be stored in the same excel spreadsheet as the main parts data, but
in a worksheet called “supplier costs”.
This data has a one-to-many relationship with the supplier cross reference data meaning one supplier cross reference may carry many supplier cost entries
(quantity breaks). This worksheet becomes mandatory when a supplier cross reference is defined.
D Minimum Quantity 1 Number Minimum quantity in the suppliers unit of measure that must
be purchased to receive this cost.
This data has a one-to-many relationship with the main parts data. This worksheet is not mandatory for sucessful import of part information.
B Text Please note: this product is Text Yes Please note: any formatting made on the worksheet is not
hazardous to health, please taken across to 123insight so you will need to format your
handle with care. text in Add/Edit Parts.
D Include on N Boolean
Acknowledgment
F Include on C of C Y Boolean
1. Location codes are not required for Non Stock or Phantom parts. Location codes are mandatory for all other part types.
4. For every Manufactured part, Order Multiple quantity should be less than or equal to Min. Batch Size
5. Part Supplier Cross Reference: combination of Part Number, Supplier Code and Rating must be unique.
123insight Data Import Guidelines Page | 36
V9.05 (22 April 2014)
6. If Serial Number description is provided then the import will check if that description exists in the serial number format table.
7. If the status of a version is pending the date effective will automatically be set to be 31/12/3000. All other status’ will be set to the current date.
Quick reference
Parts worksheet:
Methods worksheet:
Versions worksheet:
123insight Data Import Guidelines Page | 37
V9.05 (22 April 2014)
Issues worksheet:
Customers worksheet:
Suppliers worksheet:
Texts worksheet:
C Child Part Number 3777465 Text (25) This part number must exist in the system.
E Quantity 2 Number
H Method Type Manufactured Text (20) Method Type of parent part of this BOM and the method
must exist in the system.
123insight Data Import Guidelines Page | 39
V9.05 (22 April 2014)
BOM import is possible for any assembly part, even if it is being used as a component of any other BOM. BOM import is also possible even if BOM is already
defined for part. It will simply add the new components in existing BOM.
Method Type Can this be a “parent” part? Can this be a “child” part?
Purchased No Yes
We advise that after successful import of bills of materials that you run the Global Cost Recalculation.
(5) Resources
Let’s now take a look at importing resources, again both what can and can’t be
imported and the format it needs to be in.
D Allowable Wait Days 2 Number Number of days work is allowed to sit at this resource before
it is started.
E Hourly Set Rate 25.50 Number In base currency. Not required for subcontract resource.
F Hourly Run Rate 17.75 Number In base currency. Not required for subcontract resource.
J Hours available 8 0 – 24
Monday
K Hours available 8 0 – 24
Tuesday
L Hours available 8 0 – 24
Wednesday
M Hours available 8 0 – 24
Thursday
O Hours available 0 0 – 24
Saturday
P Hours available 0 0 – 24
Sunday
123insight Data Import Guidelines Page | 42
V9.05 (22 April 2014)
Columns E – P are not required for the import of a sub contract resource.
(5) Resources
Let’s now take a look at importing resources, again both what can and can’t be imported and
the format it needs to be in.
123insight Data Import Guidelines Page | 43
V9.05 (22 April 2014)
(6) Routings
Let’s now take a look at importing routings, again both what can and can’t be
imported and the format it needs to be in.
B Operation Number 10 Number Yes Must be unique while defining routing for a single part.
G Wait Time 0 Number Number of days to wait before starting next operation.
J Method Type Manufactured Text (20) Method type of the parent part.
To be stored in the same excel spreadsheet as the main routings data but in a worksheet called “Suppliers”.
B Version Number 0001 Text (8) Yes Must be the same as the version number on the Routings
worksheet.
E Supplier Code SRC001 Text (10) The supplier code must exist in system.
To be stored in the same excel spreadsheet as the main routings data but in a worksheet called “Supplier
costs”.
This data has a one-to-many relationship with the supplier cross reference data, meaning one supplier cross reference may carry many supplier cost entries.
B Version Number 0001 Text (8) Yes Must be the same as the version number on the Routings
worksheet.
E Supplier Code SRC001 Text (10) The supplier code must exist in system and must be the
same as the supplier code defined on the suppliers
worksheet.
Manufactured Yes
Phantom No
Purchased No
1. Part number, operation number and resource codes are all checked to ensure they are unique.
2. If a parts routing is already defined in database, it will not be overwritten through Data Import.
We advise that you run the global cost recalculation after a successful import of routings.
123insight Data Import Guidelines Page | 48
V9.05 (22 April 2014)
Quick reference
Routings worksheet:
Suppliers worksheet:
(6) Routings
Let’s now take a look at importing routings, again both what can and can’t be imported and
the format it needs to be in.
123insight Data Import Guidelines Page | 49
V9.05 (22 April 2014)
(7) Batches
Let’s now take a look at importing batches, again both what can and can’t be
imported and the format it needs to be in.
This is the stock batches data and is to be stored in an excel worksheet called “Batches”
Please note, if you do not add costs when importing batch information, then these cannot be added at a later date and will affect both your stock
and WIP valuations.
N Standard Date Set 21/02/2012 Date Must be greater than or equal to date received.
S Actual Date Set 21/12/2012 Date Must be greater than or equal to date received.
To be stored in the same excel spreadsheet as the main batch data but in a worksheet called “SerialNumbers”
This worksheet is mandatory for successful import of batch information for serialised parts only.
1. Import of purchased part batches will not allow for set/run/subcontract costs.
2. Once your batches have been imported, the “stock header” records will be updated to reflect the total in stock. At this point we would advise running a
stock valuation report to check the validity of your import.
3. If the serial number for any batch is provided then the number of serial numbers should be equal to the on hand stock level of that batch.
(7) Batches
Let’s now take a look at importing batches, again both what can and can’t be imported and
the format it needs to be in.
123insight Data Import Guidelines Page | 53
V9.05 (22 April 2014)
In most cases it is advisable to re-key sales orders. However, if this is not practical then this section covers the format of the Sales Headers and the Sales
Lines. You should only import the outstanding quantities – do not attempt to reflect part deliveries as the delivery history will not be present in 123insight. So if
the sales order was for 10 but you have already shipped 6, then import the sales order in 123insight as a quantity ordered of 4.
B Customer Code GEN001 Text (10) Yes Must exist in the system.
E Company Division XYZ Ltd. Text (100) Will be mandatory if the option for trade as multiple divisions
is selected.
F Project Section P1/{General} Text (200) If Project Section has been set as mandatory on sales
orders, within sales options, then this will be mandatory on
import.
All other data required in the header will be picked up from the defaults on the customer file.
123insight Data Import Guidelines Page | 55
V9.05 (22 April 2014)
To be stored in the same excel spreadsheet as the sales order header data but in a worksheet called “Sales
Lines”
This data has a one-to-many relationship with the sales headers. This worksheet is not mandatory for successful import of sales order information.
B Part Number 566/2553 Text (25) Yes Must exist in the system.
C Quantity 4 Number
G Discount % 5 Number
Quick reference
In most cases it is advisable to re-key purchase orders. However, if this is not practical then this section covers the format of the Purchase Headers and the
Purchase Lines. You should only import the outstanding quantities – do not attempt to reflect receipt deliveries as the receipt history will not be present in
123insight. So, if the purchase order was for 10 but you have already received 6, then import the purchase order in 123insight as a quantity ordered of 4.
This excel sheet is mandatory for successful import of purchase order information.
B Supplier Code SRC001 Text (10) Yes Must exist in the system.
All other data required in the header will be picked up from the defaults on the supplier file.
123insight Data Import Guidelines Page | 58
V9.05 (22 April 2014)
To be stored in the same excel spreadsheet as the purchase order header data but in a worksheet called
“Purchase Lines”
This data has a one-to-many relationship with purchase headers. This worksheet is not mandatory for successful import of purchase order information.
B Part Number 566/2553 Text (25) Yes Must exist in the system.
C Quantity 4 Number
E Part Issue A5 Text (10) Must match a valid part issue number in the system.
If a unit of measure exists for the supplier/part combination (in the supplier cross reference information) then it will be used along with its conversion.
Otherwise, the standard stock unit of measure will be used.
Your 123insight database should have at least one company delivery address defined before importing purchase orders.
This section covers importing legacy Sales Invoices and Credits, so that a history of invoices and credits raised prior to using 123insight, can be viewed from
123insight. The same import sheet is used for both invoices and credit notes.
H Sales Order Number SO/2000 Text (15) Sales order number for the invoice/credit note.
I Line Number 1 Number Line number of the sales order the invoice/credit note is
raised against.
K Delivery Note Number DN/123 Text (256) Delivery note number for the invoice/credit note.
This section covers importing legacy Purchase Invoices and Debita, so that a history of invoices and debits raised prior to using 123insight, can be viewed
from 123insight. The same import sheet is used for both invoices and debit notes.
H Purchase Order PO/4001 Text (15) Purchase order number for the invoice/debit note.
Number
I Line Number 1 Number Line number of the purchase order the invoice/debit note is
raised against.
K Delivery Note Number DN/123 Text (256) Delivery note number for the invoice/debit note.
If you find that your import has been unsuccessful, you may find it useful to first read this page of the common mistakes that can be made, before contacting
Support.
1. The cell in the spreadsheet containing the version number for a method hasn’t been formatted to text.
3. Putting headers on your worksheet to identify the columns but not deleting them before import.
4. Adding data into fields which is not mandatory and not necessary.
5. Spelling mistakes.
6. Invalid characters are being used. The most common is the apostrophe.
7. The spreadsheet you are trying to import is not as per the format shown here in our guidelines.
10. Address is incorrectly formatted as per your fixed address format set in 123insight. E.g. if your fixed address is set up in 123insight like the below:
t
123insight Data Import Guidelines Page | 66
V9.05 (22 April 2014)
Durley, Southampton,
Hampshire,
SO32 2EJ
This therefore matches your set up as per the fixed address format. Of course, which fields are mandatory and what data is to be completed in each
field will be different depending on your settings. Please check your fixed addresses before importing.