Angebot

• 1: Angebote aus Business Central übernehmen
• 2: Angebotspositionen aus Business Central übernehmen
• 3: Gewonnene Angebote aus Business Central
• 4: Angebotspositionen löschen
• 5: In BC gelöschte Angebote stornieren

flowchart LR
  A["Verkaufschance in CE"] -->|"Verkaufschance<br/>nach BC"| B["Verkaufschance in BC"]
  B -->|"Angebot erstellen<br/>(in BC)"| C["Angebot in BC"]
  C -->|"<b>Angebot nach CE</b>"| D["Angebot in CE"]
  D -.->|"verknüpft mit"| A

flowchart TB
  Q["Angebot in BC angelegt<br/>oder geändert"] --> S1["<b>Angebote aus BC</b><br/>Angebotskopf nach CE"]
  S1 --> V{"Verkaufschance<br/>über BC-Nummer<br/>gefunden?"}
  V -->|ja| VK["Angebot hängt an<br/>der Verkaufschance"]
  V -->|nein| FREI["Angebot ohne<br/>Verkaufschance"]

  S1 --> S2["<b>Positionen aus BC</b><br/>Kalkulationszeilen nach CE"]

  VK --> T{"In BC in einen<br/>Auftrag überführt?"}
  FREI --> T
  T -->|"ja — Status TRANSFERRED"| W["<b>Gewonnene Angebote aus BC</b><br/>Angebot wird <b>Gewonnen</b>"]

  Q --> DEL["Angebot in BC gelöscht"]
  DEL --> D1["<b>Stornierung</b><br/>Angebot wird in CE<br/><b>geschlossen / storniert</b>"]
  Q --> DELP["Position in BC gelöscht"]
  DELP --> D2["<b>Löschung</b><br/>Position wird in CE<br/><b>gelöscht</b>"]

flowchart LR
  Q["Angebot aus BC"] -->|"Verkaufschancennummer"| O["Verkaufschance"]
  Q -->|"<b>Kontaktnummer</b>"| A["Firma"]
  Q -->|"Verkäufercode"| S["Verkäufer (BC)"]

1 - Angebote aus Business Central übernehmen

Was passiert hier?

Sobald in Business Central ein Angebot angelegt oder geändert wird, erscheint es in Customer Engagement — mit Nummer, Betrag, Gültigkeit und Zuordnung zu Verkaufschance und Kunde. Existiert das Angebot in CE schon, werden seine Felder aktualisiert.

Wiedererkannt wird ein Angebot über die Angebotsnummer. Sie ist in beiden Systemen dieselbe — das Angebot ist damit der einzige Datensatz der Integration, der über eine fachliche Belegnummer verbunden ist und nicht über einen technischen Schlüssel.

Der Job liest ausschließlich Belege der Art Angebot; Aufträge und Rechnungen bleiben außen vor.

Welche Felder kommen an?

Worauf zu achten ist

So schließt sich der Kreis zur Verkaufschance

Das Angebot findet seine Verkaufschance über die BC Verkaufschancennummer — genau jenes Feld, das die Rückmeldung aus BC an der Verkaufschance gefüllt hat.

Damit ist der Weg vollständig: Die Verkaufschance geht von CE nach BC, bekommt dort eine Nummer, aus ihr entsteht ein Angebot, und das Angebot kommt über dieselbe Nummer zurück und hängt sich an die richtige Verkaufschance.

Wird in Business Central ein Angebot ohne Bezug zu einer Verkaufschance erstellt, kommt es in CE ohne diese Verknüpfung an — es ist dann ein freistehendes Angebot.

Der Kunde wird über die BC Kontaktnummer gefunden

Der Nettobetrag kommt nicht mit

Übertragen wird nur der Bruttobetrag (BC Gesamtbetrag inkl. MwSt.). Das Feld BC Gesamtbetrag (netto) und die Marge werden in CE aus den Angebotspositionen aufsummiert — siehe Beträge und Margen.

Der Status entscheidet über den Abschluss

Das Feld BC Status trägt den Bearbeitungsstand des Belegs aus BC. Meldet Business Central den Wert TRANSFERRED — das Angebot wurde in einen Auftrag überführt —, wird das Angebot in CE gewonnen. Das erledigt der Schritt Gewonnene Angebote aus BC; die Folgewirkungen sind unter Abschluss von Angebot und Verkaufschance beschrieben.

Angebote werden nicht nach BC zurückgeschrieben

Es gibt keinen Weg von CE nach BC. Was am Angebot in CE geändert wird, bleibt dort und wird beim nächsten Abgleich aus BC überschrieben. Das Angebot ist eine Kopie des BC-Belegs.

Technische Details

Die vollständige technische Mapping-Tabelle mit Feldzuordnungen, Key-Auflösung und Transformationen steht unter Technisches Mapping → salesquotesfrombc.

2 - Angebotspositionen aus Business Central übernehmen

Was passiert hier?

Ein Angebot in Business Central wird aus Kalkulationselementen aufgebaut — Bausteinen wie „Lizenzen", „Einführung" oder „Betrieb", die jeweils Menge und Betrag tragen. Dieser Schritt holt sie als Angebotspositionen nach Customer Engagement.

Wiedererkannt wird eine Position über die BC System-ID der Kalkulationszeile.

Es sind Kalkulationselemente, keine Artikelzeilen

Das ist der wichtigste Punkt zum Verständnis:

In Customer Engagement zeigt ein Angebot die Kalkulation des BC-Belegs, nicht seine Artikelaufstellung.

Ein BC-Angebot hat beides: Verkaufszeilen mit Artikeln und darüber die Kalkulation aus Elementen. Übertragen wird nur die Kalkulation.

Die Elemente sind dieselben, die auch die Verkaufschancenpositionen verwenden. Sie kommen über Kalkulationselemente aus BC (Job 190) als Produkte nach CE. Damit ist die Kalkulation über die gesamte Kette hinweg vergleichbar: dieselben Bausteine in der Verkaufschance wie später im Angebot.

Welche Felder kommen an?

„LW" steht für Landeswährung.

Worauf zu achten ist

Zwei Zuordnungen müssen gelingen

flowchart LR
  P["Kalkulationszeile aus BC"] -->|"Belegnummer"| Q["Angebot in CE"]
  P -->|"Elementcode"| E["Produkt in CE"]

Beide Vorgänger-Jobs laufen früher (190 und 610 gegenüber 620), sodass das innerhalb desselben Durchlaufs zusammenfindet. Fehlt eines der beiden Ziele, kann die Position nicht korrekt eingehängt werden.

Der Deckungsbeitrag kommt nicht mit

Das Datenmodell führt an der Angebotsposition ein Feld BC Deckungsbeitrag (wysa_bcProfit). Dieser Abgleich füllt es nicht — die Position kommt nur mit Netto- und Bruttobetrag an.

Eine feste Einheiten-GUID

Die Einheit der Position wird mit einem fest hinterlegten Wert gesetzt.

Löschungen laufen über einen eigenen Job

Wird eine Kalkulationszeile in BC gelöscht, verschwindet sie aus dieser Schnittstelle und kann durch Abgleich nicht mehr gefunden werden. Das erledigt Positionen löschen (621) über das Änderungsprotokoll — und zwar durch echtes Löschen, nicht durch Deaktivieren.

Technische Details

Die vollständige technische Mapping-Tabelle mit Feldzuordnungen, Key-Auflösung und Transformationen steht unter Technisches Mapping → salescalculationelementsfrombc.

3 - Gewonnene Angebote aus Business Central

Was passiert hier?

Wird ein Angebot in Business Central in einen Auftrag überführt, ist es kaufmännisch gewonnen. Business Central schreibt diesen Vorgang in sein Änderungsprotokoll — als Vorgang TRANSFERRED. Dieser Schritt liest das Protokoll und setzt das Angebot in Customer Engagement auf Gewonnen.

flowchart LR
  A["Angebot in BC<br/>in Auftrag überführt"] --> B["Eintrag im Änderungsprotokoll<br/>Vorgang <b>TRANSFERRED</b>"]
  B --> C["Angebot in CE über die<br/>BC System-ID gefunden"]
  C --> D["<b>BC Status</b> = TRANSFERRED<br/>Angebot wird <b>Gewonnen</b>"]

Der Abschluss wird nicht doppelt gepflegt

Das ist die fachliche Kernaussage dieses Schritts:

Führendes System für den Auftrag ist Business Central. Customer Engagement folgt.

Der Vertrieb muss ein gewonnenes Angebot in CE nicht von Hand abschließen. Der Abschluss im ERP genügt — und weil er dort an die Auftragserstellung gebunden ist, kann in CE kein Angebot als gewonnen gelten, dem im ERP kein Auftrag gegenübersteht.

Was sich am Angebot ändert

Alle übrigen Felder bleiben unverändert.

Was daraus weiter folgt

Das Feld BC Status ist mehr als eine Notiz — an ihm hängt weitere Logik in Customer Engagement:

• Ist die Einstellung wysa_WinQuoteAndOpportunity aktiv, wird zusätzlich die verknüpfte Verkaufschance gewonnen, mit dem Angebotsbetrag als tatsächlichem Umsatz.
• Ohne diese Einstellung bleibt der Abschluss der Verkaufschance eine bewusste Handlung des Vertriebs.

Beschrieben ist das unter Abschluss von Angebot und Verkaufschance und Konfiguration.

Worauf zu achten ist

Zwei Jobs lesen dasselbe Protokoll

Dieser Schritt und Angebote stornieren lesen beide die Protokolleinträge zur BC-Tabelle Verkaufskopf. Sie trennen sich allein über die Art des Vorgangs:

Andere Vorgangsarten werden von keinem der beiden Jobs verarbeitet.

Der Takt weicht ab

Dieser Job läuft alle 3 Minuten, die übrigen Angebots-Jobs alle 2. Zwischen der Auftragserstellung in BC und dem gewonnenen Angebot in CE können damit einige Minuten liegen.

Ein Rückweg existiert nicht

Wird der Auftrag in BC storniert, gibt es keinen Job, der das Angebot in CE wieder öffnet. Der Vorgang ist einseitig.

Verlieren funktioniert anders

Der Verlust kommt nicht aus BC, sondern wird in Customer Engagement entschieden: Wird eine Verkaufschance auf Verloren gesetzt, schließt die Lösung ihre Angebote mit — siehe Abschluss. Ein Mapping ist daran nicht beteiligt.

Technische Details

Die vollständige technische Mapping-Tabelle mit Feldzuordnungen, Key-Auflösung und Transformationen steht unter Technisches Mapping → activatesalesquotesfrombc.

4 - Angebotspositionen löschen

Was passiert hier?

Wird in Business Central eine Kalkulationszeile aus einem Angebot entfernt, wird die zugehörige Angebotsposition in Customer Engagement gelöscht.

flowchart LR
  A["Kalkulationszeile<br/>in BC gelöscht"] --> B["Eintrag im Änderungsprotokoll<br/>Vorgang <b>DELETE</b>"]
  B --> C["Position in CE über die<br/>BC System-ID gefunden"]
  C --> D["Position wird <b>gelöscht</b>"]

Der Weg über das Änderungsprotokoll ist nötig, weil eine gelöschte Zeile in der normalen Schnittstelle nicht mehr auftaucht und durch Abgleich nicht gefunden werden könnte.

Hier wird wirklich gelöscht

Anders als bei Firma, Kontakt und Produkt wird nicht deaktiviert, sondern gelöscht:

Das ist folgerichtig. Eine Angebotsposition in CE ist eine reine Kopie der BC-Zeile — sie trägt keine eigene Information, an ihr hängt keine Historie, und eine inaktive Position würde die Summenbildung des Angebots nur verfälschen. Ohne Löschen bliebe eine in BC gestrichene Leistung im CE-Angebot stehen.

Worauf zu achten ist

Das Angebot wird neu summiert

Gesamtbetrag und Marge eines Angebots werden in CE aus den Positionen aufsummiert. Nach dem Löschen einer Position ändern sich diese Summen — siehe Beträge und Margen.

Ein Wiederherstellen gibt es nicht

Die Position ist in CE endgültig entfernt. Wird die Zeile in BC erneut angelegt, kommt sie über Positionen aus BC als neue Position mit neuer BC System-ID zurück.

Beim Löschen des ganzen Angebots

Wird in BC nicht eine Zeile, sondern das ganze Angebot gelöscht, greift Angebote stornieren (690). Das Angebot wird in CE nicht gelöscht, sondern geschlossen — seine Positionen bleiben daher erhalten, sofern BC nicht für jede Zeile einen eigenen Protokolleintrag schreibt und dieser Job anspringt.

Technische Details

Die vollständige technische Mapping-Tabelle mit Feldzuordnungen, Key-Auflösung und Transformationen steht unter Technisches Mapping → salescalculationelementsfrombcdelete.

5 - In BC gelöschte Angebote stornieren

Was passiert hier?

Wird ein Angebot in Business Central gelöscht, bleibt es in Customer Engagement erhalten, wird aber geschlossen und bekommt den Statusgrund Storniert. Es ist danach schreibgeschützt und taucht in keiner Auswertung offener Angebote mehr auf.

flowchart LR
  A["Angebot in BC gelöscht"] --> B["Eintrag im Änderungsprotokoll<br/>Vorgang <b>DELETE</b>"]
  B --> C["Angebot in CE über die<br/>BC System-ID gefunden"]
  C --> D["Angebot wird <b>geschlossen</b><br/>Statusgrund <b>Storniert</b>"]

Stornieren statt Löschen

Früher wurde das Angebot in CE hart gelöscht. Jetzt bleibt es als stornierter Datensatz stehen: Man sieht an der Verkaufschance weiterhin, dass es ein Angebot gab und dass es in BC verworfen wurde. Weil das Angebot geschlossen ist, zählt es in der Pipeline nicht mehr als offen.

Worauf zu achten ist

Die Positionen bleiben am Angebot

Da das Angebot nicht mehr gelöscht wird, werden seine Positionen auch nicht mehr automatisch mit entfernt. Löscht BC beim Löschen des Angebots auch die Kalkulationszeilen einzeln, greift zusätzlich Positionen löschen; sonst bleiben die Positionen am stornierten Angebot sichtbar.

Was mit der Verkaufschance passiert

Die Verkaufschance bleibt unberührt. Das stornierte Angebot bleibt mit ihr verknüpft.

Kein Wiederöffnen aus BC

Ein in BC gelöschtes Angebot kommt nicht zurück. Wird in BC ein neues Angebot angelegt, kommt es mit neuer Nummer und neuer BC System-ID als eigenständiger Datensatz nach CE.

Zwei Jobs lesen dasselbe Protokoll

Dieser Schritt und Gewonnene Angebote aus BC lesen beide die Protokolleinträge zur BC-Tabelle Verkaufskopf und trennen sich über die Art des Vorgangs:

Technische Details

Die vollständige technische Mapping-Tabelle mit Feldzuordnungen, Key-Auflösung und Transformationen steht unter Technisches Mapping → salesquotesfrombcdelete.