de.schleupen.createOrUpdatePerson

de.schleupen.createOrUpdatePerson

Person

Geschäftspartner

Ansprechpartner

Adresse

Kommunikation

-

Neuanlage oder Update eines Geschäftspartners mit Adresse und Kommunikation, als Vertragspartner, Rechnungsempfänger oder Marktteilnehmer. Zu einem Geschäftspartner wird in EVI immer ein Default-Ansprechpartner erzeugt.

Feldbezeichnung

techn. Feldbezeichnung

Schlüssel / Entität

Besonderheit

Funktion

Objekt

techn. Feldbezeichnung

Besonderheit

Person

Person

Person

Personentyp

PersonTypeKey.Person

PERSONTYPE

Wenn Person.Rechtsform=J, dann PersonTypeKey.Person=U (Unternehmen)

sonst (Person.Rechtsform=N):

• wenn Person.Anrede.Geschlecht=”m”, dann PersonTypeKey.Person=M (Mann)

• wenn Person.Anrede.Geschlecht=”w”, dann PersonTypeKey.Person=F (Frau)

• wenn Person.Anrede.Kuerzel=”Ehel”, dann PersonTypeKey.Person=EHE (Eheleute)

• sonst: D (Divers)

Mapping siehe SC12SCHLEUPENUTILS.lookup.

insert/update

Person

Rechtsform

Rechtsform des Datensatzes
Mögliche Werte:

• N – natürliche Person

• J – juristische Person

Rechtsform (ERP)

C12ISULegal.Customer

Person

Rechtsform

Name1/Nachname

Name1.Person

insert/update

Person

Name

Nachname bzw. Firmennamen

Name2/Vorname

Name2.Person

insert/update

Person

Vorname

Vorname bei natürlichen Personen

Name3

Name3.Person

insert/update

Person

Zusatz1

Zusatz zum Namen

Kurzname

Matchcode.Person

Erster Teil aus Person.Name (bis zum ersten “ “) + Anschrift.Ort. Abgeschnitten nach 50 Zeichen.

insert/update

Geburtstag/Gründung

DateOfOrigin.Person

insert/update

Person

Geburtsdatum

Geburtsdatum der Person Format: YYYY-MM-DD Beispiel: 2021-12-20

akad. Titel

AcademicTitle.Person

 S_KEYTAB (ACADEMIC_TITLE)

ℹBezeichnungswerte > 40 Zeichen werden abgeschnitten

Neue Akad. Titel werden angelegt oder aktualisiert (Key aus Titel.Kuerzel; Beschreibung aus Titel.Bezeichnung)

insert/update

Person

Titel

Angabe eines Titels der Person Kürzel mit Länge 8 und Bezeichnung mit Länge 70 Beispiele:

• Dr – Doktor

• ProfDr – Prof. Dr. Titel können beliebig verwaltet werden.

Geschäftspartner

Customer

ERP-GP-Nr.

CustomerNo2.Customer

ID

Person

PIN

Fachlicher Schlüssel der Person
Dieser Schlüssel ist in einem Hauptmandanten und somit auch innerhalb eines Mandanten eindeutig

Ext. Ref.-Nummer

ExtRefNo.Customer

insert/update

Person

Guid

Zusätzlicher technischer Schlüssel, welcher vorrangig in der Kommunikation mit Schleupen.CS 3.0 Bedeutung hat Beispiel: {3fd83c0b-2115-248e-c520-000000003191}

ERP-Aktiv

C12ERPActive.Customer

wenn Person.Ungueltig='J', dann false,

sonst true.

siehe auch de.schleupen.deletePerson

insert/update

Person

IstUngueltig

Ungültig-Kennzeichen der Person
Mögliche Werte:

• J – Ja, Person ist ungültig, d.h. dieser Datensatz darf für neue Vorgänge nicht verwendet werden, kann jedoch noch in Bestandsdaten referenziert sein

• N – Nein, Person ist nicht ungültig und kann uneingeschränkt verwendet werden

SyncID

C12SyncId.Customer

in EVI generierter Wert über Counter-Tabelle

insert

Anrede

C12ISU_TITEL.Customer

S_KEYTAB (C12GPTITLE)

EVI-Key: Person.Anrede.Kuerzel

EVI-Bezeichnung: Person.Anrede.Bezeichnung

insert/update

Person

Anrede

Angabe der Anrede des Datensatzes

Kuerzel, Bezeichnung und Geschlecht
Im Geschlecht werden die Werte w - weiblich und m - männlich verwaltet (s.o. bei Personentyp). 

Geschäftsbeziehung

CustTypeKey

S_KEYTAB (CUSTTYPE)

über Defaultwert aus Feldeigenschaften

Ansprechpartner

ContactPerson

Anrede

Salutation.ContactPerson

Wird durch EVI Standardlogik generiert.

Briefanrede

LetterSalutation.ContactPerson

Wird durch EVI Standardlogik generiert.

Individuelle Anrede

ManualSalutation.ContactPerson

Immer fest auf true.

Notiz

Note

Es werden bis zu zwei Notizen zum Geschäftspartner (rCuNo) erzeugt

Betreff

NoteSubject.Note

Fest: "Notiz aus Schleupen"

Text

Note.Note

insert/update

Person

Notiz

Notizfeld an der Person

Betreff

NoteSubject.Note

Fest: "Bemerkung aus Schleupen"

Text

Note.Note

insert/update

Person

Bemerkung

Bemerkungsfeld an der Person

Kommunikation

Telecom

Ein Kommunikationsdatensatz Art = ERP zum Geschäftspartner.

Je Art (Tel, mobil, e-mail) wird die Televerbindung mit der größten Id übernommen.

Televerbindungen

Liste von Objekten vom Typ Televerbindung zur Angabe von bspw. Telefonnummer, Email-Adressen, etc.

Das Mapping der Televerbindung Type wird in einer Mappingmethode (SC12SCHLEUPENUTILS.getCommunicationType) fest hinterlegt mit Tel, mobil, e-mail und kann ggf. übersteuert werden. 

Televerbindungen

Type

Angabe des Typs der Televerbindung
Kürzel mit Länge 8 und Bezeichnung mit Länge 20
Beispiele:

• Tel – Telefon

• TelPriv – Telefon privat

• e-mail – Emailadresse

• Homepage – Internetseite

Televerbindungstypen können beliebig verwaltet werden.

Geschäftspartner

CustomerPk.Telecom

CUSTOMER

ID-1

ergibt sich aus Struktur des Datencontainers

Tel.Name

NameKey.Telecom

S_KEYTAB (TELECOMNAME)

wird mit dem Wert 'ERP' belegt

ID-2

Telefon Vorwahl

PhoneNoCity.Telecom

wenn Televerbindungen.Type = 'Tel' oder 'TelGesch' oder 'TelPriv'

insert/update

Televerbindungen

Vorwahl

Optionale Angabe einer Vorwahl

Telefon Rufnummer

PhoneNoBase.Telecom

wenn Televerbindungen.Type = 'Tel' oder 'TelGesch' oder 'TelPriv'

ℹFügt der User in EVI eine neue Kommunikation ein und trennt diese nach Land, Vorwahl, Rufnummer, Durchwahl auf, erhalten wir aus Schleupen nur Vorwahl und Anschluss zurück. Die übrigen Werte Land und Durchwahl werden bei Änderung geleert. Da die aus Schleupen gelieferte Kombination aus Vorwahl und Anschluss nicht CTI konform ist, wird folgende Sonderbehandlung implementiert. Es wird geprüft, ob die ersten Ziffern der Vorwahl einen Wert +xx oder 00xx beinhaltet (bspw. 0049, +49 für Deutschland). Dieser Wert wird gegen die EVI-Ländertabelle geprüft. Ist ein entsprechender Eintrag vorhanden (Ein Wert für Deutschland wird ausgeliefert) so wird der Wert im Feld *NoCountry.Telecom mit dem Wert aus der Ländertabelle gemapped. Dies wird einen Großteil der Rufnummern CTI konform wandeln, aber nicht alle Fälle abdecken.

insert/update

Televerbindungen

Anschluss

Wert der Televerbindung, z.B. Telefonnummer (mit und ohne Vorwahl), Email-Adressen, Internetseiten

Mobile Vorwahl

MobilePhoneCity.Telecom

wenn Type = 'mobil'

insert/update

Televerbindungen

Vorwahl

s.o.

Mobile Rufnummer

MobilePhoneBase.Telecom

wenn Type = 'mobil'

ℹ Logik analog Telefon Rufnummer

insert/update

Televerbindungen

Anschluss

s.o.

Email

Email.Telecom

wenn Type = 'e-mail'

insert/update

Televerbindungen

Anschluss

s.o.

Angezeigter Name

EmailDisplay.Telecom

wenn Type = 'e-mail'

Wert aus Email.Telecom

insert/update

Televerbindungen

Anschluss

s.o.

Adresse

Address

Es werden alle Adressen aus CS.VA zur Person nach EVI-GP übernommen (auch inhaltliche Dubletten). Das Attribut Anschrift.Art ist kein zuverlässig gepflegtes Feld in CS.VA und wird daher ignoriert.

Zuerst wird anhand der Id (Anschriften.Id = C12ISUADDRNUMBER.Address) am GP geprüft ob die Adresse schon existiert.

• Wenn ja, wird diese aktualisiert.

• Wenn nicht, wird über Land, PLZ, Ort, Ortsteil, Straße/Postfach, Hausnummer und Hausnummernergänzung geprüft, ob es die Adresse in EVI schon gibt ohne Adressnummer ERP (C12ISUADDRNR.Address). In diesem Fall wird die Anschriften.Id in C12ISUADDRNR.Address übernommen.

Anschriften

Liste von Objekten vom Typ Anschrift

ERP-Adress-Nr.

C12ISUADDRNUMBER.Address

ID

Anschriften

Id

Technischer Schlüssel des Datensatzes

Anzeigeadresse

DefaultCuAd.Address

Wird nur bei Neuanlage des GPs gesetzt. Die Anschrift mit der größten Anschrift.Id wird zur Anzeigeadresse.

insert

Postadresse

LetterCuAd.Address

Wird nur bei Neuanlage des GPs gesetzt. Die Anschrift mit der größten Anschrift.Id wird zur Postadresse.

insert

Hauptadresse

IsDefault.Address

Wird nur bei Neuanlage des GPs gesetzt. Wird analog Anzeigeadresse (DefaultCuAd.Address) gesetzt. Damit ist die Anzeigeadresse immer auch die Hauptadresse.

insert

Adressbezug

NameKey.Address

S_KEYTAB (ADDRNAME)

fest den Wert ERP.

insert/update

Adressart

AddressType.Address

S_KEYTAB (S_ADDRTYPE)

• Straße (Default)

• Postfach:  Wenn Postfach gefüllt, dann Postfach

• Großkunden: Wenn Postfach leer und Straße leer, dann Großkundenadresse

insert/update

Anschriften

Strasse

Postfach

s.u.

Land

CountryKey.Address

COUNTRY

Mapping gegen ISO-Kürzel, wenn leer prüfen auf Kürzel

Wenn Anschriften.Land=D oder DE, dann Deutschland,

sonst wenn Anschriften.Land.Kuerzel=D oder DE, Deutschland,

sonst leer.

insert/update

Anschriften

Land

Angabe des Landes der Anschrift

Kuerzel und Bezeichnung, ISO-Kürzel
 

Postleitzahl

ZIPKey.Address

insert/update

Anschriften

PLZ

Postleitzahl der Anschrift

Ort

City.Address

insert/update

Anschriften

Ort

Ort der Anschrift

Ortsteil

District.Address

insert/update

Anschriften

Ortsteil

Ortsteil der Anschrift

Strasse / Postfach

Street.Address

Wenn Anschriften.Postfach gefüllt, dann Wert aus Postfach verwenden, andernfalls Wert aus Anschriften.Strasse verwenden

insert/update

Anschriften

Strasse

Straße der Anschrift

insert/update

Anschriften

Postfach

Postfach, wenn es sich um eine Postfachanschrift handelt

Hausnummer

StreetNumber.Address

insert/update

Anschriften

Hausnummer

Hausnummer, wenn es sich um eine Straßenanschrift handelt

Hausnummerergänzung

StreetNumberAddition.Address

Wird hier kein Wert geliefert, ist der Wert in EVI zu leeren. 

insert/update

Anschriften

Hausnummerergaenzung

Ergänzung zur Hausnummer, welche sich aus den Schleupen-Feldern Hausnummernzusatz und Hausnummernteil zusammensetzt

Abw. Zusatz 1

CoName2.Address

insert/update

Anschriften

Zusatz

Weitere zusätzliche Angabe zur Anschrift