[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": "63221504-77a2-4aa0-8898-37d0738ec905",
"user_id": "7bd3912b-b6b7-45a2-8478-1116ae551278",
"car_id": "1c044a5e-0a3a-4842-ba58-83556fd275ba",
"from_db_address_id": "f8741e1b-7d22-47c6-9a32-b76808489f1b",
"from_db_table_id": "28f8287a-96ea-4cec-a775-b21d17d67028",
"from_id_in_table": "2e6c1c8d-cdb7-458c-8e8e-50bea4e24681",
"from_travel_type_code": "sample string 7",
"from_db_address_other": "sample string 8",
"to_db_address_id": "ebf644ff-aea1-4634-8e3b-3222f0117407",
"to_db_table_id": "b906b858-04f8-49dd-b000-49b49192e6b9",
"to_in_in_table": "80ce753d-d7c1-4d76-aa4d-add99191da5a",
"to_travel_type_code": "sample string 12",
"to_db_address_other": "sample string 13",
"hour_type_id": "a9d571e0-e5d6-4630-bd5d-7fdb9bb8fd44",
"date_from": "2026-09-16T10:16:40.8733507+00:00",
"date_from_rounded": "2026-09-16T10:16:40.8733507+00:00",
"date_to": "2026-09-16T10:16:40.8733507+00:00",
"date_to_rounded": "2026-09-16T10:16:40.8733507+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-09-16T10:16:40.8733507+00:00",
"is_approved": true,
"is_confirmed": true,
"modified_dateutc": "2026-09-16T10:16:40.8733507+00:00"
}
application/xml, text/xml
<car_travel xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <added_dateutc>2026-09-16T10:16:40.873Z</added_dateutc> <car_id>1c044a5e-0a3a-4842-ba58-83556fd275ba</car_id> <date_from>2026-09-16T10:16:40.873Z</date_from> <date_from_rounded>2026-09-16T10:16:40.873Z</date_from_rounded> <date_to>2026-09-16T10:16:40.873Z</date_to> <date_to_rounded>2026-09-16T10:16:40.873Z</date_to_rounded> <end_latitude_decimal>34</end_latitude_decimal> <end_longitude_decimal>35</end_longitude_decimal> <from_db_address_id>f8741e1b-7d22-47c6-9a32-b76808489f1b</from_db_address_id> <from_db_address_other>sample string 8</from_db_address_other> <from_db_table_id>28f8287a-96ea-4cec-a775-b21d17d67028</from_db_table_id> <from_id_in_table>2e6c1c8d-cdb7-458c-8e8e-50bea4e24681</from_id_in_table> <from_travel_type_code>sample string 7</from_travel_type_code> <hour_type_id>a9d571e0-e5d6-4630-bd5d-7fdb9bb8fd44</hour_type_id> <id>63221504-77a2-4aa0-8898-37d0738ec905</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-09-16T10:16:40.873Z</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>ebf644ff-aea1-4634-8e3b-3222f0117407</to_db_address_id> <to_db_address_other>sample string 13</to_db_address_other> <to_db_table_id>b906b858-04f8-49dd-b000-49b49192e6b9</to_db_table_id> <to_in_in_table>80ce753d-d7c1-4d76-aa4d-add99191da5a</to_in_in_table> <to_travel_type_code>sample string 12</to_travel_type_code> <user_id>7bd3912b-b6b7-45a2-8478-1116ae551278</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": "45231729-2644-4e42-bbd5-c36c7c60cc64",
"user_id": "53ab4837-2ee2-46fd-9168-7c308f687bb8",
"car_id": "e5c40da0-7051-4ede-9351-264ed7c97db7",
"from_db_address_id": "76b8d32d-1426-4b0b-8a33-6ab8e669b36e",
"from_db_table_id": "ae9af783-40ea-4c84-a24e-be36d5ae8494",
"from_id_in_table": "629ebfe6-e88e-4131-9ad7-36ec9779ee9d",
"from_travel_type_code": "sample string 7",
"from_db_address_other": "sample string 8",
"to_db_address_id": "30e6dbe8-5e58-48b5-b8f3-bb1bdfe6ae07",
"to_db_table_id": "c9f32652-0b04-4d25-ba8d-5764db9e181d",
"to_in_in_table": "1d18c2e8-d0ea-4a26-8796-cb94c043c492",
"to_travel_type_code": "sample string 12",
"to_db_address_other": "sample string 13",
"hour_type_id": "8231cced-2409-479a-a84c-19036b79a924",
"date_from": "2026-09-16T10:16:40.8844235+00:00",
"date_from_rounded": "2026-09-16T10:16:40.8844235+00:00",
"date_to": "2026-09-16T10:16:40.8844235+00:00",
"date_to_rounded": "2026-09-16T10:16:40.8844235+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-09-16T10:16:40.8844235+00:00",
"is_approved": true,
"is_confirmed": true,
"modified_dateutc": "2026-09-16T10:16:40.8844235+00:00"
}
application/xml, text/xml
<car_travel xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <added_dateutc>2026-09-16T10:16:40.884Z</added_dateutc> <car_id>e5c40da0-7051-4ede-9351-264ed7c97db7</car_id> <date_from>2026-09-16T10:16:40.884Z</date_from> <date_from_rounded>2026-09-16T10:16:40.884Z</date_from_rounded> <date_to>2026-09-16T10:16:40.884Z</date_to> <date_to_rounded>2026-09-16T10:16:40.884Z</date_to_rounded> <end_latitude_decimal>34</end_latitude_decimal> <end_longitude_decimal>35</end_longitude_decimal> <from_db_address_id>76b8d32d-1426-4b0b-8a33-6ab8e669b36e</from_db_address_id> <from_db_address_other>sample string 8</from_db_address_other> <from_db_table_id>ae9af783-40ea-4c84-a24e-be36d5ae8494</from_db_table_id> <from_id_in_table>629ebfe6-e88e-4131-9ad7-36ec9779ee9d</from_id_in_table> <from_travel_type_code>sample string 7</from_travel_type_code> <hour_type_id>8231cced-2409-479a-a84c-19036b79a924</hour_type_id> <id>45231729-2644-4e42-bbd5-c36c7c60cc64</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-09-16T10:16:40.884Z</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>30e6dbe8-5e58-48b5-b8f3-bb1bdfe6ae07</to_db_address_id> <to_db_address_other>sample string 13</to_db_address_other> <to_db_table_id>c9f32652-0b04-4d25-ba8d-5764db9e181d</to_db_table_id> <to_in_in_table>1d18c2e8-d0ea-4a26-8796-cb94c043c492</to_in_in_table> <to_travel_type_code>sample string 12</to_travel_type_code> <user_id>53ab4837-2ee2-46fd-9168-7c308f687bb8</user_id> </car_travel>