Save multiple car_travel records in a single batch request. This API is used by the Synchronization module to send multiple records in one request instead of sending each record individually, which: 1. Reduces the number of HTTP requests. 2. Improves performance and efficiency. The batch processing logic (deserialize, validation, transaction handling, saving, and logging) is handled by BatchSaveHelper. Each record will return its own ResponseResult indicating success or failure.
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 | globally unique identifier | ||
| from_id_in_table | globally unique identifier | ||
| from_travel_type_code | string | ||
| from_db_address_other | 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 | globally unique identifier | ||
| to_travel_type_code |
Kind of travel. Can be |
string |
Required |
| to_db_address_other | 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 |
Date+Time travel FROM |
date |
Required |
| date_to |
local date+time when the travel finished |
date | |
| date_to_rounded |
Date+Time travel TO |
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 | integer | ||
| is_time_for_money | boolean | ||
| is_start_stop | boolean | ||
| property_1_checked | boolean | ||
| property_2_checked | boolean | ||
| property_3_checked | boolean | ||
| property_4_checked | boolean | ||
| property_5_checked | boolean | ||
| start_latitude_decimal | decimal number | ||
| start_longitude_decimal | decimal number | ||
| end_latitude_decimal | decimal number | ||
| end_longitude_decimal | decimal number | ||
| added_dateutc |
added dateutc |
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": "b0b74d4a-abc4-4b7c-a9e8-403589002c68",
"user_id": "115ad00b-f3c8-49da-9436-42755c540d4a",
"car_id": "9548ea0c-2f48-4393-8167-cbf0d7bdd386",
"from_db_address_id": "da822658-0285-46c6-8cfd-2cf99651b763",
"from_db_table_id": "3aa2e66d-976d-4201-b810-e9290e8cf0d3",
"from_id_in_table": "47583ccb-8078-407d-a83e-dfa94ea4c78c",
"from_travel_type_code": "sample string 7",
"from_db_address_other": "sample string 8",
"to_db_address_id": "0d99101f-c765-4353-abc9-6361cc1442ad",
"to_db_table_id": "6abe3acc-6855-4fcc-8bcc-4cdab729e84c",
"to_in_in_table": "e792a763-e596-4364-85fd-730e931e9c20",
"to_travel_type_code": "sample string 12",
"to_db_address_other": "sample string 13",
"hour_type_id": "48b63228-9001-4e86-a625-07f4af2cc267",
"date_from": "2026-06-16T21:15:10.0878046+00:00",
"date_from_rounded": "2026-06-16T21:15:10.0878046+00:00",
"date_to": "2026-06-16T21:15:10.0878046+00:00",
"date_to_rounded": "2026-06-16T21:15:10.0878046+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-06-16T21:15:10.0878046+00:00",
"is_approved": true,
"is_confirmed": true,
"modified_dateutc": "2026-06-16T21:15:10.0878046+00:00"
}
application/xml, text/xml
<car_travel xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <added_dateutc>2026-06-16T21:15:10.087Z</added_dateutc> <car_id>9548ea0c-2f48-4393-8167-cbf0d7bdd386</car_id> <date_from>2026-06-16T21:15:10.087Z</date_from> <date_from_rounded>2026-06-16T21:15:10.087Z</date_from_rounded> <date_to>2026-06-16T21:15:10.087Z</date_to> <date_to_rounded>2026-06-16T21:15:10.087Z</date_to_rounded> <end_latitude_decimal>34</end_latitude_decimal> <end_longitude_decimal>35</end_longitude_decimal> <from_db_address_id>da822658-0285-46c6-8cfd-2cf99651b763</from_db_address_id> <from_db_address_other>sample string 8</from_db_address_other> <from_db_table_id>3aa2e66d-976d-4201-b810-e9290e8cf0d3</from_db_table_id> <from_id_in_table>47583ccb-8078-407d-a83e-dfa94ea4c78c</from_id_in_table> <from_travel_type_code>sample string 7</from_travel_type_code> <hour_type_id>48b63228-9001-4e86-a625-07f4af2cc267</hour_type_id> <id>b0b74d4a-abc4-4b7c-a9e8-403589002c68</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-06-16T21:15:10.087Z</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>0d99101f-c765-4353-abc9-6361cc1442ad</to_db_address_id> <to_db_address_other>sample string 13</to_db_address_other> <to_db_table_id>6abe3acc-6855-4fcc-8bcc-4cdab729e84c</to_db_table_id> <to_in_in_table>e792a763-e596-4364-85fd-730e931e9c20</to_in_in_table> <to_travel_type_code>sample string 12</to_travel_type_code> <user_id>115ad00b-f3c8-49da-9436-42755c540d4a</user_id> </car_travel>
Response Information
Resource Description :
IHttpActionResult containing batch save results.
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 | globally unique identifier | ||
| from_id_in_table | globally unique identifier | ||
| from_travel_type_code | string | ||
| from_db_address_other | 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 | globally unique identifier | ||
| to_travel_type_code |
Kind of travel. Can be |
string |
Required |
| to_db_address_other | 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 |
Date+Time travel FROM |
date |
Required |
| date_to |
local date+time when the travel finished |
date | |
| date_to_rounded |
Date+Time travel TO |
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 | integer | ||
| is_time_for_money | boolean | ||
| is_start_stop | boolean | ||
| property_1_checked | boolean | ||
| property_2_checked | boolean | ||
| property_3_checked | boolean | ||
| property_4_checked | boolean | ||
| property_5_checked | boolean | ||
| start_latitude_decimal | decimal number | ||
| start_longitude_decimal | decimal number | ||
| end_latitude_decimal | decimal number | ||
| end_longitude_decimal | decimal number | ||
| added_dateutc |
added dateutc |
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": "c26f229b-2fde-4fef-9236-34b4da14f821",
"user_id": "5e41bf16-2a09-4b75-a87e-0e1e90e062a2",
"car_id": "0061e8cb-d61d-4f81-890b-1ada3ea07575",
"from_db_address_id": "bd524cef-05ec-4a61-aab0-80f491577663",
"from_db_table_id": "b2ce6e22-903c-4802-b101-1df95bfd251c",
"from_id_in_table": "6eb0e1bc-f3f3-4612-a8d9-765994f213fc",
"from_travel_type_code": "sample string 7",
"from_db_address_other": "sample string 8",
"to_db_address_id": "dbdfcbc3-3a41-46c2-b840-0fc7974421bb",
"to_db_table_id": "e277cbb1-3b30-4b95-b40b-f72f3c02466d",
"to_in_in_table": "c0f45753-5596-448c-8035-1515d49c9fab",
"to_travel_type_code": "sample string 12",
"to_db_address_other": "sample string 13",
"hour_type_id": "ee1bc9f0-f89c-4645-92cb-6b4e60d7c173",
"date_from": "2026-06-16T21:15:10.3690506+00:00",
"date_from_rounded": "2026-06-16T21:15:10.3690506+00:00",
"date_to": "2026-06-16T21:15:10.3690506+00:00",
"date_to_rounded": "2026-06-16T21:15:10.3690506+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-06-16T21:15:10.3690506+00:00",
"is_approved": true,
"is_confirmed": true,
"modified_dateutc": "2026-06-16T21:15:10.3690506+00:00"
}
application/xml, text/xml
<car_travel xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <added_dateutc>2026-06-16T21:15:10.369Z</added_dateutc> <car_id>0061e8cb-d61d-4f81-890b-1ada3ea07575</car_id> <date_from>2026-06-16T21:15:10.369Z</date_from> <date_from_rounded>2026-06-16T21:15:10.369Z</date_from_rounded> <date_to>2026-06-16T21:15:10.369Z</date_to> <date_to_rounded>2026-06-16T21:15:10.369Z</date_to_rounded> <end_latitude_decimal>34</end_latitude_decimal> <end_longitude_decimal>35</end_longitude_decimal> <from_db_address_id>bd524cef-05ec-4a61-aab0-80f491577663</from_db_address_id> <from_db_address_other>sample string 8</from_db_address_other> <from_db_table_id>b2ce6e22-903c-4802-b101-1df95bfd251c</from_db_table_id> <from_id_in_table>6eb0e1bc-f3f3-4612-a8d9-765994f213fc</from_id_in_table> <from_travel_type_code>sample string 7</from_travel_type_code> <hour_type_id>ee1bc9f0-f89c-4645-92cb-6b4e60d7c173</hour_type_id> <id>c26f229b-2fde-4fef-9236-34b4da14f821</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-06-16T21:15:10.369Z</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>dbdfcbc3-3a41-46c2-b840-0fc7974421bb</to_db_address_id> <to_db_address_other>sample string 13</to_db_address_other> <to_db_table_id>e277cbb1-3b30-4b95-b40b-f72f3c02466d</to_db_table_id> <to_in_in_table>c0f45753-5596-448c-8035-1515d49c9fab</to_in_in_table> <to_travel_type_code>sample string 12</to_travel_type_code> <user_id>5e41bf16-2a09-4b75-a87e-0e1e90e062a2</user_id> </car_travel>