Salesman Profile

From UG

Revision as of 19:35, 13 August 2010 (edit) Andrei (Talk | contribs) m (change name of local link to Design) ← Older edit		Current revision as of 22:35, 11 January 2011 (edit) (undo) Andrei (Talk | contribs) (→Figures: removed Figure 2, renamed Figure 3)
(22 intermediate revisions not shown)
Line 3:		Line 3:
	== General Info ==		== General Info ==
-	* mantis: http://mantis.jaguarfreight.com/mantis/view.php?id=2051	+	* mantis: http://mantis.jaguarfreight.com/mantis/view.php?id=2052
-	* Related Terminology and Concepts - read [[Salesman]]	+
-	== Business Need ==	+	== Salesman Functionality Overview ==
-	Ability to manage Salesmen Life cycle.	+	There are 3 components at the moment:
-	== Business Requirements ==	+	* Salesman Profile:
		+	** tag jag user as a salesman
		+	** manage commission schedule
		+	** manage salesman accounts
		+	** manage monthly targets
-	=== Prerequisites ===	+	* [http://mantis.jaguarfreight.com/wiki/Commissions_Report Commissions Report]
-	See [[Salesman]] object.	+	* [http://mantis.jaguarfreight.com/wiki/Salesman_Target_Report Salesman Target Report]
-	=== Access Restrictions ===	+	* Misc: set access permissions
-	* These Salesman Commission Schedules and Salesman Accounts should not be visible to most users	+	** These Salesman Commission Schedules and Salesman Accounts should not be visible to most users
-	* They should be limited to management users only	+	** They should be limited to management users only
-	== Design ==	+	== Concepts ==
-	=== Access Restrictions ===	+	=== Salesman ===
-	* Access Restrictions to info from Salesman Profiles should be limited to management users only. Access control proceeds in Users Admin Access window in "Acc.Sales Persons" line. See on [[#Figure 0. Users Access Admin window | Figure 0]].	+
-	=== Interface ===	+	'''Salesman''' - jaguar employee who is in search for new companies who need to ship goods. Once such company agrees to send us orders ([[CT]]s) [[Inside Sales]] operators would create new [[Client Company]] in CT2. We call such company a '''Salesman Account'''.
-	* All [http://mantis.jaguarfreight.com/wiki/Salesman_Concepts#Salesman Salesman] info and controls are available through Sales Persons interface ("Acc -> Sales Persons"). See on [[#Figure 1. Sales Persons menu item | Figure 1]].	+
-	* Sales Persons table contains list of all Salesman Profiles. This table looks the same like "Jaguar Users" table in Admin. See on [[#Figure 2. Sales Persons table | Figure 2]].	+
-	* Each Salesman Profile shows in "Add/Edit Salesman Profile" window.  See on [[#Figure 3. Salesman Profile window | Figure 3]] or [http://64.115.223.6/proto/2052/EditSalesmanProfile.zul ZUL-prototype]. This window contains three tables:	+
-	** '''Commision Shedule table'''	+
-	*** This table corresponds to the [http://mantis.jaguarfreight.com/wiki/Salesman_Concepts#Commission_Schedule Commission Shedule] specification and represents change in [http://mantis.jaguarfreight.com/wiki/Salesman_Concepts#Commission_Percentage Commission Percentage] of current Salesman.	+
-	*** System keeps history of all set Percentage values of Salesman for each Time frame, but displays only actual of them.	+
-	*** Table consists of three columns:	+
-	**** Time Frame - time in years has elapsed since [http://mantis.jaguarfreight.com/wiki/Salesman_Concepts#Commission_Start_Date Commission Start Date].	+
-	**** Commission Percentage - number representing share of a Jaguar profit that is due to the current Salesman.	+
-	**** Date Set - date of set percentage value for Time frame for the current Salesman.	+
-	*** Current Salesman has same schedule for all of his [http://mantis.jaguarfreight.com/wiki/Salesman_Concepts#Salesman_Account Salesman Accounts].	+
-	** '''Salesman Accounts table'''	+
-	*** This table contains list of all Salesman Accounts with appropriate Commission Start/End Dates.	+
-	*** Table consists of three columns:	+
-	**** Client Company (=Salesman Account) - company which agrees to send us orders (CTs).	+
-	**** Commission Start Day - first date to calculate commission for specified Client Company.	+
-	**** Commission End Day - last date to calculate commission for specified Client Company.	+
-	** '''Salesman Monthly table'''	+
-	*** This table contains list of set '''target''' Salesman Montly values.	+
-	*** Table consists of two columns:	+
-	**** "Year-Month" pair of Salesman Monthly.	+
-	**** Salesman [http://mantis.jaguarfreight.com/wiki/Salesman_Concepts#Salesman_Monthly_Target Monthly Target] value.	+
-	== Detailed Design ==	+	===Salesman Account ===
		+	See [[#Salesman]]
-	=== Normal Workflows ===	+	=== Commission ===
-	Each workflow below corresponds to significant "business events" related to Salesman life cycle.	+	'''Commission''' - see also http://en.wikipedia.org/wiki/Commission_(remuneration)
-	All operations are done under Acc > Salesman Panel	+	=== Commission Percentage ===
-	==== New Salesman Hired ====	+	'''Commission Percentage''' is a number. It represents share of a Jaguar profit that is due to the [[#Salesman]] (as it is a part of her compensation). This number changes - see [[#Commission Schedule]].
-	1) Identify Jaguar User as a Salesman	+	=== Commission Start Date ===
-	* Check Sales Person check box on Jag User Profile	+	''' Commission Start Date ''' - first date to calculate commission. This is [[Client Company]] specific.
-	* (we assume new Jag User has been created)	+
-	2) Set Commission Schedule	+	=== Commission Schedule ===
-	* Goto Acc > Salesman	+	'''Commission Schedule''' - represents change in [[#Commission Percentage]] based on how much time has elapsed since [[#Commission Start Date]].
-	* Select Salesman, click Edit	+
-	* Goto "Commission Schedule" section	+
-	* edit commission percentage	+
-	==== Set Monthly target for Salesman (first time) ====	+	''Example:''
-	* Goto Acc > Salesman	+	* 1st year commission at 10%
-	* Select Salesman, click Edit	+	* 2nd year commission at 7%
-	* Goto "Monthly Targets" section	+	* 3rd year commission at 3%
-	* Add targets for next 6 months	+	* 4th year and on commission 0%
		+	These numbers are [[#Salesman]] specific. They are stored in the [http://mantis.jaguarfreight.com/wiki/Salesman_Profile#Interface Commision Shedule table] of the [[Salesman Profile]].
-	==== Salesman gets his first account ====	+	Given [[#Salesman]] has same schedule for all of his [[#Salesman Account]]s.
-	* Goto Acc > Salesman	+	=== Commission Amount ===
-	* Select Salesman, click Edit	+
-	* Goto "Accounts" section	+
-	* Add Account	+
-	** set client company	+
-	** set start date	+
-	==== Calculate Salesman Commissions ====	+	'''Commission Amount''' - dollar amount of commission that given [[#Salesman]] receives for specific [[#Client Company]] for specific Time Frame.
		+	* The calculation of [[Gross Profit]] should include all individual CTs that have [[Sailing Date]] within this Time Frame.
		+	* The calculation of commissions uses [[#Commission Schedule]] and is based upon '''profit''' CT only:
		+	:* if a profit on that CT, then there is commission due
		+	:* if a loss on that CT, then there is NO commission due
-	==== Generate Salesman Target Report ====	+	''Example 1''
-	==== Update Monthly target for Salesman ====	+	Assume that:
-	==== Add additional accounts ====	+	* for Client Company ABC Corp. salesman John Smith has a Commission Percentage of 10% for Dec 2009 and 5% for Jan 2010
		+	* [[Gross Profit]] for Client Company ABC Corp. for Dec 2009 is 2000 USD
		+	* [[Gross Profit]] for Client Company ABC Corp. for Jan 2010 is 1000 USD
		+	* Commission Start Date of John Smith for Client Company ABC Corp. is Jan 1, 2009
-	==== Close Accounts ====	+	Then Commission Amount for Client Company ABC Corp., salesman John Smith and time frame ''from Dec 1, 2009 to Jan 31, 2010'' is:
-	* set Commission End Date	+	2000 x .10 + 1000 x .05 = 200 + 50 = 250
-	==== Change Commission schedule ====	+	=== Salesman Monthly Target ===
		+	A dollar figure '''set''' by the VP of sales that a salesman is to reach per calendar month for all of his [[#Salesman Account]]s.
-	==== Delete or Archive Salesman ====	+	=== Salesman Monthly Actual ===
		+	It is '''calculated''' by adding all profit values for all shipments associated with all of her accounts.
-	=== Some Exceptional Workflows ===	+	== Design ==
-	==== Salesman hired with accounts ====	+	=== Access Restrictions ===
		+	* Access Restrictions to info from Salesman Profiles should be limited to management users only.
-	==== Client added by mistake ====	+	=== Data Tables ===
		+	* There are three tables for Salesman feature:
		+	** '''Commision Shedule table'''
		+	*** This table corresponds to the [[#Commission_Schedule]] specification and represents change in [[#Commission_Percentage |Commission Percentage]] of current Salesman.
		+	*** System keeps history of all set Percentage values of Salesman for each Time frame, but displays only actual of them.
		+	*** Table consists:
		+	**** Time Frame - time in years has elapsed since [[#Commission_Start_Date]].
		+	**** Commission Percentage - number representing share of a Jaguar profit that is due to the current Salesman.
		+	**** Date Set - date of set percentage value for Time frame for the current Salesman. ''details needed'' --[[User:Andrei|Andrei]] 17:31, 11 January 2011 (EST)
		+	*** Current Salesman has same schedule for all of his [[#Salesman_Account]].
		+	** '''Salesman Accounts table'''
		+	*** This table contains list of all Salesman Accounts with appropriate Commission Start/End Dates.
		+	*** Table consists:
		+	**** Client Company (=Salesman Account) - company which agrees to send us orders (CTs).
		+	**** Commission Start Day - first date to calculate commission for specified Client Company.
		+	**** Commission End Day - last date to calculate commission for specified Client Company.
		+	** '''Salesman Monthly table'''
		+	*** This table contains list of set '''target''' Salesman Montly values.
		+	*** Table consists:
		+	**** "Year-Month" pair of Salesman Monthly.
		+	**** Salesman [[#Salesman_Monthly_Target]] value.
-	==== No targets set ====	+	== Detailed Design ==
-	== Figures ==	+	=== Business Workflows and Events ===
-	=== Figure 0. Users Access Admin window ===	+	'''Normal Workflows:'''
-	[[File:Usersaccessadmin_salespersons.gif]]	+
-	=== Figure 1. Sales Persons menu item ===	+
-	[[File:Accmenu_sales_persons.gif]]	+
-	=== Figure 2. Sales Persons table ===	+
-	[[File:Sales_persons_table.gif]]	+
-	=== Figure 3. Salesman Profile window ===	+
-	[[File:Salesman_profile.gif]]	+
-	== History ==	+	* New Salesman Hired
		+	* Set Monthly target for Salesman (first time)
		+	* Salesman gets his first account
		+	* Calculate Salesman Commissions
		+	* Generate Salesman Target Report
		+	* Update Monthly target for Salesman
		+	* Add additional accounts
		+	* Close Accounts
		+	* Change Commission schedule
		+	* Delete or Archive Salesman
-	=== m2052 ===	+	'''Some Exceptional Workflows:'''
-	* mantis [http://mantis.jaguarfreight.com/mantis/view.php?id=2052 2052]	+
-	==== BA ====	+	* Salesman hired with accounts
		+	* Client added by mistake
		+	* No targets set
-	* see [[#Business Requirements]]	+	== Figures ==
-	==== SA ====	+	=== Consolidated Example of Data Tables ===
		+	[[File:Salesman_profile.gif]]
		+
		+	== History ==
-	see [[#Design]]	+	=== 0002052: (Salesman: Profile) Create this new component ===

---

Current revision as of 22:35, 11 January 2011

Contents 1 General Info 2 Salesman Functionality Overview 3 Concepts 3.1 Salesman 3.2 Salesman Account 3.3 Commission 3.4 Commission Percentage 3.5 Commission Start Date 3.6 Commission Schedule 3.7 Commission Amount 3.8 Salesman Monthly Target 3.9 Salesman Monthly Actual 4 Design 4.1 Access Restrictions 4.2 Data Tables 5 Detailed Design 5.1 Business Workflows and Events 6 Figures 6.1 Consolidated Example of Data Tables 7 History 7.1 0002052: (Salesman: Profile) Create this new component

[edit] General Info

• mantis: http://mantis.jaguarfreight.com/mantis/view.php?id=2052

[edit] Salesman Functionality Overview

There are 3 components at the moment:

• Salesman Profile:
  • tag jag user as a salesman
  • manage commission schedule
  • manage salesman accounts
  • manage monthly targets

• Commissions Report
• Salesman Target Report

• Misc: set access permissions
  • These Salesman Commission Schedules and Salesman Accounts should not be visible to most users
  • They should be limited to management users only

[edit] Concepts

[edit] Salesman

Salesman - jaguar employee who is in search for new companies who need to ship goods. Once such company agrees to send us orders (CTs) Inside Sales operators would create new Client Company in CT2. We call such company a Salesman Account.

[edit] Salesman Account

See #Salesman

[edit] Commission

Commission - see also http://en.wikipedia.org/wiki/Commission_(remuneration)

[edit] Commission Percentage

Commission Percentage is a number. It represents share of a Jaguar profit that is due to the #Salesman (as it is a part of her compensation). This number changes - see #Commission Schedule.

[edit] Commission Start Date

Commission Start Date - first date to calculate commission. This is Client Company specific.

[edit] Commission Schedule

Commission Schedule - represents change in #Commission Percentage based on how much time has elapsed since #Commission Start Date.

Example:

• 1st year commission at 10%
• 2nd year commission at 7%
• 3rd year commission at 3%
• 4th year and on commission 0%

These numbers are #Salesman specific. They are stored in the Commision Shedule table of the Salesman Profile.

Given #Salesman has same schedule for all of his #Salesman Accounts.

[edit] Commission Amount

Commission Amount - dollar amount of commission that given #Salesman receives for specific #Client Company for specific Time Frame.

• The calculation of Gross Profit should include all individual CTs that have Sailing Date within this Time Frame.
• The calculation of commissions uses #Commission Schedule and is based upon profit CT only:

• if a profit on that CT, then there is commission due
• if a loss on that CT, then there is NO commission due

Example 1

Assume that:

• for Client Company ABC Corp. salesman John Smith has a Commission Percentage of 10% for Dec 2009 and 5% for Jan 2010
• Gross Profit for Client Company ABC Corp. for Dec 2009 is 2000 USD
• Gross Profit for Client Company ABC Corp. for Jan 2010 is 1000 USD
• Commission Start Date of John Smith for Client Company ABC Corp. is Jan 1, 2009

Then Commission Amount for Client Company ABC Corp., salesman John Smith and time frame from Dec 1, 2009 to Jan 31, 2010 is:

2000 x .10 + 1000 x .05 = 200 + 50 = 250

[edit] Salesman Monthly Target

A dollar figure set by the VP of sales that a salesman is to reach per calendar month for all of his #Salesman Accounts.

[edit] Salesman Monthly Actual

It is calculated by adding all profit values for all shipments associated with all of her accounts.

[edit] Design

[edit] Access Restrictions

• Access Restrictions to info from Salesman Profiles should be limited to management users only.

[edit] Data Tables

• There are three tables for Salesman feature:
  • Commision Shedule table
    • This table corresponds to the #Commission_Schedule specification and represents change in Commission Percentage of current Salesman.
    • System keeps history of all set Percentage values of Salesman for each Time frame, but displays only actual of them.
    • Table consists:
      • Time Frame - time in years has elapsed since #Commission_Start_Date.
      • Commission Percentage - number representing share of a Jaguar profit that is due to the current Salesman.
      • Date Set - date of set percentage value for Time frame for the current Salesman. details needed --Andrei 17:31, 11 January 2011 (EST)
    • Current Salesman has same schedule for all of his #Salesman_Account.
  • Salesman Accounts table
    • This table contains list of all Salesman Accounts with appropriate Commission Start/End Dates.
    • Table consists:
      • Client Company (=Salesman Account) - company which agrees to send us orders (CTs).
      • Commission Start Day - first date to calculate commission for specified Client Company.
      • Commission End Day - last date to calculate commission for specified Client Company.
  • Salesman Monthly table
    • This table contains list of set target Salesman Montly values.
    • Table consists:
      • "Year-Month" pair of Salesman Monthly.
      • Salesman #Salesman_Monthly_Target value.

[edit] Detailed Design

[edit] Business Workflows and Events

Normal Workflows:

• New Salesman Hired
• Set Monthly target for Salesman (first time)
• Salesman gets his first account
• Calculate Salesman Commissions
• Generate Salesman Target Report
• Update Monthly target for Salesman
• Add additional accounts
• Close Accounts
• Change Commission schedule
• Delete or Archive Salesman

Some Exceptional Workflows:

• Salesman hired with accounts
• Client added by mistake
• No targets set

[edit] Figures

[edit] Consolidated Example of Data Tables

[edit] History

[edit] 0002052: (Salesman: Profile) Create this new component