# Wertelisten aus Business Central übernehmen

> Länder, Sprachen, Anreden, Debitorrabattgruppen und Organisationsebenen kommen aus dem ERP nach Customer Engagement.

---

LLMS index: [llms.txt](/llms.txt)

---

| | |
|---|---|
| **Richtung** | Business Central → Customer Engagement |
| **Wann** | alle 2 Minuten |
| **Betrifft** | fünf Wertelisten, je ein eigener Abgleich |
| **Technisch** | Jobs `countriesfrombc` (110), `languagesfrombc` (115), `salutationsfrombc` (120), `customerdiscountgroupsfrombc` (125), `positionsfrombc` (135) |

Der sechste Wertelisten-Abgleich, der [Verkäufer](../bcsalespersons/) (130), hat wegen
einer Besonderheit eine eigene Seite.

## Was passiert hier?

Jeder dieser fünf Abgleiche holt eine Werteliste aus Business Central nach Customer
Engagement — Kürzel und Bezeichnung. Danach kann die Integration in den Belegketten aus
einem BC-Kürzel eine echte Verknüpfung machen.

Alle fünf sind gleich aufgebaut: Sie kommen mit drei bis vier Feldern aus, erkennen
Einträge über die **BC System-ID**, laufen im Zwei-Minuten-Takt und übertragen nur, was
sich seit dem letzten Lauf geändert hat. Es gibt keinen Rückweg und keine
Löschverarbeitung.

## Länder

**Job** `countriesfrombc` (110) · **Zieltabelle** Land (`wysa_country`)

| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | BC Code |
| Name | Name |
| ISO-Code | ISO 3166-1 alpha-2 |

Die einzige Werteliste mit einem vierten Feld: Neben dem BC-Kürzel kommt der
**ISO-Code** mit. Damit lassen sich Länder in CE auch dort korrekt darstellen, wo eine
normierte Kennung gebraucht wird — etwa in Serienbriefen oder Exporten.

Gebraucht wird die Liste für das Feld *Land* an Firma, Kontakt und Lead.

> **Einträge ohne Code werden übersprungen**
>
> Dieser Abgleich hat als einziger einen zusätzlichen Filter: Länder ohne Kürzel werden
> nicht übertragen. Ein Ländereintrag ohne Code wäre in CE nutzlos, weil die Zuordnung aus
> den Belegen genau über dieses Kürzel läuft.



## Sprachen

**Job** `languagesfrombc` (115) · **Zieltabelle** Sprache (`wysa_language`)

| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | BC Code |
| Name | Name |

Gebraucht wird die Liste für das Feld *Sprache* am Kontakt und am Lead — und darüber
hinaus für die [Anredebildung](../../../business-logik/anrede-und-sprache/): Anredevorlagen
und Titel hängen jeweils an einer Sprache.

## Anreden

**Job** `salutationsfrombc` (120) · **Zieltabelle** Anrede (BC) (`wysa_bcsalutation`)

| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | Code |
| Beschreibung | Name |

Gebraucht wird die Liste für das Feld *Anrede (BC)* am Kontakt.

> **Nicht zu verwechseln mit den Anredevorlagen**
>
> Die Lösung kennt zwei verschiedene Anrede-Konzepte:
> 
> * **Anrede (BC)** (`wysa_bcsalutation`) — der Anredeschlüssel aus Business Central, den
>   dieser Abgleich liefert. Er geht mit dem Kontakt nach BC zurück.
> * **Anredevorlage** (`wysa_salutation`) — die Regeln, aus denen CE formelle, informelle
>   und persönliche Anredetexte erzeugt. Reine CE-Stammdaten, **kein Abgleich**.
> 
> Beide sind unabhängig voneinander zu pflegen. Siehe
> [Anrede, Titel und Sprache](../../../datenmodell/anrede-sprache/).



## Debitorrabattgruppen

**Job** `customerdiscountgroupsfrombc` (125) · **Zieltabelle** Debitorrabattgruppe (BC)
(`wysa_bccustomerdiscountgroup`)

| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | BC Code |
| Beschreibung | Name |

Gebraucht wird die Liste für das Feld *Debitorrabattgruppe* an der Firma. Dieses Feld
gehört zu denen, die **nur aus BC** kommen und nie zurückgeschrieben werden — siehe
[Firma](../../firma/).

## Organisationsebenen

**Job** `positionsfrombc` (135) · **Zieltabelle** Position (BC) (`wysa_bcposition`)

| Feld in Business Central | Feld in Customer Engagement |
|---|---|
| id | BC System-ID |
| Code | Code |
| Beschreibung | Name |

Gebraucht wird die Liste für das Feld *Position (BC)* am Kontakt und am Lead — die
Entscheidungsebene eines Ansprechpartners.

> **Position und Position (BC) sind zwei Felder**
>
> Am Kontakt gibt es **Position** (Standardfeld, freier Text, die Funktion) und
> **Position (BC)** (Verweis auf diese Werteliste). Sie laufen sogar in entgegengesetzte
> Richtungen — siehe [Kontakt](../../kontakt/).



## Worauf zu achten ist

### Gelöschte Einträge bleiben in CE stehen

Keiner dieser Abgleiche hat eine Löschverarbeitung. Wird eine Anrede oder ein Land in
Business Central gelöscht, bleibt der Eintrag in Customer Engagement bestehen und
weiterhin auswählbar. Bei Firma, Kontakt und Produkt gibt es dafür eigene Löschjobs —
bei den Wertelisten nicht.

### Änderungen am Kürzel sind unkritisch

Weil die Zuordnung über die BC System-ID läuft und nicht über das Kürzel, überlebt ein
Eintrag eine Umbenennung in BC: Beim nächsten Lauf wird derselbe CE-Datensatz gefunden
und sein Codefeld aktualisiert.

Die Belegketten lösen allerdings über das **Kürzel** auf. Wird ein Code in BC geändert,
zeigen bestehende CE-Datensätze also weiter auf den richtigen Eintrag — neue Belege aus
BC bringen aber das neue Kürzel mit, das nach dem Wertelisten-Abgleich ebenfalls stimmt.
Weil die Wertelisten vor den Belegen laufen, greift das innerhalb desselben Durchlaufs.

### Zwei Schreibweisen für das Codefeld

Länder, Sprachen und Debitorrabattgruppen legen das Kürzel in `wysa_bccode` ab, Anreden
und Organisationsebenen in `wysa_code`. Die Lookups in den Belegketten berücksichtigen
das — siehe [Stammdaten](../).

## Technische Details

Die vollständigen technischen Mapping-Tabellen mit Feldzuordnungen, Key-Auflösung und
Transformationen stehen auf den technischen Seiten der einzelnen Jobs:

| Werteliste | Technische Seite |
|---|---|
| Länder | [Technisches Mapping → countriesfrombc](../technisches-mapping/countriesfrombc/) |
| Sprachen | [Technisches Mapping → languagesfrombc](../technisches-mapping/languagesfrombc/) |
| Anreden | [Technisches Mapping → salutationsfrombc](../technisches-mapping/salutationsfrombc/) |
| Debitorrabattgruppen | [Technisches Mapping → customerdiscountgroupsfrombc](../technisches-mapping/customerdiscountgroupsfrombc/) |
| Organisationsebenen | [Technisches Mapping → positionsfrombc](../technisches-mapping/positionsfrombc/) |