Reference & Data Model
Order (order)
The order makes a project an external project and provides the order volume for all revenue KPIs.
Purpose
Section titled “Purpose”The Order holds the volume, status and dates of the customer order underlying a project (project data). Every project has at most one order. Its order volume is the basis for „Erwartete Gesamterlöse“ (expected total revenue), the project value and the earnings.
Where in the app
Section titled “Where in the app”- Create: dialog „Neues Projekt“ (New project) › section „Kundenauftrag“ (Order) › checkbox „Projekt ist ein Kundenauftrag“ › „Kundenauftrag hinzufügen“. See Guides › Create a project.
- Edit and delete: dialog „Projekt bearbeiten“ (Edit project) › button on the order (trash icon in the order dialog).
- Display: profile › card „Kundenauftrag“ with status badge, tile „Erwarteter Umsatz“ (Expected revenue); business case › card „Einnahmen“ („Erwartet“) and totals row „Erwartete Gesamterlöse“; program profile; project/portfolio cards; prioritization table „Auftragsvol.“.
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Key | user_key |
Text | yes | Identifier of the order | Title of the order dialog; searchable |
| Order volume | order_volume |
Amount | yes | Contractually agreed revenue | – |
| Currency | currency |
Selection | yes | Order currency | Default EUR; applies to earnings |
| Order status | state |
Selection | yes | see States | always „Angebotsentwurf“ on creation |
| Offer drafted on | offer_date |
Date | no | Offer date | – |
| Order received on | order_date |
Date | no | Order date | – |
| Start | start_of_order_process |
Date | no | Start of processing | – |
| End | end_of_order_process |
Date | no | End of processing | – |
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| Project | belongs to (1:1) | yes | archived along | deleted along |
| Earning event | has many | – | archived along | deleted along |
States
Section titled “States”| Value | Label |
|---|---|
offer_draft |
Angebotsentwurf (Offer draft) |
order_accepted |
Auftrag angenommen (Order accepted) |
order_rejected |
Auftrag abgelehnt (Order rejected) |
in_process |
In Bearbeitung (In process) |
on_hold |
Wartend (On hold) |
process_completed |
Vorgang abgeschlossen (Process completed) |
customer_approval |
Kundenfreigabe (Customer approval) |
process_reversal |
Vorgang zurückgesetzt (Process reversed) |
refunded |
Erstattet (Refunded) |
closed_by_refunding |
Durch Erstattung geschlossen (Closed by refunding) |
successfully_closed |
Erfolgreich Abgeschlossen (Successfully Closed) |
cancelled |
Fehlgeschlagen (Failed) |
The status is set exclusively by hand in the order dialog. There are no transition rules and no coupling to the project phase.
Rules & automation
Section titled “Rules & automation”- Without an order, the business case shows no earnings table and no waterfall chart; „Realisierung“ (realization) is „-“.
- Deleting the order deletes all earning events.
- In the dialog „Neues Projekt“, the order is only saved together with the project; the status chosen in the order dialog is not carried over, the order starts as „Angebotsentwurf“.
Order volume (server projectOrderVolume), expected total revenue, economic project value = order volume + benefit, planned (outstanding revenue), capital turnover. See Value KPIs.