Project Position Schema
Felder
Project Position Schema
ADR 0310 — optional billing/grouping layer between a project and its tasks; carries the billing model and aggregates the effort of its tasks.
projectId
Owning project UUID.
positionNumber
Position number carried over from the sales order (display / ordering).
sortOrder
Manual sort order within the project (drag & drop).
title
Position title.
description
Position description.
status
Position lifecycle status.
OPENDONECANCELLEDbillingModel
flat_rate = fixed price, bookings are a profitability metric only (never hard-blocked). time_and_material = billed by actual bookings; an optional cap lives on the task (limitMode).
flat_ratetime_and_materialplannedMinutes
Planned effort in minutes (Soll).
plannedAmount
Planned / sold net amount in EUR (Soll), decimal string.
plannedAmountCurrency
ISO 4217 currency for plannedAmount (default EUR when null).
quantity
Sold quantity carried over from the order item (decimal string).
unitPrice
Unit price carried over from the order item (decimal string).
netAmount
Net amount carried over from the order item (decimal string).
consumedMinutes
Sum of loggedMinutes of the tasks under this position (cached rollup).
consumedAmount
Sum of consumedAmount of the tasks under this position (cached rollup, EUR).
articleId
Optional linked article UUID.
salesOrderId
Sales order this position was materialised from (order-import path).
salesOrderItemId
ID of the orderItem inside the linked sales_order (matches salesOrder.orderItems[].id).
salesOrderItemSource
Origin of the linked sales-order item — internal or weclapp.
internalweclappnullbilledAt
When this flat-rate position was put on a Leistungsnachweis (per-project billing run). Null = not billed yet.
performanceRecordId
Leistungsnachweis this position was billed on. Server-managed.
invoiceId
Invoice this position was billed on. Server-managed.
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/project_positions— Liste, paginiert + filterbarGET /api/v1/project_positions/<id>— Einzelne EntityPOST /api/v1/project_positions— AnlegenPATCH /api/v1/project_positions/<id>— Teil-UpdateDELETE /api/v1/project_positions/<id>— Soft-DeleteGET /api/v1/project_positions/<id>/timeline— Audit + Aktivitäten