You are browsing the documentation for version 1.6 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Available in OroCRM Available in OroCommerce


In the applications where an integration between Commerce and CRM is configured, the Customer menu contains references to entities from both applications:

The entities under the customer menu

Account and Contact come from CRM, while Customers and Customer Users come from Commerce.

An account and a customer represent a company or a division. A contact and a customer user represent a real person who acts on behalf of the company.

This has been implemented to track this hierarchy independently if CRM or Commerce are installed separately. When both are integrated, additional options to source and retrieve the data become available. You can use the modules separately; for example, if employees work with OroCRM, they can refer to accounts and contacts while those working with OroCommerce can work with Customers and Customer Users. In both cases, they have the ability to track information about companies and people.

Even though the information in Account, Contact, and Customer may seem similar, there is a significant difference that shows the advantage of using CRM and Commerce together.

An account aggregates data from all channels (CRM, Commerce, or others) and all sources (e.g., Contacts, Business Customers, Commerce Customers) providing a 360-degree view of all the information about the company. All interactions with a particular customer are displayed on a single page where you can also track sales though opportunities.

A contact is a CRM concept that is used to associate a person with a specific account. It contains a contact’s personal information, their position in the company, address information, and other related data.

The main difference between a contact and a customer user is that a contact represents a person who may not use the Commerce segment (for example, the CEO of a company who does not buy anything personally).

Another important concept is a Customer. Out-of-the-box, OroCommerce supports three types of customers:

  • OroCommerce Customers (from Commerce package) are used to represent OroCommerce-specific data, such as Commerce Customers, Commerce Customer Users, Shopping Lists, RFQs, Quotes, Orders, and Opportunities.
  • Business Customers (from CRM package) are used to represent Business Customers who are not Commerce Customers and also CRM-specific data, such as B2B Customers, Contacts, Leads, Opportunities.

Additionally, you can associate Lifetime Sales Value with a customer and track financial statistics related to a specific customer or account.

Below is an illustration of the account hierarchy where CRM-related concepts are marked grey, and Commerce-related concepts are marked white.

An illustration of the account hierarchy