Combinations of WorkLogbook and TimeConsideration

[Bernd Welter]

Hi there,

one of our players faced the following generic error message in xRoute2 :

Code: Select all

{
  "faultInfo": {
    "$type": "InternalErrorFault",
    "hint": "Please contact your PTV representative to obtain more information."
  },
  "message": "The tour information could not be calculated. The scheduling component returned an internal error."
}

In this particular case the following part of the request was crucial - maybe this is helpful for someone else, too:

Code: Select all

{
  "routeOptions": {
    "tourRestrictions": {
      "configurableWorkingHoursPreset": "EU_DRIVING_TIME_REGULATION_FOR_TEAM_AND_MULTIPLE_DAYS",
      "workLogbookSummary": {
        "lastTimeTheDriverWorked": "2025-12-18T12:00:00",
        "configurableWorkingHoursLogbookSummary": { "accumulatedTravelTimeSinceLastDailyRest": 14400.0 }
      }
    }
  }
}

Now what I learned todays is that xRoute 2.39 and before does

• not support a driver logbook if NO time consideration is specified
• support only some some TimeConsiderations:
  • ExactTimeConsiderationAtStart
  • SnapshotTimeConsideration or
  • TimeSpanConsideration

What we will do:

• We will document the possible / impossible combinations
• We will improve the error message in the upcoming version so that a client would immediately know what leverage is available

What we WONT DO:

• Implement the support of the WorkLogbook for no time consideration or further modes that are not supported today.