~~NOTRANS~~
====== Travels ======

===== GET =====
==== Get travel via ID [From X2 new format] ====
''/rest/travels/travel/__5__''
  * Get for travel ID 5
== Example result ==
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<xml>
    <id>5</id>
    <project_id>37</project_id>
    <cost_centre_id>3</cost_centre_id>
    <work_package_id>9</work_package_id>
    <route>Graz-Bruck</route>
    <number>55</number>
    <type_id>1</type_id>
    <km_from></km_from>
    <km_to></km_to>
    <purpose>Meeting</purpose>
    <is_company_car>0</is_company_car>
    <description></description>
    <is_client_changed>0</is_client_changed>
    ...
</xml>
</code>

===== POST =====
==== Add a new travel [From X2 new format] ====
''/rest/travels/travel''
  * Add new

== Example request body ==
<code url>
staff_id=1&date=2015/01/27&project_id=37&work_package_id=9&number=55&type_id=1&purpose=Test&Route=Graz-Bruck
</code>

== Example result ==
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<xml>
    <url>.../rest/travels/travel/5</url>
</xml>
</code>

=== Possible values ===
^ Field ^ Description ^ Valid Values ^ German Name ^
^ staff_id        | Staff ID    | required,integer    | Person    | 
^ date            | Date    | required,us_date    | Datum    | 
^ project_id      | Project ID    | required,integer    | Projekt    | 
^ work_package_id         | Work package ID    | required,integer    | Bereich    | 
^ number          | Number    | required,numeric,greater_than[-0.001]    | Anzahl    | 
^ type_id         | Type ID    | required,integer    | Art    | 
^ purpose         | Purpose    |     | Zweck    | 
^ description     | Description    |     | Bemerkung    |
^ route           | Route          |     | Strecke/Ort  |

<WRAP round info 80%>
**X3 13.0**\\
The ''cost_centre_id'' is ignored starting with X3 13.0 and should therefore be omitted for this call.\\
Setting the ''cost_centre_id'' will result in a HTTP Header ''US-Warning'' with the above message, but the call will still work.
</WRAP>
===== GET =====
==== Get travels for a member of staff for today [From X2 new format] ====
''/rest/travels/staff/__4__''
  * Get for staff ID 4
== Example result ==
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<xml>
    <item0 id="34" purpose="foo" number="55" is_deducted="0" staff_name="Administrator" project="095 Krankenhaus Kupferberg 30" project_id="2" project_name="Krankenhaus Kupferberg 30" project_number="095" ... date="2015-10-12 00:00:00"/>
</xml>
</code>
==== Get travels for a member of staff for a defined date [From X2 new format] ====
''/rest/travels/staff/__4__/__2011/1/1__''
  * Get for staff ID 4
  * Get for 2011/Jan/01

== Same result as above ==