One of your ideas has been delivered from your suggestion.Commitment Allocation Based on Tender Response - Planner and Service Provider

This feature provides you with new configuration option for how the application handles commitment usage when the Service Provider Assignment parameter "Decrease Commitment Usage When Tender Decline" is set to false, the default.  Specifically, this feature provides you with the option of configuring a set of Decline Reason Code(s), that, if entered and matched as part of the planner running the Withdraw Tender action, will, even with the "Decrease Commitment Usage When Tender Decline" set to false, still decrease the commitment usage for the service provider. A similar configuration and usage scenario is available for the service provider.  You have the ability to configure a set of Decline Reason Code(s), that, if entered and matched as part of the service provider submits a Decline Tender for a tender, will, even with the "Decrease Commitment Usage When Tender Decline" set to false, decrease the commitment usage for the service provider.

In addition to the functionality described above, this feature also provides you with a new Service Provider Assignment parameter "Stop Commitment Usage On Retender", which, as the parameter name implies allows you to decide if the retendered shipment should be or should not be considered for commitment usage.  Setting this parameter to true (the default is false) treats the retendered shipment as a "bonus" shipment for the service providers the shipment is being re-tendered to since it will not impact commitment usage. 

Service Provider Assignment Related Parameters

Service Provider Assignment Related Parameters

Planner Setup Usage

To configure the matching Quick Codes/Decline Reason Codes for the planner initiated Withdraw Tender that will decrease the commitment usage with the "Decrease Commitment Usage When Tender Decline" is set to false, you will need to configure the property "glog.server.tender.planner.internalQuickCodes".  This property allows you to enter a set of comma separated values, that, when entered as part of a planner initiated Withdraw Tender will allow the commitment usage to  be decreased, otherwise the commitment usage will not be decreased.  The entered codes allows for the ability to decide if the Withdraw is related to a failure on the part of the service provider - like no equipment or a break down -  or if the issues is on the shipper's side, like the freight not available - in which case the commitment should not be decreased.  Depending on the reason code, the commitment usage may or may not be decreased. By default, no values are provided for this property.

In the example below the code Carrier_Fault is configured for the property "glog.server.tender.planner.internalQuickCodes". This page is accessed via Configuration and Administration > Property Management > Property Sets. 

NOTE: Only the DBA.ADMIN user can access and use the Property Sets page.

Planner Code Setup for Withdraw Tender Commitment Usage

Planner Code Setup for Withdraw Tender Commitment Usage

With the Service Provider Assignment parameter "Decrease Commitment Usage When Tender Decline" set to false - and given the property setup above, when the planner runs the Withdraw Tender action for a shipment using commitments and enters the Decline Reason Code (Quick Code) Carrier_Fault - the commitment usage for the service provider will be decreased. 

NOTE: Any other Decline Reason Code or a Null value would not decrease the commitment usage.

Planner Withdraw Tender Matching Decline Reason Code - Decreases Commitment Usage

Planner Withdraw Tender Matching Decline Reason Code - Decreases Commitment Usage

Service Provider Setup Usage

For the service provider – the property "glog.server.tender.servprov.internalQuickCodes" is used to configure the Quick Codes/Decline Reason Codes that will cause a decrease in the commitment usage when the service provider runs the Decline Tender action and provides a Decline Reason code that matches one of the codes configured in the property.  In the example below, the "glog.server.tender.servprov.internalQuickCodes" has been configured with the "No_Equipment" code/value.  When the service provider runs the Decline Tender action and the "No_Equipment" Decline Reason Code is entered, the commitment usage will be decreased, even with the parameter "Decrease Commitment Usage When Tender Decline" set to false. This page is accessed via Configuration and Administration > Property Management > Property Sets.

NOTE: Only the DBA.ADMIN user can access and use the Property Sets page.

Service Provider Code Setup for Decline Tender Commitment Usage

Service Provider Code Setup for Decline Tender Commitment Usage

With the Service Provider Assignment parameter "Decrease Commitment Usage When Tender Decline" set to false - and given the property setup above, when the servicer provider runs the Decline Tender action for a shipment using commitments, and enters the Decline Reason Code (Quick Code) "No_Equipment" - the commitment usage for the service provider will be decreased. 

NOTE: Any other Decline Reason Code or a Null value would not decrease the commitment usage.

Service Provider Decline Tender Matching Decline Reason Code - Decrease Commitment Usage

Service Provider Decline Tender Matching Decline Reason Code - Decrease Commitment Usage

Stop Commitment Usage On Retender

As noted above, the parameter "STOP COMMITMENT USAGE ON RETENDER (Default – False)" allows you to decide if the retendered shipment should be or should not be considered for commitment usage.  Setting this parameter to true (the default is false) treats the retendered shipment as a "bonus" shipment for the subsequent service providers - when set to true, the re-tendered shipment will not impact commitment usage. 

Stop Commitment Usage On Retender Parameter

Stop Commitment Usage On Retender Parameter

This feature provides some conditional control for whether the Decline Reason for the Withdraw Tender action initiated by the planner or the Decline Tender action initiated by the service provider should or should not decrease the commitment usage.  

Steps to Enable

You don't need to do anything to enable this feature.

Tips And Considerations

The property "glog.server.tender.planner.internalQuickCodes" works when the parameter DECREASE COMMITMENT USAGE WHEN TENDER DECLINE is set to false.  There is no impact if the parameter is set to true.

  • Will not decrease the commitment allocations during decline, timeout, withdraw(External/no quick codes), step tender. (on retender)
  • Decrease the commitment usage only for withdraw action when providing the internal reason code (decline reason code matches with planner.internalQuickCodes property).

The property "glog.server.tender.servprov.internalQuickCodes" is only for the service provider and is used in conjunction with Decline Tender.  If the tender is declined by the service provider and the Decline Reason Code matches with the configured set of codes in the property, the commitment usage will be decreased otherwise no need to decrease the commitment usage.