do_order.php
Table of Contents
You can use this function to send simple service orders to YellowFox tablets. These contain only one destination and an order text. The order can return status messages and you are able to attach a form, which the driver has to fill-out after executing the order. You can e.g. use this to model delivery notes.
All customers who need more than this can use the Tour Webservice, located at https://yfox.li/tour. The Tour Webservice is already included in the YellowFox subscription and can be used for free after activation. Beside all functions that are supported by orders, tours offer a lot more. You are able to define multiple pick-up and delivery stations or use YellowFox workflows. By using workflows you can define precisely what the driver has to do in which order. Multi-langual status messages are also possible, as well as multiple shipments for a single address. Even by building a tour with just one destination it will still be much more powerful than a simple order.
To unlock to Tour Webservice for free or get further information and help, please contact the YellowFox support.
Creates an order and sends it to the vehicle.
Description
POST do_order.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR123XYZ&ordertext=Auftragstext&lat=51.0374&lon=13.587813
Parameter
| Parameter | Description | Type | Note | Mandatory |
|---|---|---|---|---|
| company | RTI company key | string | yes | |
| customorderid | user-defined order number | string | max. 20 chars (will not be checked for duplicates) | yes |
| ordertext | order text | string | max. 500 chars (CE Display, Tablet) max. 200 chars (all other displays) | yes |
| vehicle | RTI vehicle key | string | yes | |
| lat | Latitude of navigation target | float | -90 to +90 in WGS84 format | yes for Garmin displays |
| lon | Longitude of navigation target | float | -180 to +180 in WGS84 format | yes for Garmin displays |
| street | street name of navigation target | string | max. 100 chars (reduces the max char count of order text for garmin displays) | no |
| hnr | house number of navigation target | string | max. 10 chars (reduces the max char count of order text for garmin displays) | no |
| zipcode | zipcode of navigation target | string | max. 10 chars (reduces the max char count of order text for garmin displays) | no |
| city | city of navigation target | string | max. 100 chars (reduces the max char count of order text for garmin displays) | no |
| country | country code of navigation target | string | max. 3 chars (reduces the max char count of order text for garmin displays) | no |
| customername1 | Customer Name 1 | string | max. 100 chars (will be displayed only on Fleet V3) | no |
| customername2 | Customer Name 2 | string | max. 100 chars (will be displayed only on Fleet V3) | no |
| target_time | target arrival time | datestring | Format: YYYYMMDDHHMM reduces maximum char count of order text down by 18 chars | no |
| sortnumber | sort number | int | Will be written in front of the order text in brackets. Reduces the max char count of order text + 2 chars. | no |
| formname | name of customer form which will be opened after order has been executed | string | max. 20 chars (available for CE Displays at Version 1.1.67 and Tablets) Attention | no |
| textlayout | layout of order text at display (only available for Garmin FMI displays) | int |
Attention | no |
| save_in_pool | Saves the order only in the order pool and does not send it to a vehicle. | int | 0 = is not stored in the order pool and requires a vehicle 1 = is stored in the order pool, vehicle key is not required, but the import key is | no |
| meta | meta info | string | This info will be returned on accessing the order via get_orders.php to be able to track this order. | no |
| attachments | file attachments | string | UUIDs of desired file attachments, comma-separated You get these UUIDs while uploading a file via file_storage/upload_file.php or you can access them via file_storage/get_overview.php | no |
Return
A string will be returned. If the request was successful "OK". If the request failed "ERROR:Description".
Example calls
Simple order
https://map.yellowfox.de/rti/do_order.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext
https://map.yellowfox.de/rti/do_order.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&customorderid=NR1234&ordertext=Auftragstext
Example with navigation target and target time
https://map.yellowfox.de/rti/do_order.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&target_time=201411310800
https://map.yellowfox.de/rti/do_order.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&target_time=201411310800
Example with navigation target + form + sort number + textlayout
https://map.yellowfox.de/rti/do_order.php?company=COMPANY_RTIKEY&vehicle=VEHICLE_RTIKEY&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&sortnumber=1&formname=Abholung&textlayout=2
https://map.yellowfox.de/rti/do_order.php?company=COMPANY_RTIKEY&vehicle={"type":"car_ident","groupKey":"GROUP_RTIKEY","ident":"VEHICLE_IDENT"}&customorderid=NR1234&ordertext=Auftragstext&lat=51.0374&lon=13.587813&street=Hauptstr&hnr=3&zipcode=01723&city=Kesselsdorf&country=D&sortnumber=1&formname=Abholung&textlayout=2