Page 1 of 1

Combinations of WorkLogbook and TimeConsideration

Posted: Thu Jan 29, 2026 5:02 pm
by 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
:idea: 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.