Time Record Schema

User ID who recorded this time entry

Date of the time entry (ISO date format)

Start time for exact time tracking (ISO datetime)

End time for exact time tracking (ISO datetime)

Total duration in minutes

Break time in minutes

When the break started (ISO datetime) — legacy, first break

Multiple break entries with start time and duration

Work description

Internal note not visible to customer

Service type UUID — primary classification for billing parameters

Snapshot von service_type.serviceNature zum Buchungszeitpunkt (SUPPORT = im Full-Service enthalten, ORDER_BASED = auftragsbezogen). Server-gesetzt (protected), als direktes Feld in der Analytics-Auswertung gruppierbar. Null = nicht klassifiziert.

Derived from serviceType.category (legacy compatibility)

Location where work was performed (defaults from serviceType.defaultLocation)

Company UUID — always required (own company or customer)

If true, not visible to customer and not billable

Type of linked entity (Auftrag)

UUID of linked entity (Auftrag)

Linked project UUID (max. one; primary reference when set)

Linked ticket UUID (max. one; must belong to linkedProjectId when both set)

Linked task UUID (max. one; must belong to linkedTicketId/linkedProjectId when set)

Linked contact person (PERSON party) UUIDs — informational, never billing-relevant while a work-item link exists

Linked asset UUIDs — informational, never billing-relevant while a work-item link exists

Associated contract UUID (can be set alongside referenceType/Id)

ADR 0310: project_position this direct-on-project booking is billed against. Set when time is booked off a project appointment (calendar_event.positionId) so the position Ist (consumedMinutes/consumedAmount) reflects it. Only meaningful for direct project bookings (referenceType=PROJECT); task bookings already carry their position via task.positionId.

Asset the work was performed on (inherited from the linked ticket)

How this record is handled financially against a contract

Contract that covers this record (resolver result)

Contract assignment whose coverage rule applied

Contingent the work was deducted from (CONTINGENT mode)

Frozen contract special rate snapshot (CONTRACT_RATE mode)

Frozen rate-source snapshot for revision safety

Resolver logic version active when coverage was resolved

Timestamp the coverage was resolved

Asset could not be determined unambiguously — manual clarification needed

Contingent overage was blocked by policy — overhang billed regularly

Surcharge amount for the contingent overhang (ALLOW_WITH_SURCHARGE)

A reference linked multiple assets, so coverage was split across them and this record mixes covered + billable shares (ADR 0164). When true, billing invoices only `billableMinutes - coveredMinutes`.

Sum of per-asset share minutes resolving to INCLUDED/CONTINGENT coverage (ADR 0164). Subtracted from billable minutes for coveragePartial records so covered work is not double-charged.

Per-asset coverage split snapshot when a reference links multiple assets (ADR 0164). Display/audit only — the actual contingent deduction lives in contingent_ledger / contingent_usages.

Origin entity type this time record was booked from. CALENDAR_EVENT marks records booked off a calendar appointment via "Zeit buchen" — the source event is then hidden in the calendar (the time record renders in its place).

Origin entity ID this time record was booked from

Billability classification

Derived: true when billableType !== NONE

Billable minutes when billableType is PARTIAL

Billable percentage when billableType is PARTIAL

Computed billable minutes (after rounding and inclusive deduction)

Non-billable minutes

Reason why time is not billable

Hourly rate in EUR as decimal string

Snapshot of the hourly rate that was effective when this time record was created. Read-only after insert (ADR 0139 — Snapshot-Pattern analog ADR 0128a). Sourced from serviceType.billing.pricing[] or articlePrices[] depending on priceSource.

Provenance of the frozen base rate (ADR 0415): contract = contract.conditions.serviceRates / CONTRACT_RATE, party_override / party_discount = customer conditions (party.serviceTypeOverrides), article = article.articlePrices, service_type = tenant-wide mask price. Server-set alongside appliedRatePerHour; billing uses it to decide whether a BILLING_DATE re-resolve may replace the frozen rate (a contract-driven rate never is). Null on legacy records (treated conservatively: frozen rate kept).

Snapshot of billable amount = durationMinutes/60 * appliedRatePerHour, computed once on insert. Drives task.consumedAmount aggregation for limitMode=amount tasks (ADR 0139).

Linked weclapp time-record ID after successful push

Sync state of this time-record against weclapp

Last successful weclapp push timestamp

Last weclapp push error message

weclapp salesOrderItem id of the TIME position appended to the sales order for this booking (non-service-position time, ADR 0412). Dedupe key for retries and the removal address when the approval is revoked.

weclapp salesOrderItem ids of the TRAVEL positions appended to the sales order for this booking (ADR 0412).

Whether this is a flat-rate billing entry

Flat rate amount in EUR as decimal string

Assignment target type

Assignment target UUID

Associated org unit (department/team) UUID

Associated cost center UUID

Herkunftsmarker (z. B. TANSS). Entspricht der Wert einem `externalMaster`-Provider, ist der Datensatz ein read-only Spiegel (ADR 0377) und nur vom Sync pflegbar; Bearbeitungsversuche scheitern mit 423. Der Guard wirkt pro Dokument — lokal erfasste Zeitbuchungen tragen kein `source` und bleiben normal bearbeitbar.

Referenz auf das Quellsystem, aus dem dieser Datensatz importiert wurde

Unified lifecycle status: DRAFT → SUBMITTED → APPROVED → RECORDED → INVOICED. Branches: REJECTED, CREDITED.

User who approved this entry

Timestamp when approved (ISO datetime)

Reason for rejection if status is REJECTED

Parked over-limit draft (ADR 0223): this entry was recorded against a ticket whose budget cap (Obergrenze) is already reached. It stays a permanent DRAFT, is EXCLUDED from budget.consumedMinutes and from billing, and blocks the ticket from being closed until the cap is raised (which auto-converts it back to a normal draft) or it is deleted. Distinct from a regular status:'DRAFT'.

Employee flagged this entry as unclear/needing clarification at recording time (e.g. unsure how to bill it, missing context). Surfaced to the team lead in the draft overview so it can be resolved before approval. Client-editable by the recorder.

Optional note describing what is unclear about this entry (set alongside isUnclear).

Task UUIDs of Rücksprache (consultation) tasks raised for this entry. Owned by the request-consultation endpoint — never client-editable.

Leistungsnachweis this record was booked onto (set when status becomes RECORDED, cleared when the Leistungsnachweis is deleted)

Invoice this record was billed on (set when status becomes INVOICED, cleared when the invoice attempt is rolled back)

Whether this time entry is overtime (outside regular hours)

Whether this time entry was performed on a weekend or public holiday

Whether this time entry was emergency/on-call service

Reason explaining why overtime/weekend/emergency service was necessary

Reference to a flat rate service (Pauschalleistung)

Surcharges applied to this time record

Minute-accurate surcharge split of this booking (ADR 0431) — the breakdown behind the blended `ratePerHour`.

References to trip entities linked to this time record

Travel information when entryType includes travel

Time entry tags