Collapse AllExpand All

6.1. New Account

Accounts are central to the xTuple CRM system. An account holds information about an entity and serves to define it further as a customer, prospect, vendor, competitor, or partner. To create a new account, go to CRM > Account > New. The following screen will appear.

Create new Account

When creating a new account, you are presented with the following options:

Account Number

The account number uniquely identifies the account. Users must have sufficient privileges to change the account number, particularly when the account extends to different types (e.g., customer, vendor, etc.). If the number is linked to a user account, the change can only be made by a superuser.

Account Name

Enter the name of the account you do business with (e.g., customer name or vendor name). This field should not to be confused with the contact name of an individual at the company. Users must have sufficient privileges to change the account name, particularly when the account extends to different types (e.g., customer, vendor, etc.).

Active

Select if you are actively doing business with this account. Not selecting makes the account inactive.

Type

Specify one of the following account types:

Organization

Select if the account is an organization.

Individual

Select if the account is an individual.

Parent

Enter the account number of the account (if any) which serves as the parent for the account. All contacts and comments associated with the child account record will be inherited by and displayed in the parent account record.

Owner

Enter a contact who serves as the owner of the account.

Roles

Indicate how the account relates to your business by selecting from the available options. A single account may have multiple different roles. Users with sufficient privileges may access each of the roles by clicking on the associated buttons.

Prospect

Select if the account is a prospect. Specific prospect information is maintained on the Prospect screen, which can be reached by selecting the PROSPECT button.

Customer

Select if the account is a customer account. Specific customer information is maintained on the Customer screen, which can be reached by selecting the CUSTOMER button.

Vendor

Select if the account is a vendor account. Specific vendor information is maintained on the Vendor screen, which can be reached by selecting the VENDOR button.

Sales Rep

Select if the account is a sales representative. Specific sales rep information is maintained on the Sales Rep screen, which can be reached by selecting the SALES REP button.

Employee

Select if the account is an employee. Specific employee information is maintained on the Employee screen, which can be reached by selecting the EMPLOYEE button.

User Account

Select if the account is a user. Specific user information is maintained on the User screen, which can be reached by selecting the USER button. Changing the account number of a user account requires an admin with superuser privileges.

Tax Authority

Select if the account is a tax authority. Specific tax authority information is maintained on the Tax Authority screen, which can be reached by selecting the TAX AUTHORITY button.

Competitor

Select if the account is a competitor. There is no separate screen for maintaining competitor information.

Employer

Select if the account is an employer. There is no separate screen for maintaining employer information.

Partner

Select if the account is a partner. There is no separate screen for maintaining partner information.

When defining or viewing contacts for the specified account, you are presented with the following options:

Tip

For contacts, you have two options:

  1. Attach an existing contact to the account.

  2. Enter new contact information.

Contacts

Select to attach and/or detach contacts to the account. For additional documentation related to creating contacts, see Section 7.1, “New Contact”.

Account Contacts/Addresses
Addresses

Select to attach or add addresses to the account. If a new address is manually entered here, that information will be added automatically to the master list of addresses. For additional documentation related to creating addresses, see Section 8.1, “ New Address”.

The following buttons are unique to this screen:

DETACH

Highlight a contact and then select this button to remove the association between the contact and the account.

ATTACH

Select to associate a new contact with the account.

To add notes to an account, select the Notes tab. The following screen will appear:

Account Notes

When adding notes to an account, you are presented with the following options:

Notes

This is a scrolling text field with word-wrapping for entering notes related to the account. Any notes entered on this screen are for internal purposes only.

To add comments to an account, select the Comments tab at the bottom of the Account screen. The following screen will appear:

Account Comments

When adding or reviewing comments, you are presented with the following options:

Verbose Text

Select to display all comments in the list in an expanded view which includes the entire text of each comment. To edit a comment, simply select the EDIT link next to the comment. That link will not be shown for changelog comments, which can't be edited. If the Verbose Text option is not selected, the comment list will display only header level information for each comment.

Comments

Display lists comments related to the record.

The following buttons are available:

NEW

Opens screen for creating a new comment.

VIEW

Highlight a comment and then select this button to reach a read-only view of the Edit screen.

EDIT

Enables you to edit highlighted comments—as long as the comments are not changelog comments. ChangeLog comments are system-generated and may not be edited. The Edit screen is the same as that for creating a new comment—except that when editing, the fields will contain comment information. Double-clicking on a comment will also bring you to the editing screen.

To enter a new comment, select the NEW button. The following screen will appear:

Create new Comment
Comment Type

Select a comment type from the drop-down list to classify the comment. This is a required step. Comment types may be system-defined (i.e., changelog and general) or user-defined, as described in Section 13.2.3, “Comment Types”. Once you have specified a comment type, begin typing your comment in the main text area. The text area features word-wrapping and scroll-bar support for longer comments.

The following buttons are unique to this screen:

MORE

Select to show the complete list (i.e., thread) of comments associated with the record. To hide the list, simply select the MORE button again. The comment thread will show the most recent comment first.

Account characteristics are user-defined definitions of an account which may be used to provide additional layers of description. To enter characteristics associated with an account, select the Characteristics tab. The following screen will appear:

Account Characteristics

To create a new characteristic for your current context, select the NEW button from the characteristics list. The following screen will appear:

Create new Characteristic

When creating a new characteristic, you are presented with the following options:

Characteristic

Select a characteristic from the list of characteristics available for your current context. To learn more about how characteristics are linked to specific contexts, please see Section 9.2.2.1, “Characteristic”.

Value

Enter a value to associate with the characteristic.

Default

In some contexts, the Default option will appear. Select if the value entered is the default value for the specified characteristic. Default values will always be listed first where characteristics are used.

To enter or associate tasks, opportunities, or incidents with an account, select the Activities tab. The following screen will appear:

Account Activities

When associating tasks, opportunities, or incidents with an account, you are presented with the following options:

Show

Specify which of the following options you want to include in the list:

Tasks

Select to include tasks in the display. If not selected, tasks will not be included.

Opportunities

Select to include opportunities in the display. If not selected, tasks will not be included.

Incidents

Select to include incidents in the display. If not selected, incidents will not be included.

Projects

Select to include projects in the display. If not selected, projects will not be included.

Show Completed

Select to include the completed activities in the list. If not selected, the completed activities will not be included.

Activities List

Displays tasks, opportunities, incidents, projects associated with the account.

You have the ability to track lot/serial registrations by account. In most cases, registrations must be manually entered. However, in the case of items sold to customers, the system can be configured to automatically track warranty registrations for you.

Tip

If you select the Auto Register Lot/Serial at Shipping option on the item site for an item, then the system will automatically track registrations (by customer) whenever the item is shipped. This applies only to sold items which are lot/serial controlled.

To view a list of lot/serial registrations associated with the account, select the Registrations tab. The following screen will appear:

Account Registrations

When viewing lot/serial registrations associated with the account, you are presented with the following options:

Registrations

Display lists lot/serial registrations associated with the account. The process for creating a new lot/serial registration is described in Section 7.1, “Lot/Serial Registration”.

To associate images and files with an account, select the Documents tab. The following screen will appear:

Account Documents

When associating documents, you are presented with the following options:

NEW

Select to create a new document and associate it with the current record. You may create the following document types:

Image

Select to create a new image association.

Fixed Asset

Select to create a new fixed asset association.

Maintenance Order

Select to create a new maintenance order association.

Incident

Select to create a new incident and associate it.

Project

Select to create a new project and associate it.

Opportunity

Select to create a new opportunity and associate it.

Task

Select to create a new task and associate it.

EDIT

Enables you to edit associated documents. The Edit screen is the same as that for creating a new document—except that when editing, the fields will contain document information. Double-clicking on a document will also bring you to the editing screen.

VIEW

Highlight a document and then select this button to reach a read-only view of the Edit screen.

ATTACH

Select to associate already-existing documents. The following document types may be attached: contact, account, customer, employee, file, image, incident, item, opportunity, project, purchase order, sales order, vendor, web site, work order.

DETACH

Highlight a document and then select this button to remove the association.

To associate already-existing documents, select the ATTACH button. The following screen will appear:

Attach a Document

When associating already-existing documents, you are presented with the following options:

Relationship

Indicate how the document is related to the current record. The following relationship options are available: related to, parent of, child of, duplicate of.

Type

Specify the kind of document you want to associate. The following document types may be attached: contact, account, customer, employee, file, image, incident, item, opportunity, project, purchase order, sales order, vendor, web site, work order. When associating files, you will also be given the option to save the file to the database.

Tip

There is no file size restriction when saving files to the database. However, excessively large files could cause storage and performance issues.

Notes

Leave any notes on the document file as needed.

Document

Use the lookup tool to identify the specific document you want to attach. The data entry options will vary depending on the document type you select.

To view email associated with the CRM account, select the Email tab. The following screen will appear:

Email

When viewing associated emails, you are presented with the following options:

Email list

Display lists associated emails.

Email body

The content of a highlighted email will be displayed here.

Limit to

Specify the maximum number of associated emails you want to be displayed in the email list. If the list is extremely long, you may experience some slowness when opening the screen.

Load All

Select to load all associated emails into the list.

Search

Enter a string of letters or complete words to search for matches in the list of associated emails. The search will scan through subject lines, To addresses, and From addresses.

The following buttons are unique to this screen:

NEW

Select to send a new email, using the default email program on your computer.

PRINT

Highlight an email and then select this button to print a copy of the email.

REPLY

Highlight an email and then select this button to reply to the email's sender, using the default email program on your computer.

REPLY ALL

Highlight an email and then select this button to reply to everyone associated with the email, using the default email program on your computer.

FORWARD

Highlight an email and then select this button to forward the email to another person(s), using the default email program on your computer.

ATTACH

Highlight an email and then select this button to attach an email associated with a contact in your contact list.

DETACH

Highlight an email and then select this button to remove the associated email from the list.