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 |
|
|
Wird im ersten Schritt in TINA nicht verarbeitet. Verarbeitung in Ausbaustufe. Installateur muss manuell über TINA Prozess geprüft werden. |
|
|
rolleDetail 2026.6 |
Schlüssel |
Ja, wenn im Aufruf rolle == Installateur und rolleDetail Firma oder VFK ist Sonst nicht |
|
- |
- |
- |
Wenn der Request mit Rolle == Installateur und rolleDetail == Firma oder VFK eingeht, muss in der Response eine Projektnummer (projectNo) mitgegeben werden. 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 |
|
login 2026.6 |
String |
Ja, wenn rolleDetail == VFK ist Sonst nicht |
|
- |
LoginName.C12PORTALLOG |
Login-Name |
Ist für die Firmenregistrierung/-prüfung erst einmal irrelevant, wird aber für die Anmeldung der Verantwortlichen Fachkraft (VFK) benötigt |
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).