Reference & Data Model
Purchase (good_purchase)
A purchase is a concrete order of a good with price, quantity and conditions; from „Bestellt“ (ordered) it posts material costs, from „Geliefert“ (delivered) stock.
Purpose
Section titled “Purpose”The Purchase documents the procurement process of a good from draft to payment (project data). It is the only source for actual material costs from orders.
Where in the app
Section titled “Where in the app”Project › tab „Beschaffung“ (Procurement) › table „Einkäufe“ (Purchases) with filter and sorting, „+“ („Einkauf hinzufügen“, dialog „Neuer Einkauf“), double-click or „Details“ opens the purchase dialog, „Löschen“ (Delete) in the context menu. KPI cards „Bereits eingekauft“ (Already purchased), „Einkaufsvolumen“ (Purchase volume), „Einkäufe“ (Purchases). See Guides › Procurement and Guides › From engineering to order.
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Title | title |
Text | yes | Label of the purchase | – |
| Order number | key |
Text | yes (may be empty) | Internal purchase number | Column „Nummer“ |
| Good | good_variant_id |
Reference | yes | Purchased good variant | cannot be changed after creation |
| Status | state |
Selection | yes | see States | Default „Entwurf“ (draft) |
| Description | description |
Text | no | Free text | – |
| Unit price (net) | net_unit_price |
Amount | yes | Net price per unit | – |
| Currency | currency |
Selection | no | Currency of the purchase | Display falls back to the project currency |
| Order quantity | quantity |
Number | yes | Number of units | Default 1 |
| Received quantity | delivered_quantity |
Number | no | Delivered quantity | purchase dialog only |
| Returned quantity | returned_quantity |
Number | no | Quantity sent back | purchase dialog only |
| Tax rate | tax_rate_in_pct |
Number (%) | yes | VAT | Default 19 |
| Discount | discount_in_pct |
Number (%) | no | Reduction | – |
| Surcharge | additional_charge_in_pct |
Number (%) | no | Additional fees | – |
| Requested on | requested_at |
Date | no | – | purchase dialog only |
| Ordered on | ordered_at |
Date | no | – | Posting date of the material costs |
| Delivered on | delivered_at |
Date | no | – | Date of the stock inbound |
| Invoiced on | invoiced_at |
Date | no | – | purchase dialog only |
| Paid on | paid_at |
Date | no | Payment date | purchase dialog only |
| Cancelled on | cancelled_at |
Date | no | – | purchase dialog only |
Computed display values: amount (net) = unit price × quantity × (1 − discount) × (1 + surcharge); amount = net × (1 + tax rate).
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| Project | belongs to | no | kept | deleted along |
| Material (good variant) | belongs to | yes | – | blocked (a good with purchases cannot be deleted) |
States
Section titled “States”Entwurf (draft, draft) · Angefragt (requested, requested) · Genehmigt (approved, approved) · Abgelehnt (rejected, rejected) · Bestellt (ordered, ordered) · Bestellung bestätigt (order_confirmed, order confirmed) · Teilweise geliefert (partially_delivered, partially delivered) · Geliefert (delivered, delivered) · In Prüfung (under_inspection, under inspection) · Abgenommen (accepted, accepted) · Bei Prüfung abgelehnt (rejected_at_inspection, rejected at inspection) · In Rechnung gestellt (invoiced, invoiced) · Bezahlt (paid, paid) · Storniert (cancelled, cancelled) · Retourniert (returned, returned) · In Klärung (disputed, disputed) · Abgelaufen (expired, expired).
Every status belongs to a base class: Geplant (planned: Entwurf, Angefragt, Genehmigt), Bestellt (ordered: Bestellt, Bestellung bestätigt, In Klärung), Geliefert (delivered: Teilweise geliefert, Geliefert, In Prüfung, Abgenommen, In Rechnung gestellt, Bezahlt), Ungültig (void: Abgelehnt, Storniert, Retourniert, Abgelaufen, Bei Prüfung abgelehnt).
The status is set by hand in the purchase dialog (pencil next to the badge). Allowed are moves within the base class, one base class forward (Geplant → Bestellt → Geliefert) or to Ungültig; nothing leaves Ungültig. The server refuses backward moves (error GV205). Colors per base class: blue (Geplant), orange (Bestellt), green (Geliefert), red (Ungültig). „Offen“ (open) in the card „Einkaufsvolumen“ = base class Geplant or Bestellt. Under Settings › „Anzeige & Ansichten“ › „Beschaffungsstatus“ an admin picks the display mode for the whole organisation: „Detailliert“ (detailed) shows every status, „Vereinfacht“ (simplified) only the base classes; the calculation does not depend on it.
Rules & automation
Section titled “Rules & automation”- Purchases are editable and deletable; deletion removes the generated cost event and the stock inbound.
- Purchases are created manually; procurement requests do not create a purchase automatically (they create planned costs, see Procurement request). A purchase can be linked to a purchase request; once it reaches „Bestellt“, the request stops planning.
Already purchased = Σ net of purchases in base class „Bestellt“ or „Geliefert“; purchase volume = Σ net of all purchases; number of purchases and open purchases. See Procurement KPIs.