• Installing Magento 2 Sales Representative
• Uninstalling M2 Sales Representative
• Compatibility
• Introducing M2 Sales Representative
• Creating Sales Representatives
• Backend Configurations
• Storefront
• Integration with Aheadworks Modules

Magento 2 Sales Representative tool assigns personal managers to certain orders, customers, and customer groups to improve customer service and sell products more effectively.

Installing Magento 2 Sales Representative

Command Line Installation

1. Backup your web directory and store database
2. Download the Sales Representative installation package
3. Upload contents of the Sales Representative installation package to your store root directory
4. In SSH console of your server navigate to your store root folder:

cd path_to_the_store_root_folder

run:

php bin/magento module:enable Aheadworks_Bup
php bin/magento module:enable Aheadworks_SalesRepresentative

then:

php bin/magento setup:upgrade

after:

php bin/magento setup:static-content:deploy -f

     5. Flush store cache; log out from the backend and log in again

Composer Installation

If you are installing an extension from Aheadworks for the first time, you need to add our composer repository to your Magento store:

     1. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

Run the following command:

composer config repositories.aheadworks composer https://dist.aheadworks.com/

On successful execution of the commands you will be able to use the composer to install the extensions.

To install the extension:

     2. Login to your ssh console and navigate to your store folder:

cd path_to_the_store_root_folder

     3. Run the following command to install the latest version of the extension:

composer require aheadworks/module-sales-representative

if you need to install a specific version, run this command:

composer require aheadworks/module-sales-representative:<version>

When prompted, enter Public Key (Username) and Private Key (Password):

Both Public Key (Username) and Private Key (Password) can be found in My Projects and Licenses in your personal account on our site:

 Run the following command to install Sales Representative GraphQl:   

composer require aheadworks/module-sales-representative-graph-ql

 4. Enable the extension:

php -f bin/magento module:enable Aheadworks_Bup
php -f bin/magento module:enable Aheadworks_SalesRepresentative
php -f bin/magento module:enable Aheadworks_SalesRepresentativeGraphQl

Next, register the extension:

bin/magento setup:upgrade

Recompile your Magento store if you are in the Production mode:

bin/magento setup:di:compile

To verify that the extension is enabled, run this command:

bin/magento module:status

Clean store cache, by running the following command:

bin/magento cache:clean

Log out and Log in the backend again.

To upgrade the extension:

     5. To update or upgrade an extension:

Download the updated extension file. Take note of the module-name and version. Export the contents to your Magento root.

If a composer package exists for the extension, run one of the following.

Update per module name:

composer update aheadworks/module-sales-representative

Updater per version:

composer require aheadworks/module-sales-representative:<version>

Run the following commands to upgrade, deploy, and clean the cache.

php bin/magento setup:upgrade --keep-generated
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Uninstalling M2 Sales Representative

Since Magento introduced declarative Database you need to be very carefull when uninstalling or disabling the module.

Manual Removal

1. Disable the module by executing the following commands:

php bin/magento module:disable Aheadworks_SalesRepresentative
php bin/magento setup:upgrade

2. Remove the extension files from the following folder:

app/code/Aheadworks/SalesRepresentative

Automatic Removal (via Composer)

1. Disable the module by executing the following commands:

php bin/magento module:uninstall Aheadworks_SalesRepresentative

Compatibility

Introducing M2 Sales Representative

The Sales Representative Extension for Magento 2 enables the role of a personal manager in a store. The extension allows creating sales representatives and assigning them to customer groups and individual customers. Orders can be ascribed to. With the present extension, you are able to do the following:

• Create sales managers
• Assign sales representatives to customer groups
• Ascribe orders to sales representatives
• Assign personal sales representatives to customers
• Display the contact information of a sales representative for a customer     
• Enhanced with Company Accounts and Cart to Quote

Integrations

• B2B Extension Suite
• Requisition List
• Company Credit
• Reward Points
• Cart to Quote
• Store Credit and Refund
• Payment & Shipping Restrictions
• Customer Segmentation
• GraphQL
• Web API

Creating Sales Representatives

Sales Representative Permissions 

Start creating a sales representative by adding a new user role in System → Permissions → User Roles. Configure Role Info and Role Resources just as usual. 

Then, go to the Advanced Permissions tab. Here you can specify if the user will have access to Sales, Customers, and Custom Price. Do that with the help of the Allow Access to Sales, Allow Customer Price, and Allow Access to Customers selectors.

• If you choose YES in the Access to Sales dropdown, this user sees and manages only those sales resources that are assigned to him;
• If you choose YES in the Access to Customers dropdown, this user sees and manages only those customers resources that are assigned to him;
• If you choose NO in the Allow Custom Price dropdown, the Custom Price checkbox is unavailable for this user while creating order in Admin.

Additional Information about Sales Representative 

Next, add a new user in System → Permissions → All Users. Enter all the necessary User Info and choose User Role. In the Additional User Information tab the following fields are presented:

• User Status - make a sales representative active or inactive. If the chosen value is ‘inactive’, the sales representative is no longer assigned to the orders.
• Display Name - enter the sales representative’s name to display it on the Storefront.
• Email - enter the sales representative’s email here.
• Phone Number - enter the sales representative’s phone number.
• Image - upload/delete the sales representative’s photo. Mind that only jpg, jpeg, gif, and png file types are allowed.
• Additional Information - enter any necessary information to display on the Storefront.

Any input field can be left empty if there is no need to display such user information for customers. 

Backend Configurations

Assign Sales Representative to Customer Group 

If you want sales representatives to be assigned to orders automatically, choose sales representatives for customer groups in Stores → Settings → Configurations → Aheadworks → Sales Representative. 

After clicking ‘Add’ button in the Conditions tab, you can assign sales representatives to customer groups:

• Customer Group - a dropdown with the list of all customer groups in the store.
• Sales representative Name - a dropdown with the list of all users created on All Users page.
• Action - ‘trash’ button that allows you to delete options.

One sales manager can be chosen for several customer groups while one customer group cannot have several sales representatives. 

Email Settings 

Email Settings tab includes:

• Email sender - the one who sends emails to sales representatives.
• Email template - an email that a sales representative receives after having been assigned to a new order (Aheadworks SalesRepresentative template is set by default).

Assign Sales Representative to Order 

Sales managers can be assigned to orders manually on Sales > Orders > Order View page. You can find Sales Representative section in the Account Information tab: 

• Sales Representative - a dropdown with the list of both active and inactive sales managers. You can assign a user from the list to the order or choose ‘Not Assigned’ value to leave the order without any sales representative.  

Click the ‘Save’ button near the dropdown to save the changes. If a sales representative has been chosen for an order, a confirmation email with the order details will be sent to this sales representative. 

Assign Sales Representative to Customer 

What is more, a dedicated sales representative can be chosen for a customer in Customers → All Customers. There are two options to do so:

• Choose a sales representative in the corresponding column of the Customers Grid.
• Choose a sales representative in the individual tab on the Customer Information page.

Let’s look at the Customer Grid first. 

If you assign a sales representative in the Customer grid, you just need to click on the row of a particular customer. As soon as the quick editing mode has been activated, a dropdown with the list of all sales representatives appears in the corresponding column. The ‘Not Assigned’ value is displayed here too, in case a sales representative has to be unassigned from any customer. 

Click ‘Save’ to save all the changes in the grid. Click ‘Cancel’ to abandon any changes.

Assigning sales representatives to customers in bulk is also applicable. You just need to select customers in the first column via checkbox and choose ‘Edit’ in the Actions dropdown. Having chosen the right option, click ‘Apply’ and ‘Save Edits’ above the grid to save the changes.

The second option - the Sales Representative tab on the Customer Information page. 

Here you see the same dropdown as in the Customer grid and on the Order View page.

As long as a customer has an appointed sales representative, his/her orders are assigned to this sales representative. If a customer has no appointed sales representative, his/her orders are assigned to the sales representative specified for his/her customer group.

Storefront

Sales Representative Infoblock

Sales manager’s contact information is available for signed-in customers on My Account → My Orders → Order View page. There is a special block with the data about a sales representative specified in the Additional Information tab on the  backend:

• sales manager’s name;
• email;
• phone number;
• additional information;
• photo. 

If it’s necessary, the contact information of a sales representative can be added to the order confirmation email for guests and logged-in customers. All you need to do is to insert the ‘Sales Representative Information’ variable while creating a new order confirmation email template. Here is an example of what the email can look like: 

Integration with Aheadworks Modules

Sales Representative for Magento 2 can enhance the functionality of some Aheadworks modules, namely:

• M2 Company Accounts
• M2 Cart to Quote
• Customer Segmentation

Company Accounts

When M2 Company Accounts is installed on the store alongside M2 Sales Representative, the Admin gets able to appoint sales representatives to companies. Sales representatives can be appointed to companies automatically in compliance with the company users' belonging to a customer group, or manually and individually to each company. By appointing sales representatives to companies, that is users created with the help of M2 Sales Representative, the Admin can demarcate access for these users to the data on the companies. 

Integration of M2 Company Accounts enables the Allow Access to Companies option in the Advanced Permissions Tab on a User Role page. When set to Yes, this user role will allow users to access data in the Companies grid.

It must be mentioned here, that M2 Company Accounts, when used on its own, has an option of assigning sales representatives to companies. With regard to this fact, M2 Sales Representative is meant to enhance M2 Company Accounts as follows:

• Sales Representative (Conditions) is added as an option to the dropdown Default Sales Representative at Stores → Configuration → Aheadworks Extensions → Company Accounts 

• A hint is added to explain the use of Sales Representative (Conditions) and to give quick access to Stores → Configuration → Aheadworks Extensions → Sales Representatives → Conditions: “If Sales Representative (Conditions) is selected, Default Sales Representative is assigned to a new company according to conditions specified here {link to SR conditions}”

• Sales Representative (Conditions) is the default value of Default Sales Representative when M2 Company Accounts and M2 Sales Representative are installed one after another for the first time on the store. Otherwise, if M2 Company Accounts has already been in use, and M2 Sales Representative is added to the store, the default value of Default Sales Representative remains unchanged. The latter aspect allows companies that have been created before the installation of M2 Sales Representative to keep on working with the appointed to them earlier sales representatives.

Cart to Quote

When M2 Cart To Quote is installed on the store alongside M2 Sales Representative, the Admin gets able to assign Sales Representatives to quotes. Sales representatives can be appointed to quotes automatically in compliance with the customers belonging to a customer group, or manually and individually to each quote. By assigning quotes to sales representatives, that is users created with the help of M2 Sales Representative, the Admin can demarcate access for these users to the data on the quotes. 

M2 Cart to Quote, when used on its own, has an option of assigning sales representatives to quotes. With regard to this fact, M2 Sales Representative is meant to enhance M2 Cart To Quote as follows:

• Sales Representative (Conditions) is added as an option to the dropdown "Admin User Quote is Assigned to" at Stores → Configuration → Aheadworks Extensions → Cart to Quote 

• A hint is added to explain the use of Sales Representative (Conditions) and to give quick access to Stores → Configuration → Aheadworks Extensions → Sales Representatives → Conditions: “If Sales Representative (Conditions) is selected, Default Sales Representative is assigned to a new company according to conditions specified here {link to SR conditions}”

• Sales Representative (Conditions) is the default value of "Admin User Quote is Assigned to" when M2 Cart To Quote and M2 Sales Representative are installed one after another for the first time on the store. Otherwise, if M2 Cart To Quote has already been in use, and M2 Sales Representatives is added to the store, the default value of "Admin User Quote is Assigned to" remains unchanged. The latter aspect allows quotes that have been created before the installation of M2 Sales Representative to keep on being monitored by the appointed to them earlier sales representatives.
• Automatic emails are sent to users indicated as sales representatives in "Admin User Quote is Assigned to" when quotes are assigned to them.

Customer Segmentation

Integration of M2 Customer Segmentation enables the Assign Sales Representative by AW Customer Segment option in the Conditions Tab.  Assign Sales Representative by AW Customer Segment option takes precedence over Assign Sales Representative by Customer Group option.

Product Page