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.

ADR 0963 — ticket this record was generated for (per-ticket standalone billing run). Null/absent for collective and per-project runs and for records created before ADR 0963 (those count as a collective record when the weclapp commission is chosen).

Auto-generated sequence number

Date of the performance record

Service period start date

Service period end date

Lifecycle status. CLOSED_WITHOUT_INVOICE (ADR 0929) = a record with a net value of 0.00 EUR that was settled without an invoice; its time records stay RECORDED. Set and lifted only via POST /performance-records/:id/close-without-invoice and …/reopen.

ADR 0914 — billing stream this record was generated for. EMERGENCY = a Notdienst-Leistungsnachweis holding only emergency-service bookings (isEmergencyService) of a customer whose emergency billing is SEPARATE. Missing on documents created before ADR 0914 (= STANDARD).

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.

ADR 0909 — subset of timeRecordIds that is linked but not priced (contract-covered INCLUDED/CONTINGENT, ADR 0563; covered by a flat-rate position, ADR 0416). These bookings have no line item; the PDF lists them in a separate "already settled" section. Missing on records created before ADR 0909 — those keep the legacy PDF table.

ADR 0909 — snapshot of the effective "group positions by ticket" setting (customer override → tenant default) at generation time. Items then carry groupLabel. Missing on documents created before ADR 0909 (= ungrouped).

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.