Performance Record Schema

Customer party UUID

Associated contract UUID

Project this record was generated for (per-project standalone billing run). Null/absent for collective and per-ticket runs and for legacy records.

Auto-generated sequence number

Date of the performance record

Service period start date

Service period end date

Lifecycle status

Title / summary

Internal note

Linked time record UUIDs

Linked expense UUIDs

Linked trip UUIDs

Material buckets selected during a per-project billing preview. Materialised as invoice positions when the invoice is generated (default for opts.materialBucketIds).

Flat-rate project positions (ADR 0310/0406) billed in this per-project run. Their FLAT_RATE line items are part of the snapshot; the invoice stamps project_position.invoiceId from this list.

Snapshot of the component selection of a per-project billing run (display/audit). Null/absent for collective and legacy runs.

Total tracked minutes

Total billable minutes (after rounding and inclusive deduction)

Total billing units (Arbeitseinheiten) derived from billable minutes and billingUnitMinutes

Total net amount in EUR as decimal string. Mirrors netAmount; kept for backward compatibility.

Snapshot of calculated line items (services + trips). Frozen at PR creation, reused 1:1 when generating the invoice — no recalculation.

Default VAT rate applied to the items snapshot (percent string)

Sum of item netAmounts in EUR as decimal string

Total VAT in EUR as decimal string

Gross total (net + VAT) in EUR as decimal string

Linked invoice UUID (when converted to invoice)

ADR 0146 — snapshot of tickets that were still open when this Leistungsnachweis was generated but were unlocked via `ticket.billingOverride`. Frozen at PR creation so the invoice PDF can render a neutral "Hinweise"-section ("Ticket … wird weiterhin bearbeitet") without re-querying ticket state at print time. Internal `reason` is intentionally NOT included — it stays on the ticket.