Billing for Virtual Group

From UG

(Difference between revisions)
Jump to: navigation, search
(→Figure 3. Example 1. Rate fuel per trucker (one trucker per spreadsheet))
(→History)
 
(12 intermediate revisions not shown)
Line 1: Line 1:
[[Category:NATP Billing]]
[[Category:NATP Billing]]
 +
 +
== General ==
 +
 +
* parent: http://mantis.jaguarfreight.com/mantis/view.php?id=1884
== Business Requirements ==
== Business Requirements ==
Line 5: Line 9:
See [[New Arden Trucking Project NATP (main)#Billing]]
See [[New Arden Trucking Project NATP (main)#Billing]]
-
Trucking Billing Manifest for Virtual Group is a spreadsheet that is generated based on pick-up or delivery trucker. It will be an option to generate the billing, edit and send to the client or vendor.
+
== Specs ==
-
== Location ==
+
To add this feature you need to add 2 components:
 +
* [[#Wizard Pop Up]]
 +
* [[#Trucking Billing Manifest for NATP]]
-
* Misc Tab in [[Master Trucking]].
 
-
* This can be replaced the existing one or separated for another menu, so that will be two options to create billing manifest. Just in case they change their mind, so at least we still have the existing one.
 
-
'''NOTE:''' Billing can be generated after defining Truck virtual group from [http://mantis.jaguarfreight.com/wiki/Virtual_Groups_for_NATP Virtual Group] and assigning virtual group to group and master. Then user can generate billing based on pick-up truckers or delivery truckers
+
=== Wizard Pop Up ===
-
[[Category: Trucking Billing Manifest (M) (xls)]]
+
After user selects billing option on [[Virtual_Groups_for_NATP#General_Wizard_Step_3]] system will:
-
== Example and Typical Workflow ==
+
* create a [[CT Group]] out of all CTs in Virtual Group
 +
** MOT = Truck Domestic
 +
** Client = Client from Virtual Grp classifiers
 +
* Create Trucking Master
 +
* Add [[CT Group]] above to the Master
 +
* present pop up as on [[#Figure 1. Assign GRP and MASTER]]
-
* User creates a virtual group by classifiers
+
=== Trucking Billing Manifest for NATP ===
-
* User reviews the result then click next
+
-
* User selects '''Generate Billing'''  <strike>'''Generate Billing on Pick up Trucker''' or '''Generate Billing on Delivery Trucker''' </strike> option from the menu
+
-
* User clicks '''Apply'''
+
-
* Pop-up window shows Group#XXXX has been generated and Master#XXXX has been generated. See [[#Figure 1. Assign GRP and MASTER]]
+
-
* User clicks '''Ok'''
+
-
* User will go to Master# record from quicklink or ListMs to generate Billing Manifest
+
-
* User navigates to Master> Misc tab
+
-
* User generates Billing Manifest
+
-
* System brings up model window where user may select any subset of CTs that belong to the virtual group. See example on [[#Figure 1.]]
+
-
* User selects some CTs or all CTs
+
-
* User selects "Pick Up Trucker" or "Delivery Trucker"
+
-
* User completes the form and clicks "Generate Report" button.
+
-
* System generates spreadsheet and opens it to the user. See example on [[#Figure 3. Billing Trucking Manifest for Virtual Group]]
+
-
** See additional information about spreadsheet here: [[#Spreadsheet]]
+
-
=== User Interface ===
+
-
See [[#Figure 1. Assign GRP and MASTER ]] for pop-up window. This window is showing once user selected generating billing.
+
Master Trucking needs additional tab: NATP.
-
System assigned a group and Master automatically once user clicks ''Generate Billing on Pick up Trucker'' or ''Generate Billing on Delivery Trucker''
+
See [[#Figure 2. Billing for Virtual Group]]
-
See [[#Figure 2. Billing for Virtual Group]] for viewing CTs below
+
This tab has same purpose as Misc tab - to generate Trucking Billing Manifest. The difference is in how it is done and output design. Overall one is just a variation of another.
-
This is the HTML template from Misc Tab under a Master
+
See what we have now on Misc tab here: [[Trucking Billing Manifest (Developer Guide)]]
-
See [[#Figure 3. Billing Trucking Manifest for Virtual Group]] for billing spreadsheet below
+
==== Template ====
-
This is a xls spreadsheet that user can enter Rate,...etc, and the number will calculated automatically
+
NATP template:
 +
* has CT/GRP list as Misc does
 +
* does not have any other field present on Misc except "Extra Columns". Reason: System will produce xls with default values (as defined for Misc) and user will edit on xls
 +
* has additional (not present on Misc) controls/choices - see [[#Generate For Choices]] and [[#Rate Fuel Choices]]
-
=== Template ===
+
==== Xls ====
-
* '''Selected Shipment''' - [[checkbox]], default is ''uncheck''
+
-
* '''Extra columns''' - [[listbox]], default value is 0
+
-
* '''Reset Form'''  button
+
-
* '''Generate Result''' button
+
-
* '''Pick Up Trucker''' radio // map to [[CT#Pick Up Trucker]]
+
-
* '''Delivery Trucker''' radio // [[CT#Delivery Trucker]]
+
 +
It consists of same components as xls for Misc but there are some important differences:
 +
* Section 1 and 2 are now located on same tab not 2 different tabs as for Misc
 +
* user has some choices of layout - see [[#Generate For Choices]] and [[#Rate Fuel Choices]]
-
Additional information:
+
==== Rate Fuel Choices ====
-
* '''Extra columns''' - [[listbox]], default value is 0, possible values: {0,1,2,3}
+
* per Trucker
-
* '''Reset Form''' button - should clear the data and uncheck the CTs from the Shipments table
+
** this is how it is done on Misc
-
* '''Generate Result''' button - - should generate spreadsheet
+
** in this case system creates one set of parameters (rates/fuel) per tab
 +
** see [[#Figure 3. Rate fuel per trucker (one trucker per spreadsheet)]]
-
=== Hard Coded Conditions ===
+
* per unique origin / destination pair
 +
** new idea
 +
** for Section 2 system creates as many groups as there are unique origin destination pairs (with its own set of parameters (rates/fuel)) per tab
 +
** business reason: rates could be defined by origin/destination in the future for some companies
 +
** see [[#Figure 4. Rate fuel per unique origin and destination pair]]
-
<strike>
+
==== Generate For Choices ====
-
Based on Pick-up Trucker
+
-
* This billing is generated based on Pick-up Trucker ONLY
+
* All Pick Up Truckers
-
* Consider Trucker companies that handle the loads from pick up location to warehouse
+
** system must group all selected CTs per [[CT#Pick Up Trucker]] and display each group on a separate xls tab. Tab is to be named after given Trucker
 +
* All Delivery Truckers
 +
** same idea as above
 +
* Selected Pick Up Trucker
 +
** on template system produces dropdown with all unique truckers across selected CTs
 +
** user may select one
 +
** xls has only CTs that have selected trucker
 +
* Selected Delivery Trucker
 +
** same idea as above
-
Based on Delivery Trucker
+
Validation
-
 
+
  ----------
-
* This billing is generated based on Delivery Trucker ONLY
+
Each CT must have Pick Up and Delivery Trucker set.
-
* Consider Trucker companies that handle the loads from warehouse to destination
+
If not show error pop-up and block xls generation.
-
</strike>
+
-
 
+
-
=== Spreadsheet ===
+
-
 
+
-
==== Tabs based grouping====
+
-
 
+
-
Based on what user selected on Template system will group per [[CT#Pick Up Trucker]] or per [[CT#Delivery Trucker]].
+
-
 
+
-
==== Each Tab ====
+
-
 
+
-
See Example on Figure 3.
+
-
 
+
-
* This is a table.
+
-
 
+
-
* Horizontally:
+
-
** It consists of as many sections as there are CTs (originally selected by user)
+
-
** Each CT section has as many lines as there are in commod table for this CT
+
-
** Header for each section: print column headers
+
-
** Divide section by From one location To another location (''' you need to group by all existing From / To pairs among selected CTs''')
+
-
** Body for each section: print one line per CT
+
-
** Each section provides Rate, Minimum Rate, Maximum Rate, and Fuel for before each table
+
-
** Footer for each section: print totals
+
-
 
+
-
* Vertically it has a number of columns and each line has the following fields - See column definitions below.
+
-
** '''CT#'''
+
-
*** Mapping: [[Ct#CT_Num]]
+
-
** '''From'''
+
-
*** Mapping: ''Company name'' from [[Ct#Export_Pick_Up]] If [[Ct#Export_Pick_Up]] is empty THEN Map [[Ct#Shipper]]
+
-
*** Note: print once per CT on the first line if there are multiples lines per CT on a spreadsheet
+
-
** '''Origin City'''
+
-
*** Mapping: ''City'' from [[Ct#Export_Pick_Up]] If [[Ct#Export_Pick_Up]] is empty THEN Map [[Ct#Shipper]]
+
-
*** Note: print once per CT on the first line if there are multiples lines per CT on a spreadsheet
+
-
** '''Origin State'''
+
-
*** Mapping: ''State'' from [[Ct#Export_Pick_Up]] If [[Ct#Export_Pick_Up]] is empty THEN Map [[Ct#Shipper]]
+
-
*** Note: print once per CT on the first line if there are multiples lines per CT on a spreadsheet
+
-
** '''To'''
+
-
*** Mapping: ''Company name'' from[[Ct#Export_Delivery_To]] If [[Ct#Export_Delivery_To]] is empty THEN Map [[Ct#Consignee]]
+
-
*** Note: print once per CT on the first line if there are multiples lines per CT on a spreadsheet
+
-
** '''Destination City'''
+
-
*** Mapping: ''City'' from [[Ct#Export_Delivery_To]] If [[Ct#Export_Delivery_To]] is empty THEN Map [[Ct#Consignee]]
+
-
*** Note: print once per CT on the first line if there are multiples lines per CT on a spreadsheet
+
-
** '''Destination State'''
+
-
*** Mapping: ''State'' from [[Ct#Export_Delivery_To]] If [[Ct#Export_Delivery_To]] is empty THEN Map [[Ct#Consignee]]
+
-
*** Note: print once per CT on the first line if there are multiples lines per CT on a spreadsheet
+
-
** '''P.O.'''
+
-
*** Mapping: [[Commodity#PO]]
+
-
** '''SKU'''
+
-
*** Mapping: [[Commodity#SKU]]
+
-
** '''Actual Pick Up Date'''
+
-
*** Mapping: [[CT#Actual Export Pick Up Date]]
+
-
*** Note: for Truck-Ocean this date is on [[Container]]; and since each [[Commodity]] line is assigned to its own container - date would be shown for every spreadsheet line for such CT
+
-
**'''Actual Delivery Date'''
+
-
*** Mapping: [[CT#Actual Delivery Date]]
+
-
*** Note: for Truck-Ocean this date is on [[Container]]; and since each [[Commodity]] line is assigned to its own container - date would be shown for every spreadsheet line for such CT
+
-
** '''Plts'''
+
-
*** Mapping: [[Commodity#Grand Total: Plts]]
+
-
** '''Pkgs on Plts'''
+
-
*** Mapping: [[Commodity#Grand Total: Pkgs On Plts]] 
+
-
** '''Loose Pkgs'''
+
-
*** Mapping: [[Commodity#Grand Total: Loose Pkgs]] 
+
-
** '''Gross Weight'''
+
-
*** Mapping: [[Commodity#Grand Total: Gross Kg]]
+
-
** '''Rate '''
+
-
*** Mapping: From user input on the spreadsheet for Rate field
+
-
** '''Freight Total  '''
+
-
*** IF(''gross weight''/100*Rate < X) THEN X
+
-
*** ELSE IF (''gross weight''/100*Rate > Y) THEN Y
+
-
*** ELSE  ''Gross Weight''/100*Rate
+
-
*** '''! Please note that generated spreadsheet must contain formulas so that if number is changed by user it will re-calculate!'''
+
-
** '''Fuel'''
+
-
*** Mapping: From user input on the spreadsheet for Fuel field
+
-
** '''Fuel Total  ''' 
+
-
*** Calculation field =  ''Freight Total '' x ''Fuel''
+
-
** '''Extra 1 '''
+
-
*** Mapping: none
+
-
*** Default value:  0.00
+
-
** '''Extra 2 '''
+
-
*** Mapping: none
+
-
*** Default value:  0.00
+
-
** '''Total  '''
+
-
*** Calculation field = ''Freight Total '' + ''Fuel Total  '' + ''Extra 1 '' + ''Extra 2 ''
+
-
* Default for each section for calculation fields (user input)
+
-
** '''Rate:''' - default value is 0.00
+
-
** '''Minimum Rate:''' - default value is 0.00
+
-
** '''Maximum Rate:''' - default value is 0.00
+
-
** '''Fuel:''' - default value is 0.0000
+
-
* Sorted by: CT#
+
-
* each total is simply a sum of all numbers above it
+
-
* CT formulas examples for line 15:
+
-
** Freight Total // =IF(015/100*B9<75,75,(015/100*B9>600,600),O15/100*B9)
+
-
*** note: 75 here is a "Minimal Rate"
+
-
*** note: 600 here is a "Maximu, Rate"
+
-
** Fuel Total  // =Q15*B12
+
-
** Total        // ==Q15+S15 If there is Extra column, it should add values from extra columns as well
+
-
 
+
-
== Misc ==
+
-
 
+
-
* Please note that it is not required to have option to save generated version into the system (as for pdfs)
+
-
* Please note that this spreadsheet consists of many column (wide spreadsheet), please use window pane to fix column CT#. If not, please repeat column CT# after Total column
+
== Figures ==
== Figures ==
Line 193: Line 100:
[[File:Rate fuel per origin destination (one trucker per spreadsheet).JPG]]
[[File:Rate fuel per origin destination (one trucker per spreadsheet).JPG]]
-
=== Change request ===
+
== History ==
-
TBD
+
-
 
+
-
'''Approval '''
+
-
* By: Marc
+
=== m1905 ===
-
* Update the change to the original Spec: No
+
-
== Sales Invoice ==
+
* 0001905: (*NATP) Billing for Virtual Group (add this new feature)
-
TBD
+
* see this wiki
 +
* spec updated? Y

Current revision as of 01:10, 17 April 2010


Contents

[edit] General

[edit] Business Requirements

See New Arden Trucking Project NATP (main)#Billing

[edit] Specs

To add this feature you need to add 2 components:


[edit] Wizard Pop Up

After user selects billing option on Virtual_Groups_for_NATP#General_Wizard_Step_3 system will:

[edit] Trucking Billing Manifest for NATP

Master Trucking needs additional tab: NATP.

See #Figure 2. Billing for Virtual Group

This tab has same purpose as Misc tab - to generate Trucking Billing Manifest. The difference is in how it is done and output design. Overall one is just a variation of another.

See what we have now on Misc tab here: Trucking Billing Manifest (Developer Guide)

[edit] Template

NATP template:

  • has CT/GRP list as Misc does
  • does not have any other field present on Misc except "Extra Columns". Reason: System will produce xls with default values (as defined for Misc) and user will edit on xls
  • has additional (not present on Misc) controls/choices - see #Generate For Choices and #Rate Fuel Choices

[edit] Xls

It consists of same components as xls for Misc but there are some important differences:

[edit] Rate Fuel Choices

  • per unique origin / destination pair
    • new idea
    • for Section 2 system creates as many groups as there are unique origin destination pairs (with its own set of parameters (rates/fuel)) per tab
    • business reason: rates could be defined by origin/destination in the future for some companies
    • see #Figure 4. Rate fuel per unique origin and destination pair

[edit] Generate For Choices

  • All Pick Up Truckers
    • system must group all selected CTs per CT#Pick Up Trucker and display each group on a separate xls tab. Tab is to be named after given Trucker
  • All Delivery Truckers
    • same idea as above
  • Selected Pick Up Trucker
    • on template system produces dropdown with all unique truckers across selected CTs
    • user may select one
    • xls has only CTs that have selected trucker
  • Selected Delivery Trucker
    • same idea as above 
Validation
----------
Each CT must have Pick Up and Delivery Trucker set.
If not show error pop-up and block xls generation.

[edit] Figures

[edit] Figure 1. Assign GRP and MASTER

File:PopUpAssignedMasterVT.JPG

[edit] Figure 2. Billing for Virtual Group

File:TruckingBillingManifestVT.JPG

[edit] Figure 3. Rate fuel per trucker (one trucker per spreadsheet)

File:Rate fuel per trucker (one trucker per spreadsheet).JPG

[edit] Figure 4. Rate fuel per unique origin and destination pair

File:Rate fuel per origin destination (one trucker per spreadsheet).JPG

[edit] History

[edit] m1905

  • 0001905: (*NATP) Billing for Virtual Group (add this new feature)
  • see this wiki
  • spec updated? Y
Retrieved from "https://wiki.jaguarfreight.com/Billing_for_Virtual_Group"
Personal tools