Table of Contents

Creating a New Account

Mitchell Paul-Soumis Updated by Mitchell Paul-Soumis

Read Time: 2 mins

To provide service to your customers within Sonar, an account needs to be created for them. This account allows for the assignment of a serviceable address, the assignment of network inventory, and the assignment of services. In this article, we'll be going over the process of creating a new account, the fields you need to fill out, and the basics of delivering a service to this new account.

Account Creation overview

When you first load into your instance, you'll automatically be placed on the Accounts List View page. While the primary function of this page is explored in its overview article, you also have the ability to create a new account by clicking on the "Create Account" button located in the upper-right hand corner:

Account creation is divided into 3 pages that need to be filled out:

  1. The first page prompts you to select a name for the account, the company in your instance it'll be tied to, the serviceable address, the initial account status for the account, and any account groups you'd like the account assigned to.
  2. The second page prompts you to fill in information for the primary contact, such as their name, contact information, and what email categories they should belong in.
  3. The third page of the account creation modal prompts you to fill in Custom Fields, if applicable.
    1. If you don't have any custom fields created, you'll see this
    2. If you do have some fields configured, you'll see any account-level custom fields instead

Over the following sections, we'll review each page of the account creation modal and discuss the requirements for each field as it relates to account creation.

Account Name and Basic Details

The first page of the Account Creation modal is fairly straightforward - provide a name for the account, select a serviceable address, and assign the account type and group information.

  1. The Name name field sets the name of the account, visible in the account list and on reports.
    While easy to confuse with the name of the contact, that's set on the next page of account creation and the account name can be entirely unrelated.
  2. The Company dropdown allows you to set the desired company for the account to belong to. If you have only one company or have a company set as default in your instance, this field will autofill with that company's information
  3. The Address field allows you to select a serviceable address for the account, or create a new one. Serviceable Addresses will be detailed further in the next section.
  4. The Account Status dropdown allows you to set what status this account will start with. You can find more details over at the Account Statuses: Overview & Example Use Cases article.
  5. The Account Type dropdown is similar to the Account Status dropdown, allowing you to assign a type to the account. More information on Account Types can be found in the Account Types: Overview & Example Use Cases article.
  6. The Groups dropdown allows you to select which account group(s) this account should belong to once it gets created. For more information on account groups, have a look at the Account Groups: Overview & Example Use Cases article.

Selecting a Serviceable Address

When selecting an Address for your new account, you'll be provided with a list of currently unassigned serviceable addresses. If there are no Serviceable addresses available, then you can also create one from directly within the Addresses dropdown.

We cover the creation process of a new Serviceable Address in-depth in the linked overview article, however, the basics will also be covered here.

Clicking on "Create" from within the dropdown will send you to a new page where you can enter the Serviceable Address's location information.

For a Serviceable Address belonging to an account, the marked mandatory fields all need to be filled out. Address information will be dynamically populated using Google Maps, and the precise location can be modified by moving the pin on the map, or by modifying the latitude and longitude. The Elevation tool can be accessed by clicking on the Elevation toggle, highlighted in the image.

If you attempt to add an address that is an exact duplicate of another, you'll receive an error stating "This address is a duplicate of an existing serviceable address". If you need to add another serviceable address at the same location, we recommend adding a Line 2, however, you could also modify the latitude and longitude.

Clicking on "Create" once the address information is filled out will return you to the account creation modal, where you can continue from where you left off.

Once you select a Serviceable Address, a map will appear, as pictured here:

With this map, you can navigate to the nearest Network Site and make use of the Elevation tool to gain information on the line of sight distance and topographical features of the Serviceable Address in relation to the Network Site.

If you're assigning a Serviceable Address to an account which has been used previously, keep in mind that all historical inventory information will come along with it, including assigned access points and routers.

Primary Contact

After completing the basic account information, we can proceed to the second page, which has you define the Primary Contact for this account.

  1. The Name of the primary contact. This will pre-fill to match the account name but can be modified as needed.
  2. The Role is used to define the position within the account. For a Residential account, this is typically unused, but a Commercial account might see a Role such as "IT Contact".
  3. The Email Address field allows you to set the email address for the contact, which will be used for things like service notifications and invoices.
  4. The Email Categories dropdown allows you to select as many or as few email categories for the primary contact as you'd like, as long as these categories currently exist in your instance. You can read more about email categories in the Email Categories: Overview & Use Cases article.
  5. The Phone Numbers section allows you to add phone numbers based on the Phone Number Types you configured in your instance settings.
Additional contacts can be set up once the account is created - the primary contact is the only one created during account setup.

Custom Fields

The final step in account creation is filling out the Custom Fields. These fields are set in your instance settings, and mandatory fields are configured per instance.

If no Custom Fields are created, this page will display a message indicating that there are no custom fields for the entity:

Next Steps

Once you've filled in all required information and created the account, you'll automatically be redirected to the account's management page. This is where you can modify custom fields, add services, and manage payment methods. For a complete overview of the Account Management Page, you can review the article for it here | Account Management View: Overview.

In the following sections, we'll be reviewing the basics of continuing the setup of a new account, including Assigning Services, Scheduling the Install Job, and adding a payment method. These three activities can be done in any order, however, they should all be done before leaving the account's management page for the first time.

Assigning Services

You may have noticed in the example above, the Account Status was set to "Lead - no drop". The reasons for first setting an account to Lead are varied, but one such reason is adding a service to the account. When services are added to an account, charges won't be generated until the account is moved into an account status which activates the account.

To add a recurring service to the account, click on the Billing Tab, followed by the Service & Packages sub-tab.

By clicking on the Add Service button, which is present in both the highlighted area and at the center of the page - as long as no services are currently added to the account - you'll be presented with the "Create Account Service" modal. This modal will prompt you to select a service from a list of all services created on your instance, and allocated to the company this account is attached to.

  1. The Service dropdown allows you to select a Recurring, Expiring, or Data services to add to the account
  2. The Quantity field allows you to adjust the number of times this service should be billed.
    1. For example, a customer who has 2 domains to renew would have the Domain Renewal Service with Quantity set to 2, rather than two listings of the same service.
  3. The Price Override field allows you to define a custom price for the service, which will be in effect until the override is changed or removed.
  4. The Price Override Reason allows you to provide additional details for why the price of the service has been overridden.
  5. The Name Override allows you to set a new name for the service being added to the account.
    1. A common use of name overrides is an adjustment or expiring service with a generic name which is overridden to be more specific when being added to an account.
  6. The Prorate checkbox will, if checked, cause a prorate date checkbox to appear, which will allow you to adjust the pricing date of services being added to the account.

Another type of service that might be added to an account in Lead status is a One-Time transaction. This is added from the Transactions sub-tab of Billing and can be by clicking on the dropdown of the "One Time Transaction" button.

One-time transactions are added in a similar way to recurring services, although One-Time transactions don't continue to create debits after the initial one.

One-Time transactions differ from account services in that they apply their debit to the account immediately, however, the debit won't be invoiced until the account is active. You could also add One-Time transactions to a job, which will be debited upon job completion, which we'll cover in the next section.

Scheduling a Job

In most cases, the account is created in Lead status and an installation appointment is needed to complete the activation. Whether this installation is as simple as connecting a router to a drop or requires the installation of physical equipment, you will generally need to have a job scheduled on the account to complete the installation.

In this section, we'll be scheduling a new installation job. To begin, click on the Jobs tab, followed by the "Create Job" button.

Next, we'll be creating the installation appointment. Clicking on the 'Create Job" button will open the job creation modal, where you can select the job to be scheduled. In the Job Types: Best Practices article, we created a job titled "Residential Install 2".

Job Types are created by going to Settings -> Scheduling -> Job Types followed by clicking on "Create Job Type"

The reason we're using our previously created job is to make use of the Account Status Change upon Completion parameter we configured as part of the Job Type creation. This means that when the installation is successful, this account will automatically be switched to Active.

Adding a Payment Method

Lastly, for the basics of creating an account, we need to add a Payment Method in order to charge the customer for the services they'll be receiving.

Prior to being able to add a Payment Method, you'll need to have configured a payment processor, which you can read more about here | Setting up Bank Account & Credit Card Processors

Payment Methods are added by going to the Billing tab, then the Payment Details sub-tab. From there, you can click on "Add Credit Card" to being adding a payment method.

You can also add a Bank Account by clicking on the dropdown arrow next to "Add Credit Card" and selecting "Add Bank Account"

Once you've clicked on "Add Credit Card", the payment information modal will appear and prompt you to fill in the relevant payment method details:

  1. The Payment Card details prompt you to enter the card number, expiry information, CVV (or CVC), and cardholder name
  2. The Auto Payment toggle determines whether or not this payment method will be used when auto-pay runs on your instance. If auto-pay is disabled on your instance, or no payment method is configured for auto-pay, all payments would need to be entered manually.
  3. The Autofill Address dropdown allows you to select from any address on the account (Mailing or Serviceable) and autofill that address information on the payment method.
  4. The Billing Address for the card is entered here and uses the same street address auto-fill as the serviceable address. The billing address is not pre-filled with the account's serviceable or mailing address and must be entered manually.
The numbers shown here are for test purposes only and do not represent a real credit card. Upon saving the card information, the numbers get encrypted and the card details tokenized.

Once the card is added, it will be displayed as a payment method. If Autopay is enabled on the added method, it will be displayed by a tag on the card. If you need to make changes to the autopay status, billing address, expiration date, or name on the card, clicking on the edit button will allow you to do that.

Once a payment method is added the card number (or account information) can no longer be modified. Changes to those details require deleting the card and re-adding it

How did we do?

FCC Data Exports: General Overview and Usage