Verkaufschance

• 1: Neue Verkaufschancen nach Business Central übertragen
• 2: Rückmeldung aus Business Central
• 3: Kalkulationselemente aus Business Central übernehmen
• 4: Neue Positionen nach Business Central übertragen
• 5: Rückmeldung der Positionen aus Business Central
• 6: Positionsänderungen nach Business Central übertragen

flowchart TB
  subgraph VC["Verkaufschance"]
    A["Verkaufschance in CE angelegt"] --> B{"Kontakt bereits<br/>in BC?"}
    B -->|nein| BLOCK["Freigabe wird abgelehnt"]
    B -->|ja| C{"<b>Sync zu BC</b><br/>freigegeben?"}
    C -->|nein| WAIT["bleibt in CE"]
    C -->|ja| D["<b>Neu nach BC</b><br/>Verkaufschance wird angelegt"]
    D --> E["<b>Rückmeldung aus BC</b><br/>BC Verkaufschancennummer<br/>und BC System-ID"]
  end

  subgraph POS["Positionen"]
    E --> F{"<b>Sync zu BC</b> an der<br/>Position freigegeben?"}
    F -->|ja| G["<b>Positionen neu nach BC</b>"]
    G --> H["<b>Rückmeldung Positionen</b><br/>BC System-ID der Position"]
    H --> I["<b>Positionsänderungen nach BC</b><br/>Menge und Beträge"]
  end

  ELEM["<b>Kalkulationselemente aus BC</b><br/>füllen die Produktliste"] -.->|"Voraussetzung"| G

1 - Neue Verkaufschancen nach Business Central übertragen

Was passiert hier?

Der Vertrieb arbeitet die Verkaufschance in Customer Engagement aus. Sobald sie kaufmännisch tragfähig ist und ein Angebot entstehen soll, wird Sync zu BC auf „Ja" gesetzt — und die Verkaufschance beim nächsten Lauf in Business Central angelegt.

Zwei Bedingungen müssen erfüllt sein:

1. Sync zu BC steht auf „Ja"
2. das Feld BC System-ID ist noch leer

Unmittelbar danach läuft die Rückmeldung aus BC und trägt BC Verkaufschancennummer und BC System-ID nach.

Vorher: der Kontakt muss in BC sein

Business Central hängt eine Verkaufschance an einen Kontakt. Existiert der dort nicht, kann die Verkaufschance nicht angelegt werden. Die Lösung lehnt die Freigabe deshalb ab, solange die BC Kontaktnummer des Kontakts leer ist — und ganz ohne Kontakt ohnehin.

flowchart LR
  A["Verkaufschance in CE"] --> B{"Kontakt vorhanden?"}
  B -->|nein| X["Freigabe wird abgelehnt"]
  B -->|ja| C{"BC Kontaktnummer<br/>des Kontakts gefüllt?"}
  C -->|nein| X
  C -->|ja| D{"Sync zu BC = Ja?"}
  D -->|nein| E["nichts passiert"]
  D -->|ja| F["Verkaufschance wird<br/>in BC angelegt"]

Das ist die dritte Stufe der Kette Firma → Kontakt → Verkaufschance, beschrieben unter Freigabe nach Business Central.

Welche Felder gehen nach BC?

Neun Zuordnungen — die schlankste Übertragung der ganzen Integration. Business Central braucht von einer Verkaufschance nur, was es zur Angebotserstellung benötigt.

Worauf zu achten ist

Business Central erhält einen Link zurück ins CRM

Die Übertragung baut aus der Datensatz-GUID einen vollständigen Deep Link auf die Verkaufschance in Customer Engagement und legt ihn in BC im Feld Dynamics-Sales-Link ab. Wer im ERP an der Verkaufschance arbeitet, springt damit direkt in den CRM-Datensatz.

Nach der Anlage stehen die Daten in BC still

Es gibt keinen aktiven Änderungspfad für die Verkaufschance. Wird das Thema, die Firma, der Kontakt oder der Verkäufer nachträglich in CE geändert, kommt das nicht in Business Central an. Der dortige Stand bleibt auf dem Zeitpunkt der Anlage.

Die zugehörigen Positionen werden dagegen laufend abgeglichen.

Der voraussichtliche Umsatz kann berechnet sein

Das übertragene Feld Voraussichtlicher Umsatz wird in CE je nach Konfiguration manuell erfasst oder aus den Positionen bzw. dem führenden Angebot berechnet — siehe Beträge und Margen. Übertragen wird der Wert, der beim Lauf im Feld steht.

Doppelte Anlage ist ausgeschlossen

Läuft der Abgleich zweimal, bevor die Rückmeldung eingetroffen ist, entsteht in BC trotzdem keine zweite Verkaufschance — der Datensatz wird über die in BC hinterlegte Dataverse Id wiedererkannt.

Technische Details

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

2 - Rückmeldung aus Business Central

Was passiert hier?

Wenn eine Verkaufschance neu nach BC übertragen wird, vergibt Business Central zwei Werte, die Customer Engagement noch nicht kennen kann:

• die BC Verkaufschancennummer aus dem Nummernkreis des ERP
• die BC System-ID, den technischen Schlüssel des Datensatzes

Dieser Schritt trägt beides in CE nach. Er wertet dabei die Antwort von Business Central aus — es ist keine erneute Abfrage.

sequenceDiagram
  participant CE as Customer Engagement
  participant BC as Business Central
  CE->>BC: neue Verkaufschance anlegen
  BC-->>CE: Antwort mit Verkaufschancennummer<br/>und BC System-ID
  Note over CE: Rückmeldung trägt beides<br/>an der Verkaufschance nach

Welche Felder kommen zurück?

Warum dieser Schritt die Positionen erst möglich macht

Bei Firma und Kontakt ist die Rückmeldung vor allem der Nachweis, dass der Datensatz im ERP angekommen ist. Bei der Verkaufschance hat sie darüber hinaus eine ganz konkrete Funktion: Ohne die BC Verkaufschancennummer lässt sich keine Position übertragen.

Business Central adressiert eine Verkaufschancenposition über die Nummer ihrer Verkaufschance. Der Schritt Positionen neu nach BC löst dazu das Feld BC Verkaufschancennummer auf. Ist es leer, findet die Position ihr Ziel nicht.

Da die Positions-Jobs mit Order 710 – 760 deutlich hinter der Verkaufschance (260 / 261) laufen, greift das innerhalb desselben Durchlaufs.

Worauf zu achten ist

Bleibt die Rückmeldung aus, hängt die ganze Kette

Ohne BC System-ID gilt die Verkaufschance als „nicht in BC vorhanden" und würde beim nächsten Lauf erneut zur Anlage angeboten — dass dabei keine Dublette entsteht, verhindert die Wiedererkennung über die Dataverse Id. Gleichzeitig bleibt die BC Verkaufschancennummer leer, sodass auch keine Position übertragen werden kann. Bleibt der Zustand über mehrere Läufe bestehen, sollte das geprüft werden.

Technische Details

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

3 - Kalkulationselemente aus Business Central übernehmen

Was passiert hier?

Business Central kalkuliert eine Verkaufschance nicht aus Artikeln, sondern aus Verkaufschancen-Elementen — gröberen Bausteinen wie „Lizenzen", „Einführung" oder „Betrieb", die jeweils eigene buchhalterische Dimensionen tragen.

Dieser Schritt holt diese Elemente nach Customer Engagement, damit sie dort in Verkaufschancenpositionen ausgewählt werden können.

Sie landen in der Produkttabelle

Das ist die Besonderheit dieses Schritts:

Die Kalkulationselemente werden in CE als Produkte angelegt — in der Standard-Produkttabelle.

Am Produkt kennzeichnet das Feld Verkaufschancen-Element (wysa_OppElement), welche Datensätze in einer Verkaufschancenposition verwendet werden dürfen. Der Abgleich schreibt dieses Feld nicht selbst; eine Geschäftsregel am Produkt setzt es auf „Ja", sobald der BC Dimension 1 Wert gefüllt ist — also bei jedem aus BC übernommenen Element.

Welche Felder kommen an?

Wiedererkannt wird ein Element über den BC Code.

Worauf zu achten ist

Die Dimensionen wandern mit

Jedes Element bringt bis zu zwei buchhalterische Dimensionen samt Werten mit. Sie werden am Produkt gespeichert und laufen später mit der Position nach BC zurück — so bleibt die Kalkulation kontierbar.

Ohne diesen Schritt keine Positionen

Eine Verkaufschancenposition wird nach BC über den Elementcode übertragen, den sie aus dem verknüpften Produkt zieht. Fehlt das Element in CE, kann die Position nicht angelegt werden. Dieser Schritt läuft alle zwei Minuten, die Positions-Jobs alle drei — die Elemente sind also stets vorab verarbeitet, siehe Ausführungsreihenfolge und Takt.

Warum dieser Schritt hier steht

Fachlich ist er ein Stammdaten-Abgleich und läuft im Stammdatenblock. Dokumentiert ist er hier, weil die Elemente, die er liefert, ausschließlich in Verkaufschancenpositionen und Angebotspositionen verwendet werden. Die übrigen Stammdaten-Abgleiche stehen unter Stammdaten.

Technische Details

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

4 - Neue Positionen nach Business Central übertragen

Was passiert hier?

Die Positionen einer Verkaufschance — in CE die Verkaufschancenprodukte — werden in Business Central als Kalkulationszeilen der Verkaufschance angelegt. Aus ihnen entsteht dort später das Angebot.

Zwei Bedingungen müssen erfüllt sein:

1. Sync zu BC an der Position steht auf „Ja"
2. das Feld BC System-ID der Position ist noch leer

Zwei Voraussetzungen an anderen Datensätzen

Eine Position adressiert ihr Ziel in BC über zwei Werte, die sie sich aus verknüpften Datensätzen holt:

flowchart LR
  P["Position in CE"] --> A["Verkaufschance<br/><b>BC Verkaufschancennummer</b>"]
  P --> B["Produkt<br/><b>BC Code</b>"]
  A --> Z["Kalkulationszeile in BC"]
  B --> Z

Fehlt einer der beiden, findet die Position ihr Ziel nicht.

Sichergestellt ist das über den Takt: Verkaufschance und Kalkulationselemente laufen alle zwei Minuten, dieser Schritt alle drei. Die Vorarbeit ist also stets erledigt — allerdings aus einem früheren Durchlauf, nicht aus demselben. Siehe Ausführungsreihenfolge und Takt.

Welche Felder gehen nach BC?

„LW" steht für Landeswährung — Business Central führt diese Beträge in der Währung des Buchungskreises.

Worauf zu achten ist

Beschreibung und Marge gehen auch bei Änderungen mit

Beschreibung und Marge sind sowohl Teil dieses Schritts als auch des Schritts Positionsänderungen nach BC. Werden sie später in CE geändert, kommt das in Business Central an.

Wiedererkennung über die BC System-ID

Anders als Firma, Kontakt und Verkaufschance schickt dieser Schritt keine Dataverse Id mit. Die Position wird in Business Central über die BC System-ID adressiert, die anschließend über die Rückmeldung nach CE kommt.

Die Freigabe folgt der Verkaufschance

Das Feld Sync zu BC an der Position (wysa_SynctoBC) folgt der Freigabe der Verkaufschance — es muss nicht je Position einzeln gesetzt werden. Zu beachten ist der abweichende technische Feldname gegenüber der Verkaufschance (wysa_sync2bc), siehe Übersicht.

Anderer Takt als die übrigen Schritte

Die Positions-Jobs laufen alle 3 Minuten, nicht alle 2 wie der Rest der Integration. Zusammen mit der Reihenfolge bedeutet das: Zwischen der Freigabe einer Verkaufschance und dem Ankommen ihrer Positionen in BC können einige Minuten liegen.

Technische Details

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

5 - Rückmeldung der Positionen aus Business Central

Was passiert hier?

Wenn eine Position neu nach BC übertragen wird, vergibt Business Central für die entstandene Kalkulationszeile eine System-ID. Dieser Schritt trägt sie an der Position in Customer Engagement nach.

sequenceDiagram
  participant CE as Customer Engagement
  participant BC as Business Central
  CE->>BC: neue Kalkulationszeile anlegen
  BC-->>CE: Antwort mit System-ID
  Note over CE: Rückmeldung trägt die<br/>BC System-ID an der Position nach

Welche Felder kommen zurück?

Nur ein Feld — die knappste Rückmeldung der ganzen Integration. Eine eigene Nummer vergibt Business Central für Kalkulationszeilen nicht; sie sind über ihre Verkaufschancennummer und den Elementcode adressierbar.

Warum dieser Schritt entscheidend ist

Die BC System-ID ist die Weiche zwischen Anlegen und Ändern:

Solange sie leer bleibt, gilt die Position als „nicht in BC vorhanden" und wird beim nächsten Lauf erneut zur Anlage angeboten. Da die Positionen — anders als Firma, Kontakt und Verkaufschance — keine Wiedererkennung über eine mitgeschickte CE-GUID haben, ist diese Rückmeldung ihre einzige Absicherung gegen wiederholtes Anlegen. Siehe die Hinweise auf Positionen neu nach BC.

Worauf zu achten ist

Der Änderungsjob läuft vor dem Anlagejob

Ein Blick auf die Reihenfolge lohnt: Der Änderungsjob trägt Order 750, der Anlagejob 710 und dieser Rückmeldeschritt 760.

Alle drei liegen im Drei-Minuten-Takt, laufen also tatsächlich im selben Tick — hier greift die Ordnungsnummer. Innerhalb eines Durchlaufs wird demnach erst angelegt, dann geändert, dann die System-ID nachgetragen.

Eine frisch angelegte Position hat beim Änderungsjob desselben Durchlaufs noch keine System-ID und fällt dort nicht in den Filter — sie wird erst im nächsten Durchlauf für Änderungen erfasst. Für die Praxis ist das ohne Folgen, weil die Anlage alle Werte bereits mitgeschickt hat.

Technische Details

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

6 - Positionsänderungen nach Business Central übertragen

Was passiert hier?

Ändert sich an einer Position die Menge, die Beschreibung oder ein Betrag, geht das nach Business Central. Dieser Schritt ist damit der einzige aktive Änderungspfad im Bereich Verkaufschance — für die Verkaufschance selbst gibt es keinen, siehe Übersicht.

Erfasst werden Positionen, bei denen beides zutrifft:

1. Sync zu BC an der Position steht auf „Ja"
2. das Feld BC System-ID der Position ist gefüllt

Ist die BC System-ID leer, greift stattdessen Positionen neu nach BC.

Welche Felder gehen nach BC?

Sieben fachliche Felder — dieselben wie bei der Anlage.

Worauf zu achten ist

Beschreibung und Marge gehen auch bei Änderungen mit

Anlage (710) und Änderung (750) übertragen denselben Feldsatz — inklusive Beschreibung und Marge. Wird eine davon später in CE geändert, kommt das in Business Central an.

Die Zuordnung wird bei jedem Lauf neu aufgelöst

Verkaufschancennummer und Elementcode sind Teil jeder Übertragung — sie werden also bei jeder Änderung erneut aus Verkaufschance und Produkt aufgelöst. Wird eine Position in CE auf ein anderes Produkt umgestellt, geht das damit auch nach BC.

Der Änderungsjob läuft vor der Rückmeldung

Innerhalb eines Durchlaufs ist die Reihenfolge: anlegen (710) → ändern (750) → System-ID zurückmelden (760). Da alle drei im Drei-Minuten-Takt liegen, greift die Ordnungsnummer hier wirklich.

Eine frisch angelegte Position hat beim Änderungsjob desselben Durchlaufs noch keine System-ID und fällt dort nicht in den Filter. Sie wird erst im nächsten Durchlauf für Änderungen erfasst — ohne praktische Folge, weil die Anlage alle Werte bereits mitgeschickt hat.

Technische Details

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