# Beträge und Margen

> Wie Summen aus Positionen entstehen und wie der voraussichtliche Umsatz ermittelt wird.

---

LLMS index: [llms.txt](/llms.txt)

---

## Angebotssumme und Marge

Die Beträge eines Angebots werden nicht erfasst, sondern aus den Positionen berechnet.
Sobald eine Angebotsposition angelegt, geändert oder gelöscht wird, aktualisiert die
Lösung am Angebot:

| Feld | Berechnung |
|---|---|
| BC Gesamtbetrag (`wysa_bcTotalAmount`) | Summe der Positionsbeträge |
| Marge (`wysa_Margin`) | Summe der Deckungsbeiträge der Positionen |

Weil die Berechnung serverseitig läuft, stimmen die Summen auch dann, wenn Positionen
über die Übertragung aus Business Central entstehen — nicht nur bei manueller Erfassung.

## Voraussichtlicher Umsatz und voraussichtliche Marge

An der Verkaufschance gibt es zwei berechenbare Kennzahlen, die **getrennt voneinander**
konfiguriert werden:

| Feld | Einstellung | Auslieferungsstand |
|---|---|---|
| Voraussichtlicher Umsatz (`estimatedvalue`) | `wysa_EstimatedRevenueSource` | `UserProvided` |
| Voraussichtliche Marge (`wysa_EstimatedMargin`) | `wysa_EstimatedMarginSource` | `UserProvided;OpportunityproductProvided` |

Die Trennung erlaubt unterschiedliche Arbeitsweisen: Der Umsatz kann bewusst
Vertriebsschätzung bleiben, während die Marge aus den Positionen gerechnet wird.

### Aufbau des Einstellungswerts

Beide Einstellungen erwarten eine **Liste erlaubter Quellen**, mit Semikolon getrennt.
Jede zusätzlich aufgeführte Quelle erweitert die vorhergehende — sie ist keine
Alternative, sondern eine höhere Priorität.

| Wert | Verhalten |
|---|---|
| `UserProvided` | Der Wert wird immer manuell erfasst, es wird nichts berechnet. |
| `UserProvided;OpportunityproductProvided` | Solange die Verkaufschance keine Produkte hat, wird manuell erfasst. Sobald Produkte vorhanden sind, wird der Wert aus deren Summe berechnet und das Feld schreibgeschützt. |
| `UserProvided;OpportunityproductProvided;QuoteProvided` | Zusätzlich gilt: Ist ein **führendes Angebot** verknüpft, hat dessen Wert Vorrang vor der Produktsumme. Das Feld ist ebenfalls schreibgeschützt. |

Welche Werte konkret herangezogen werden:

| Quelle | Für den Umsatz | Für die Marge |
|---|---|---|
| Verkaufschancenprodukte | Summe von `wysa_bcAmount` | Summe von `wysa_Margin` |
| Führendes Angebot | `wysa_bcTotalAmount` | `wysa_Margin` |

### Wann neu gerechnet wird

Die Berechnung läuft serverseitig, sobald sich eine der Grundlagen ändert:

| Auslöser | Wirkung |
|---|---|
| Verkaufschancenprodukt angelegt, geändert oder gelöscht | Umsatz und Marge der Verkaufschance werden neu ermittelt |
| Angebot angelegt oder dessen Marge geändert | Marge der zugehörigen Verkaufschance wird neu ermittelt |
| Führendes Angebot der Verkaufschance gewechselt | Beide Kennzahlen werden neu ermittelt |

### Im Formular

Ist eine Kennzahl berechnet, sperrt das Formular das zugehörige Feld — sowohl im
Formularkörper als auch in der Kopfzeile der Verkaufschance. So ist erkennbar, dass der
Wert abgeleitet und nicht verhandelbar eingetragen ist.

Umsatz und Marge werden dabei **einzeln** bewertet: Je nach Konfiguration kann das eine
Feld gesperrt und das andere frei sein. Die Prüfung läuft beim Öffnen des Formulars, beim
Wechsel des führenden Angebots und bei Änderungen im Produkt-Unterraster.

## Das führende Angebot

Zu einer Verkaufschance können mehrere Angebote gehören — Nachverhandlungen,
Alternativvarianten, korrigierte Fassungen. Kaufmännisch maßgeblich ist aber nur eines.
Die Lösung setzt das Feld **Führendes Angebot** (`wysa_LeadingQuoteId`) automatisch: Es
verweist auf das älteste der verknüpften Angebote.

Wird ein Angebot einer anderen Verkaufschance zugeordnet, wird auch die zuvor zugeordnete
Verkaufschance korrigiert — sie erhält ihr nächstes gültiges führendes Angebot oder keins.
So bleibt bei jeder Umhängeaktion auf beiden Seiten ein stimmiger Stand.