Customers Data Importer

How to import customers

Written By Grainne Reidy (Super Administrator)

Updated at March 14th, 2024

Introduction

The Data Importer lets you populate predefined Excel templates and import them into AccountsIQ. It can clear data or import or add to existing system data. The Import Templates are available in Office 97-2003 and Office 2007 formats. 


  The Data Importer can import: 

  • Static information such as Chart of Accounts, VAT (Tax) Codes, and BI Codes.
  • Existing Supplier (Vendor) or Customer records for company setup, including codes, names, addresses, contacts, and bank details. 
  • Transactional information such as invoices or payroll journals.

 

Delete

Info

If you wish to use this tool, please contact your local support team. If you have not used this before you will have to undergo training and assistance to ensure you have the knowledge and skills to use the tool effectively.


Any user can have access to the data importer if their user profile is set with that permission. For more on user permissions, see Managing Group and Entity Users‍ . User role then determines the range of available imports. Admin users have access to the full suite, while Users only have access to a subset.


The Data importer lets you import customers. You can choose from two different options:

  • Import Customer Accounts: This completely replaces the existing customers, deleting all existing data, including associated transactions.
  • Add to Customer Accounts: This adds additional customers to the existing records, keeping all data or adding additional contacts to existing customers.

Guidelines for successful importing 

Check database setup

Before importing data, ensure that the client database has been created correctly using the company setup wizard and that the correct currencies, financial year, and client locale were selected. Verify this in the main system in advance of importing data.

Use separate templates for each company.

You must download the Import Templates from each company individually. We do not recommend importing data using a template from a different company as this company may have a different setup. 

Use newly downloaded templates each time

Use a newly downloaded template each time as it will contain any changes made in the system, for example, updates to the General Ledger codes, Supplier defaults, or Customer information. Make sure you download the Import Templates from the correct database.

See: 

BI Code Importer‍ 

Bank Accounts Importer‍ 

Chart of Accounts Data Importer‍ 
Supplier Data Importer‍ 

Items Data Importer ‍ 

Trial Balance and Banks Importer‍ 

Opening Financial Position Importer‍ 

Transactions Data Importer‍ 

Delete

Preparing Templates

When completing a worksheet, always read the instructions provided.

  1. Go to Setup > Data Importer > Start Customers.

     
  2. Click Next for either:
    • Import Customer Accounts: This completely replaces the existing customers, deleting all existing data.
    • Add to Customer Accounts: This adds additional customers to the existing records, keeping all data or adding additional contacts to existing customers 
  1. Click the relevant download link and save the file as a Microsoft Excel Macro-enabled file (.xlsm format).    

     
  1. Open the file. If Macros are not enabled, click Enable Content.
      
    Graphical user interface, application, Word Description automatically generated   
  2. Fill in the required template, following the Guidelines for Data Entry (see below):
    • Import Customer Accounts: Make sure you complete all worksheets in the template, as using this will completely remove all existing data, including system accounts and defaults.
    • Add Customer Accounts:  Add all the accounts needed, ensuring that you populate all mandatory fields. If any accounts already have any of the additional fields associated with them, these fields will appear as columns in the Customers worksheet.

      Both templates contain the same worksheets. For details on each worksheet, see the relevant Customer template section in this article:
      • Customers: Mandatory fields are marked with an asterisk (*) on the column header. Leave other fields blank to use the customer default or populate with required data.
      • Contacts: Use this to import contacts to new or existing customers.
      • Additional Fields: All other field headings are listed in the Additional Fields worksheet. Copy and paste any fields that you want to import to the Customers worksheet.
  3. Save the file.

Guidelines for Data Entry

Follow these guidelines before you import the data. The data must be prepared appropriately before attempting to import.

General:

  • The import tool cannot accept data prepared from any other workbook format. It must be downloaded from the Setup > Data Importer
  • Download the template from the entity that you want to import data into.
  • Complete each field according to any requirements provided in the worksheet.
  • Do not change column headings or worksheet names. 
  • Do not delete any columns in the existing worksheets.
  • Do not leave any mandatory columns or rows blank.
  • Where there are dropdowns, always select an option.  

Formatting non-numerical data: 

  • Do not use special characters (e.g., apostrophes, ampersands, accents, etc.).
  • Save non-numerical data according to the requirements example, for example, save dates using the date format.
  • Ensure that dates are valid.

Formatting numerical data: 

  • Use the ‘Paste Values’ option when pasting data into the template. This will eliminate any formulas used to calculate those values.
  • For negative financial figures, use a minus sign.
  • Values must be two decimals. Round the values to two decimals before pasting them into the template (use the =ROUND () Excel formula).
  • Ensure that there are no totals added to the bottom of any worksheet.
  • Ensure that the financial information is accurate.   
Delete

Customers Template 


Fields marked with an asterisk (*) on the column header are mandatory.

    
Field Names
 
Data Type (Length)
 
Mandatory
 
Example Text
 
Notes
 
Customer Code Text (50)
 
Y  
Customer Name Text (50) Y    
Currency Code Enter Code Y
 
  Leave blank to use customer default
Bank GL Account Enter GL Code Y
 
 
  Leave blank to use customer default
Payment Details & Credit Terms Credit Term Enter Code customer default   Leave blank to use customer default or check code from Setup>Codes Maintenance
Payment Details & Credit Terms Payment Method Enter Code     check code from Setup>Codes Maintenance
Tax Settings Default Tax Code Enter Code   NT check code from Setup>Codes Maintenance 
Control GL Code Enter GL Code customer default   Leave blank to use customer default, or enter GL code
Delete

Contacts Template


Account Code and Contact Name are mandatory. 

Delete

Additional Fields Template


All other field headings are listed on the Additional Fields Tab, copy, and paste any fields that you want to import to the customer tab.

    
Field Names
 
Data Type (Length)
 
Mandatory
 
Example Text
 
Notes
 
Account on Hold 0-2   0 0 for not on hold; 1 for deliveries on hold; 2 for orders and deliveries on hold
Business Address_Address 1 Text (50)   15 Heart Road  
Business Address_Address 2 Text (50)   Blackrock  
Business Address_City Text (50)   Dublin  
Business Address_County State Text (50)   County Dublin  
Business Address_Post Code Text (50)   A94 EO45  
Business Address_Country Code Text (50)   IE short (2 letter country code)
Business Address_Country Text (50)   Ireland  
Business Contacts_Email Address Text (50)   abc@limited.ie separate different email addresses with semi colon or comma
Business Contacts_Website Text (50)   www.abc-limited.com  
Business Contacts_Telephone Text (50)   125/125-1234 enter ' to include the leading 0
Business Contacts_Fax Text (50)   125/125-1234 enter ' to include the leading 0
Business Contacts_Mobile Text (50)   055/125-1234 enter ' to include the leading 0
Delivery Address_Name Text (50)   ABC Limited  
Delivery Address_Address 1 Text (50)   15 Heart Road  
Delivery Address_Address 2 Text (50)   Blackrock  
Delivery Address_City Text (50)   Dublin  
Delivery Address_County State Text (50)   County Dublin  
Delivery Address_Post Code Text (50)   A94 EO45  
Delivery Address_Country Text (50)   Ireland  
Delivery Settings_Delivery Route Enter Code     check code from Setup>Codes Maintenance
Delivery Settings_Ship Via Enter Code     check code from Setup>Codes Maintenance
Delivery Settings_Priority Enter Code     check code from Setup>Codes Maintenance
Sales Settings_Sales Rep. Enter Code     check code from Sales>Sales Representatives
Account Dimensions_Area Enter Code     check code from Setup>Codes Maintenance
Account Dimensions_Region Enter Code     check code from Setup>Codes Maintenance
Account Dimensions_Referral Enter Code     check code from Setup>Codes Maintenance
Account Dimensions_Account Group Enter Code     check code from Setup>Codes Maintenance>GL Groups
Account Dimensions_BI Code Enter Code     check code from Analysis>BI Codes
Head Office Details_Is Head Office Account Yes/No   Yes  
Head Office Details_Head Office Account Enter Code     Enter the customer code of the head office customer. NB the head office customer must have the "Is Head Office" checkbox ticked. 
Bank Details_Bank Account No Text (50)   12345678 enter the bank account number, do not include spaces or delimiters such as "-"
Bank Details_IBAN Text (50)   IE91BOFI900017999999  
Bank Details_Bank Sort Text (50)   123456 enter the bank account sort code, do not include spaces or delimiters such as "-"
Bank Details_Bank Swift Code Text (50)   IRCEIE2DEPA  
Payment Details & Credit Terms_Credit Limit Enter Code     check code from Setup>Codes Maintenance
Payment Details & Credit Terms_EDI ID Text (50)     check code from Setup>Codes Maintenance
Payment Details & Credit Terms_EDI File Type Enter ID     enter required file ID; 1 for BWG, 2 for Celerity generic CSV, 3 for Musgraves, 4 for Tesco or 5 for Musgraves ROI Daybreak
Pricing & Discount Settings_Price Category   customer default   Leave blank to use customer default or check code from Setup>Codes Maintenance>Price Categories
Pricing & Discount Settings_Price List 1-8     check code from Setup>Codes Maintenance>Price Categories
Pricing & Discount Settings_Discount 0-1   0.5 enter the percentage discount as a decimal e.g., for 10%, enter 0.10
Pricing & Discount Settings_Is Franchisee Yes/No   Yes  
Tax Settings_Use Tax Code Yes/No   Yes  
Tax Settings_VAT No Text (50)   123456  
Tax Settings_VAT Exempt Ref Text (50)   VATEX  
[Contract Date Signed]
Date 


[DD Signature Date]
Date


[DD Payment Type]
Enter Code


Delete

Import Templates

Delete

Info: Group Companies

Create individual templates for each subsidiary that you want to import into. Do not import Customers into the Group Consolidation Entity.


Step One: Import the Data File

  1. Go to Setup > Data Importer > Start > Customers.
  2. Click Next for the relevant option.

     
      
  3. Click Browse to find your saved template.
  4. Click Import.
      

Step Two: Validation

The import file will be validated.

  1. If there are any errors, an error message will appear, along with an error file. Download this file. It includes a new sheet, Import Errors, and a copy of the import file. This shows a summary of all errors found during validation, together with a link to the fields causing the error and the actual error message. 
  2. Click on each link to see details of the error, cells causing the error will be highlighted in red with a note showing further details (hover over the highlighted cell to see the detailed message).
  3. Correct all errors and re-import the file as described in step two above. You can make corrections directly in the error file.

Step Three: Check the Imported Data in the system.

You will receive a confirmation message if the import is successful. Close the importer and check the imported data in the system. Customers can be updated if needed in the system, they can also be deleted if there are no transactions saved against them.

Delete

FAQs

I can't see the notes in the error file.

You can control the appearance of notes in Excel:

  1. Go to File > Options > Advanced.
  2. Scroll down to the display settings. We recommend you select the Indicators only, and comments and notes on hover option. This lets you see detailed notes on errors when you hover over highlighted cells.

    Graphical user interface, text, applicationDescription automatically generated
Delete