Changes

WEBFLEET is the professional fleet management platform of Webfleet Solutions, before October 2019 known as TomTom Telematics. RouteXL is connected to WEBFLEETvia the ''WEBFLEET.connect interface'', which allows you to import orders from the fleetmanagement platform, optimize order itinerary the route and send optimized itineraries the sorted orders back to connected TomTom PRO devices.

=== Settings =Set up the connection ==

To connect you'll need RouteXL to your WEBFLEET account, enter your WEBFLEET account credentials in the [[Options]] on the WEBFLEET tab.

''Hint: If connected, * The WEBFLEET user must have the icon of the Import button "expert" profile and have external access to interface WEBFLEET.connect. Your administrator user can change these settings in the [[WEBFLEET application. * If you grant external access to an existing WEBFLEET user interface]] changes from two rectangles (copy) , it may take up to 24 hours to one black rectangle (paste)get activated. If you’re in a hurry: you’d better create a new user with these rights.''

* If the connection to WEBFLEET is made, the icon of the Import button in the [[user interface]] changes from two rectangles (copy) to one black rectangle (paste). == Import orders into RouteXL == [[File:WEBFLEET_import.png|thumbnail|right|The WEBFLEET import dialog]] Use the WEBFLEET button in the [[Import]] dialog to import orders from WEBFLEET. Orders will be imported as destination locations into RouteXL.

=== Export =route to WEBFLEET ==

[[File:WEBFLEET_export.png|thumbnail|right|Export a route to a WEBFLEET device]]  An optimized itinerary can be send to a connected TomTom PRO device by using the WEBFLEET button in the [[Share]] and [[Download]] dialog. Your addresses will be converted into destination orders using the .connect interfacein WEBFLEET.

* Select device and date: TomTom satnav device and day for which the orders must be created.

* Replace the current orders: will delete all of the currect orders on the device on the specified date. May be This is useful if orders were imported from WEBFLEET before.* Create itinerary order: adds all stops in one single order entry. The result is one order with numerous stops. Not all devices allow thisfeature.

Warning: WEBFLEET does not allow more than 100 orders on one device. == Hints and tips = Order numbers ===  When exporting orders RouteXL will generate unique order numbers for WEBFLEET. However, you may require your own order numbers to appear in WEBFLEET. To add your own order number to a order, [[edit location]] and put it between straight brackets [ ] in the comments of a location before your create the route and export to WEBFLEET. RouteXL also allows you to [[import]] your own order numbers with your addresses. To import order numbers that must appear in WEBFLEET, add the order number between [ ] to the comments between { }. For example if you [[import]] this text:

* Kennemerstraatweg 464, Heiloo, The WEBFLEET user must have the "expert" profile and have external access to interface WEBFLEET.connect. Your administrator user can change these settings in the WEBFLEET application.Netherlands {[ordernumber1]}

* If you grant external access This will import '''[ordernumber1]''' with your address as comment. When exporting the route to an existing WEBFLEET user, it may take up to 24 hours to get activated. If you’re in a hurry: you’d better create a new user with these rights'''ordernumber1''' will appear as order number.

* There should at least be one vehicle attached to Note: WEBFLEET requires unique order numbers. If your order numbers are not unique, the WEBFLEET user to orders will not be able to import or export ordersaccepted.

Error messages from The errors that are generated by the WEBFLEET .connect interface are shown in the RouteXL interface. Here are some common errors and their solution: '''User does not exist [ERROR 1101]''' This error may have various reasons:* The WEBFLEET username is not correct. Check if the user is available in WEBFLEET. Try to log in at WEBFLEET with the username.* You used special characters like &?#! in your WEBFLEET password. Go to WEBFLEET and change the password.* You removed the Expert profile from the user in WEBFLEET. Go to WEBFLEET and add the Expert profile.

'''External request Account blocked [ERROR 1130]''' There is an issue with your account at WEBFLEET. Contact Webfleet Solutions support to solve the problem. '''The user is not allowed valid anymore [ERROR 80141140]'''

This error indicates that your There is an issue with the user at WEBFLEET user is not correctly configured. Go to Check the WEBFLEET interface and double check if settings of the user has Expert profile and external acces in WEBFLEET, or contact Webfleet Solutions support to solve the .connect interfaceproblem.

'''User does not exist Order already exists [ERROR 11012515]'''

This may occur when WEBFLEET requires unique id's to identify orders. If you use special characters like &?#! in your assign id's that are not unique, WEBFLEET passwordwill not accept the order. Change Remove orders from WEBFLEET or change the password for this userid's.

This error indicates your TomTom device does not accept an itinerary orders. An itinerary order is a single orderthat consists of many route points, e.g. for snow clearing vehicles. If you're not aware of itinerary orders, you probably don't need it. Disable the this option when exporting a route to WEBFLEET.

This error is given when you have made too many requests in a short time period. If this happens too often, contact your TomTom Telematics representative Webfleet Solutions support to increase the request quota for your WEBFLEET account. '''External request not allowed [ERROR 8014]''' This error indicates that your WEBFLEET user is not correctly configured. Go to the WEBFLEET interface and check if the user has the ''Expert'' profile and external access to the WEBFLEET.connect interface. '''HTTP Status 0''' The WEBFLEET.connect server is not responding to your request to import/export orders. Their server is having technical issues, is offline or too busy handling other requests. Get a cup of coffee and try again later. If the problem persists, contact Webfleet Solutions support.