Table of Contents

PTV Developer

General

PTV Developer is the new replacement of xServer of PTV and contains a set of APIs that enrich the planning functionality like Geocoding, Maps and Routecalculation in 3PL Dynamics.

Note

Using PTV Developer is restricted to licences. Contact your relation manager at Boltrics of your local partner in your country for more information on this feature branch.

Functionality

Registration

For using the APIs the Boltrics Customer will first has to create a PTV account. Contact your relation manager at Boltrics or your local partner in your country for more information.

Once an account has been completed the API-key received has to be registered by Boltircs in MGT in the: User Accounts. A Q-lane: Set BC Envicrionment Settings can be executed to push the key to the customer environment.

PTV Developer Setup

On the page: PTV Developer the action: Initialize PTV can be found. By Clicking on this action the following steps will be performed:

Vehicle Profiles

For calculation trip routes, -kilometers and -duration the Vehicle Profile is applicable using the following priority:

  1. The Vehicle Profile set on the Truck planned on the Trip.
  2. The Vehicle Profile set on the Resource Group.
  3. The Vehicle Profile set on the page: PTV Developer
  4. The default profile: EUR_TRUCK_40T
Note

Althought it is recommended to use the default PTV-profiles it is possible to create new profiles with specific characteristics. Per Truck or Resource Group countries can excluded so routes are not using the countries specified.

Toll calculation

The calculation of Toll is based on the PTV Vehicle Profile and the planned route calculated.

Once a Trip has been calculated the Toll will be shown in the factbox:

Example of Toll in a Trip Factbox. Trip factbox Toll

Depending on the level set in the PTV Calculation Methode, the Toll-costs will be specified per Country or section.

Note

Boltrics is not responsible for any differences between the Toll-amount calculated on the planned route and the actual Toll charged.

Toll allocation per section

In 3PL Dynamics, the total toll-costs of a trip will be divided among the individual sections on the trip. This division is based on the footprint principle. The footprint can be determinated as follows: For each section on a trip the distance between the place of loading and unloading is determined. This distance is multiplied with the chargeable weight of the goods on this section. By adding up the footprints of all the sections of a trip, the total trip-footprint is determined. Now the percentage for each section can be determined by dividing the footprint of each section with the total trip-footprint. By multiplying the tollcosts of the trip with the footprint of each section, the toll-costs can be allocated to each section.

Example toll allocation per section

A trip executed has a total distance of kilometer: 450 km. PTV Developer has determinated that on the distance traveled and the vehicle-profile € 35,- toll-costs are to be expected.

Section Section Distance Chargeble Weight Footprint Percentage Toll-costs allocated
A. 200 km 10.000 kg 2.000.000 44,45 % € 15,55
B. 150 km 10.000 kg 1.500.000 33,33 % € 11,67
C. 200 km 5.000 kg 1.000.000 22,22 % € 7,78
Total 4.500.000 100,00 % € 35,00

Emissions

On each Trip automatically emissons can be calculated based on the following settings/values:

Example of Emissions in a Trip Factbox. Trip Factbox Emissions

Setup

On the page: PTV Setup all settings related to the PTV Developer functionaltity can be found.

Edit this page