Import customers from an Excel file

Use an Excel workbook to create or update customer records in AtomicSeller. The first row must contain the exact header names listed below.

Before you start #

  • Use an .xlsx workbook.
  • Do not use formulas in the cells. Paste calculated values before uploading.
  • Format postal codes and phone numbers as text to preserve leading zeros and international prefixes.
  • One row represents one customer. Unknown columns are ignored.

Upload the file #

  1. Open Tools > Upload files.
  2. In Upload customers file, select Choose File.
  3. Choose the workbook, then select Upload.
  4. Review the imported records in the Customers area.

Supported headers #

HeaderRequirementDescription
MERCHANTKEYMandatoryMerchant reference configured in AtomicSeller.
COMPANYNAMEOptionalCustomer company name.
ADR0OptionalAdditional address information, such as floor or entrance.
ADR1OptionalFirst address line.
ADR2OptionalSecond address line.
ZIPCODEOptionalPostal code. Format as text to preserve leading zeros.
CITYOptionalCity.
EMAILOptionalCustomer email address.
PHONENUMBEROptionalCustomer landline or main phone number.
FIRSTNAMEOptionalCustomer first name.
LASTNAMEOptionalCustomer last name.
COUNTRYOptionalCountry name.
STATEOptionalState, province, or region.
MOBILENUMBEROptionalCustomer mobile phone number.

Download a sample #

Start with this sanitized workbook and replace the demonstration values with your own customer data.

Troubleshooting #

  • If a row is not imported, check that MERCHANTKEY is present and matches your AtomicSeller configuration.
  • Check the email address format before uploading.
  • Keep postal codes and phone numbers as text.
  • Keep the header spelling unchanged; extra columns that AtomicSeller does not recognize are skipped.