[OBSOLETE]: Creates or updates a car travel record.
Request Information
URI Parameters :
None.
Body Parameters :
car_travel| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary Key |
globally unique identifier | |
| user_id |
Foreign key of User |
globally unique identifier |
Required |
| car_id |
Foreign key of Car |
globally unique identifier |
Required |
| from_db_address_id |
the FROM info are filled with the latest travel of this car |
globally unique identifier | |
| from_db_table_id |
Identifier of the database table that belongs to, when the departure point is linked to another record (e.g. a job). |
globally unique identifier | |
| from_id_in_table |
Primary key of the linked departure record in the table identified by . |
globally unique identifier | |
| from_travel_type_code |
Kind of departure point (e.g. home, office, previous job). |
string | |
| from_db_address_other |
Free-text departure address, used when the departure point isn't one of the standard linked records. |
string |
Max length: 255 |
| to_db_address_id |
The address used on navigation |
globally unique identifier | |
| to_db_table_id |
TO=> if navigate to a JOBS, to_db_table_id and to_in_table is filled with the jobs info |
globally unique identifier | |
| to_in_in_table |
Primary key of the linked destination record in the table identified by . |
globally unique identifier | |
| to_travel_type_code |
Kind of travel. Can be |
string |
Required |
| to_db_address_other |
Free-text destination address, used when the destination isn't one of the standard linked records. |
string |
Max length: 255 |
| hour_type_id |
Foreign key of the hour type |
globally unique identifier |
Required |
| date_from |
Local date+time when the travel started |
date | |
| date_from_rounded |
rounded to the nearest configured interval, used for billing/display. |
date |
Required |
| date_to |
local date+time when the travel finished |
date | |
| date_to_rounded |
rounded to the nearest configured interval, used for billing/display. |
date |
Required |
| notes |
Additional notes field |
string |
Max length: 4000 |
| km |
2019-04-01: Old field not use it anymore (FSA-986) the Mileage of the car after the travel,* Be aware, value should be always bigger than the last one |
integer | |
| km_before |
Auto filled when a new record is added |
integer | |
| km_after |
the Mileage of the car after the travel,* Be aware, value should be always bigger than the last one |
integer | |
| km_private |
A value the user indicates that contains the total number of km for Private use. |
integer | |
| km_distance |
Distance traveled, in kilometers, computed as minus . |
integer | |
| is_time_for_money |
Indicates this travel time is billable ("time for money") rather than purely informational. |
boolean | |
| is_start_stop |
Indicates this entry was recorded via a start/stop timer rather than manually keyed in. |
boolean | |
| property_1_checked |
Checked state of the hour type's configurable custom property #1 (see ) for this entry. |
boolean | |
| property_2_checked |
Checked state of the hour type's configurable custom property #2 for this entry. |
boolean | |
| property_3_checked |
Checked state of the hour type's configurable custom property #3 for this entry. |
boolean | |
| property_4_checked |
Checked state of the hour type's configurable custom property #4 for this entry. |
boolean | |
| property_5_checked |
Checked state of the hour type's configurable custom property #5 for this entry. |
boolean | |
| start_latitude_decimal |
Latitude of the user's location when the travel was started. |
decimal number | |
| start_longitude_decimal |
Longitude of the user's location when the travel was started. |
decimal number | |
| end_latitude_decimal |
Latitude of the user's location when the travel ended. |
decimal number | |
| end_longitude_decimal |
Longitude of the user's location when the travel ended. |
decimal number | |
| added_dateutc |
Readonly system field: UTC date and time this travel record was added. |
date | |
| is_approved |
is_approved flag |
boolean | |
| is_confirmed |
offline field: is_confirmed flag |
boolean | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date |
Request Formats :
application/json, text/json
{
"id": "42c12af4-d119-4d7c-a914-d02104d39aff",
"user_id": "6bf27dc6-1999-4404-98b3-81de48a9d16e",
"car_id": "aa67044f-294c-48db-a547-b45540ff267e",
"from_db_address_id": "b03846e1-acc7-4c24-aaed-d571be67e29e",
"from_db_table_id": "952b9b36-c642-4676-a63b-1f71eaf7a630",
"from_id_in_table": "52984b7a-fbef-4608-98f5-733210cd05de",
"from_travel_type_code": "sample string 7",
"from_db_address_other": "sample string 8",
"to_db_address_id": "9e12092d-3bd5-4227-b4ae-529196244729",
"to_db_table_id": "55787f44-0acd-4c92-8410-278ea420b5b8",
"to_in_in_table": "d2b217f7-c430-4983-a4a4-06f0135042ec",
"to_travel_type_code": "sample string 12",
"to_db_address_other": "sample string 13",
"hour_type_id": "f37cd6d8-8ece-45a5-b2b4-9f2fb2b52618",
"date_from": "2026-11-12T14:28:57.2760211+00:00",
"date_from_rounded": "2026-11-12T14:28:57.2760211+00:00",
"date_to": "2026-11-12T14:28:57.2760211+00:00",
"date_to_rounded": "2026-11-12T14:28:57.2760211+00:00",
"notes": "sample string 19",
"km": 20,
"km_before": 21,
"km_after": 22,
"km_private": 23,
"km_distance": 24,
"is_time_for_money": true,
"is_start_stop": true,
"property_1_checked": true,
"property_2_checked": true,
"property_3_checked": true,
"property_4_checked": true,
"property_5_checked": true,
"start_latitude_decimal": 32.0,
"start_longitude_decimal": 33.0,
"end_latitude_decimal": 34.0,
"end_longitude_decimal": 35.0,
"added_dateutc": "2026-11-12T14:28:57.2760211+00:00",
"is_approved": true,
"is_confirmed": true,
"modified_dateutc": "2026-11-12T14:28:57.2760211+00:00"
}
application/xml, text/xml
<car_travel xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <added_dateutc>2026-11-12T14:28:57.276Z</added_dateutc> <car_id>aa67044f-294c-48db-a547-b45540ff267e</car_id> <date_from>2026-11-12T14:28:57.276Z</date_from> <date_from_rounded>2026-11-12T14:28:57.276Z</date_from_rounded> <date_to>2026-11-12T14:28:57.276Z</date_to> <date_to_rounded>2026-11-12T14:28:57.276Z</date_to_rounded> <end_latitude_decimal>34</end_latitude_decimal> <end_longitude_decimal>35</end_longitude_decimal> <from_db_address_id>b03846e1-acc7-4c24-aaed-d571be67e29e</from_db_address_id> <from_db_address_other>sample string 8</from_db_address_other> <from_db_table_id>952b9b36-c642-4676-a63b-1f71eaf7a630</from_db_table_id> <from_id_in_table>52984b7a-fbef-4608-98f5-733210cd05de</from_id_in_table> <from_travel_type_code>sample string 7</from_travel_type_code> <hour_type_id>f37cd6d8-8ece-45a5-b2b4-9f2fb2b52618</hour_type_id> <id>42c12af4-d119-4d7c-a914-d02104d39aff</id> <is_approved>true</is_approved> <is_confirmed>true</is_confirmed> <is_start_stop>true</is_start_stop> <is_time_for_money>true</is_time_for_money> <km>20</km> <km_after>22</km_after> <km_before>21</km_before> <km_distance>24</km_distance> <km_private>23</km_private> <modified_dateutc>2026-11-12T14:28:57.276Z</modified_dateutc> <notes>sample string 19</notes> <property_1_checked>true</property_1_checked> <property_2_checked>true</property_2_checked> <property_3_checked>true</property_3_checked> <property_4_checked>true</property_4_checked> <property_5_checked>true</property_5_checked> <start_latitude_decimal>32</start_latitude_decimal> <start_longitude_decimal>33</start_longitude_decimal> <to_db_address_id>9e12092d-3bd5-4227-b4ae-529196244729</to_db_address_id> <to_db_address_other>sample string 13</to_db_address_other> <to_db_table_id>55787f44-0acd-4c92-8410-278ea420b5b8</to_db_table_id> <to_in_in_table>d2b217f7-c430-4983-a4a4-06f0135042ec</to_in_in_table> <to_travel_type_code>sample string 12</to_travel_type_code> <user_id>6bf27dc6-1999-4404-98b3-81de48a9d16e</user_id> </car_travel>
Response Information
Resource Description :
IHttpActionResult containing the saved car travel record.
car_travel| Name | Description | Type | Additional information |
|---|---|---|---|
| id |
Primary Key |
globally unique identifier | |
| user_id |
Foreign key of User |
globally unique identifier |
Required |
| car_id |
Foreign key of Car |
globally unique identifier |
Required |
| from_db_address_id |
the FROM info are filled with the latest travel of this car |
globally unique identifier | |
| from_db_table_id |
Identifier of the database table that belongs to, when the departure point is linked to another record (e.g. a job). |
globally unique identifier | |
| from_id_in_table |
Primary key of the linked departure record in the table identified by . |
globally unique identifier | |
| from_travel_type_code |
Kind of departure point (e.g. home, office, previous job). |
string | |
| from_db_address_other |
Free-text departure address, used when the departure point isn't one of the standard linked records. |
string |
Max length: 255 |
| to_db_address_id |
The address used on navigation |
globally unique identifier | |
| to_db_table_id |
TO=> if navigate to a JOBS, to_db_table_id and to_in_table is filled with the jobs info |
globally unique identifier | |
| to_in_in_table |
Primary key of the linked destination record in the table identified by . |
globally unique identifier | |
| to_travel_type_code |
Kind of travel. Can be |
string |
Required |
| to_db_address_other |
Free-text destination address, used when the destination isn't one of the standard linked records. |
string |
Max length: 255 |
| hour_type_id |
Foreign key of the hour type |
globally unique identifier |
Required |
| date_from |
Local date+time when the travel started |
date | |
| date_from_rounded |
rounded to the nearest configured interval, used for billing/display. |
date |
Required |
| date_to |
local date+time when the travel finished |
date | |
| date_to_rounded |
rounded to the nearest configured interval, used for billing/display. |
date |
Required |
| notes |
Additional notes field |
string |
Max length: 4000 |
| km |
2019-04-01: Old field not use it anymore (FSA-986) the Mileage of the car after the travel,* Be aware, value should be always bigger than the last one |
integer | |
| km_before |
Auto filled when a new record is added |
integer | |
| km_after |
the Mileage of the car after the travel,* Be aware, value should be always bigger than the last one |
integer | |
| km_private |
A value the user indicates that contains the total number of km for Private use. |
integer | |
| km_distance |
Distance traveled, in kilometers, computed as minus . |
integer | |
| is_time_for_money |
Indicates this travel time is billable ("time for money") rather than purely informational. |
boolean | |
| is_start_stop |
Indicates this entry was recorded via a start/stop timer rather than manually keyed in. |
boolean | |
| property_1_checked |
Checked state of the hour type's configurable custom property #1 (see ) for this entry. |
boolean | |
| property_2_checked |
Checked state of the hour type's configurable custom property #2 for this entry. |
boolean | |
| property_3_checked |
Checked state of the hour type's configurable custom property #3 for this entry. |
boolean | |
| property_4_checked |
Checked state of the hour type's configurable custom property #4 for this entry. |
boolean | |
| property_5_checked |
Checked state of the hour type's configurable custom property #5 for this entry. |
boolean | |
| start_latitude_decimal |
Latitude of the user's location when the travel was started. |
decimal number | |
| start_longitude_decimal |
Longitude of the user's location when the travel was started. |
decimal number | |
| end_latitude_decimal |
Latitude of the user's location when the travel ended. |
decimal number | |
| end_longitude_decimal |
Longitude of the user's location when the travel ended. |
decimal number | |
| added_dateutc |
Readonly system field: UTC date and time this travel record was added. |
date | |
| is_approved |
is_approved flag |
boolean | |
| is_confirmed |
offline field: is_confirmed flag |
boolean | |
| modified_dateutc |
Readonly system field managed by database, filled with GetUtcDate when adding,updating |
date |
Response Formats
application/json, text/json
{
"id": "e0cf885c-7670-40ae-890f-48016a95c5ea",
"user_id": "993a5e34-5ed9-45b3-a71a-162f2d4e0e69",
"car_id": "b3f3cc1a-b714-4dc4-a129-98acf595eb63",
"from_db_address_id": "ed7c2014-7dc3-402d-bbfc-9df28f4449aa",
"from_db_table_id": "40bb972b-80af-46ed-8b82-b2908b9c4642",
"from_id_in_table": "e313c3a2-cd4d-494f-9011-9e1aa7a27fcf",
"from_travel_type_code": "sample string 7",
"from_db_address_other": "sample string 8",
"to_db_address_id": "a0068e02-76c9-4279-a839-fe7b0a14a8d6",
"to_db_table_id": "14b19323-116f-4496-8e25-36283c778b35",
"to_in_in_table": "6922f189-969d-4a0e-84c9-97d48e1f2668",
"to_travel_type_code": "sample string 12",
"to_db_address_other": "sample string 13",
"hour_type_id": "7cf8ee82-5848-4f43-9054-1226e22d9565",
"date_from": "2026-11-12T14:28:57.2760211+00:00",
"date_from_rounded": "2026-11-12T14:28:57.2760211+00:00",
"date_to": "2026-11-12T14:28:57.2760211+00:00",
"date_to_rounded": "2026-11-12T14:28:57.2760211+00:00",
"notes": "sample string 19",
"km": 20,
"km_before": 21,
"km_after": 22,
"km_private": 23,
"km_distance": 24,
"is_time_for_money": true,
"is_start_stop": true,
"property_1_checked": true,
"property_2_checked": true,
"property_3_checked": true,
"property_4_checked": true,
"property_5_checked": true,
"start_latitude_decimal": 32.0,
"start_longitude_decimal": 33.0,
"end_latitude_decimal": 34.0,
"end_longitude_decimal": 35.0,
"added_dateutc": "2026-11-12T14:28:57.2760211+00:00",
"is_approved": true,
"is_confirmed": true,
"modified_dateutc": "2026-11-12T14:28:57.2760211+00:00"
}
application/xml, text/xml
<car_travel xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <added_dateutc>2026-11-12T14:28:57.276Z</added_dateutc> <car_id>b3f3cc1a-b714-4dc4-a129-98acf595eb63</car_id> <date_from>2026-11-12T14:28:57.276Z</date_from> <date_from_rounded>2026-11-12T14:28:57.276Z</date_from_rounded> <date_to>2026-11-12T14:28:57.276Z</date_to> <date_to_rounded>2026-11-12T14:28:57.276Z</date_to_rounded> <end_latitude_decimal>34</end_latitude_decimal> <end_longitude_decimal>35</end_longitude_decimal> <from_db_address_id>ed7c2014-7dc3-402d-bbfc-9df28f4449aa</from_db_address_id> <from_db_address_other>sample string 8</from_db_address_other> <from_db_table_id>40bb972b-80af-46ed-8b82-b2908b9c4642</from_db_table_id> <from_id_in_table>e313c3a2-cd4d-494f-9011-9e1aa7a27fcf</from_id_in_table> <from_travel_type_code>sample string 7</from_travel_type_code> <hour_type_id>7cf8ee82-5848-4f43-9054-1226e22d9565</hour_type_id> <id>e0cf885c-7670-40ae-890f-48016a95c5ea</id> <is_approved>true</is_approved> <is_confirmed>true</is_confirmed> <is_start_stop>true</is_start_stop> <is_time_for_money>true</is_time_for_money> <km>20</km> <km_after>22</km_after> <km_before>21</km_before> <km_distance>24</km_distance> <km_private>23</km_private> <modified_dateutc>2026-11-12T14:28:57.276Z</modified_dateutc> <notes>sample string 19</notes> <property_1_checked>true</property_1_checked> <property_2_checked>true</property_2_checked> <property_3_checked>true</property_3_checked> <property_4_checked>true</property_4_checked> <property_5_checked>true</property_5_checked> <start_latitude_decimal>32</start_latitude_decimal> <start_longitude_decimal>33</start_longitude_decimal> <to_db_address_id>a0068e02-76c9-4279-a839-fe7b0a14a8d6</to_db_address_id> <to_db_address_other>sample string 13</to_db_address_other> <to_db_table_id>14b19323-116f-4496-8e25-36283c778b35</to_db_table_id> <to_in_in_table>6922f189-969d-4a0e-84c9-97d48e1f2668</to_in_in_table> <to_travel_type_code>sample string 12</to_travel_type_code> <user_id>993a5e34-5ed9-45b3-a71a-162f2d4e0e69</user_id> </car_travel>