Salesman Profile

From UG

(Difference between revisions)
Jump to: navigation, search
(Figures: removed Figure 2, renamed Figure 3)
 
(60 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 Requirements ==
+
== Salesman Functionality Overview ==
-
=== Core Need ===
+
There are 3 components at the moment:
-
Ability to manage all JFS salesmen.
+
-
=== Requirements ===
+
* Salesman Profile:
 +
** tag jag user as a salesman
 +
** manage commission schedule
 +
** manage salesman accounts
 +
** manage monthly targets
-
Need [[CRUD]] interface to [[Salesman]] object.
+
* [http://mantis.jaguarfreight.com/wiki/Commissions_Report Commissions Report]
 +
* [http://mantis.jaguarfreight.com/wiki/Salesman_Target_Report Salesman Target Report]
-
== Preliminary Design ==
+
* 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
-
* So far as Salesman [[http://mantis.jaguarfreight.com/wiki/Salesman#Salesman]] is Jaguar employee, could be assumed that Salesman info should be controlled from Admin interface in "Add/Edit Jaguar User" window ("Admin -> Users and Offices -> Jaguar Users").
+
== Concepts ==
-
* Salesman sign is checked "Sales Person" checkbox in section "Part B. Other".
+
 
-
* For control of Salesman properties suggested to change standard Jaguar User window ([[#Figure 1. Jaguar User window (initial) | Figure 1]]) onto new edition of Jaguar User window as showed on [[#Figure 2. Jaguar User window (commission) | Figure 2]].
+
=== Salesman ===
-
* New edition of Jaguar User window should be contain new section "Part C. Commissions". This section contains two tables:  
+
 
 +
'''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'''.
 +
 
 +
===Salesman Account ===
 +
 
 +
See [[#Salesman]]
 +
 
 +
=== Commission ===
 +
 
 +
'''Commission''' - see also http://en.wikipedia.org/wiki/Commission_(remuneration)
 +
 
 +
=== 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]].
 +
 
 +
=== Commission Start Date ===
 +
 
 +
''' Commission Start Date ''' - first date to calculate commission. This is [[Client Company]] specific.
 +
 
 +
=== 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 [http://mantis.jaguarfreight.com/wiki/Salesman_Profile#Interface Commision Shedule table] of the [[Salesman Profile]].
 +
 
 +
Given [[#Salesman]] has same schedule for all of his [[#Salesman Account]]s.
 +
 
 +
=== 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
 +
 
 +
=== 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.
 +
 
 +
=== Salesman Monthly Actual ===
 +
It is '''calculated''' by adding all profit values for all shipments associated with all of her accounts.
 +
 
 +
== Design ==
 +
 
 +
=== Access Restrictions ===
 +
* Access Restrictions to info from Salesman Profiles should be limited to management users only.
 +
 
 +
=== Data Tables ===
 +
* There are three tables for Salesman feature:
** '''Commision Shedule table'''
** '''Commision Shedule table'''
-
*** This table corresponds to the Commission Shedule specification [[http://mantis.jaguarfreight.com/wiki/Salesman#Commission_Schedule]] and represents change in Commission Percentage [[http://mantis.jaguarfreight.com/wiki/Salesman#Commission_Percentage]] of current Salesman.
+
*** This table corresponds to the [[#Commission_Schedule]] specification and represents change in [[#Commission_Percentage |Commission Percentage]] of current Salesman.
-
*** Table consists of two columns:
+
*** System keeps history of all set Percentage values of Salesman for each Time frame, but displays only actual of them.
-
**** Time - time in years has elapsed since Commission Start Date [[http://mantis.jaguarfreight.com/wiki/Salesman#Commission_Start_Date]]
+
*** Table consists:
-
**** Commission Percentage - number representing share of a Jaguar profit that is due to the current Salesman
+
**** Time Frame - time in years has elapsed since [[#Commission_Start_Date]].
-
*** Current Salesman has same schedule for all of his Salesman Accounts [[http://mantis.jaguarfreight.com/wiki/Salesman#Salesman_Account]].  
+
**** 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'''
** '''Salesman Accounts table'''
-
*** This table contains list of all Salesman Accounts with appropriate Commission Start Dates
+
*** This table contains list of all Salesman Accounts with appropriate Commission Start/End Dates.
-
*** Table consists of two columns:
+
*** Table consists:
**** Client Company (=Salesman Account) - company which agrees to send us orders (CTs).
**** 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 Start Day - first date to calculate commission for specified Client Company.  
-
* Each table must have control buttons for CRUD-functionality: Add, Edit, Delete.
+
**** 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.
 +
== Detailed Design ==
-
== Final Detailed Design ==
 
-
== Figures ==
+
=== Business Workflows and Events ===
-
=== Figure 1. Jaguar User window (initial) ===
+
'''Normal Workflows:'''
-
[[File:jaguaruser_window_initial.gif]]
+
-
=== Figure 2. Jaguar User window (commission) ===
+
-
[[File:jaguaruser_window_commission.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 [[#Preliminary Design]]
+
=== 0002052: (Salesman: Profile) Create this new component ===

Current revision as of 22:35, 11 January 2011


Contents

[edit] General Info

[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
  • 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.

  • 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:

[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

File:Salesman_profile.gif

[edit] History

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

Personal tools