Abonnementzeilen aus Business Central übernehmen
Themen:
| 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 |
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.