ag.itc.registerCustomer
Registrierung des Portal-Benutzers. In TINA wird ein Portal-Login-Datensatz erzeugt. Sind der Ansprechpartner- und Geschäftspartner bekannt, werden diese Informationen automatisch im Portal-Login-Datensatz verknüpft. Andernfalls werden die Informationen in einem Zeitereignis zum Portal-Login-Datensatz festgehalten. Die Identifikation des Geschäfts- und Ansprechpartners erfolgt dann nachgelagert über entsprechende Prozesse.
Request
|
JSON-Attribut |
Datentyp |
Pflicht |
Anmerkungen |
Entität |
Feldname |
Feldname intern |
Anmerkungen |
|---|---|---|---|---|---|---|---|
|
login |
String(255) |
Ja |
|
Portal-Login |
Login-Name |
LoginName.C12PORTALLOG |
|
|
customerNo |
String(20) |
Nein |
Nein |
Geschäftspartner |
Kundennummer |
CustomerNo2.Customer |
|
|
contactID |
String(20) |
Nein |
Nein |
Ansprechpartner |
|
Pk.ContactPerson |
|
|
customerProfile |
Ja |
|
Geschäftspartner |
|
ag.itc.checkRegistration.customerProfile |
|
|
|
customerAddress |
Nein |
Standard Kundenadresse |
Geschäftspartner-Adresse |
|
|
Standardadresse des Geschäftspartners, muss nur gefüllt sein, im Fall Solarteur (egal ob der Geschäftspartner bekannt (customerProfile.pk gefüllt) oder unbekannt ist |
|
|
contactProfile |
Nein |
|
Ansprechpartner |
|
ag.itc.checkRegistration.contactProfile |
Wenn der Ansprechpartner bekannt ist mit PK, sonst ohne PK. |
|
|
rolle |
String(20) |
Nein |
Schlüsselliste analog getCustomer.rolle mit [INSTALLATEUR, SOLARTEUR, KUNDE] |
Portal-Login |
Rolle |
PortalRole.C12PORTALLOG |
|
|
installer |
Nein |
|
Installateursverzeichnis |
|
|
|
|
|
rolleDetail 2026.6 |
Schlüssel |
Ja, wenn im Aufruf rolle == Installateur und rolleDetail Firma oder VFK ist Sonst nicht |
Mögliche Werte
|
Wird lediglich vom Portal an TINA übergeben, TINA speichert diese Information nicht weg und liefert sie auf dem Rückweg demnach auch nicht an das Portal. |
- |
- |
Wenn der Request mit Rolle == Installateur und rolleDetail == Firma oder VFK eingeht, wird in der Response Projektnummer (projectNo) zurückgeliefert. Für die Werte SB und SV wird kein Projekt erzeugt. Hier wird ein Portal-Login für die übergebenen Informationen erzeugt. Es findet keine dedizierte Dublettenprüfung statt. |
|
login 2026.6 |
String |
Ja, wenn rolleDetail == VFK ist Sonst nicht |
|
- |
LoginName.C12PORTALLOG |
Login-Name |
|
Logik
Beim Aufruf des Service (anhand des request) muss in folgende drei Fälle unterschieden werden:
-
Geschäftspartner und Ansprechpartner bekannt
-
Geschäftspartner bekannt und Ansprechpartner unbekannt
-
Geschäftspartner und Ansprechpartner unbekannt
|
JSON-Objekt |
GP + AP bekannt |
GP bekannt, AP unbekannt |
GP + AP unbekannt |
|
customerProfile |
mit pk |
ohne pk mit: name1 (Firma), name2 (Zusatz) |
|
|
customerAddress |
Leer |
mit: postalCode (PLZ), city (Ort), street (Straße), houseNo (Hausnr.), houseNoAffix (Erg.) |
|
|
contactProfile |
mit pk |
ohne pk mit: name1 (Name), name2 (Vorname), email (E-Mail) |
|
Der Service aktualisieren oder erzeugen ein Portal-Login Datensatz wie folgt:
|
GP + AP bekannt |
GP bekannt, AP unbekannt |
GP + AP unbekannt |
|
Portal-Login am GP (CustomerPk.C12PORTALLOG) und AP (ContactPersonPk.C12PORTALLOG)
|
Portallogin am GP
|
Portallogin
|
|
Login-Name (LoginName.C12PORTALLOG) = login |
||
|
Portalname (PortalName.C12PORTALLOG) = wird fest auf ITC setzen |
||
|
Account Status (Accountstatus.C12PORTALLOG) = wird fest auf AKTIV setzen |
||
|
Registriert seit (RegisterDate.C12PORTALLOG) = Datum der initialen Registrierung |
||
|
Letzte Anmeldung (LastLogin.C12PORTALLOG) = Datum der letzten Anmeldung |
||
Sollte es bereits einen Portal-Login-Datensatz geben, wird dieser aktualisiert (wie bereits im Standard umgesetzt).
Behandlung von “rolleDetail”
Firma und VFK
Bei der Registrierung mit rolle == Installateur und rolleDetail == Firma oder VFK wird das customerProfile, contactProfile und die customerAddress im Aufruf weggelassen.
Stattdessen werden diese Informationen im installer-Objekt übergeben.
Beim Abruf von getCustomer mit anderen Rollen (!= Installateur) wird im installer nichts übergeben, customerProfile, contactProfile und customerAddress werden wie gehabt in der ersten Ebene übergeben.
Bei der Registrierung mit rolle == Installateur und rolleDetail != Firma, VFK wird das customerProfile, contactProfile und die customerAddress direkt im Aufruf mitgegeben und nicht unterhalb des installer-Objekts.
SB und SV
Abbildung der Rollen “Sachbearbeiter” (SB) und “Stellvertreter” (SV) im Installateurportal. Wird einer dieser Werte über das Attribut “rolleDetail” übergeben, entsteht in TINA kein Projekt. Für die Detail-Rolle erfolgt keine Übernahme dieser Information nach TINA, da sie hier irrelevant ist und die Rollenbehandlung durch das Portal übernommen wird.
Es erfolgt direkt die Anlage eines Portal-Login-Datensatzes.
|
Feldname intern |
Feld Anzeigename |
Wert |
Anmerkung |
|---|---|---|---|
|
CustomerPk.C12PORTALLOG |
Geschäftspartner
|
|
Es wird der Geschäftspartner mit dem übergebenen customerPk gesucht und im Portal-Login eingetragen. |
|
ContactPersonPk.C12PORTALLOG |
Ansprechpartner |
|
Es wird zum Geschäftspartner, dessen customerPk übergeben worden ist in jedem Fall ein neuer Ansprechpartner erzeugt, dieser enthält den im registerCustomer übergebenen Vornamen und Nachnamen (aus dem contactProfile) und wird im Anschluss in den Portal-Login eingetragen. Es findet keine dedizierte Dublettenprüfung statt. |
|
PortalName.C12PORTALLOG |
Portalname |
ITC - ITC PowerCommerce |
|
|
EventArchive.C12PORTALLOG |
Zeitereignis |
<Zeitereignis (EventArchive), das die Anlage des Projekts ausgelöst hat> |
|
|
AccountStatus.C12PORTALLOG |
Account Status |
AKTIV |
|
|
LoginName.C12PORTALLOG |
Login-Name |
loginName aus Registrierung (= Anmeldename im Portal) |
|
|
PortalRole.C12PORTALLOG |
Rolle |
Installateur |
|
|
RegisterDate.C12PORTALLOG |
Registriert seit |
NOW |
|