FMS Job Allocation Process

Overview

When the service and full address have been entered, the FMS4 client sends details to the FMS4 server for the job to be allocated.

At this point, we don’t know if it’s a previous client or a new client. Rather than assume either, FMS4 server makes TWO separate allocation decisions - one for each scenario - and both decisions are returned to the FMS4 client.

The FMS4 client is then responsible for determining if the client is new or previous, determining which scenario to assume, and therefore which decision to accept.

https://miro.com/app/board/o9J_liH3aBM=/

Scenario: If it’s a new client

Franchisees go through 3 levels of filtering before a decision is made:

1) Which franchisees to even consider;

2) Which franchisees to rule out on the spot; and

3) Which franchisee is most suitable.

Note that being Restricted (z) - formerly known as Suspended – does not prevent a franchisee getting work, but they are restricted to getting work in their territory only.

 

Which franchisees are considered

A franchisee will be considered if they satisfy all the following conditions:

  •  

    • Any of their areas includes the client’s address

    • They provide the requested service (and it doesn’t have obsolete ticked)

    • Their Start Date is prior to or including today

    • Their Finish Date is blank or any date from tomorrow onwards

    • They are not breached due to service compliance

    • If the job is entered outside business hours (after 8pm) and they have not ticked "Disable after hours Leads" in Jim’s Online

    • If the job is post dated and they accept post dated jobs

 

Which franchisees are available

A franchisee will be ruled out on the spot if they satisfy the following conditions:

  •  

    • Work code for today is N

    • Already received maximum number of leads today (lead date is the key to determine when the lead is counted for)

    • Not on A/T/L/Z on the day in question (When Franchisee is on “Z”, Franchisee is considered available even they are not in the same zone which covers the client’s address)

    • Not enough time left in the day

    • Doesn't provide the service in that area

    • Isn't covering that area on that day

    • Breached due to service compliance


 Which franchisee is most suitable

The most suitable franchises are determined by compiling a simple string then finding the “highest” string.

 

(A) Are they taking work on this day?

Down for A, T, L or Z - check work requirements screen

 

(B) Are they offer same day service if client requested?

Check if franchisee offer same day service (only applicable when client requested). Franchisee may be suggested to the client if non them offer same day service

 

(C) Are they the territory holder (and NOT working cross-division)?

Check the territory definition. When a Mowing franchisee takes a Tree job he is working cross division, so territory rights don't apply.

 

(D) Are they on bottom?

Check franchisee details screen, if PfWG  = bottom, or Businesses.Status field. Bottom is a function we plan to phase out at some point.

 

(E) Are they working cross division?

Check if the franchisee's franchisor is under a different division to the specified service. Or if Businesses.Service_Group_ID <> Services.Service_Group_ID.

 

(F) Are they working cross region?

Check if the franchisee's franchisor's enquiry area covers this suburb/postcode. If not, this franchisee is working cross region.

 

(G) Recent leads value

This is computed from the number of leads in the last 3 days (or alternative number specified in Service_Groups.Recent_Lead_Days) and PFWG .

The Recent Leads Value is computed as follows:

Recent Leads Value = 1000 – (Recent Leads Count / (if PFWG  then 2 else 1))

For example:

  •  

    • 5 recent leads, not on PFWG  = 0995.0

    • 8 recent leads, not on PFWG  = 0992.0

    • 5 recent leads, on PFWG  = 0997.5

    • 8 recent leads, on PFWG  = 0996.0

Therefore, while each extra recent lead you acquire lowers your suitability for the next lead, being on PFWG  will halve the effect each extra lead has.

Lead values is also affected by the FSE average star rating. e.g earn 0.1 leads value every 0.1 point above 4.5 rating; lose leads value by 0.1 for every 0.1 point below 4.5 rating



(H) Are they on PfWG?

Including this as a factor this late in the game ensures that people on PfWG have a tiny edge over those not on PFWG , which takes effect when all other factors are equal. PfWG ‘s real influence is in computing (G) Recent leads value, digit J rarely comes into play.

 

(I) Earlier leads count

K = 1000 - the number of leads the franchisee received in the week PRIOR to the 3 days examined in I: Recent leads value.

This means that if all else is equal, it'll search further back into the past. eg. if AB2 received 10 leads in this prior week when TH3 received 11, then the lead goes to AB2.

This factor rarely comes into play, but makes a difference in areas which receive very few leads.

Scenario: If it’s a previous client

A previous client will be given to the previous franchisee again if they meet ALL the following conditions:

  •  

    • Franchisee start date is today or earlier

    • Franchisee finish date is tomorrow or later, or blank

    • Franchisee provides service (if it's ticked obsolete and offer obsolete to previous client is enabled)

    • Any of the franchisee’s current areas cover the job, OR “Get previous clients outside areas” is ticked (found on the Franchisee Miscellaneous screen) even they are down to 0

    • Any of the franchisee’s today areas cover the job, OR “Get previous client outside today’s areas” is ticked (found on the Franchisee Miscellaneous screen), OR their working status is “P”

    • Franchisee is not suspended

    • The lead’s status is OK (not cancelled or suspended)

    • The lead’s Job Cancel Date is blank

If there are multiple leads and previous franchisees, FMS4 will give priority to the most recent one.

  

How FMS4 determines if it’s a new or previous client

This is determined by the FMS4 client by the following logic:

  •  

    • If a previous lead is found, and the client’s name entered by the operator matches, then the client is previous.

    • If a previous lead is found, but the client’s name doesn’t match a previous client’s name, prompt the user to clarify whether it’s a new or previous client and accept their decision.

    • If no previous leads are found, it’s a new client.

 

How to investigate issue by the allocation report

Allocation report should provide enough information to answer most of the questions regarding allocation process, there are two way to inspect the allocation report

  1. UI Report

    The UI report is user friendly and easy to inspect the process result
    Factors are listed from left the most important to right the less important. Green tick means franchisee passes that factor so they are on top of others who have red cross for the same factors



    You can also click on a green tick which shows you more information about the factor, 
    For example

    click on the green tick for EA on the Available column, it shows you EA is available because all conditions are "YES"



    click on the red cross for OD on the Available column, it shows you OD is not available because he is not available on any day.




  2. XML Data

    Apart from the UI report, you can go deeper to the advanced XML report for technical data





    The XML report will give more detail about how the lead to be allocated






FAQ

Question

Answer

Question

Answer

My franchisee received lead when he/she was not down to work?

Most likely because of the franchisee changed his/her work requirement after they received lead. You can check what the franchisee work status was when the lead was allocated.

  1. Go to the advanced XML report

  2. Find <FSEs> tag

  3. Find the franchisee (the first franchisee normally)

  4. Find the <Days> tag of the franchisee and look at the day the franchisee received job for (the first day normally except a post-dated job)

  5. Check the Work_Type_ID which represent where the franchisee was down to when the job was allocated



    You can also reference to the <Work_Types> tag in the same report for more information about the work type

Franchisee received lead from where he/she was not down to?

It could because of the entered address was not recognised by Google, so an incorrect Geospaced information is returned.

  1. Go to the advanced XML report

  2. Find <Parameters> tag

  3. Copy the Geocode_Y and Geocode_X value then paste them into Google Map to check if the pinpoint location is same as the entered address

Franchisee received lead from previous client when he/she was down to 0?

Check the Franchisee Misc screen in FMS, the franchisee may want previous clients, even outside normal areas

Franchisee does not want any post-dated work but still receiving job from previous day.

  1. Check the footprint of the Accept post-dated work checkbox, make sure this option was off when the lead came

  2. Check the date and time when the lead arrived, when lead came after 8PM and no franchisee available, it will be allocated to the most suitable franchisee for next date as a non post-dated job. Lead email will be sent out immediately, however the SMS will be held until 8AM the next day.

Franchisee works in Zone A but receive lead from Zone B

Whenever Franchisee is working in Zone, they will receive lead from other zones as well. FMS does not consider if client is from the Zone the franchisee is working in today.



Issues we have been having in FMS4



Link to Support ticket



Link to Support ticket

Getting leads from old customers for "0" work needed outside work hours

Link

Getting Lead messages outside work hours

Link

Sharing of Job Entry/Reallocation pages between MCCC and Bizza - access rights related considerations

Link

Red Flag messages for customers for Jobs assigned to Bizza Contractor not showing on Job Entry Screen.

Link

Work needed code “X” for Do not disturb

https://jimsgroup.atlassian.net/browse/FMS-2813

Logic for next day leads needs to be updated. Issue where leads are assigned to the next day when lead comes in today but before starting time of FSE

link