API · v1 · stabil
CODEMETA OSDeveloper Center
Konsole öffnen
Entity · trips

Trip Schema

Schema-ID
trip
Collection
trips
Permissions
  • Lesentrip_view
  • Anlegentrip_create
  • Änderntrip_edit
  • Löschentrip_delete

Felder

Trip Schema

trips4 Permissions

Schema for validating trip entities

userIduuidoptional

User ID who created this trip entry

datedateerforderlich

Date of the trip (ISO date format)

statusstringerforderlich

Current status of the trip

PLANNEDIN_PROGRESSCOMPLETEDCANCELLED
Default: "PLANNED"
startLocationstringerforderlich

Trip start location

1–200 Zeichen
endLocationstringerforderlich

Trip end location

1–200 Zeichen
isRoundTripbooleanerforderlich

Whether this is a round trip

Default: false
distanceKmnumbererforderlich

Distance in kilometers

≥ 0
durationMinutesintegererforderlich

Trip duration in minutes

≥ 0
travelModestringerforderlich

Mode of transportation

CARPUBLIC_TRANSPORTFLIGHTTAXIBIKEWALK
vehicleInfostringoptional

Vehicle information (license plate, description)

max 100 Zeichennullable
departureAtdatetimeoptional

Departure time (ISO datetime)

nullable
arrivalAtdatetimeoptional

Arrival time (ISO datetime)

nullable
returnDepartureAtdatetimeoptional

Return departure time for round trips (ISO datetime)

nullable
returnArrivalAtdatetimeoptional

Return arrival time for round trips (ISO datetime)

nullable
distanceBillablebooleanerforderlich

Whether distance/mileage is billable

Default: true
timeBillablebooleanerforderlich

Whether travel time is billable

Default: true
ratePerKmstringerforderlich

Rate per kilometer in EUR as decimal string

PatternDefault: "0.30"
timeBillingModestringoptional

How travel time is billed when timeBillable=true

HOURLYFLAT_RATE
Default: "HOURLY"
timeRatePerHourstringoptional

Hourly rate for travel time in EUR (used when timeBillingMode=HOURLY)

PatternDefault: "0.00"
timeFlatRateAmountstringoptional

Flat-rate amount for travel time in EUR (used when timeBillingMode=FLAT_RATE)

PatternDefault: "0.00"
parkingCoststringoptional

Parking costs in EUR as decimal string

PatternDefault: "0.00"
tollCoststringoptional

Toll costs in EUR as decimal string

PatternDefault: "0.00"
otherCostsstringoptional

Other costs in EUR as decimal string

PatternDefault: "0.00"
totalCoststringoptional

Total computed cost in EUR as decimal string

PatternDefault: "0.00"
ticketIduuidoptional

Associated ticket UUID

nullable
projectIduuidoptional

Associated project UUID

nullable
partyIduuidoptional

Associated party/customer UUID

nullable
contractIduuidoptional

Associated contract UUID

nullable
timeRecordIduuidoptional

Linked time record UUID (optional)

nullable
billablebooleanerforderlich

Whether this trip is billable to the customer

Default: true
billingStatusstringerforderlich

Current billing status

OPENAPPROVEDRECORDEDINVOICEDTRANSFERRED
Default: "OPEN"
notesstringoptional

Trip notes

max 1000 Zeichennullable
tagsstring[]optional

Trip tags

Default: []

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 + filterbar
  • GET /api/v1/trips/<id> — Einzelne Entity
  • POST /api/v1/trips — Anlegen
  • PATCH /api/v1/trips/<id> — Teil-Update
  • DELETE /api/v1/trips/<id> — Soft-Delete
  • GET /api/v1/trips/<id>/timeline — Audit + Aktivitäten

Suche