testing16324bool(false)
View Categories

Sales Agent for WooCommerce – Guide

43 min read

Table of Contents

Sales Agent For WooCommerce manages sales agents and their customers. Sales agent for WooCommerce gives you everything you need to calculate commissions on every order.

Store Owner’s Guide – Basic Concepts #

Installation #

  1. Download the plugin zip file from WordPress
  2. Navigate to the WordPress Admin Dashboard > Plugins
  3. Click on the Add New button in the top left corner.
  1. Click the Upload plugin button and upload the zip file of the plugin which you have downloaded earlier.
  2. Click the “Install now” button.
  3. Once installed, click the “Activate” link.

Commission System #

  • Admin can set a commission system from the drop-down menu for the agent.
  • Go to Admin Dashboard => Sales Agent => Commission Category.
  • Set-up the Commission Category or Edit the existing commission.
  • Navigate Commission Type, select Percentage from the drop-down menu.

On Order Basis #

  • Navigate Commission System.
  • Select On Order Basis from the drop-down menu.

Select Product #

  • Navigate Select Product.
  • Select products in the multi-selector box, on which the agent will get commission.
  • Click on Update.

Calculate Commission On Single-Product

  • If the check-box is not checked, then the agent will get the commission on a single product, no matter how much quantity customers buy. 

If the check-box is checked, then the agent will get the commission on a single product, no matter how much the quantity customers buy. 

Front-End Impact #
  • Login with a Sales Agent Account.
  • Go to My Account.
  • Navigate and click on Agent Customers.
  • Search required customers.
  • Navigate and click on Make Order.
  • Agent will be redirected to the Customer Account.
  • Go to the Shop Page.
  • Place an order of products on which the agent will get the commission.
  • Navigate to Admin Dashboard => WooCommerce => Orders.
  • Navigate to the order, and click on it to view the order details.

Calculate Commission On Product Total

  • If the check-box is checked, then the agent will get the commission on the product Total. 
  • Login with a Sales Agent Account.
  • Go to My Account.
  • Navigate and click on Agent Customers.
  • Search required customers.
  • Navigate and click on Make Order.
  • Agent will be redirected to the Customer Account.
  • Go to the Shop Page.
  • Place an order of products on which the agent will get commission.
  • Navigate to Admin Dashboard => WooCommerce => Orders.
  • Navigate to the order, click on it to view the order details.

On Earning Basis #

  • On Earning Basis allows the admin to set a target amount that needs to be sold by the sales agent within the set deadline in order to achieve the commission.
  • Admin can set commission type from the drop-down menu for the customer.
  • Go to Admin Dashboard => Sales Agent => Commission Category.
  • Set-up the Commission Category or Edit the existing commission.

For Percentage Commission Type #

  • Navigate to the Commission Type, and select Percentage from the drop-down menu.
  • Navigate to the Commission System.
  • Select On Earning Basis from the drop-down menu.

On Target Earning #

  • Navigate On Target Earning.
  • Enter the targeted Amount in the box, on which the agent will get commission.
  • Select the Timeline, and enter the number of days, weeks, or months on which it will end the agent commission.
  • Agent commission depends on this timeline, if the agent completes the orders equivalent to or greater than the given Target Amount in the set Timeline, only then will the agent receive the commission amount.
  • Click on the Update button

Front-End

  • Login with a Sales Agent Account.
  • Go to My Account.
  • Click on the Agent Customers.
  • Search required customers.
  • Navigate and click on Make Order.
  • Agent will be redirected to the Customer Account.
  • Go to the Shop Page.
  • Place an order of products on which the agent will get commission.
  • Navigate to Admin Dashboard => WooCommerce => Orders.
  • Navigate order, click on it to view the order.

Agent Dashboard #

  • Agents can check their statistics.
  • Navigate My Account => Agents Statistics.
  • If there is no On Target Commission for sales agents then the status will display INACTIVE and the rest of the boxes will be hidden except On Target Based Commission.
  • When an agent is added to the commission category, the status will be ACTIVE in the On Target Based Commission box, and Sale Status will display INACTIVE.
  • When the agent makes his first sale only then, the Commission timer (Days remaining) will be started, and the Sale Status will display ACTIVE.
  • These all boxes will be updated dynamically.
  • When On Target Basis is selected and the target basis commission system is active, the agent dashboard will show following:
  • On Target Commission  :  Active/Inactive. This will update when an agent has assigned an On Target Commission category.
  • Sale Status: This shows whetherf the sales agent has started the sale yet. If the sale has been started, the status will be ACTIVE; if, the agent has not yet started any sale, it will be INACTIVE.
  • On Target Sale Completed: This will be the amount that is earned up till now by the agent out of the total amount. It will become 0 when reset or the deadline is ended.
  • Pending Amount: This is the remaining amount that the agent needs to earn to get the commission.
  • On Target Sale Total Amount: This is the total target amount set by the admin.
  • Days Remaining: These the remaining days set by the admin in which the agent has to complete the targeted order amount in order to earn the commission.
    • This will change dynamically; if the admin has selected 3 Months from the back-end, then these 3 Months will be converted into days, i.e, 90 Days, and these 90 Days will be displayed in this box.
    • This box will also display the Expires on Time. This will be the date and time when this commission timeline will end.
  • When the deadline is ended i.e Days Remaining is zero, all the boxes will be reset and Sales Status will display INACTIVE.
  • When agents achieve the targeted amount, in their statistics, the Sales Status will be INACTIVE and On Target sale Completed will become zero.
  • Navigate to the Agent Dashboard => My Account => Payout.
  • The commission amount earned by the agent after selling the orders equivalent to the target amount is shown in the agent payout.

For Fixed Commission Type #

  • Navigate Commission Type, and select Fixed from the drop-down menu.
  • Navigate Commission System.
  • Select On Earning Basis from the drop-down menu.

On Target Earning #

  • Navigate On Target Earning.
  • Enter the targeted Amount in the box, on which the agent will get commission.
  • Select the Timeline and enter the number of days, weeks, or months on which it will end the agent commission.
  • Agent commission depends on this timeline, if the agent completes the orders equivalent to or greater than the given Target Amount in the set Timeline, only then agent will receive the commission amount.
  • Click on the Update button.

Front-End

  • Login with a Sales Agent Account.
  • Go to My Account.
  • Navigate and click on Agent Customers.
  • Search required customers.
  • Navigate and click on Make Order.
  • Agent will be redirected to the Customer Account.
  • Go to the Shop Page.
  • Place an order of products on which the agent will get commission.
  • Navigate to Admin Dashboard => WooCommerce => Orders.
  • Navigate order, click on it to view the order.

Agent Dashboard #

  • Agents can check their statistics.
  • Navigate My Account => Agents Statistics.
  • If there is no On Target Commission for sales agents then the status will display INACTIVE and the rest of the boxes will be hidden except On Target Based Commission.
  • When an agent is added in the commission category, status will be ACTIVE in the On Target Based Commission box.
  • When the agent makes his first sale only then the Commission timer (Days remaining) will be started and the Sale Status will display ACTIVE.
  • The amount of the completed order will be added in the On Target Sale.
  • The remaining target amount will be displayed in the Pending Amount.
  • When the deadline is ended i.e Days Remaining is zero, all the boxes will be reset and Sales Status will display INACTIVE.
  • When agents achieve the targeted amount, in their statistics, the Sales Status will be INACTIVE and On Target sale Completed will become zero.
  • Navigate to the Agent Dashboard => My Account => Payout.
  • The commission amount earned by the agent after selling the order equivalent to the target amount is shown in the agent payout.

Number Of Orders #

  • Admin can view the Number Of Orders agent receives. 
  • Navigate to the Admin Dashboard => Sales Agent => Agents.
  • Navigate to the Number Of Orders column in the agents table.
  • Admin can also check the Total Orders while editing an Agent.

Commission Category #

How to add a commission category? #

  • Navigate to Admin Dashboard → Agents → Commission Category.
  • Once you’re on the Commission Category page, you can add a new commission category by filling in the required fields mentioned on the page’s left side.
  • Set the Name for the commission category.
  • Set the Slug for the commission category.
  • Set the Description for the commission category.
  • Select the Commission Type (Fixed or Percentage) for the commission category.
  • Set the Commission Value for the commission category.
  • Select the product in the Select Product option on which the sales agent will earn the commission.
  • Click on the Add new category button.
  • Once you’re Commission Category is successfully created, it will appear on the right side of the page.
  • Similarly, you can create multiple commission categories according to your requirements.

Commission List #

Inside the Commission List:

  • Admin can view commission list/details. 
  • Admin can edit commission list/details.

How to view the commission list? #

  1. Go to agents → Commission List 
    1. Admin can search by agent name and filter by date [from: to]
    2. Admin can export all commissions [export will be applied only if a search is applied]
    3. Agent Name 
    4. Order number 
    5. Order date 
    6. Commission value 
    7. Order Status 
  2. Option to edit or delete

  3. Click on Export button (search applied) → Export CSV

How to change commission status? #

On viewing commission details, the admin can change the status of any commission (Paid/Pending/Cancelled) using a drop-down menu. They can also view details including:

  • Order number 
  • Order date
  • Commission status: admin can change commission status for [pending, paid, canceled]

Sales Agents – Administrator View #

Create a new sales agent #

  • Navigate to Admin Dashboard → Agents → Agents.
  • All the sales agents are mentioned on the Agents page.
  • You can add new sales agents by clicking on the Add New button.
  • Set the First Name of the sales agent.
  • Set the Last Name of the sales agent.
  • Select the Yes or No in the dropdown menu of the Customer Registration option. If Yes is selected, the sales agent would be able to create a customer from the My Account page.
  • Assign any user to the sales agent in the Assign User option.
  • Assign a commission category to your sales agent from the dropdown menu in the Commission Category option.
  • Click on the Create button.
  • Now navigate back to Admin Dashboard → Agents → Agents.
  • You can view the new sales agent created.
  • Similarly, you can create multiple sales agents according to your requirements.
  • You can also filter the sales agents according to the Commission Category.
  • Select the Commission Category.
  • Once done, click on the Filter button.
  • Sales Agents having the selected commission category will be filtered.
  • Hover over any sales agent to view further options.
  • Once done, you can also Edit, Trash, and View Customers of any particular sales agent.

List view of all agents #

Admin can view a list of all agents including details like:

  • Agent username.
  • Agent First/Last name 
  • Customers related to this user
  • Commission category that is assigned to this agent.

Admin will be asked for confirmation if they want to delete a sales agent.

Admin can filter by commission category.

View customers related to sales agents #

Admin can view a list of all customers related to sales agents (created by an agent or assigned to them).

How to view a sales agent’s customers? #

  1. Go to agents → View Customers 
  2. View all customers list by all details.
  3.  Click on View customers.

View customer details #

How to view customer details? #

Admin can view all customer details including:

  1. Go to customer listView details.
    1. Admin can view all customer details.
    2. Admin can change sales agents.
    3. Admin can view all orders related to their customers with all details. 
    4. Admin can search for a specific order.
  2. Click on edit admin to view order details.

Sales Agents – Agent View #

What can sales agents do? #

  • Once the Sales Agent is configured, log in to the website.
  • On the My Account page, we can see four tabs for the Sales Agent.
  1. Agent Statistics 
  2. Agent Customers 
  3. Agent Orders 
  4. Agent Commissions

How can sales agents create customer profiles? #

  • Once the Sales Agent is logged in, navigate to the My Account page.
  • On the Dashboard, navigate to the Agent Customers tab.
  • All the customers of that Agent will appear.
  • Now click on the Create Customer button to add new customers.
  • Fill in the required fields and click on the Save Changes button.
  • Once the customer is created successfully, a notification will appear at the top of the page “Customer details added successfully.
  • Now navigate to the Agent Customers tab on the Dashboard. We can see the customer mentioned, which was recently created.
  • The Agent can view all their customers in the Agent Customers tab.
  • Click on the View button in the Actions column to view all their customers in the Agent Customers tab.
  • All the details of the customer will appear.
  • You can also update the details by clicking on the Edit button.

How can sales agents view their customer list? #

  1. Go to the wp-admin menuAgent Customers 
  2. The agent can view a list of all customers. 
  3. The agent can use filters to view specific customers (if a search is applied).
  4. The agent can view customer details. 
  5. Agents can make orders on behalf of their customers (When clicked, it will switch agents to a customer account. Sales agents will be able to access the Shop, Cart, and Checkout page) 

How can sales agents view customer information & orders? #

  • Agents can view all customer info.
  • Agents can edit all customer info.
  • Agents can view all orders created by customers.
  • Agents can view customer WooCommerce order details.

How can sales agents create an order for customers? #

  • Now, navigate to the Agent Customers tab on the Dashboard.
  • All the customers will appear.
  • Click on the Make Order button in the Actions column of that respective customer.
  • Once done, the agent will log in to the customer’s account.
  • Now Navigate to the Shop page.
  • Click on the Add to Cart button against any item.
  • Now Navigate to the Cart page.
  • Click on the Proceed to checkout button.
  • Now you’ll be on the Checkout page.
  • Click on the Place Order button.
  • The order is successful.

How to view customer orders? #

  • If the Sales Agent is logged in with the customer’s account, navigate to the My Account page and click on the Back to Agent tab on the Dashboard.
  • Once the Sales Agent is navigated to his My Account page, click on the Agent Orders tab on the Dashboard.
  • All the Orders will appear in this tab, and details like Date, Status, and Total.
  • Click on the View button in the Actions column of that respective order.
  • Once done, all the Customer details and Order details related to that order will be displayed.
  • If the order status is Completed, an Order again button will display if you want to order the same item with the same quantity.
  • The Sales Agent can also search any specific order using the search functionality present on the top right in the Agent Orders tab.

How to view agent commissions? #

  • Click on the Agent Commissions tab on the Dashboard.
  • All the Orders will appear in this tab, and details like Order Number, Order Date, Commissions, and Status.
  • A filter will appear at the top of this tab. We can search for the customer in the Filter Customer field. Enter the name of the customer and select it from the dropdown menu. Once done, click on the Filter button.
  • All the orders of that customer will be displayed.
  • Another filter will appear below the Filter Customer option. Set the Start Date and the End Date in the filter. Once done, click on the Filter button.
  • All the orders that took place between the filtered dates will be displayed.
  • Click on the Details button in the Actions column of that order, and the Customer details and Order details related to that order will be displayed.
  • Click on the Delete button in the Actions column of that individual order to remove that order.
  • You may also export order data in the Commissions tab by applying filters.
  • Once the filter is applied, click on the Export button.
  • Once done, a CSV file will be downloaded.
  • Open the CSV file. It will contain all the details of the filtered orders.
  • Click on the Clear button to remove all the filters.

How to view agent statistics? #

  • Click on the Agent Statistics tab on the Dashboard.
  • The statistics will appear in this tab, including the Number of Customers, Commission Percentage, Number of Orders monthly, Total Commission Monthly, Paid Commission monthly, and Pending Commission.

Sales Dashboard #

Sales dashboard options and filters #

  • Go to → wp-admin menuAgentsDashboard
  • Admin can find a monthly report of :
    • Number of created customers by agent current month
    • Number of created sales agents a current month
    • Number of orders of current month
    • Total of commissions monthly
    • Number of paid commissions current month
    • Number of pending commissions current month

General Settings #

How to change general settings? #

  • Navigate to Admin Dashboard → Agents → General Settings.

Once you’re on the General Settings page, all the options will appear.

Setting the number of rows for general pages  #

  • In the List Number Rows option, the Administrator can set the number of rows displayed on the Agent Customer, Agent Customer – Customer Details, Agent Orders, Agent Commissions, and Commission List page.

Agent Customer Page #

  • Navigate to the My Account page on the website.
  • On the Dashboard, navigate to the Agent Customers tab.
Before #
After #

Agent Customer – Customer Details Page #

  • Navigate to the My Account page on the website.
  • On the Dashboard, navigate to the Agent Customers tab.
  • Click on the details button against the customer.
Before #
After #

Agent Order Page #

  • Navigate to the My Account page on the website.
  • On the Dashboard, navigate to the Agent Orders tab.
Before #
After #

Agent Commissions Page #

  • Navigate to the My Account page on the website.
  • On the Dashboard, navigate to the Agent Commissions tab.
Before #
After #

Commission List Page #

  • Navigate to the Admin Dashboard → Agents → Payout.
  • All the Payouts are mentioned on this page.
  • Click the View Payout button against any agent to view his commission list.
Before #
After #

Agent Order Notification

  • In the Agent Order Notification option, If the Administrator clicks on the Enabled checkbox, then when a customer orders anything from the shop page, the Agent assigned to that customer will also receive an email of the order.

Agent Registration #

  • To register an Agent, navigate to WordPress Admin Dashboard > Sales Agent > Registration.
  • You will have two options on the Registration page: Registration List and Registration Form.

Registration Form #

  • Admin can create an Agent Registration form. To create a form, click the Registration Form button.
  • An Agent Registration Form Page will appear.
  • On this Page, by default, First Name, Last Name, Email, Password, and Commission Category form fields will be available.
     
  • The admin can reflect additional fields in the form by dragging and dropping them.
  • Once the admin adds the field, Field Components will appear.
  • Here, the admin can customize it accordingly.
  • Under the Display Tab, the admin can edit the Label and Placeholder.
  • Admin can also set the Placeholder.
  • Under the Validation tab, the admin can make the field required by clicking the Required Checkbox.
  • Admin can set the Conditions for the specific field under the header Conditional.
  • Under the Conditional tab select This component should Display option from the dropdown.
  • Under the ‘when the form component’ dropdown, select the field and specify the ‘Has the Value option’.
  • In our case, there’s no need for a value, so it is empty; provide the required data in the Has the Value section.
  • Click the Save button.
  • Once saved, copy the shortcode.
  • Paste the shortcode on the desired page.

Frontend Impact

  • Fill out the form and click register.
  • The phone number field will appear when there is a value in the Last Name field.

Registration List #

  • Once registered, the admin can view the Registration list by navigating to WordPress Admin Dashboard > WooCommerce > Registration.
  • Admin can view all the Registered Users with their status and details.
  • Admin can Approve or Reject the registered user.
  • Once the Admin Approves or Rejects the registered user, the status will be updated.

Sales Agent Dashboard #

  • Once the Agent orders for his Customer, the Order Amount and Commission Amount will be shown on the Sales Agent Dashboard.
  • The Order Amount indicates the customer’s payment. The Commission Amount reflects the earnings of the Sales Agent on that order displayed on the dashboard.

Filter by Commission Category #

  • Further, the Admin has the capability to sort the list using options such as Select Category, Select Agent, and Select Date from the available filtering options.
  • Navigate to the Select Category filter.
  • Select a Commission Category.
  • Click on the Filter button.
  • The filtered data will be displayed.

Filter by Sales Agent #

  • Navigate to the Select Agent filter.
  • Select a Sales Agent.
  • Click on the Filter button.
  • The filtered data will be displayed.

Filter by Date #

  • Navigate to the Date filter.
  • Select a date.
  • Click on the Filter button.
  • The filtered data will be displayed.

Download CSV #

  • The Admin can also Download the Listing as a CSV by clicking the Download CSV button.
  • After downloading, the admin can view the downloaded CSV.

Sales Agent Information in orders #

  • The Admin can view the Sales Agent information on the Order listing page
  • To view the information, navigate to WooCommerce > Orders.
  • Here, the Admin can view the order details with the Sales Agent’s name and Commission Amount.

Latest Orders in Sales Agents Dashboard #

  • The Agent can view the Latest Orders in the Sales Agent Dashboard. To do so, log in as an Agent and navigate to My Account.
  • Under the My Account header, click Agent Statistics.
  • Once clicked, the Agent can view the Last Order list.

Enable Messages #

  • In the Enable Messages option, If the Administrator clicks on the Enabled checkbox, it will allow the administrator and agents to communicate among themselves through the messages. The agent and administrator can compose new messages.
  • Once the Administrator clicks on the Enabled checkbox, a Messages option will appear in the WP Admin Dashboard.
  • Navigate to Admin Dashboard → Agents → Messages.
  • All the messages are mentioned on the Messages page.
  • You can compose a message by clicking on the Add New button.
  • Set the Title of the message.
  • Select the sales agent from the dropdown menu from the Select Agent option.
  • Type your message in the given Textbox.
  • Click on the Send button.
  • Once done, a notification will appear.
  • As we know, the sales agent Matthew Murdock has the user assigned Burce Wayne.
Front-End Impact #
  • Go to the website.
  • Log in with the Burce Wayne credentials.
  • On the My Account page, navigate to the Messages tab.

NOTE: Whenever the Agents receive a new message, the Messages tab will appear as Messages (New) on the dashboard.

  • All the messages will appear in the Messages tab.
  • Click on the View button on the message.
  • A popup will appear will all the details, and the message will be displayed.
  • The sales agent can type their message in the textbox and click on the Send button.
  • Once done, a notification will appear indicating the message has been sent, and the message will appear with all the details.
  • The sales agent can also compose a new message to the Administrator.
  • Click on the Compose button.
  • A popup will appear to compose your message.
  • Enter the Subject.
  • Enter the Message.
  • Once done, click on the Submit button.
  • A notification will appear, and the message will appear in the Messages tab.
  • Now the Administrator will navigate to Admin Dashboard → Agents → Messages.
  • Now you’re on the Messages page.
  • Hover over the new message to view further options.
  • Click on the Edit suboption.
  • You’re on the Edit Post page now.
  • The message from the Sales agent will appear.
  • The Administrator can also compose a message in the textbox responding to the Sales Agent’s message.
  • Once done, click on the Send button.
  • Once done, a notification will appear.
  • Go to the Messages tab.
  • On the Agent Messages page, the sales agent can click on the Mark as Read button on the New message to make it read.
  • Once done, the New tag will disappear from the messages.
  • The sales agent can click on the Mark as Unread button on any read message, due to which the message will be unread again.
  • Click on the Mark as Inactive button on the message to make it inactive.
  • A Closed tag will appear in the message.
  • The sales agent can click on the Mark as Active button on any Inactive message, due to which the message will be active again.
  • There’s a filter on the Agent Messages page.
  • The sales agent can filter the message using All, Active, and Inactive tags.

Enable Affiliate Links #

  • The Administrator will checkmark the Enable checkbox in the Enable Affiliate Links option.
  • Once the Enable Affiliate Links option is enabled, two suboptions will appear.

Add Create Account Link #

  • Add an account creation/registration link here for affiliate links.
  • Leave it empty if you want the WooCommerce default account link.

Add Shop Link #

  • Add a store/shopping link here for affiliate links.
  • Leave it empty if you want the WooCommerce default store/shop link.
Front-End Impact #
  • The Sales Agent will go to the website and log in.
  • Once done, the Sales Agent will navigate to the My Account page.
  • On the Dashboard, a new tab will appear titled Affiliate Links.
  • Click on the Affiliate Links tab.
  •  Now you’re Affiliate links page.
  • There are three types of affiliate links available on this page.

Registration Link  #

  • It will be a pre-defined registration link with the agent’s reference ID. The agent can copy the link and share it with their customers. Customers registered via the link provided by the agent will be automatically assigned to the respective agent.

Shopping Link #

  • It will be a pre-defined store/shopping link with the agent’s reference ID. The agent can copy the link and share it with their customers. The customers visit the shop and order products via the link provided by the agent.
  • The orders will be linked to the respective agent, and the agent will get the commission on the category assigned.

Product Link Generator  #

  • It will be a pre-defined product link with the agent’s reference ID.
  • The agent will select any product and then navigate to the single product page of that product.
  • Copy the URL of that single product page.
  • Navigate back to the Affiliate links page.
  • Paste the single product page URL in the Product Link Generator option and click on the Get Link button.
  • A popup will appear at the top of the page. 
  • Your link product link will be generated.
  • The agent can copy the link and share it with their customers. The customers visit the store/shop and order products via the link provided by the agent. 
  • The orders will be linked to the respective agent, and the agent will get the commission on the category assigned.

Enable Cart Sharing #

  • In the Enable Cart Sharing option, checkmark the Enabled checkbox. Click on the Save Changes button to apply your settings.
Front-End Impact #
  • The Sales Agent will go to the website and log in.
  • Once done, the Sales Agent will navigate to the My Account page.
  • On the Dashboard, a new tab will appear titled Chart Sharing.
  • Click on the Chart Sharing tab.
  • We can see that at the moment, there is no cart saved.

Cart Sharing Workflow Overview
#

  • Once the Cart Sharing option is enabled, the Sales Agent will log in.
  • On the Dashboard, go to the Cart Sharing tab.
  • We can see that at the moment, there is no cart saved.
  • The Sales Agent will now navigate toward the Shop page and add one or multiple items to the cart.
  • Now navigate to the Cart page.
  • Once done, navigate to the Cart Sharing tab on the My Account page.
  • We can see that the items added to your cart would appear.
  • You can enter the name of this cart sharing and click on the Create button.
  • Once done, a cart will be created, which is mentioned below.
  • Once done, a cart will be created, which will be mentioned below.
  • Click on the Actions column’s Copy button to copy the cart-sharing URL.
  • Now go to the website and log in with a user who is a customer of that specific sales agent.
  • Now paste the URL that you copied from the Cart Sharing tab.
  • Once done, all the items added in the Cart Sharing will be added to the user’s cart.
  • Click on the Proceed to checkout button.
  • Now on the Checkout page, we can see all the items added in the Your order section.
  • Now click on the Place order button.
  • The order is placed successfully.
  • Once the order has been placed successfully, the impact would appear on the agent’s statistics.
  • Navigate to the Agent Statistics tab.

Agent Statistics before the order was placed #

Agent Statistics after the order was placed #

  • Navigate to the Agent Commissions tab.
  • We can see that the commission for that order is $6.80.
  • Click on the Details button against that order.
  • We can see all the details of the order. 

Commission Calculation #

  • As we know, the commission for that order placed using the Cart Sharing link is $6.80.
  • The Commission Category assigned to the agent has a 20% Commission Value on Cap and Beanie.
  • 1 Beanie is for $18.00, and 1 Cap is for $16.00.
    $16.00 + $18.00 = $34.00
    20 percent of 34.00 = $6.80

Enable Announcements #

  • In the Enable Announcements option, If the Administrator clicks on the Enabled checkbox, it will allow the administrator to post announcements to all the sales agents.
  • Once the Administrator clicks on the Enabled checkbox, and Announcements option will appear in the WP Admin Dashboard.
  • Navigate to Admin Dashboard → Agents → Announcements.
  • All the messages are mentioned on the Announcements page.
  • You can create an announcement by clicking on the Add New button.
  • Now you’re on the Edit Announcement page.
  • Set the Title of the announcement.
  • Set the paragraph/ text of the announcement.
  • Click on the Publish button.
Front-End Impact #
  • Go to the website.
  • Log in with the Burce Wayne credentials.
  • On the My Account page, navigate to the Announcement tab.

NOTE: Whenever there’s a new announcement, the Announcements tab will appear as Announcements (New) on the dashboard.

  • All the announcements will appear in the Announcements tab.
  • Click on the announcement to view it.
  • A popup will appear, and all the announcements will be displayed.
  • The Administrator will navigate to Admin Dashboard → Agents → Announcements.
  • Now you’re on the Announcements page.
  • Hover over the announcements to view further options.
  • Click on the Edit suboption.
  • You’re on the Edit Announcement page now.
  • At the bottom of the page, there’s a Select Agent tab.
  • Click on the Select Agent tab.
  • Select the sales agent from the dropdown menu in this tab.
  • The announcement will only appear to the selected sales agent in this tab.
  • Once done, click on the Update button.
  • Since we can see that the sales agent Matthew Murdock is not included, we will log in with the assigned user of this sales agent and navigate to the Announcements tab.
  • We can see that there’s no announcement in the Announcements tab. 

Payouts #

How to apply filters in Payout? #

  • Navigate to the Admin Dashboard → Agents → Payout.
  • All the Payouts are mentioned on this page.
  • Click the View Payout button against any agent to view his commission list.

Filter – Customer Name  #

  • On the Commission List page, a Customer Name filter section is present.
  • The Administrator can filter out the commission list of any particular customer by selecting it from the dropdown menu in the Customer Name filter.
  • Once done, click on the Filter button.

Filter – Start Date and End Date #

  • A Start Date and End Date filter section on the Commission List page is present.
  • The Administrator can filter out the commission list by setting the Start Date and the End Date in the filter. Once done.
  • Once done, click on the Filter button.
  • All the commissions that took place between the filtered dates will be displayed.

How to Export the Commission List? #

  • Apply the filters according to your requirement.
  • Once the filter is applied, click on the Export button.
  • Once done, a CSV file will be downloaded.
  • Open the CSV file. It will contain all the details of the filtered commission list.

Enable Paypal for Payouts #

  • In the Enable Paypal for Payouts option, If the Administrator clicks on the Enabled checkbox, it will allow the sales agent to payout through Paypal.
Front-End Impact #
  • Go to the website.
  • Log in with the sales agent credentials.
  • On the My Account page, navigate to the Payout tab.
  • Once the agent is on the Payout page, click the Configure button.
  • A popup will appear, select the Paypal radio button and then enter the email of the Paypal account of the sales agent.
  • Once the payment method is successfully added, a notification will appear as Thank you! Your Payment Detail has been Saved.
  • Navigate to the Admin Dashboard → Agents → Payout.
  • All the Payouts are mentioned on this page.
  • Click the View Payout button against any agent to view his commission list.

Before Paypal Account details were added #

  • We can see that no payment details were added.

After Paypal Account details were added #

  • We can see that the Paypal Payout Details appear at the top of the page.
  • The Administrator can change the sales agent and status of the commission status.
  • Click on the Edit button against any commission in the Actions column.
  • The Administrator can change the sales agent in the Agent Name option and then enter the name of another sales agent.
  • The Administrator can change the status of the commission in the Commission Status option by selecting the options from the dropdown menu.
  • Once done, click on the Save Changes button.
  • Once the operation is successful, a notification will appear at the top of the page Commission Update successfully.

Enable Bank Transfer for Payouts #

  • In the Enable Bank Transfer for Payouts option, If the Administrator clicks on the Enabled checkbox, it will allow the sales agent to payout through Bank Transfer.
Front-End Impact #
  • Go to the website.
  • Log in with any sales agent credentials.
  • On the My Account page, navigate to the Payout tab.
  • Once the agent is on the Payout page, click the Configure button.
  • A popup will appear, select the Bank Transfer radio button and then enter the required information of the sales agent.
  • Once the payment method is successfully added, a notification will appear as Thank you! Your Payment Detail has been Saved.
  • Navigate to the Admin Dashboard → Agents → Payout.
  • All the Payouts are mentioned on this page.
  • Click the View Payout button against any agent to view his commission list.

Before Bank Transfer details were added #

  • We can see that the Paypal Payout Details appear at the top of the page.

After Bank Transfer details were added #

  • We can see that the Bank Transfer details appear at the top of the page.

Default Sales Agent #

  • In the Default Sales Agent option, the Administrator can select any sales agent and make them a Default Sales Agent, so whenever a new customer register’s through the website registration page, the sales agent assigned to that customer will be the default sales agent.
Front-End Impact #
  • Go to the website.
  • Navigate to the My Account page.
  • Enter your email for registration and click on the Register button.
  • Once the registration is successful, navigate to the WP Admin Panel → Users → All Users.
  • All the users are present on this page.
  • Hover over the user (Clint) to view further options.
  • Click on the Edit suboption.
  • On the Edit User – Clint page, we can see that the agent assigned to this user is Dick Grayson, who was set as the default sales agent.

Sales Agent Commission via Discounts #

  • In this feature, the admin can allow sales agents to provide discount coupons to their customers.
  • Navigate to WordPress Admin Dashboard > Sales Agent > Agents.
  • Hover over the agent you want to edit and click on the Edit option.
  • The Edit Agent screen will appear.
  • Scroll down to the Allow Discount Coupon to Agent option and enable it.
  • After enabling the Allow Discount Coupon to Agent, a Max Agent Discount % field will appear.
  • Enter the maximum discount percentage that the agent can offer to their customers.

PLEASE NOTE: The sales agent will earn a commission based on the discounted price after the coupon is applied.

  • Click on the Update button to save your changes.

Front End Impact – Agent #

  • Login to your WordPress account. Go to the My Account page.
  • Scroll down to the Agent Discount tab.
  • The agent can create a coupon for his users. The maximum allowed discount will be written on the top of the form.
  • The agent can create a coupon by filling out these details.
  1. Coupon Code – The agent will create a unique code for the coupon.
  2. Coupon Discount – The agent can enter the discount value for the coupon. This value must be less than the maximum discount value specified on the form.
  3. Usage Limit – The agent can set the maximum number of times the coupon can be used. This field is optional.
  4. Total Spending – The agent can set the minimum and maximum cart amount to which the coupon can be applied.  This field is optional.
  5. Expiry Date – The agent can set an expiry date for the coupon. The coupon will be automatically disabled after this date. This field is optional.
  • Now click on the Save button to create a coupon.
  • The created coupon will be listed below the form.

Front End Impact – Customer #

  • Login to your Agent WordPress account. Go to the My Account page.
  • Scroll down to the Agent Customers tab.
  • The customer list will appear.
  • Click on the Make Order button to order for a customer.
  • Now the agent will be directed to the Customer account.
  • Go to the Shop page.
  • Add a product to the cart.
  • Click on the Add a Coupon option.
  • Enter the Coupon Code and Click on Apply.
  • The Coupon will be activated and the discounted amount will be deducted from the Cart total.
  • Proceed to the Checkout page.
  • Click on Place Order to complete the order.
  • The customer’s order will be successfully placed.

Sales Agent Groups #

  • This feature allows the admin to create a group of sales agents with a global commission category and max agent discount. The group settings will take priority when an agent is added.
  • Navigate to WordPress Admin Dashboard > Sales Agent > Agents Groups.
  • The Agent Groups list page will appear. Click on the Add New button to add a group.
  • The Add New Group screen will appear. The admin can configure the group details here.
  • The admin can set the group’s name in the Group Title option.
  • The admin can add agents to the group from the Add Agents to Group option.
  • The admin can allow the Agents in the group to register customers from their accounts.
  • The admin can assign the Commision category to the group from the Commision Category drop-down list.

PLEASE NOTE: When an agent is added to the group, the group commission category and max agent discount will take priority over the individual agent’s settings.

  • The admin can allow the agents to give discounts to their customers.
  • If the Allow Discount Coupon to Agents is enabled, the admin can set the value of how much an agent can give discounts.
  • Click on the Create button to create an agent group.
  • Once the group has been created an email will be sent to the Agents.
  • For the Email template of Agent Group, Navigate to WordPress Admin Dashboard > Settings > Emails.
  • The Group will be created and the group details will be displayed on the WordPress Admin Dashboard > Agent Groups.

Sales Manager #

  • This feature allows the admin to create sales managers who will have sub-sales agents. Managers will work as sales agents and earn sub-commissions based on their agents’ sales. Navigate to WordPress Admin Dashboard > Sales Agent > Agents.
  • Hover over the agent you want to edit and click on the Edit option.
  • The Edit Agent screen will appear.
  • Scroll down to the Agent Type option and select Sale Manager.
  • After selecting the Sales Manager, Select the Sales Agent from the multi-selector. These agents will become sub-sales agents.
  • The admin can set the sub-commission value for managers from the sub-sales agent’s sales. For example: If the sub-commission for the sales manager is 5% and the commission for the sub-sales agent is 10% of the total order, then if an agent’s customer makes an order of $1000, the sub-sales agent will earn 10% of $1000, which is $100. From this, 5% of $100, which is $5, will be earned by the sales manager.
  • Click on the update button to save your changes.

Front End Impact – Sub Sales Agent #

  • Login to your WordPress account. Go to the My Account page.
  • Scroll down to the Agent Customer tab. The Customer list will appear.
  • Click on the Make Order button to place an order for your customer.
  • Now the sub-agent will be directed to the Customer account.
  • Go to the Shop page. Add a product to the cart.
  • Proceed to the checkout page and place the order.
  • The order will be placed for the customer.
  • Now move back to the Agent’s account by clicking the Back to Agent option on the My Account page.
  • Once the order is completed, the sub-sales agent will receive their commission after deducting the sales manager’s share. 
  • The sub-sale agent can see the details of the Sales Manager from the Agent Manager tab on the My Account page.

Back End Impact – Sales Manager #

  • Navigate to WordPress Admin Dashboard > Sales Agent > Payout.
  • Click on the View Payout button on the action column of the agent.
  • Switch to the Sub Commission List tab.
  • All the sub-commission earned will be listed here. 

Front End Impact – Sales Manager #

  • Login to your WordPress account. Go to the My Account page.
  • The number of Sub Agents and Sub-Commision Percentage will be displayed in the Agents Statistics tab.
  • Scroll down to the Agent Sub-Commission tab.
  • The sales manager can see the list of sub-sale agents assigned to him. Click on the Subagents tab on the My Account page.
  • The admin can see the details of the Sub Agent by clicking on the View button.
  • The sub-agent’s details, statistics, and Order details will appear.

Rest API #

Authorization #

  • Go to Users.
  • Select and Edit any user you want to assign authorization of APIs.
  • In the User Edit Page insert any name of your application password.
  • Click on the Add New Application password.
  • After Click on New Application Password Unique password will be generated.
  • In the Postman Select Basic Auth from Auth Type from the Authorization Tab.
  • Insert username and Application password in Basic Auth.
  • After configuration, click on Send button to test the authorization.

Without Authorization. #

  • Trying using API without Authorization.

Commission Category  #

  • The Commission API provides functionality for generating, displaying, modifying, and removing Commission systems.
  • Available Routes are mentioned below:
  1. GET: wp-json/sales-agent/v1/category 
  2. GET: wp-json/sales-agent/v1/category/{category_id}
  3. POST: wp-json/sales-agent/v1/category 
  4. PUT: wp-json/sales-agent/v1/category/{category_id}
  5. PATCH: wp-json/sales-agent/v1/category/{category_id}
  6. DELETE: wp-json/sales-agent/v1/category/{category_id}

List Of Commission System (GET) #

Request Example

  • METHOD: GET
  • ENDPOINT: /wp-json/sales-agent/v1/category
  • POSTMAN: Fetch all Commission category
  • POST: sales-agent/v1/category

Response Example

  • STATUS: 200 OK (Fetch all Commission Category)

Retrieve a Commission Category (GET) #

Request Example

  • METHOD: GET
  • ENDPOINT: /wp-json/sales-agent/v1/category/{category_id}
  • POSTMAN: Fetch a specific Commission Category
  • POST: sales-agent/v1/category/category_id

Response Example

  • STATUS: 200 OK (Fetch a specific Commission Category)

Create a Commission Category (POST) #

Request Example

  • METHOD: POST
  • ENDPOINT: /wp-json/sales-agent/v1/category
  • POSTMAN: Create a Commission Category
  • POST: sales-agent/v1/category
  • JSON Body:

{

    “commission_category_name”: “8th Commission”,

    “commission_category_desc”: “8th Commission”,

    “commission_type”: “percentage”,

    “commission_value”: “50”,

    “commission_system”: “earning-basis”,

    “target_earning_amount”: “10”,

    “target_earning_timeline_calendrical”: “target_earning_timeline_days”,

    “target_earning_timeline_days_num”: “1”,

    “target_amount_commission”: “1”

}

Response Example

  • STATUS: 201 CREATED (Commission Category created successfully)
  • STATUS: 400 Bad Request (In case of Duplication)
  • STATUS: 400 Bad Request (In case of Missing Required Fields)

Update a Commission Category (PUT) #

Request Example

  • METHOD: PUT
  • ENDPOINT: wp-json/sales-agent/v1/category/{category_id}
  • POSTMAN: Update Commission Category
  • POST: sales-agent/v1/category/category_id
  • JSON Body:

{

    “commission_category_name”: “8th Commission”,

    “commission_category_desc”: “8th Commission”,

    “commission_type”: “percentage”,

    “commission_value”: “50”,

    “commission_system”: “earning-basis”,

    “target_earning_amount”: “20”,

    “target_earning_timeline_calendrical”: “target_earning_timeline_days”,

    “target_earning_timeline_days_num”: “1”,

    “target_amount_commission”: “2”

}

Response Example

  • STATUS: 200 OKAY (Commission Category is updated successfully)
  • STATUS: 400 Bad Request (In case of Missing Required Fields)

Update a Commission Category (PATCH) #

Request Example

  • METHOD: PATCH
  • ENDPOINT: wp-json/sales-agent/v1/category/{category_id}
  • POSTMAN: Update Commission Category
  • POST: sales-agent/v1/category/category_id
  • JSON Body:
    {

        “commission_type”: “fixed amount”,

        “commission_value”: “10”

}

Response Example

  • STATUS: 200 OKAY (Commission Category is updated successfully)

Delete a Commission System (DELETE) #

Request Example

  • METHOD: DELETE
  • ENDPOINT: /wp-json/sales-agent/v1/category/{category_id}
  • POSTMAN: Fetch all Commission category
  • POST: sales-agent/v1/category/category_id

Response Example

  • STATUS: 200 OK (Delete Commission Category)

Agent  #

  • The Agent API provides functionality for generating, displaying, modifying, and removing Agents.
  • Available Routes are mentioned below:
  1. GET: wp-json/sales-agent/v1/agent 
  2. GET: wp-json/sales-agent/v1/agent/{agent_id} .
  3. POST: wp-json/sales-agent/v1/agent 
  4. PUT: wp-json/sales-agent/v1/agent/{agent_id}
  5. PATCH: wp-json/sales-agent/v1/agent/{agent_id}
  6. DELETE: wp-json/sales-agent/v1/agent/{agent_id}

List Sales Agent (GET) #

Request Example

  • METHOD: GET
  • ENDPOINT: /wp-json/sales-agent/v1/agent
  • POSTMAN: Fetch all Sales Agent
  • POST: sales-agent/v1/agent

Response Example

  • STATUS: 200 OK (Fetch all Sales Agent)

Retrieve a Sales Agent (GET) #

Request Example

  • METHOD: GET
  • ENDPOINT: /wp-json/sales-agent/v1/agent/{agent_id}
  • POSTMAN: Fetch a specific Sales Agent
  • POST: sales-agent/v1/agent/agent_id

Response Example

  • STATUS: 200 OK (Fetch a specific Sales Agent)

Create a Sales Agent (POST) #

Request Example

  • METHOD: POST
  • ENDPOINT: /wp-json/sales-agent/v1/agent
  • POSTMAN: Create Sales Agent
  • POST: sales-agent/v1/agent
  • JSON Body:

{

    “first_name”: “Danke”,

    “last_name”: “Kroos”,

    “Assign_user”:”12″,

    “customer_registration”: “yes”,

    “commission_category_id”: “74”

}

Response Example

  • STATUS: 200 CREATED (Sales Agent created successfully)
  • STATUS: 400 Bad Request (In case of Duplication)
  • STATUS: 400 Bad Request (In case of Missing Required Fields)

Update a Sales Agent (PUT) #

Request Example

  • METHOD: PUT
  • ENDPOINT: /wp-json/sales-agent/v1/agent/{agent_id}
  • POSTMAN: Update Sales Agent
  • POST: sales-agent/v1/agent/agent_id
  • JSON Body:

{

    “first_name”: “agent”,

    “last_name”: “change”,

    “assign_user”: “23”,

    “commission_category_id”: “73”,

    “customer_registration”: “no”

}

Response Example

  • STATUS: 200 OKAY (Sales Agent is updated successfully)
  • STATUS: 400 Bad Request (In case of Missing Required Fields)

Update a Sales Agent (PATCH) #

Request Example

  • METHOD: PATCH
  • ENDPOINT: /wp-json/sales-agent/v1/agent/{agent_id}
  • POSTMAN: Update Sales Agent
  • POST: sales-agent/v1/agent/agent_id
  • JSON Body:

{

            “commission_category_id”: “73”

        }

Response Example

  • STATUS: 200 OKAY (Sales Agent is updated successfully)

Delete a Sales Agent (DELETE) #

Request Example

  • METHOD: DELETE
  • ENDPOINT: /wp-json/sales-agent/v1/agent/{agent_id}
  • POSTMAN: Delete Sales Agent
  • POST: sales-agent/v1/agent/agent_id

Response Example

  • STATUS: 200 OKAY (Sales Agent is deleted successfully)

Payout #

  • GET: wp-json/sales-agent/v1/payout/{payout_id} .
  • PUT: wp-json/sales-agent/v1/payout/{payout_id}
  • DELETE: wp-json/sales-agent/v1/payout/{payout_id}
  • The Payout API provides functionality for generating, modifying, and removing Payout.
  • Available Routes are mentioned below:

List Sales Agent Payouts (GET) #

Request Example

  • METHOD: GET
  • ENDPOINT: /wp-json/sales-agent/v1/payout
  • POSTMAN: Fetch all Payout of a Sales Agent
  • POST: sales-agent/v1/payout/payout_id

Response Example

  • STATUS: 200 OK (Fetch all Payout of a Sales Agent)

Update a Sales Agent Payout (PUT) #

Request Example

  • METHOD: PUT
  • ENDPOINT: /wp-json/sales-agent/v1/payout/{payout_id}
  • POSTMAN: Fetch a specific Sales Agent Payouts
  • POST: sales-agent/v1/payout/payout_id

Response Example

  • STATUS: 200 OK (Fetch a specific Sales Agent)

Delete a Sales Agent Payout (DELETE) #

Request Example

  • METHOD: DELETE
  • ENDPOINT: /wp-json/sales-agent/v1/payout/{payout_id}
  • POSTMAN: Fetch a specific Sales Agent Payouts
  • POST: sales-agent/v1/payout/payout_id

Response Example

  • STATUS: 200 OK (Fetch a specific Sales Agent)