Skip to content

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.

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.

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.

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).

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)

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.

  • 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.

Cost event · Material · Procurement request