Das ist eine für den Ausdruck optimierte Ansicht des gesamten Kapitels inkl. Unterseiten. Druckvorgang starten.

Abonnement

Wie wiederkehrend abgerechnete Leistungen und ihre Vertragsdetails aus Business Central nach Customer Engagement kommen.

1: Abonnements aus Business Central übernehmen
2: Abonnementzeilen aus Business Central übernehmen

Ein Abonnement bildet eine wiederkehrend abgerechnete Leistung ab: eine Lizenz, einen Cloud-Service, einen Wartungsvertrag. Diese Daten entstehen in der Abonnementverwaltung von Business Central — Customer Engagement führt sie mit, damit der Vertrieb Bestand, Laufzeiten und Kündigungsfristen im Blick hat.

Abonnements laufen ausschließlich von Business Central nach Customer Engagement.

Es gibt keinen Rückweg und keine Löschverarbeitung. Der Bereich besteht aus zwei Schritten, die aufeinander aufbauen:

Schritt	Was passiert	Wann
Abonnements aus BC	die abonnierte Leistung selbst	alle 2 Minuten
Abonnementzeilen aus BC	Laufzeiten, Preise, Kündigungsfristen	alle 2 Minuten

Zwei Ebenen

flowchart TB
  BC["Abonnementverwaltung<br/>in Business Central"]
  BC -->|"550 · <b>Abonnements aus BC</b>"| A["<b>Abonnement</b><br/>Was ist abonniert?<br/>Produkt, Menge, Seriennummer,<br/>Bereitstellungszeitraum"]
  BC -->|"560 · <b>Abonnementzeilen aus BC</b>"| Z["<b>Abonnementzeile</b><br/>Zu welchen Bedingungen?<br/>Laufzeit, Preis, Rabatt,<br/>Kündigungsfrist"]
  Z -->|"über die<br/>Abonnementnummer"| A

Ein Abonnement kann mehrere Zeilen mit unterschiedlichen Laufzeiten und Abrechnungsrhythmen haben. Die Zeile findet ihr Abonnement über die Abonnementnummer — deshalb muss Schritt 550 vor Schritt 560 laufen, was die Ordnungsnummern sicherstellen.

Rechnungsempfänger und Leistungsnehmer

Die fachlich interessanteste Eigenschaft dieses Bereichs: Das Abonnement trennt zwei Rollen, die in Konzernstrukturen auseinanderfallen.

Rolle	Bedeutung	Kommt aus BC von
Rechnungsempfänger	wer bezahlt	Rechnungsadresse des Belegs
Leistungsnehmer	wer die Leistung nutzt	Lieferadresse des Belegs

Beide werden je als Firma und Kontakt übertragen — vier Verknüpfungen pro Abonnement. Business Central liefert dafür vier Kontaktnummern, die in CE aufgelöst werden.

Aufgelöst wird über die BC Kontaktnummer

Alle vier Zuordnungen laufen über die BC Kontaktnummer — auch die auf Firmen. Das unterscheidet diesen Bereich vom Angebot, das die Firma über die BC Debitorennummer sucht.

Praktisch ist das die günstigere Variante: Die BC Kontaktnummer ist an jeder nach BC übertragenen Firma vorhanden, die Debitorennummer erst, wenn die Firma im ERP zum Debitor gemacht wurde.

Was in Customer Engagement bleibt

Nicht alle Felder der beiden Tabellen kommen aus Business Central. Diese werden CE-seitig gepflegt oder durch Automatik gefüllt:

Feld	Tabelle	Bemerkung
Verkaufschance	Abonnement	Ursprung des Abonnements — Zuordnung in CE
Mitbewerber	Abonnement	aktueller Anbieter, falls die Leistung abgelöst werden soll
Leaderstellung	Abonnement	Stichtag der Leadgenerierung
Anzahl Zeilen	Abonnement	Anzahl der zugehörigen Abonnementzeilen
Produkt (Verweis)	Abonnement	siehe unten
Abzurechnendes Produkt	Abonnementzeile	—
Währung	Abonnementzeile	—

Das passt zum Zweck des Bereichs: Business Central liefert den Vertragsbestand, Customer Engagement ergänzt die Vertriebssicht — aus einem auslaufenden Abonnement kann ein Lead entstehen, und dazu gehören Verkaufschance und Mitbewerber.

Der Produktverweis wird nicht gesetzt

Das Abonnement führt Produktnummer und Produktbeschreibung als Text. Der Verweis auf einen Produktdatensatz (Produkt) wird nicht befüllt, weil Artikel nicht aus Business Central übernommen werden — siehe Stammdaten.

Worauf zu achten ist

Keine Löschverarbeitung

Für Abonnements und Abonnementzeilen gibt es keinen Löschjob. Wird ein Abonnement in Business Central gelöscht, bleibt es in Customer Engagement mit dem letzten übertragenen Stand erhalten.

Die Abonnementart wird fest gesetzt

Das Feld Abonnementart wird bei jedem Lauf auf einen festen Vorgabewert gesetzt — Business Central liefert dazu nichts. Eine Unterscheidung nach Ausprägung findet über diesen Abgleich also nicht statt; eine in CE geänderte Abonnementart wird beim nächsten Lauf überschrieben.

Die Quellen liegen außerhalb der dyce-Schnittstelle

Alle übrigen Abgleiche lesen API Pages der Singhammer-Erweiterung unter singhammerITConsulting/dyce/v2.0/. Die beiden Abonnement-Jobs lesen stattdessen serviceObjects und serviceCommitments — die Schnittstelle der Abonnementverwaltung von Business Central selbst.

Praktische Folge: Dieser Bereich hängt an einer anderen Erweiterung als der Rest der Integration. Wird sie in BC nicht bereitgestellt, laufen die beiden Jobs ins Leere, während alles andere weiterarbeitet.

Kündigung möglich bis ist das wichtigste Datum

Von den 27 Feldern der Abonnementzeile ist eines für den Vertrieb entscheidend: Kündigung möglich bis. Es nennt den konkreten Stichtag, bis zu dem der Kunde kündigen kann — und damit den Zeitpunkt, an dem eine Verlängerung spätestens verhandelt sein muss. Alle übrigen Laufzeit- und Fristenfelder sind die Herleitung dazu.

Technische Zuordnung

Jobs und Mappings dieser Kette

Order	Job	Mapping	Zieltabelle	Felder	Seite
550	`serviceobjectsfrombc`	`BCServiceObjects`	`wysa_bcserviceobject`	17	Abonnements aus BC
560	`servicecommitmentsfrombc`	`BCServiceCommitments`	`wysa_bcserviceobjectcommitment`	27	Abonnementzeilen aus BC

Mit 44 Feldzuordnungen ist das der umfangreichste Datenbereich der Integration.

Quellen: serviceObjects und serviceCommitments — nicht unter singhammerITConsulting/dyce/v2.0/ wie alle übrigen Abgleiche.

Schlüssel je Schritt

Schritt	Schlüssel im Ziel	Alternate Key
Abonnements aus BC	`wysa_number` ← BC `no`	`wysa_numberkey`
Abonnementzeilen aus BC	`wysa_bcsystemid` ← BC `systemId`	`wysa_bcsystemidkey`

Auffällig ist die Uneinheitlichkeit: Das Abonnement wird über seine fachliche Nummer adressiert — wie das Angebot —, die Zeile über die BC System-ID, wie die Angebotsposition. Beide Konventionen kommen also innerhalb desselben Bereichs vor.

Auflösung von Referenzen

Feld	Zieltabelle	Nachschlagefeld	Alternate Key
Rechnungsempfänger Kontakt	`contact`	`wysa_bccontactnumber`	`wysa_bccodekey`
Rechnungsempfänger Firma	`account`	`wysa_bccontactnumber`	`wysa_bccodekey`
Leistungsnehmer Kontakt	`contact`	`wysa_bccontactnumber`	`wysa_bccodekey`
Leistungsnehmer Firma	`account`	`wysa_bccontactnumber`	`wysa_bccodekey`
Abonnement (an der Zeile)	`wysa_bcserviceobject`	`wysa_number`	`wysa_numberkey`

Damit setzen die Abonnements voraus, dass Firmen und Kontakte bereits abgeglichen sind. Die Ordnungsnummern 550 und 560 liegen hinter den Kontakt-Jobs (430 / 440), sodass das innerhalb desselben Durchlaufs zusammenfindet.

Feldnamen im Datenmodell

Das Datenmodell schreibt Logical Names in einer lesefreundlichen Schreibweise (z. B. wysa_NextBilling für wysa_nextbillingdate). Die folgende Übersicht ordnet die Felder dieses Mappings den Bezeichnungen im Datenmodell zu — getrennt nach Abonnementzeile und dem übergeordneten Abonnement, da beide Entitäten hier zusammenkommen.

Felder der Abonnementzeile (wysa_bcServiceObjectCommitment, dieses Mapping):

Feld	Im Mapping	Im Datenmodell
Zeilennummer	`wysa_contractlinenumber`	`wysa_LineNumber`
Verlängerungslaufzeit	`wysa_extensionterm`	`wysa_RenewalTerm`
Leistungsbeginn / -ende	`wysa_servicestartdate` / `wysa_serviceenddate`	`wysa_ServiceStart` / `wysa_ServiceEnd`
Nächste Berechnung	`wysa_nextbillingdate`	`wysa_NextBilling`
Abrechnungszeitraum	`wysa_billingbaseperiod`	`wysa_BillingPeriod`
Berechnungsbasis	`wysa_calculationbaseamount`	`wysa_CalculationBase`

Felder des übergeordneten Abonnements (wysa_bcServiceObject, aus Abonnements aus BC übernehmen):

Feld	Im Mapping	Im Datenmodell
Einheit	`wysa_uom`	`wysa_Uom`
Bereitstellung von	`wysa_provisionstartdate`	`wysa_ProvisioningStart`
Bereitstellung bis	`wysa_provisionenddate`	`wysa_ProvisioningEnd`
Rechnungsempfänger Firma	`wysa_billtocustomerid`	`wysa_BillToAccountId`
Leistungsnehmer Firma	`wysa_endusercustomerid`	`wysa_EndUserAccountId`

Einheit ist ein reines Textfeld, kein Verweis auf einen Einheiten-Datensatz.

Zusätzlich schreibt das Mapping ein Feld wysa_entrynumber an der Abonnementzeile, das im Datenmodell nicht aufgeführt ist.

1 - Abonnements aus Business Central übernehmen

Die abonnierten Leistungen kommen aus der Abonnementverwaltung des ERP nach Customer Engagement.


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	alle Abonnements, die in BC seit dem letzten Lauf geändert wurden
Technisch	Job `serviceobjectsfrombc` (550), Mapping `BCServiceObjects`

Was passiert hier?

Dieser Schritt holt die abonnierten Leistungen aus Business Central: was abonniert ist, in welcher Menge, mit welcher Seriennummer, für welchen Bereitstellungszeitraum — und für wen.

Die kaufmännischen Bedingungen dazu, also Laufzeiten, Preise und Kündigungsfristen, kommen im zweiten Schritt: Abonnementzeilen aus BC.

Wiedererkannt wird ein Abonnement über die Abonnementnummer.

Welche Felder kommen an?

Feld in Business Central	Feld in Customer Engagement	Anmerkung
Nr.	Nummer	Erkennungsmerkmal
Nr.	(Name des Datensatzes)	dieselbe Nummer, zusätzlich als Anzeigename
systemId	BC System-ID	technischer Schlüssel des ERP
Herkunftsnr.	Produktnummer	als Text — kein Verweis, siehe unten
Beschreibung	Produktbeschreibung
Menge	Menge
Einheit	Einheit
Seriennr.	Seriennummer
Version	Version
Bereitstellung von	Bereitstellung von
Bereitstellung bis	Bereitstellung bis
Rechnung an Kontaktnr.	Rechnungsempfänger Kontakt	wird zur Verknüpfung aufgelöst
Rechnung an Unternehmenskontaktnr.	Rechnungsempfänger Firma	wird zur Verknüpfung aufgelöst
Liefern an Kontaktnr.	Leistungsnehmer Kontakt	wird zur Verknüpfung aufgelöst
Liefern an Unternehmenskontaktnr.	Leistungsnehmer Firma	wird zur Verknüpfung aufgelöst
Kundenreferenz	Kundenreferenz
—	Abonnementart	fester Vorgabewert

Worauf zu achten ist

Vier Verknüpfungen für zwei Rollen

Das Abonnement trennt, wer bezahlt und wer nutzt — in Konzernstrukturen sind das verschiedene Firmen. Business Central liefert dafür die Rechnungs- und die Lieferadresse des Belegs, jeweils als Kontakt- und als Unternehmenskontaktnummer:

flowchart LR
  BC["Abonnement in BC"] -->|"Rechnung an<br/>Kontaktnr."| A["Rechnungsempfänger<br/>Kontakt"]
  BC -->|"Rechnung an<br/>Unternehmenskontaktnr."| B["Rechnungsempfänger<br/>Firma"]
  BC -->|"Liefern an<br/>Kontaktnr."| C["Leistungsnehmer<br/>Kontakt"]
  BC -->|"Liefern an<br/>Unternehmenskontaktnr."| D["Leistungsnehmer<br/>Firma"]

Alle vier werden über die BC Kontaktnummer aufgelöst — auch die beiden auf Firmen. Das ist die zuverlässigere Variante gegenüber der Debitorennummer, die das Angebot verwendet: Die Kontaktnummer ist an jeder nach BC übertragenen Firma vorhanden.

Ist eine Firma oder ein Kontakt in CE nicht auffindbar, bleibt die entsprechende Verknüpfung leer — das Abonnement wird trotzdem angelegt. Da die Kontakt-Jobs (430) vor diesem Schritt laufen, findet das normalerweise innerhalb desselben Durchlaufs zusammen.

Die Produktnummer kommt als Text, nicht als Verweis

Produktnummer und Produktbeschreibung werden als Text übertragen. Das Feld Produkt — der eigentliche Verweis auf den Produktdatensatz — bleibt leer.

Artikel werden nicht übernommen

Weil Artikel nicht aus Business Central übernommen werden, gibt es in CE keine Artikel-Produkte, auf die verwiesen werden könnte. Siehe Stammdaten.

Die Nummer steht in zwei Feldern

Die Abonnementnummer wird doppelt geschrieben: einmal in das Fachfeld Nummer, über das auch die Zuordnung läuft, und einmal in das Namensfeld des Datensatzes. Damit erscheint in Listen und Verknüpfungen die Nummer als Bezeichnung — das Abonnement hat keinen sprechenden Namen.

Die Abonnementart wird bei jedem Lauf gesetzt

Das Feld Abonnementart wird mit einem festen Vorgabewert befüllt; Business Central liefert dazu nichts. Eine in CE geänderte Abonnementart wird beim nächsten Abgleich wieder überschrieben.

Vier Felder kommen nicht aus BC

Verkaufschance, Mitbewerber, Leaderstellung und Anzahl Zeilen sind nicht Teil dieses Mappings — sie werden in Customer Engagement gepflegt oder durch Automatik gefüllt. Das ist der Vertriebsteil des Abonnements: Aus einem auslaufenden Vertrag kann ein Lead entstehen, und dazu gehört, wer der aktuelle Anbieter ist.

Keine Löschverarbeitung

Wird ein Abonnement in Business Central gelöscht, bleibt es in CE stehen — ohne Kennzeichnung. Siehe die Warnung auf der Übersicht.

Technische Details

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

2 - Abonnementzeilen aus Business Central übernehmen

Laufzeiten, Preise, Rabatte und Kündigungsfristen der Abonnements kommen nach Customer Engagement.


Richtung	Business Central → Customer Engagement
Wann	alle 2 Minuten
Betrifft	alle Abonnementzeilen, die in BC seit dem letzten Lauf geändert wurden
Technisch	Job `servicecommitmentsfrombc` (560), Mapping `BCServiceCommitments`

Was passiert hier?

Während das Abonnement sagt, was abonniert ist, sagt die Abonnementzeile, zu welchen Bedingungen: Laufzeit, Kündigungsfrist, Preis, Rabatt und Abrechnungsturnus.

Ein Abonnement kann mehrere Zeilen haben — etwa eine Grundlizenz mit Zweijahreslaufzeit und einen Support-Baustein mit jährlicher Verlängerung.

Mit 27 Feldzuordnungen ist das das umfangreichste Mapping der ganzen Integration. Wiedererkannt wird eine Zeile über die BC System-ID.

Welche Felder kommen an?

Zuordnung

Feld in Business Central	Feld in Customer Engagement
systemId	BC System-ID
Abonnementnr.	Abonnement (Verknüpfung)
Vertragsnr.	Vertragsnummer
Vertragszeilennr.	Zeilennummer
Zeilennr.	Eintragsnummer
Beschreibung	Beschreibung
Paketcode	Paketcode

Laufzeit und Fristen

Feld in Business Central	Feld in Customer Engagement
Anfangslaufzeit	Anfangslaufzeit
Verlängerungslaufzeit	Verlängerungslaufzeit
Kündigungsfrist	Kündigungsfrist
Kündigung möglich bis	Kündigung möglich bis
Leistungsbeginn	Leistungsbeginn
Leistungsende	Leistungsende
Laufzeit bis	Laufzeit bis

Abrechnung

Feld in Business Central	Feld in Customer Engagement	Anmerkung
Nächstes Berechnungsdatum	Nächste Berechnung
Abrechnungsrhythmus	Abrechnungsrhythmus
Abrechnungsbasiszeitraum	Abrechnungszeitraum
Abrechnung über	Abrechnung über	Text wird zum Auswahlwert
Partner	Partner	Text wird zum Auswahlwert

Preis und Rabatt

Feld in Business Central	Feld in Customer Engagement	Anmerkung
Preis	Preis
Menge	Menge
Rabatt	Rabatt	Ja/Nein — Text wird zum Auswahlwert
Rabattbetrag	Rabattbetrag
Rabatt %	Rabatt Prozent
Berechnungsbasisbetrag	Berechnungsbasis
Berechnungsbasis	Berechnungsbasis Prozent
Leistungsbetrag	Leistungsbetrag

Worauf zu achten ist

Kündigung möglich bis ist das entscheidende Feld

Von allen 27 Feldern ist dieses das wichtigste für den Vertrieb: Es nennt den konkreten Stichtag, bis zu dem der Kunde kündigen kann — und damit den Zeitpunkt, an dem eine Verlängerung spätestens verhandelt sein muss.

Anfangslaufzeit, Verlängerungslaufzeit und Kündigungsfrist sind die Regelwerke dahinter; Business Central rechnet daraus das Datum aus und liefert es fertig. Customer Engagement muss nichts nachrechnen.

Die Zeile hängt an der Abonnementnummer

Die Verknüpfung zum Abonnement wird über die Abonnementnummer aufgelöst. Ist das Abonnement in CE noch nicht vorhanden, bleibt die Verknüpfung leer — die Zeile wird trotzdem angelegt und stünde dann ohne Bezug da.

Da Abonnements aus BC mit Order 550 vor diesem Schritt (560) läuft, findet das normalerweise innerhalb desselben Durchlaufs zusammen.

Drei Felder werden von Text in Auswahlwerte übersetzt

Business Central liefert Abrechnung über, Partner und Rabatt als Text. In Customer Engagement sind das Auswahlfelder, weshalb hier die Operation OptionMapping zum Einsatz kommt — die es sonst nirgends in der Integration gibt:

Feld	Wert in BC	Wert in CE
Abrechnung über	`Contract`	Vertrag
	`Sales`	Verkauf
Partner	`Customer`	Kunde
	`Vendor`	Lieferant
Rabatt	`true`	Ja
	`false`	Nein

Übersetzungstabellen

Die Übersetzungstabellen sind Teil der Mapping-Konfiguration und enthalten genau die oben aufgeführten Werte. Ein Wert, der dort nicht aufgeführt ist, wird nicht übersetzt und lässt das Zielfeld leer.

Zwei Felder für die Berechnungsbasis, gekreuzt benannt

Hier ist beim Lesen der Konfiguration Vorsicht geboten: Das BC-Feld Berechnungsbasisbetrag geht in das CE-Feld Berechnungsbasis, das BC-Feld Berechnungsbasis dagegen in Berechnungsbasis Prozent. Die Namen kreuzen sich also. Fachlich passt es — BC führt unter Berechnungsbasis einen Prozentsatz —, beim Prüfen eines Datensatzes ist es aber leicht zu verwechseln.

Drei Nummernfelder

Die Zeile bringt drei verschiedene Nummern mit: Vertragsnummer, Zeilennummer (aus der Vertragszeile) und Eintragsnummer (aus der Zeilennummer des Belegs). Für die Zuordnung ist keine davon relevant — die läuft über die BC System-ID.

Währung und abzurechnendes Produkt fehlen

Die Felder Währung und Abzurechnendes Produkt sind nicht Teil dieses Mappings. Preis, Rabattbetrag und Leistungsbetrag kommen also ohne Währungsangabe an; in CE gilt dann, was am Datensatz voreingestellt ist.

Keine Löschverarbeitung

Wird eine Abonnementzeile in Business Central gelöscht, bleibt sie in CE stehen. Siehe die Warnung auf der Übersicht.

Technische Details

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