1. LOU
  2. Operations
  3. Configuration: Import Data

How to Import Customers - LOU® - Powered by Evosus



Customers are an important part of your business. They’re a big part of LOU, too!

When you first get started with LOU, you will need to create your Customer Base. This can be a time-consuming task if you’re forced to do so one-by-one.

That’s where Data Imports comes in. You can download a template, allowing you to create a spreadsheet of all your Customers that can be imported to add them en masse.

VERY IMPORTANT! Do not change the template in any way. Populate data in the fields, but do NOT change formatting, add additional columns, or move columns around. Templates are intended to be a document with specific formatting and placement already configured. Making changes to these preconfigured fields will cause errors and prevent the data from importing correctly.




Go to Operations / Import Data

Download the Template
The first thing you need to do is download the Template you’ll use to create the file you upload.


 
  1. Click 
  2. Select Customers as the Spreadsheet Type and .xlsx as the File Type
    • .xlsx is currently the only supported file type
  1. Click 
  2. The Template will download and you will receive a confirmation


 
REMEMBER! This template does not include every single field that is available on the Customer Profile. This import’s primary function is to help you quickly add Customers and their Contact information to LOU en masse. Account Settings, Equipment, Site Profiles, Customer Message Preferences, and other aspects of a Customer record are not included on this template and must be completed for each Customer Profile individually. These features are too varied to appear on the Customer Import template. This includes Cards on File, which cannot be imported due to Consumer Privacy laws and TSYS policies intended to protect sensitive information.


Create a File to Upload
The Template will download to the folder designated as the default in your browser settings. For most people, this will be the Downloads folder.



The file will be an .xlsx file which can be opened by Excel. If you are having trouble getting the file to open, you may need to change the default app used to open this file type in your Windows Settings. Find instructions on doing so here.

The Template contains every field available when you create a Customer. The fields which are required are highlighted. You cannot upload data without these fields correctly populated. All non-highlighted fields are optional.

IMPORTANT! Do not change the formatting of the template. Excel may add characters or formatting that are not recognized by LOU.




Required Fields are highlighted. Please be aware some fields require specific data:
 
  • Last Name: This is a Required Field
  • Company Name: This is a Required Field

TIP! You do not have to include both Last Name and Company Name in the Customer Import. These fields are one-or-the-other. You must include at least one of these fields.
 
  • Phone Number: This field is not required. However, you must be mindful of formatting.
    • Do not use parentheses or dashes. Example: 3605551234, not (360)555-1234 or 360-555-1234
  • PhoneMsg is the field in which you can put the extension.
  • PhoneIsTextMsg determines whether the phone number is a mobile. Enter Yes or No.

IMPORTANT! When uploading, there are a couple important things to keep in mind.
  1. Do not change the order of columns in the template.
  2. Do not remove Column Headers.
  3. Do not add or change formatting in fields.
    • Nothing should be bold, italicized, or underlined in data fields.
    • NO changes to Columns’ or Rows’ Formatting
  4. Do not add spaces to the end of data. Excel interprets spaces as characters and this can cause errors in fields in LOU.
 
ADDRESS VERIFICATION TIP! LOU cannot Google Verify addresses that are included in the import. They will be added to the Customer Profile as Manual Entry. Additionally, the Bill To and Ship To Addresses are not required fields. However, if you populate both address fields with the same address, LOU will automatically toggle Shipping Address is Different on in the Customer Profile. This will make it difficult when you go to Google Verify these addresses after import. If the Ship To and Bill To address are the same, you only need to populate the Bill To Address fields and LOU treat it as the Ship To Address as well.


 
REMEMBER! Everything in LOU is case-sensitive. Be mindful of case whenever you are entering data. When referencing existing data, you must use the same case. Changing case may result in duplicated data. Example: Steve Rogers and STEVE ROGERS.


Upload Spreadsheets
Once you’ve used the Template to create the Spreadsheet, you can upload it by clicking


 
  1. Select your Spreadsheet Type
  2. Give your import a name
  3. Select the file from your computer to upload
  4. Click 
You should see the Status changing from Uploading to Validating to Ready to Import. Once you click Upload, you can leave the screen and carry on with your work. LOU will email you when the Upload is ready for import. 



IMPORTANT! Large import (2501+ records) files will take several minutes or more to upload. The system has to go through the data line-by-line and add it appropriately. Spreadsheets uploaded during business hours with 5000+ records will be Queued by LOU and will not import until after 4p PST.


 
  1. Click the Actions link on the line corresponding to your upload.
  1. Select View Details to confirm the information being uploaded. The information in the spreadsheet has not been added to your database yet. Confirming the information here is an important step in preventing bad data uploads.
    • The Details Page will display the information from your spreadsheet as it will upload into LOU.
  • You can click the Action link and select Edit to make changes to any line item being uploaded. This will open a window with every field from the template for you to add, remove, or update information. IMPORTANT! Do not remove data from required fields without replacing it. The upload will fail if you don’t have the required fields correctly filled in.


  • When you’re finished, click 
  • To delete the line item entirely, click 
  1. Once you’ve confirmed what will be uploaded, and made any changes you wish to make, you are ready to complete the import. Click the Actions link and select Import.
  1. The Confirm Import message will pop up, confirming that you are going to copy the data onto your database. Click Import.



The status should update from Ready to Import to Complete.


You can access your Customers and add them to Sales and Work Orders, now.



You can access your Customers and add them to Sales and Work Orders now.

Rollback an Import
If you complete the Import and realize there’s a mistake, you can undo the Import under specific circumstances. For Inventory SKUs, the Import can only be rolled back if there is no financial data associated with the SKUs. This means no transactions have been posted with those SKUs, they have not been added to documents (Orders, Estimates, POs), and no Beginning Balances were entered.

BEWARE! A Rollback will essentially make it as if the data never existed, deleting all mention of them in the database.




Once the data has been rolled back, the line item will disappear from Spreadsheet Uploads. To verify the SKUs are gone, you can go to Inventory and search for the SKUs.


What Happens if Your Import Contains Errors?
You may have errors in your file. Maybe you forgot a required field. Maybe you have a character in a field which doesn’t belong. Maybe you included a SKU which is already in your Inventory. When you have an error in the upload process, LOU will tell you. After you’ve completed steps 1-4 above, you may see a number under the Exceptions column and the Status listed as Has Errors.

Click the Actions link next to this line item to see what actions you can take to view and correct the errors.



Click View Exceptions to see the errors. This will take you to a Details page with each item in the spreadsheet listed. The ones with errors will have a red bar with the error message in it.



You can use the Update link to update the information in the SKU. However, some errors may require you to make updates to the spreadsheet and upload again.

If there are items in the upload which are good – free from errors, you can go back to the Spreadsheet Uploads page, click the Actions link for the import file you’re working with, and select Move Exceptions to Separate Upload. This will create a new line item with just the errors. The Status of the original file should update to Ready to Import as it now only contains the valid line items from your spreadsheet. You may complete the Import process outlined above on the line item which is Ready to Import.



For the line item which now contains only the errors, you can complete updating the items to correct them and finish the Import process, or you can click the Delete link to delete the line item with errors. Go back to your template and make the necessary changes and corrections, then process a new Import.


Validation and Data Tips
These are some of the things LOU looks for when it validates data or helpful tips on how to populate fields in the template. This is not a comprehensive list. Instead, these are the more common issues that prevent data from validating.

  • First Name and Last Name: LOU will successfully validate a name that contains an apostrophe. However, apostrophes can make searching for the Customer record in LOU difficult. If a name has an apostrophe, leave it off to make searches easier. Example: O’Brien can be entered as OBrien.
  • Company Name: You do not have to enter a Company Name. Either Last Name or Company Name can serve as unique Identifiers. If you enter a Company Name, you do not need to enter a Last Name, and vice versa. You must have at least a Last Name or a Company Name.
  • Customer Type: These should already be created in LOU. You must make sure to enter the Customer Type on the template exactly the way it exists in LOU. Case, spelling, and spacing matter. LOU will not create a Customer Type if you enter one that doesn’t exist. If LOU finds a Customer Type that doesn’t exist in LOU (including one with a different case, spelling, or spacing), it will give an error and mark that line item as an Exception.
  • Phone Number: As noted in the Create File to Upload section above, Phone Numbers should not contain dashes or parentheses. LOU will automatically format the Phone Numbers for you. Parentheses, dashes, even periods, will create errors and the data will not be imported correctly.
  • Email: The email address must be formatted correctly as name@domain.com or LOU will create an error and the line item will be marked as an Exception.<