CSV import: Item GL groups to GL accounts

You can import any number of item GL groups to GL account mappings into Sage Intacct by uploading a CSV file, which can save a great deal of time. For example, suppose you have 100 item GL group to GL account mappings. Instead entering each mapping one at a time, you can easily add the data to the Item GL Groups Map template, then import it as a CSV file.

Get the mapping template

Before you begin the mapping import, you must first obtain the mapping template from Sage Intacct.

To obtain the mapping template:

  1. Go to Company > Admin > Subscriptions.

  2. On the Subscriptions list, find the Spend Management application, then select Configure.
  3. In the Configure Spend Management window, scroll down to the Item GL Groups to GL Accounts section, then select Import mapping.
  4. Select Mapping template to download the import template.

Populate the mapping template

Unlike other imports, the item GL groups to GL accounts map import simply imports the mapped relationship between an item GL group and a GL account. The import doesn't support the creation of item GL groups or GL accounts. This means that any data you enter on the template must already exist in your instance of Intacct for it to import properly.

You can update existing item GL groups to GL account mappings through import as well. Intacct always takes the most recently added mapping loaded into Intacct, whether through import or the Intacct UI itself.

The mapping template includes two data columns:

  • GL_ACCOUNT_NUMBER
  • ITEM_GL_GROUP_NAME
The GL Account and Item GL Group must already exist in Intacct in order for the map to be imported.

Best practices

The following best practices will help you prepare your CSV file for upload.

  1. From the Import company data list, download a template.
    • Use the latest template, especially following a product release.
    • Use the correct template for the area in which you want to upload information. Different templates organize different types of information. Use a template specifically for the information you need to upload.
  2. Use the column descriptions as a guide to entering information.
    • Read the header descriptions in the template.
      The header description is the cell under the header row that explains what type of information is accepted for each column. If you enter information in the wrong format, or with an incorrect accepted value, it will cause an error in your upload.
    • Enter required information.
      Some data is required, while others aren’t. Read the description field to determine which information is required. If you don’t enter required information, your upload will fail.
  3. Save the file as a comma-separated value, or CSV, file. If saving from Excel, you could choose the comma-delimited file type.

The file will have the file extension .csv after you save it.
Leave the file open until your import is successful. Excel can sometimes reformat the file if you close it before the import is successful.

Common errors

You can avoid common errors by following the suggestions in this table:

Recommendation Directions Notes

Format fields as text.

In Microsoft Excel:

  1. Select all cells.
  2. Right-click and select Format Cells.
  3. On the Number tab, select Text and select OK.
  4. Save the file.
 

Change any date to a short date format.

In Microsoft Excel:

  1. Select a column of dates.
  2. Right-click and select Format Cells.
  3. On the Number tab, select Date and select the short date format.
  4. Save the file.

Short date format: 3/15/2009

Remove spaces from your data.

In Microsoft Excel:

  1. Select a range of cells.
  2. On the Home tab, in the Editing group, select Find & Select and select Replace.
  3. In the Find what box, press the space bar once. Leave the Replace with box blank.
  4. Select Replace All. A prompt opens telling you how many spaces have been removed.
  5. Save the file.

Spaces included in a memo field don’t need to be removed. However, be sure that there are no spaces at the beginning or end of the memo. Trailing spaces can cause an upload to fail.

Remove all commas from the file.

 

Since the import file is a CSV, a Comma-Separated Values file (sometimes known as a comma-delimited file) any commas in the data automatically shifts information into other fields. This will either cause incorrect information to be imported, or cause the whole import to fail.

There are several ways to avoid this issue:

  • Never use commas in numeric amounts.
  • Don’t use commas in any text fields.
  • Put text fields in quotes if you must use commas in text fields.

Make sure that all headers in your file exactly match the headers in the downloaded template.

 

Don’t change the content of the header. Headers map to fields in Intacct. Changing the headers means that your data won’t up load to the correct locations.

You can change the order of the columns in your CSV template. Changing the order of the columns doesn’t affect upload.

ID fields must contain exact references to customers or suppliers.

 

ID fields are case-sensitive. For example, supplier ID "ven100" and supplier ID "VEN100" aren’t the same.

You must enter the ID exactly as it appears in the Intacct system or you run the risk of mismatching transactions to the wrong supplier or customer, or having the upload fail.

When referencing a supplier, customer, term, budget, etc., what you are referencing must already exist in Intacct.  

For example, if you’re uploading transactions for a particular supplier, if the supplier doesn't exist as a supplier in Intacct before your upload, your upload will fail.

This doesn’t apply when creating new entries for customers or suppliers using the import process.

Number line items sequentially.

 

For more information about to correctly number line items, see CSV import: Line number examples.

Import the CSV file

Now that you've entered your data and looked through it for any of the common issues imports can have, save your file in CSV format, then import it into Intacct.

To import your CSV file:

  1. Go to Company > Admin > Subscriptions.

  2. On the Subscriptions list, find the Spend Management application, then select Configure.
  3. On the Configure Spend Management page, set the following.

  4. Select Import.

After an import, Intacct informs you if the import was successful and how many records were imported.

In a completely successful import, the confirmation page lets you verify all the records in your original file were, in fact, successfully imported without having to manually verify them.

Import offline

Some imports can take considerable time, depending on their size and how much processing Intacct must do to the data. When in doubt, select Process offline on the import utility page.

When the offline process is complete, Intacct sends an email to the address you entered in the Import Company Information dialog (where you imported your file).

Intacct recommends that you select Process offline when importing CSV files, and provide your email address. If your import fails, you’ll always be notified, and the failed records are sent to your email.

Handle errors

If you experience import errors, review the importing tips and common errors.

Import errors occur when you try to import information that doesn’t match the requirements of the template. Each template has a set of required information you must enter to import the file successfully, and formats to follow for certain kinds of information. Read the descriptions in the template to determine the most accurate way to enter your data.

If individual transactions are in error, the rows in the transaction that are in error are saved in a CSV file for you along with an error code for each row. Check your email for information about specific errors. See Find and fix CSV import errors for more information.

For more information about the CSV upload process, read Prepare your file for CSV import.