Firmenstammdatenänderung (Admin)

2026.9 TINA

Anwenderhandbuch: Firmenstammdaten ändern

Datenübermittlung

Die Übermittlung der Firmenstammdatenänderung aus dem Installateurportal erfolgt über den Service ag.itc.changeInstaller mit dem changeType FIRMENSTDAE

• Es werden ausschließlich geänderte Daten übergeben

• Nicht veränderte Daten werden im Aufruf weggelassen

• Wird ein Wert im Portal entfernt, wird der Wert als Leerstring (““) mitgesendet

• Der Primärschlüssel des Geschäftspartners (pk) wird immer mitgesendet und nicht als Änderung registriert

Bei einer “gemischten” Meldung mit Übermittlung prüfpflichtiger und nicht prüfpflichtiger Daten wird für die prüfpflichtigen Daten ein Projekt erzeugt und die nicht prüfpflichtigen Änderungen werden direkt in die Zieldatensätze geschrieben.

Für folgende Änderungen wird kein Projekt erzeugt, da sie als nicht prüfpflichtige Änderungen gelten

• Telefon (PhoneNoBase.Telecom)

• Mobil (MobilePhoneBase.Telecom)

• Fax (FaxNoBase.Telecom)

• E-Mail (Email.Telecom)

• Homepage/Webseite (Website.Telecom)

Projekterzeugung

Für folgende Änderungen wird ein Projekt erzeugt, da sie als prüfpflichtige Änderungen gelten

• Firmierung (Name1.Customer)

• Rechtsform (Legal.Customer)

• Adresse (Hauptadresse des Geschäftspartners)

• Betriebsart (EnterpriseType.Customer)

Sobald ein Projekt mit Projektart == FIRMSTDAE entsteht, wird auf dem zugehörigen Geschäftspartner das Flag CoVerified.Customer auf false gesetzt

Ablauf der Prüfung

Start der Prüfung einer Firmenstammdatenänderung

Aktionsboxeintrag “Firmenstammdaten prüfen” (Ordner: Installateurportal)

• der Eintrag ist aktiv, wenn Projektart == FIRMSTDAE && Projektstatus == 11 - Firma in Prüfung

  • andernfalls ist der Eintrag inaktiv

• mit Prozessstart öffnet sich eine Benutzeraktion

  • sofern in C12CurrentEmpl.Project (Aktueller Bearbeiter) des Projekts niemand eingetragen ist, wird der User der den Prozess gestartet hat, dort eingetragen

Datenabgleich

In der Benutzeraktion werden die bisherigen Stammdaten den geänderten Stammdaten gegenübergestellt

• es werden nur diejenigen Stammdaten angezeigt, bei denen es eine Änderung gab

• zusätzlich wird der login (Login-Name) aus dem der Änderung zugrundeliegenden Zeitereignis (ag.itc.changeInstaller) dargestellt

• ebenso wird das Anlagedatum dieses Zeitereignisses dargestellt

Dokumentenprüfung

Für die Firmenstammdatenänderung müssen zwingend Dokumente für Betriebshaftpflicht, Handwerkskarte, Gewerbeanmeldung im Portal hochgeladen werden

Die übermittelten Dokumente der o.g. Kategorien werden zur Überprüfung angezeigt. Sind mehrere Dokumente derselben Kategorie vorhanden, wird jeweils das aktuellste Dokument angezeigt. Zusätzlich ist optional der Upload eines Dokuments der Kategorie SONSTIGES möglich, das bei Vorhandensein ebenfalls zur Prüfung angezeigt wird.

Prozessabschluss

Mit Abschluss des Prozesses über einen der Schalter (Freigabe ablehnen, Korrektur anfordern, Freigabe erteilen) wird der Prüfungsstatus der Dokumente auf IsChecked.Document in den jeweiligen Dokumentendatensatz übernommen.

Ablehnung

Mit Ablehnung der Änderungen

• wird der Projektstatus auf “93 - Firmendatenänderung abgelehnt” gesetzt

• bleiben die bisherigen Geschäftspartnerdaten (inkl. Kommunikations- und Adressdaten) unverändert

• wird dem Sachbearbeiter ein Memotext-Feld zur Eingabe einer Begründung für die Ablehnung angezeigt. Es handelt sich hierbei um ein Pflichtfeld, es muss eine Begründung angegeben werden, andernfalls kann der Prozess nicht fortgesetzt werden

Mit Fortsetzen des Prozesses wird eine Portal-Aktivität erstellt

Es wird zudem automatisch eine E-Mail an den Antragssteller versendet

Genehmigung

Mit Genehmigung der Änderungen

• wird der Projektstatus auf Status 61 - Firma zugelassen gesetzt

• die geänderten Werte aus dem zugehörigen Zeitereignis (ag.itc.changeInstaller) in die jeweiligen Zielfelder auf dem Geschäftspartner übernommen

Handelt es sich um einen Gastinstallateur
(Installateurverzeichnis-Datensätze mit AdNoHomeGridOp.C12INSTDIR != leer UND HomeGridOp.C12INSTDIR != leer)

• es wird kein neuer Installateurvertrag benötigt und demnach auch keiner erstellt

• auf dem zugehörigen Geschäftspartner das Flag CoVerified.Customer auf true gesetzt

Für alle beim Geschäftspartner tätigen aktiven Vertrags-Installateure

• müssen alle Installateurverträge unter Verwendung der aktualisierten Stammdaten neu erzeugt werden

  • Die Dokumente werden mit dem Geschäftspartner verknüpft

  • das jeweilige Dokument für die einzelne verantwortliche Fachkraft wird mit dem jeweiligen Ansprechpartner verknüpft

  • Die Dokumente werden mit dem Projekt verknüpft.
    Auf den Dokumenten ist das Flag IsChecked.Document = false

• Der Installateurausweis für das Unternehmen muss ebenfalls neu generiert werden

• am Ende wird auf dem zugehörigen Geschäftspartner das Flag CoVerified.Customer auf true gesetzt

Nachbesserung erforderlich

Zuvor getätigte Kommentare aus der Dokumenten-Prüfseite werden in einer Zusammenfassung in derselben Reihenfolge wie die Kommentarfelder in ein Memotext-Feld übernommen. Der Text kann bearbeitet und ergänzt werden

Mit Abschluss des Prozessschrittes entsteht eine Portal-Aktivität. Diese ist verknüpft mit dem Geschäftspartner, dem Ansprechpartner und dem Prüfprojekt.

• Der Status des Projekts wird auf 31 (Dokumente nachreichen) gesetzt

• Gleichzeitig wird aus TINA automatisch eine E-Mail versendet

  • Empfänger: Der/die Inhaber, Mailadresse aus den Portal-Logins verwenden

  • Absender/Signatur: senderMailMatchCode

  • Betreff: Sprachvariable companyMasterData.audit.correction.mail.subject

    • Default DE: “Firmenregistrierung Installateurportal: Korrekturbedarf für Dokumente”

    • Default EN: “Your company registration in our installer portal: Documents need correction”

  • Text: Sprachvariable companyMasterData.audit.correction.mail.text

    • Default DE: “Für die Freischaltung Ihres Betriebs im Installateurportal sind Korrekturen an den Dokumenten erforderlich. Melden Sie sich unter <URL> im Portal an, um weiter Informationen zu erhalten.”
      Default EN: “Corrections to the documents are required to activate your business on the installer portal. Log in to the portal at <Globale Variable C0InstallerPortalUrl> to receive further information.”
      Die URL des Portals wird in den Systemeinstellungen konfiguriert, siehe Abschnitt Firmenstammdatenänderung (Admin) | Systemeinstellungen

• Die E-Mail ist als Aktivität am Projekt, am Geschäftspartner und an den Ansprechpartnern, die sie erhalten haben, verknüpft

• Kennzeichen für die Freischaltung der weiteren Funktionen (Anmeldung VFK, Meldungen, …) am Geschäftspartner wird nicht gesetzt: Das Feld “Firma geprüft” (CoVerified.Customer) bleibt false

Nachvollziehbarkeit von Änderungen

Für folgende Felder ist im Standard die Änderungshistorie aktiv

• Firmenname (Name1.Customer)

• Rechtsform (LegalForm.Customer)

• Straße (Street.Address)

• Hausnummer (StreetNumber.Customer)

• Postleitzahl (ZIP.Address)

• Ort (City.Address)

• Betriebsart (EnterpriseType.Customer)

• Telefon (PhoneNoBase.Telecom)

• Mobilnummer (MobilePhoneBase.Telecom)

• Fax (FaxNoBase.Telecom)

• E-Mail (Email.Telecom)

• Homepage (Website.Telecom)

Hierüber lassen sich die Änderungen an den einzelnen Werten nachvollziehen. Sofern auf einem der Bereiche die Kachel “Änderungshistorie” platziert ist, sind die Änderungen dort ebenfalls sichtbar.

Komponenten

Prozess

• Firmenstammdaten prüfen (C0StartCompanyMasterDataAudit)

Skriptklassen

• SC0ITCLogic

• SC0KeyUtils

• SC12ITCUtils

• SC14ProjectUtils

Systemeinstellungen

Abschnitt “ITC-Modul-Konfiguration”

Installateursportal-Url: Hier ist die Url zum Installateursportal zu hinterlegen. Diese wird in den Status-E-Mails über auslaufende Zulassungen, die an die verantwortlichen Fachkräfte (VFK) versendet werden, genutzt.