Firma-Kontakt on dsyr.SalesCentral

Firmen aus Business Central übernehmen

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


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	alle Firmenkontakte, die in BC seit dem letzten Lauf geändert wurden
Technisch	Job `accountsfrombc` (410), Mapping `BCAccounts`

Was passiert hier?

Wird in Business Central ein Firmenkontakt angelegt oder geändert, erscheint er kurz darauf in Customer Engagement. Existiert die Firma dort schon, werden ihre Felder aktualisiert; existiert sie noch nicht, wird sie neu angelegt.

Wiedererkannt wird eine Firma an ihrer BC Kontaktnummer. Sie ist die Klammer zwischen beiden Systemen — nicht der Firmenname.

Kontakte aus Business Central übernehmen

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


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	alle Kontakte, die in BC seit dem letzten Lauf geändert wurden
Technisch	Job `contactsfrombc` (430), Mapping `BCContacts`

Was passiert hier?

Wird in Business Central ein Kontakt angelegt oder geändert, erscheint er kurz darauf in Customer Engagement. Existiert der Kontakt dort schon, werden seine Felder aktualisiert; existiert er noch nicht, wird er neu angelegt.

Wiedererkannt wird ein Kontakt an seiner BC Kontaktnummer — nicht am Namen.

Firma

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

Firmen werden zwischen Customer Engagement und Business Central in beide Richtungen abgeglichen. Der Vertrieb legt eine Firma in CE an, gibt sie frei, und sie erscheint im ERP — oder ein Debitor entsteht in BC und taucht kurz darauf in CE auf. Beides ist möglich, und beides greift ineinander.

Diese Seite zeigt das Gesamtbild. Die fünf Schritte, aus denen der Abgleich besteht, sind je auf einer eigenen Seite beschrieben:

Schritt	Was passiert	Wann
Aus BC übernehmen	BC-Firmen kommen nach CE	alle 2 Minuten
Neu nach BC	in CE angelegte, freigegebene Firmen werden in BC angelegt	alle 2 Minuten
Rückmeldung aus BC	BC meldet Nummer und Id zurück	direkt nach der Anlage
Änderungen nach BC	Änderungen in CE gehen nach BC	alle 2 Minuten
Löschung aus BC	in BC gelöschte Firmen werden in CE deaktiviert	alle 2 Minuten

Kontakt und Verkaufschance funktionieren nach demselben Muster.

Firma, Kontakt und Lead

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

Firma (Account), Kontakt (Contact) und Lead sind unveränderte Standardtabellen. Ergänzt wurden Felder für die Schlüssel aus Business Central, für die Freigabe zur Übertragung und für die Anredebildung.

Firma

Eine Firma entspricht in Business Central je nach Ausprägung einem Debitor, einem Kreditor oder einem Kontakt. Dafür gibt es drei getrennte Nummernfelder.

Anzeigename	Logical Name	Typ	Bedeutung
Sync zu BC	`wysa_sync2bc`	Auswahl (Ja/Nein)	Freigabe zur Übertragung nach Business Central
BC System-ID	`wysa_bcSystemId`	Text	Herkunfts-ID in Business Central; gefüllt, sobald die Übertragung erfolgreich war
BC Debitorennummer	`wysa_bcCustomerNumber`	Text	Debitorennummer
BC Kreditorennummer	`wysa_bcVendorNumber`	Text	Kreditorennummer
BC Kontaktnummer	`wysa_bcContactNumber`	Text	Kontaktnummer in Business Central
BC Suchbegriff	`wysa_bcSearchName`	Text	Suchbegriff aus Business Central
Name 1 (BC) / Name 2 (BC)	`wysa_bcName1`, `wysa_bcName2`	Text	Zweizeiliger Firmenname aus Business Central; daraus wird der Firmenname zusammengesetzt
CRM-Firmennummer	`wysa_CRMAccountnumber`	Text	Fortlaufende Nummer aus Customer Engagement
USt-IdNr.	`wysa_VatNumber`	Text	Umsatzsteuer-Identifikationsnummer
Firmentyp	`wysa_AccountType`	Auswahl	Rechtliche Einheit oder Standort
Mandant (BC)	`wysa_bcClientId`	Verweis	Zugehöriger Buchungskreis
Verkäufer (BC)	`wysa_bcSalesPersonId`	Verweis	Zuständiger Verkäufer
Debitorrabattgruppe	`wysa_bcCustomerDiscountGroupId`	Verweis	Rabattgruppe des Debitors
Land	`wysa_Address1_CountryId`	Verweis	Land der Hauptadresse

Name 1 und Name 2 sind die Felder, die die Schnittstelle mit Business Central austauscht. Der einzeilige Firmenname des CRM-Standards wird daraus zusammengesetzt und ist auf dem Formular schreibgeschützt — siehe Stammdaten und Anzeige.

Kontakt

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

Kontakte werden nach demselben Muster abgeglichen wie Firmen: in beide Richtungen, im Zwei-Minuten-Takt, gesteuert über die Freigabe Sync zu BC und die BC System-ID.

Ein Unterschied ist aber grundlegend: Ein Kontakt hängt an seiner Firma. Business Central kann einen Kontakt nur anlegen, wenn dessen Firma dort bereits existiert. Das prägt den gesamten Ablauf.

Schritt	Was passiert	Wann
Aus BC übernehmen	BC-Kontakte kommen nach CE	alle 2 Minuten
Neu nach BC	in CE angelegte, freigegebene Kontakte werden in BC angelegt	alle 2 Minuten
Rückmeldung aus BC	BC meldet Nummer, Id und Adressdaten zurück	direkt nach der Anlage
Änderungen nach BC	Änderungen in CE gehen nach BC	alle 2 Minuten
Löschung aus BC	in BC gelöschte Kontakte werden in CE deaktiviert	alle 2 Minuten

Der Kreislauf

flowchart TB
 START(["Kontakt entsteht"]) --> Q{"Wo?"}

 Q -->|"in CE angelegt"| C0{"Firma bereits<br/>in BC?"}
 Q -->|"in BC angelegt"| B1["<b>Aus BC übernehmen</b><br/>Kontakt erscheint in CE"]

 C0 -->|nein| BLOCK["Freigabe wird abgelehnt —<br/>erst die Firma übertragen"]
 C0 -->|ja| C1["Feld <b>BC System-ID</b><br/>ist noch leer"]

 C1 --> C2{"<b>Sync zu BC</b><br/>freigegeben?"}
 C2 -->|nein| WAIT["Kontakt bleibt in CE"]
 C2 -->|ja| C3["<b>Neu nach BC</b><br/>Kontakt wird in BC angelegt"]

 C3 --> C4["<b>Rückmeldung aus BC</b><br/>BC Kontaktnummer, BC System-ID<br/>und Adressdaten kommen zurück"]

 B1 --> SYNC["Kontakt existiert in beiden Systemen"]
 C4 --> SYNC

 SYNC --> U1["Änderung in CE<br/><b>Änderungen nach BC</b>"]
 SYNC --> U2["Änderung in BC<br/><b>Aus BC übernehmen</b>"]
 U1 --> SYNC
 U2 --> SYNC

 SYNC --> D1["Kontakt in BC gelöscht"]
 D1 --> D2["<b>Löschung aus BC</b><br/>Kontakt in CE wird deaktiviert"]

Erst die Firma, dann der Kontakt

Das ist die zentrale Regel — und der wichtigste Unterschied zur Firma:

Neue Firmen nach Business Central übertragen

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


Richtung	Customer Engagement → Business Central
Wann	alle 2 Minuten
Betrifft	Firmen, die freigegeben sind und in BC noch nicht existieren
Technisch	Job `accountsnewfromce` (220), Mapping `CEAccounts`

Was passiert hier?

Der Vertrieb legt eine Firma in Customer Engagement an. Zunächst bleibt sie dort — das ERP erfährt nichts davon. Erst wenn das Feld Sync zu BC auf „Ja" gesetzt wird, wird die Firma beim nächsten Lauf in Business Central angelegt.

Neue Kontakte nach Business Central übertragen

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


Richtung	Customer Engagement → Business Central
Wann	alle 2 Minuten
Betrifft	Kontakte, die freigegeben sind und in BC noch nicht existieren
Technisch	Job `contactsnewfromce` (240), Mapping `CEContacts`

Was passiert hier?

Der Vertrieb legt einen Kontakt in Customer Engagement an. Sobald das Feld Sync zu BC auf „Ja" gesetzt ist, wird er beim nächsten Lauf in Business Central angelegt — als Personenkontakt, zugeordnet zu seiner Firma.

Zwei Bedingungen müssen erfüllt sein:

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 Firmen, die gerade in BC angelegt wurden
Technisch	Job `accountsresponsefrombc` (221), Mapping `BCAccountsResponse`

Was passiert hier?

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

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

Dieser Schritt trägt beides in CE nach. Er läuft direkt im Anschluss an die Anlage und wertet dabei die Antwort von Business Central aus — es ist keine erneute Abfrage.

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 Kontakte, die gerade in BC angelegt wurden
Technisch	Job `contactsresponsefrombc` (241), Mapping `BCContactsResponse`

Was passiert hier?

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

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

Beim Kontakt kommt aber noch etwas hinzu: Business Central schickt auch die Adressdaten zurück.

Änderungen nach Business Central übertragen

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


Richtung	Customer Engagement → Business Central
Wann	alle 2 Minuten
Betrifft	freigegebene Firmen, die in BC bereits existieren
Technisch	Job `accountupdatesfromce` (520), Mapping `CEAccountUpdates`

Was passiert hier?

Sobald eine Firma in beiden Systemen existiert, hält dieser Schritt Business Central auf dem Stand von Customer Engagement. Er ist das Gegenstück zu Aus BC übernehmen — dieselben Felder, nur andersherum.

Erfasst werden Firmen, bei denen beides zutrifft:

Sync zu BC steht auf „Ja"
das Feld BC System-ID ist gefüllt — BC kennt die Firma also

Ist die BC System-ID leer, greift stattdessen Neu nach BC. Die beiden Schritte schließen sich gegenseitig aus.

Änderungen nach Business Central übertragen

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


Richtung	Customer Engagement → Business Central
Wann	alle 2 Minuten
Betrifft	freigegebene Kontakte, die in BC bereits existieren
Technisch	Job `contactupdatesfromce` (530), Mapping `CEContactsUpdates`

Was passiert hier?

Sobald ein Kontakt in beiden Systemen existiert, hält dieser Schritt Business Central auf dem Stand von Customer Engagement.

Erfasst werden Kontakte, bei denen beides zutrifft:

Sync zu BC steht auf „Ja"
das Feld BC System-ID ist gefüllt

Ist die BC System-ID leer, greift stattdessen Neu nach BC. Die beiden Schritte schließen sich gegenseitig aus.

Löschung in Business Central nachvollziehen

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


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	Firmen, die in BC gelöscht wurden
Technisch	Job `accountsfrombcdelete` (420), Mapping `BCAccountsDelete`

Was passiert hier?

Wird eine Firma in Business Central gelöscht, wird sie in Customer Engagement deaktiviert — sie bleibt also erhalten und wird nur inaktiv gesetzt. Als Statusgrund wird festgehalten, dass die Löschung aus BC kam.

flowchart LR
 A["Firma in BC gelöscht"] --> B["Eintrag im<br/>Änderungsprotokoll von BC"]
 B --> C["Abgleich liest das Protokoll"]
 C --> D["Firma in CE wird<br/><b>deaktiviert</b>"]

Der Weg über das Änderungsprotokoll ist notwendig, weil eine gelöschte Firma in der normalen Schnittstelle nicht mehr auftaucht — sie könnte durch Abgleich gar nicht mehr gefunden werden. Das Protokoll hält dagegen fest, dass etwas gelöscht wurde.

Löschung in Business Central nachvollziehen

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


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	Kontakte, die in BC gelöscht wurden
Technisch	Job `contactsfrombcdelete` (440), Mapping `BCContactsDelete`

Was passiert hier?

Wird ein Kontakt in Business Central gelöscht, wird er in Customer Engagement deaktiviert — er bleibt also erhalten und wird nur inaktiv gesetzt.

Der Weg führt über das Änderungsprotokoll von BC: Ein gelöschter Kontakt taucht in der normalen Schnittstelle nicht mehr auf und könnte durch Abgleich gar nicht gefunden werden. Das Protokoll hält dagegen fest, dass etwas gelöscht wurde.

Stammdaten und Anzeige

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

Firmenname aus Name 1 und Name 2

Business Central führt Firmennamen zweizeilig, in den Feldern Name und Name 2. Genau diese beiden Felder beschreibt die Schnittstelle in beide Richtungen — sie sind in Customer Engagement als Name 1 (BC) (wysa_bcName1) und Name 2 (BC) (wysa_bcName2) abgebildet. Der einzeilige Firmenname des CRM-Standards ist an der Übertragung nicht beteiligt.

Damit er trotzdem stimmt, setzt ihn die Serverlogik zusammen: Name 1, ein Leerzeichen, Name 2 — führende und nachfolgende Leerzeichen werden entfernt, ist nur eines der beiden Felder gefüllt, steht auch nur dieses im Namen. Die Berechnung läuft, sobald eines der beiden Quellfelder angelegt oder geändert wird.