Verkaufschance-Angebot on dsyr.SalesCentral

Angebote aus Business Central übernehmen

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	alle BC-Verkaufsbelege der Art Angebot, die seit dem letzten Lauf geändert wurden
Technisch	Job `salesquotesfrombc` (610), Mapping `BCSalesQuotes`

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.

Neue Verkaufschancen nach Business Central übertragen

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Customer Engagement → Business Central
Wann	alle 2 Minuten
Betrifft	Verkaufschancen, die freigegeben sind und in BC noch nicht existieren
Technisch	Job `opportunitiesnewfromce` (260), Mapping `CEOpportunities`

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:

Angebotspositionen aus Business Central übernehmen

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	die Kalkulationselemente von BC-Belegen der Art Angebot
Technisch	Job `salescalculationelementsfrombc` (620), Mapping `BCSalesCalculationElements`

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.

Rückmeldung aus Business Central

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	unmittelbar nach jeder Neuanlage — kein eigener Zeitplan
Betrifft	genau die Verkaufschancen, die gerade in BC angelegt wurden
Technisch	Job `opportunitiesresponsefrombc` (261), Mapping `BCOpportunitiesResponse`

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.

Beträge und Margen

Mon, 01 Jan 0001 00:00:00 +0000

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:

Gewonnene Angebote aus Business Central

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	alle 3 Minuten
Betrifft	Angebote, die in BC in einen Auftrag überführt wurden
Technisch	Job `activatesalesquotesfrombc` (625), Mapping `BCSalesQuotesActivate`

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.

Kalkulationselemente aus Business Central übernehmen

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	die Verkaufschancen-Elemente aus BC
Technisch	Job `opportunityelementsfrombc` (190), Mapping `BCOpportunityElements`

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:

Verkaufschance

Mon, 01 Jan 0001 00:00:00 +0000

Die Verkaufschance ist die dritte Stufe der Freigabekette: Firma → Kontakt → Verkaufschance. Und sie ist der erste Datenbereich, der grundlegend anders funktioniert als Firma und Kontakt:

Die Verkaufschance läuft nur von Customer Engagement nach Business Central.

Es gibt keine Übernahme aus BC und keine Löschverarbeitung. Verkaufschancen entstehen im Vertrieb, nicht im ERP — Business Central braucht sie nur, um daraus Angebote zu erzeugen.

Dazu kommt eine zweite, eigene Kette für die Positionen (Verkaufschancenprodukte), die anders getaktet ist und ein anderes Freigabefeld nutzt.

Verkaufschance, Angebot und Produkt

Mon, 01 Jan 0001 00:00:00 +0000

Verkaufschance

Anzeigename	Logical Name	Typ	Bedeutung
Sync zu BC	`wysa_sync2bc`	Auswahl (Ja/Nein)	Freigabe zur Übertragung
BC System-ID	`wysa_bcSystemId`	Text	Herkunfts-ID in Business Central
BC Verkaufschancennummer	`wysa_bcOpportunityNumber`	Text	Nummer in Business Central; Nachweis der erfolgreichen Übertragung
CRM-Verkaufschancennummer	`wysa_CRMOpportunityNumber`	Text	Fortlaufende Nummer aus Customer Engagement
Führendes Angebot	`wysa_LeadingQuoteId`	Verweis	Das Angebot, das die Verkaufschance kaufmännisch abbildet
Voraussichtliche Marge	`wysa_EstimatedMargin`	Betrag	Erwartete Marge; je nach Konfiguration manuell erfasst oder berechnet
Wiedervorlage am	`wysa_resetdateto`	Datum	Termin, zu dem die Chance erneut bewertet wird
Grund der Wiedervorlage	`wysa_resetreason`	Text	Begründung der Verschiebung
Vertriebsprozess	`wysa_SalesProcess`	Auswahl	Standard oder Ausschreibung
Leadquelle	`wysa_LeadSourceId`	Verweis	Herkunft, aus dem Lead übernommen
Mandant (BC) / Verkäufer (BC)	`wysa_bcClientId`, `wysa_bcSalesPersonId`	Verweis	Zuordnung wie bei der Firma

Der Standardwert Voraussichtlicher Umsatz (estimatedvalue) und die Voraussichtliche Marge (wysa_EstimatedMargin) werden je nach Konfiguration manuell erfasst oder automatisch berechnet — aus den Verkaufschancenprodukten oder aus dem führenden Angebot. Beide sind getrennt konfigurierbar. Siehe Beträge und Margen.

Abschluss von Angebot und Verkaufschance

Mon, 01 Jan 0001 00:00:00 +0000

Gewinnen: Business Central gibt das Signal

Ein Angebot gilt als gewonnen, wenn es in Business Central in einen Auftrag überführt wurde. Diese Rückmeldung kommt über das Feld BC Status (wysa_BCStatus). Meldet Business Central den Wert TRANSFERRED, setzt die Lösung das Angebot in Customer Engagement automatisch auf Gewonnen.

Der Vertrieb muss den Abschluss also nicht doppelt pflegen — das führende System für den Auftrag ist Business Central, und Customer Engagement folgt.

Angebot

Mon, 01 Jan 0001 00:00:00 +0000

Das Angebot schließt den großen Kreis der Integration. Die Verkaufschance geht von Customer Engagement nach Business Central — dort entsteht daraus das kaufmännische Dokument, und dieses kommt zurück:

Das Angebot läuft ausschließlich von Business Central nach Customer Engagement.

In CE wird kein Angebot erfasst und keines nach BC übertragen. Kalkulation, Preise, Rabatte und Belegnummern gehören ins ERP; Customer Engagement führt das Angebot nur mit, damit der Vertrieb Pipeline und Abschluss im CRM sieht.

Angebotspositionen löschen

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	Kalkulationszeilen, die in BC gelöscht wurden
Technisch	Job `salescalculationelementsfrombcdelete` (621), Mapping `BCSalesCalculationElementsDelete`

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.

Neue Positionen nach Business Central übertragen

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Customer Engagement → Business Central
Wann	alle 3 Minuten
Betrifft	Positionen, die freigegeben sind und in BC noch nicht existieren
Technisch	Job `opportunityproductsnewfromce` (710), Mapping `CEOpportunityProducts`

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:

Sync zu BC an der Position steht auf „Ja"
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:

In BC gelöschte Angebote stornieren

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	Angebote, die in BC gelöscht wurden
Technisch	Job `salesquotesfrombcdelete` (690), Mapping `BCSalesQuotesDelete`

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

Datenbereich	Verhalten bei Löschung in BC
Firma, Kontakt, Produkt	deaktivieren — an ihnen hängt Historie
Angebot	schließen / stornieren — der Vorgang bleibt nachvollziehbar
Angebotsposition	löschen — sie ist eine Kopie der BC-Kalkulationszeile

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.

Rückmeldung der Positionen aus Business Central

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Business Central → Customer Engagement
Wann	unmittelbar nach jeder Neuanlage einer Position — kein eigener Zeitplan
Betrifft	genau die Positionen, die gerade in BC angelegt wurden
Technisch	Job `opportunityproductsresponsefrombc` (760), Mapping `BCOpportunityProductsResponse`

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?

Feld in Business Central	Feld in Customer Engagement
systemId	BC System-ID

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.

Positionsänderungen nach Business Central übertragen

Mon, 01 Jan 0001 00:00:00 +0000


Richtung	Customer Engagement → Business Central
Wann	alle 3 Minuten
Betrifft	freigegebene Positionen, die in BC bereits existieren
Technisch	Job `opportunityproductsupdatesfromce` (750), Mapping `CEOpportunityProductsUpdates`

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: