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.
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 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.
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.
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).
(cost per det. hour)
(from delivery or shipment)
|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|
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).
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.
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.