Freight Detention

Abstract

This functionality enables you to measure how much time a forwarding agent spends at the place of loading. By keeping track of this time, you can base an element cost in the freight cost model on the time spent at the place of loading. In the system, you can set a time that will be deducted from the time on which such a cost is based. This time is called the detention free-time. The remaining time is called the detention time, and it is this time that can be used as the basis for a cost element in the freight cost model, a cost for detention.

You can mark the detention time with a detention reason code, which explains the type of detention and its cause.

Limitations

The times used to calculate detention time and the detention reason code can only be set manually. The system never sets these automatically.

Detention time calculation

Detention time can be calculated for each delivery and for each shipment. In the calculation the actual departure time, the detention free-time and one of either forwarder's planned arrival time or forwarder's actual arrival time are used.

The forwarder's planned arrival time is automatically calculated by the system based on the planned departure time. To calculate the forwarder's planned arrival time, the forwarder's arrival lead time is deducted from the planned departure time.

The forwarder's actual arrival time and the actual departure time are never set automatically by the system. They must be set manually by a user or an external system. The detention free-time is a period during which no detention costs are incurred.

The detention time is the period during which detention costs are incurred. The detention time is the time difference between the greater of forwarder's planned arrival time and forwarder's actual arrival time plus the detention free-time and the actual departure time.

Detention free-time starts at the forwarder's planned arrival time if that time is later than the forwarder's actual arrival time because it is understood that the work required to load the shipment is not planned to start until the planned arrival time. If the forwarder arrives early, detention free-time should not be consumed until the planned time occurs.

If the forwarder arrives late and the actual arrival time is later than the planned arrival time, then loading cannot start before the forwarding agent actually arrives at the place of loading. In that case, the detention free-time starts at the actual arrival time.

Flowchart

Detention time uses

The detention time can be used in the freight cost calculation to assign a cost for detention as part of the total freight cost.

The detention time can be used in two ways.

  • Detention time is used as a base in a freight cost operator. Operator 19 uses detention hours as the base for freight cost elements with that operator. This means that the element amount for such an element is calculated as the detention time in hours multiplied by the freight rate (PPS109/E). A detention time of 1 hour and 15 minutes is transformed to 1.25 hours before it is multiplied by the freight rate.
  • Detention time is used as a scale unit type. Scale unit type 5 uses detention hours. Hence it is possible to scale with detention time. In the scale (PPS109), the scale steps are entered in hours with two decimals. This means that a step in the scale that starts at 1 hour and 30 minutes of detention must be entered and 1.50 hours in the scale.

You can use these two methods for the same freight cost element. This means that it is possible to define different rates for each detention hour for different detention times.

Example: Rate scale for a freight cost element using freight cost operator 19 (rate per detention hours) and freight scale unit type 5 (detention hours).

From value

(detention hours)

Freight rate

(cost per det. hour)

Detention hours

(from delivery or shipment)

Cost
0.00 10 15 min = 0.25 hours 10 * 0.25 = 2.50
0.50 15 45 min = 0.75 hours 15 * 0.75 = 11.25
1.00 20 2 hr, 18 min = 2.30 hours 20 * 2.30 = 46
10.00 25 2 days = 48 hours 25 * 48 = 1200
Note: The cost is calculated as the total time multiplied by the cost per detention time. The system does not calculate each step in the scale and then summarize the cost for each step. In the example where detention time is 45 minutes, the system applies the rate for that time for the entire time and not just for the time above 0.5 hours (the calculation is not 0.50 *10 + 0.25 * 15 = 8.75).

Define detention reason code

Each detention should have a reason code. The reason code is set manually for each delivery on the delivery header (MWS410/J) and on each shipment (DRS110/E).

The detention reason code must be defined in the detention reason code table, managed in (DRS026).

Define detention free-time

Usually detention is not calculated right from the time the forwarding agent arrives at the place of loading but only after some time detention starts. The time between the forwarding agent's arrival at the place of loading and detention time start is called the detention free-time.

The detention free-time is defined for each transportation service ID on the freight agreement (PPS101/E). It is entered in number of days, hours and minutes.

Define forwarder's arrival lead time

The system calculates a planned arrival time for the forwarding agent for the delivery and for the shipment. This is done by subtracting the forwarder's arrival lead time from the planned departure time. The calculated time is the time when the forwarding agent is planned to arrive at the place of loading of the delivery or shipment.

The forwarder's arrival lead time is defined on the route departure (DRS006/E). This means that the system can only calculate the forwarder's planned arrival time when routes with route departures are used.