Entity · seat_packages
Seat Package Schema
Felder
Seat Package Schema
Bulk seat allocation for a shared course (ADR 0066b Phase 4)
seatsTotal
Total seats sold in this package.
≥ 1
seatsAssigned
Seats already redeemed by the customer-tenant manager.
≥ 0Default: 0read-only
unitPriceCents
Per-seat price in cents at sale time.
≥ 0
totalPriceCents
unitPriceCents × seatsTotal (denormalised for reporting).
≥ 0
currency
Default: "EUR"
taxRatePercent
0 – 100Default: 19
status
active: seats remain. depleted: all assigned. cancelled: revoked, unassigned seats invalid.
Werte
activedepletedcancelledDefault: "active"
expiresAt
Optional expiration after which unused seats are invalid.
Default: nullnullable
chargeId
course_charges row that bundles the bulk payment.
nullable
notes
max 2000 Zeichennullable
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/seat_packages— Liste, paginiert + filterbarGET /api/v1/seat_packages/<id>— Einzelne EntityPOST /api/v1/seat_packages— AnlegenPATCH /api/v1/seat_packages/<id>— Teil-UpdateDELETE /api/v1/seat_packages/<id>— Soft-DeleteGET /api/v1/seat_packages/<id>/timeline— Audit + Aktivitäten