Trip Schema
Felder
Trip Schema
Schema for validating trip entities
userId
User ID who created this trip entry
date
Date of the trip (ISO date format)
status
Current status of the trip
PLANNEDIN_PROGRESSCOMPLETEDCANCELLEDstartLocation
Trip start location
endLocation
Trip end location
isRoundTrip
Whether this is a round trip
distanceKm
Distance in kilometers
durationMinutes
Trip duration in minutes
travelMode
Mode of transportation
CARPUBLIC_TRANSPORTFLIGHTTAXIBIKEWALKvehicleInfo
Vehicle information (license plate, description)
departureAt
Departure time (ISO datetime)
arrivalAt
Arrival time (ISO datetime)
returnDepartureAt
Return departure time for round trips (ISO datetime)
returnArrivalAt
Return arrival time for round trips (ISO datetime)
distanceBillable
Whether distance/mileage is billable
timeBillable
Whether travel time is billable
ratePerKm
Rate per kilometer in EUR as decimal string
timeBillingMode
How travel time is billed when timeBillable=true
HOURLYFLAT_RATEtimeRatePerHour
Hourly rate for travel time in EUR (used when timeBillingMode=HOURLY)
timeFlatRateAmount
Flat-rate amount for travel time in EUR (used when timeBillingMode=FLAT_RATE)
parkingCost
Parking costs in EUR as decimal string
tollCost
Toll costs in EUR as decimal string
otherCosts
Other costs in EUR as decimal string
totalCost
Total computed cost in EUR as decimal string
ticketId
Associated ticket UUID
projectId
Associated project UUID
partyId
Associated party/customer UUID
contractId
Associated contract UUID
timeRecordId
Linked time record UUID (optional)
billable
Whether this trip is billable to the customer
billingStatus
Current billing status
OPENAPPROVEDRECORDEDINVOICEDTRANSFERREDnotes
Trip notes
tags
Trip tags
Keine Felder passen zum Filter.
Standard-Endpoints
Diese Resource folgt dem generischen CRUD-Vertrag der Plattform. Lesen Sie die Konventionen für Pagination, Idempotenz, Optimistic Locking und Audit. Die wichtigsten Endpoints:
GET /api/v1/trips— Liste, paginiert + filterbarGET /api/v1/trips/<id>— Einzelne EntityPOST /api/v1/trips— AnlegenPATCH /api/v1/trips/<id>— Teil-UpdateDELETE /api/v1/trips/<id>— Soft-DeleteGET /api/v1/trips/<id>/timeline— Audit + Aktivitäten