Verkaufschance

Wie Verkaufschancen und ihre Positionen nach Business Central übertragen werden — Gesamtbild und die Schritte im Detail.

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.

SchrittWas passiertWann
Neu nach BCfreigegebene Verkaufschancen werden in BC angelegtalle 2 Minuten
Rückmeldung aus BCBC meldet Verkaufschancennummer und System-ID zurückdirekt nach der Anlage
Kalkulationselemente aus BCdie in Positionen verwendbaren Elemente kommen nach CEalle 2 Minuten
Positionen neu nach BCfreigegebene Positionen werden in BC angelegtalle 3 Minuten
Rückmeldung PositionenBC meldet die System-ID der Position zurückdirekt nach der Anlage
Positionsänderungen nach BCÄnderungen an Positionen gehen nach BCalle 3 Minuten

Der Ablauf

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

Erst Firma, dann Kontakt, dann Verkaufschance

Business Central kann eine Verkaufschance nur anlegen, wenn ihr Kontakt dort existiert — und den Kontakt nur, wenn dessen Firma existiert. Die Freigaberegel setzt das in beiden Stufen durch:

FreizugebenVoraussetzung
KontaktBC System-ID der Firma ist gefüllt
VerkaufschanceBC Kontaktnummer des Kontakts ist gefüllt

Eine Verkaufschance ohne Kontakt kann gar nicht übertragen werden — die Freigabe wird abgelehnt. Ausführlich unter Freigabe nach Business Central.

Was nach der Anlage passiert — und was nicht

Zwei Freigabefelder mit unterschiedlichem Namen

Verkaufschance und Position tragen jeweils ein eigenes Feld Sync zu BC — technisch sind es aber zwei verschieden benannte Felder:

DatensatzAnzeigenameLogical Name
VerkaufschanceSync zu BCwysa_sync2bc
VerkaufschancenproduktSync zu BCwysa_SynctoBC

Beide arbeiten mit demselben Wert für „Ja". Beim Erstellen von Auswertungen oder Automatisierungen ist die abweichende Schreibweise zu beachten — siehe Datenmodell.

Positionen verweisen nicht auf Artikel, sondern auf Kalkulationselemente

Eine Verkaufschancenposition zeigt in CE auf einen Datensatz der Produkttabelle. Gefüllt wird diese Tabelle über die Kalkulationselemente aus BC (190).

Für Positionen sind nur diese Elemente verwendbar — Business Central erwartet in der Position einen Elementcode, keine Artikelnummer. Am Produkt kennzeichnet das Feld Verkaufschancen-Element (wysa_OppElement), welche Datensätze dafür zulässig sind.

Welche Felder gehen nach BC?

Verkaufschance

Feld in Customer EngagementFeld in Business Central
ThemaBeschreibung
BeschreibungErweiterte Beschreibung
Voraussichtliches AbschlussdatumErwartetes Abschlussdatum
Voraussichtlicher UmsatzErwarteter Umsatz
FirmaUnternehmensnummer des Kontakts
KontaktKontaktnummer
Verkäufer (BC)Verkäufercode
(Link auf den CE-Datensatz)Dynamics-Sales-Link

Acht Felder — deutlich weniger als bei Firma und Kontakt. Business Central braucht von einer Verkaufschance nur das Nötigste, um daraus ein Angebot zu erzeugen.

Position

Feld in Customer EngagementFeld in Business CentralNeu nach BCÄnderungen nach BC
VerkaufschanceVerkaufschancennummer✓✓
ProduktElementcode✓✓
MengeMenge✓✓
BC BetragBetrag (LW)✓✓
BC Betrag inkl. MwSt.Betrag inkl. MwSt. (LW)✓✓
BeschreibungBeschreibung✓✓
MargeDeckungsbeitrag (LW)✓✓

Beide Schritte übertragen denselben Feldsatz; auch Beschreibung und Marge gehen bei späteren Änderungen mit nach BC.

Unterschiede zu Firma und Kontakt

Firma / KontaktVerkaufschancePosition
Richtungbidirektionalnur CE → BCnur CE → BC
Übernahme aus BC✓––
Änderungspfad✓–✓
Löschverarbeitung✓ deaktivieren––
Taktalle 2 Minutenalle 2 Minutenalle 3 Minuten
Freigabefeldwysa_sync2bcwysa_sync2bcwysa_SynctoBC

Technische Zuordnung

Jobs und Mappings dieser Ketten
OrderJobMappingSeite
190opportunityelementsfrombcBCOpportunityElementsKalkulationselemente aus BC
260opportunitiesnewfromceCEOpportunitiesNeu nach BC
261opportunitiesresponsefrombcBCOpportunitiesResponseRückmeldung aus BC
710opportunityproductsnewfromceCEOpportunityProductsPositionen neu nach BC
750opportunityproductsupdatesfromceCEOpportunityProductsUpdatesPositionsänderungen nach BC
760opportunityproductsresponsefrombcBCOpportunityProductsResponseRückmeldung Positionen

Beteiligte Tabellen:

DataverseBusiness Central API Page
opportunity.../acdopportunities
opportunityproduct.../acdopportunitycalculationelements
product.../acdopportunityelements

Alle API Pages unter singhammerITConsulting/dyce/v2.0/.

Schlüssel je Schritt
SchrittSchlüssel im ZielTyp
Neu nach BCBC dataverseId ← CE opportunityidFilter
Rückmeldung aus BCCE opportunityid aus der AntwortnachrichtPrimaryKey
Kalkulationselemente aus BCwysa_bccode ← BC codeCustomKey
Positionen neu nach BCBC systemId ← CE wysa_bcsystemidId
Rückmeldung PositionenCE opportunityproductid aus der AntwortnachrichtPrimaryKey
Positionsänderungen nach BCBC id ← CE wysa_bcsystemidId

Bemerkenswert: Die Verkaufschance folgt dem bekannten Muster aus Firma und Kontakt — Anlage über dataverseId, danach über die BC System-ID. Die Positionen tun das nicht: Sie verwenden schon bei der Anlage KeyType: Id auf ein Feld, das der Filter des Jobs als leer voraussetzt. Es gibt bei ihnen also keine Wiedererkennung über eine mitgeschickte CE-GUID. Was das für wiederholte Läufe bedeutet, steht auf Positionen neu nach BC.

Auflösung von Referenzen
CE-FeldNachschlagetabelleNachschlagefeld
Firma (parentaccountid)accountwysa_bccontactnumber
Kontakt (parentcontactid)contactwysa_bccontactnumber
Verkäufer BC (wysa_bcsalespersonid)wysa_bcsalespersonwysa_code
Verkaufschance (opportunityid)opportunitywysa_bcopportunitynumber
Produkt (productid)productwysa_bccode

Alle mit LookupType: Attribute und UseCache: true — außer der Verkaufschance: Sie wird ohne Cache aufgelöst (UseCache: false), damit eine gerade erst zurückgemeldete BC Verkaufschancennummer sofort gefunden wird. Die letzten beiden erklären, warum die Reihenfolge zählt: Eine Position kann erst übertragen werden, wenn die Verkaufschance ihre BC Verkaufschancennummer hat und das Produkt seinen BC Code — deshalb laufen die Positions-Jobs (710 – 760) ganz am Ende und die Kalkulationselemente (190) ganz am Anfang.


Neue Verkaufschancen nach Business Central übertragen

In Customer Engagement angelegte und freigegebene Verkaufschancen werden im ERP angelegt.

Rückmeldung aus Business Central

Nach der Anlage im ERP kommen Verkaufschancennummer und BC System-ID zurück nach Customer Engagement.

Kalkulationselemente aus Business Central übernehmen

Die Bausteine, aus denen eine Verkaufschance kalkuliert wird, kommen als Produkte nach Customer Engagement.

Neue Positionen nach Business Central übertragen

Freigegebene Verkaufschancenpositionen werden als Kalkulationszeilen im ERP angelegt.

Rückmeldung der Positionen aus Business Central

Nach der Anlage der Kalkulationszeile meldet BC deren System-ID zurück.

Positionsänderungen nach Business Central übertragen

Änderungen an bereits im ERP bekannten Verkaufschancenpositionen gehen nach Business Central.