Customer CSV Format

You must import customers before you import certificates owned by those customers. Before importing customers, configure the desired customer groups on the target system.

For information about using CSV format files, see Best Practices for Importing Data with CSV Files.

Because CSV uploads for Exemption Certificates, Exemption Certificate Zones, and Customers share many columns, you can reduce errors by copying columns that are common to each of these imports.

Customer File Format

SDITYPE=Customer

Column Name

Format

Req?

Description

CustomerName

varchar2(100)

Y

Customer name.

CustomerNumber

varchar2(100)

Y

Customer number.

CustomerComment

varchar2(2000)

N

Optional comment.

DbaName

varchar2(100)

N

Doing Business As name.

Address1

varchar2(60)

N

First address line.

Address2

varchar2(60)

N

Second address line.

Address3

varchar2(60)

N

Third address line.

Address4

varchar2(60)

N

Fourth address line. (Stored in the database but not displayed on the Customer page in Determination.)

Country

varchar2(2)

N

A two-letter, capitalized country code (such as CA). Leave blank for US (default).

Province

varchar2(50)

N

Province.

State

varchar2(50)

N

State.

County

varchar2(50)

N

County.

City

varchar2(60)

N

City.

District

varchar2(50)

N

District.

PostCode

varchar2(50)

N

ZIP or postal code.

BusinessPhone

varchar2(20)

N

Business telephone number.

ContactName

varchar2(60)

N

Contact name.

ContactEmail

varchar2(60)

N

Contact email address.

ContactPhone

varchar2(20)

N

Contact telephone number.

ContactTitle

varchar2(100)

N

Contact job title.

ContactDepartment

varchar2(100)

N

Contact department.

ContactFax

varchar2(20)

N

Contact fax number.

FullyExempt

varchar2(1)

N

Valid values are Y or N. Defaults to N. Indicates whether or not the customer is fully exempt from tax.

Customer File Example

This file includes two customers.

  1. sdiType=Customers

  2. CustomerName,CustomerNumber,Country,CustomerComment,ContactFax,Db
    aName

  3. Aurora Forest Products,589247,US,Update,5415554704,Aurora DBA

  4. Sequoia Office Services,649823,US,New Customer,541555266,Sequoia
    DBA

For more information about formatting a CSV file, see Creating CSV Import Files.

Updating an Existing Customer

You can update a customer record by including data in the CustomerName and CustomerNumber columns to match a customer; then modifying additional columns as needed.

Customer File Import Prerequisites

You need to create any desired target companies and customer groups before importing customers with the Import/Export Wizard.

Customer File Import Options

When importing a customer file, the Import/Export Wizard prompts for:

  • Company Selection: Select the desired company.
  • Customer Group Selection: Select the desired customer group belonging to the company you selected above.