Kontakt

Wie Kontakte zwischen Customer Engagement und Business Central abgeglichen werden — Gesamtbild und die fünf Schritte im Detail.

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.

SchrittWas passiertWann
Aus BC übernehmenBC-Kontakte kommen nach CEalle 2 Minuten
Neu nach BCin CE angelegte, freigegebene Kontakte werden in BC angelegtalle 2 Minuten
Rückmeldung aus BCBC meldet Nummer, Id und Adressdaten zurückdirekt nach der Anlage
Änderungen nach BCÄnderungen in CE gehen nach BCalle 2 Minuten
Löschung aus BCin BC gelöschte Kontakte werden in CE deaktiviertalle 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:

Ein Kontakt darf erst freigegeben werden, wenn die BC System-ID seiner Firma gefüllt ist.

Ein gesetztes Häkchen bei Sync zu BC an der Firma genügt nicht. Es bedeutet nur „soll übertragen werden". Erst die gefüllte BC System-ID beweist, dass die Firma im ERP angekommen ist. Die Lösung setzt das aktiv durch: Die Freigabe eines Kontakts wird abgelehnt, solange die Firma nicht nachweislich in BC existiert. Dasselbe gilt beim Umhängen eines Kontakts an eine andere Firma.

Ausführlich beschrieben ist die Regel unter Freigabe nach Business Central.

Die Weiche: das Feld „BC System-ID"

Wie bei der Firma entscheidet die BC System-ID, welcher Schritt greift:

Feld ist …BedeutungEs greift
leerBC kennt den Kontakt noch nichtNeu nach BC
gefülltBC kennt den KontaktÄnderungen nach BC

Beide setzen zusätzlich die Freigabe über Sync zu BC voraus.

Welche Felder laufen in welche Richtung?

Feld in CEAus BC übernehmenNeu nach BCÄnderungen nach BC
Vorname, Zweiter Vorname, Nachname✓✓✓
Anrede (BC)✓✓✓
Sprache✓✓✓
Straße 1 / Straße 2✓✓✓
Postleitzahl / Ort✓✓✓
Land✓✓✓
Geschäftlich (Telefon)✓✓✓
Mobiltelefon✓✓✓
E-Mail✓✓✓
Firmenname (übergeordnete Firma)✓✓✓
Position (BC)✓––
Verkäufer (BC)–✓✓
Sync zu BC✓––
BC Kontaktnummer✓––
BC System-ID✓––

Zwölf Felder laufen glatt in beide Richtungen. Die drei hervorgehobenen verdienen einen zweiten Blick.

Die übergeordnete Firma ist hier bidirektional

Beim Kontakt wird die Zuordnung zur Firma in beide Richtungen abgeglichen — anders als bei der Firma, wo die übergeordnete Firma nur aus BC kommt. Wird ein Kontakt in CE an eine andere Firma gehängt, geht das nach BC; und umgekehrt.

Aufgelöst wird über die BC Kontaktnummer der Firma. Fehlt sie — weil die Firma noch nicht in BC ist —, kann die Zuordnung nicht gebildet werden. Genau deshalb greift die Freigaberegel oben.

Zwei Felder laufen nur in eine Richtung

FeldRichtungKonsequenz
Position (BC) — die Organisationsebene aus BCnur BC → CEEine Änderung in CE geht nicht nach BC und wird beim nächsten Abgleich überschrieben
Verkäufer (BC)nur CE → BCDer in BC hinterlegte Verkäufer wird beim Übernehmen nicht nach CE geholt

Was in der Praxis zu beachten ist

Unterschiede zur Firma auf einen Blick

FirmaKontakt
Kontaktart in BCCompanyPerson
Übergeordnete Firmanur BC → CEbidirektional
NameName 1 / Name 2 (BC), Firmenname bleibt unberührtVorname / Zweiter Vorname / Nachname, Standardfelder
Rückmeldung aus BC2 Felder (Nummer, Id)9 Felder — zusätzlich Adressdaten
Freigabe abhängig von—BC System-ID der Firma
Anredefester Vorgabewert MANDANTVerweis auf die BC-Anredeschlüssel

Technische Zuordnung

Jobs und Mappings dieser Kette
OrderJobMappingSeite
240contactsnewfromceCEContactsNeu nach BC
241contactsresponsefrombcBCContactsResponseRückmeldung aus BC
430contactsfrombcBCContactsAus BC übernehmen
440contactsfrombcdeleteBCContactsDeleteLöschung aus BC
530contactupdatesfromceCEContactsUpdatesÄnderungen nach BC

Beteiligte Tabellen: Dataverse contact ⇄ BC API Page singhammerITConsulting/dyce/v2.0/acdcontacts; Löschungen über singhammerITConsulting/dyce/v2.0/acdlogentries.

Schlüssel je Schritt
SchrittSchlüssel im ZielTyp
Aus BC übernehmenwysa_bccontactnumber ← BC numberCustomKey wysa_bccodekey
Neu nach BCBC dataverseId ← CE contactidFilter
Rückmeldung aus BCCE contactid aus der AntwortnachrichtPrimaryKey
Änderungen nach BCBC id ← CE wysa_bcsystemidId
Löschung aus BCwysa_bcsystemid ← Log recordIdCustomKey wysa_bcsystemidkey

Identisch zur Firma.

Auflösung von Referenzen

Der Kontakt löst mehr Referenzen auf als die Firma — fünf statt drei:

CE-FeldWertelisteCodefeldStammdaten-Job
Land (wysa_address1_countryid)wysa_countrywysa_bccodecountriesfrombc (110)
Sprache (wysa_language)wysa_languagewysa_bccodelanguagesfrombc (115)
Anrede BC (wysa_salutationbcid)wysa_bcsalutationwysa_codesalutationsfrombc (120)
Verkäufer BC (wysa_bcsalespersonid)wysa_bcsalespersonwysa_codesalespersonsfrombc (130)
Position BC (wysa_bcpositionid)wysa_bcpositionwysa_codepositionsfrombc (135)
Firma (parentcustomerid)accountwysa_bccontactnumber—

Die Stammdaten-Jobs 110 – 135 laufen vor den Kontakt-Jobs (240 / 430), sodass die Wertelisten innerhalb desselben Laufs aktuell sind.


Kontakte aus Business Central übernehmen

Neue und geänderte Kontakte aus dem ERP erscheinen in Customer Engagement.

Neue Kontakte nach Business Central übertragen

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

Rückmeldung aus Business Central

Nach der Anlage im ERP kommen Kontaktnummer, BC System-ID und die von BC ergänzten Adressdaten zurück.

Änderungen nach Business Central übertragen

Änderungen an bereits im ERP bekannten Kontakten werden von Customer Engagement nach Business Central übertragen.

Löschung in Business Central nachvollziehen

Wird ein Kontakt im ERP gelöscht, wird er in Customer Engagement deaktiviert — nicht gelöscht.