Important change in breaks handling within v1.35/1.36/1.37

Questions refering to the Optiflow based API within PTV Developer (launched on 20.12.2023)
Post Reply
User avatar
Bernd Welter
Site Admin
Posts: 2982
Joined: Mon Apr 14, 2014 10:28 am
Contact:

Important change in breaks handling within v1.35/1.36/1.37

Post by Bernd Welter »

Here's also some important remark for those who deal with breaks returned in the response and who use an API call based on v1.35 or before.
  • Version 1.36.0 | 2025-12-11 : Feature: Added support for taking a break during charging.
  • Version 1.35.0 | 2025-11-24 : Feature: Breaks are no longer scheduled between tasks at the same stop. Therefore there are no more breaks at Task and Appointment.
As you can see from the API changes there's been some impact in the way how we model breaks in the response.

Now with v1.36 we invented a new Breaks-collection at the stops and though the current 1.36 API doc says
breaks
Array of objects (Break)
Indicates when a break is taken at the current stop. A break can only take place during charging.
we have to implement an important internal move which could shift a break from the "approach.breaks" collection to the "stop.breaks" collection - even if there's no charging involved.

This also means that the description of the "stop.breaks" will change with one of the next versions.

:!: We strongly recommend that you already prepare your existing break handling for this new 1.36 stops.break collection - though this might feel like "learning to swim on land".

Bernd
Bernd Welter
Technical Partner Manager Developer Components
PTV Logistics - Germany

Bernd at... The Forum,LinkedIn, Youtube, StackOverflow
I like the smell of PTV Developer in the morning... :twisted:
Post Reply