Was passiert im Hintergrund?
Nach dem Start der Versandwegsänderung übernimmt der Vertragsprozess die weitere Verarbeitung automatisch. Dabei werden die benötigten Daten zunächst angereichert und validiert, anschließend die zulässigen Versandwege geprüft und die erforderlichen Änderungen an Person, Personenrollen und Rechnungseinheitskonto verarbeitet.
Sofern die Erstellung eines Rückläuferschreibens vorgesehen ist, wird zusätzlich die Dokumentenerzeugung angestoßen. Abschließend wird der Vertragsprozess beendet.
Der technische Ablauf umfasst folgende Verarbeitungsschritte:
- Vertragsprozess starten
Schleupen.CS.ksp.vpm.vpe.VertragsprozesseStartenActivityService#VertragsprozesseStarten - Event auslösen
vpm.rek.VersandwegAendernStartenEventService - Workflow starten
ksp.vpm.rek.VersandwegAendernProcessService
Der Workflow durchläuft anschließend folgende Schritte:
- Verarbeitung starten
Schleupen.CS.ksp.vpm.anr.VertragsprozessDatenAnreichernActivityService#VertragsprozessVerarbeitungStarten - Personenkonto validieren
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#PersonenkontenValidieren - Rechnungseinheitstarifoptionen prüfen
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#RechnungseinheitsTarifoptionenPruefen - ZD-Person ändern
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#ZDPersonAendern - Personen werden über Schleupen.CS.AP.ZD.Personen.PersonEntityService gelesen.
- Neue Kontaktwege werden bei Bedarf an den jeweiligen Personen angelegt.
- Personenrollen ändern
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#PersonenrollenAendern - Personenrollen werden über Schleupen.CS.AP.ZD.Personenrollen.PersonenrolleActivityService geladen.
- Kontaktwegverwendungen an den Personenrollen werden bei Bedarf über Schleupen.CS.AP.ZD.Personenrollen.PersonenrolleActivityService geändert.
- Rechnungseinheitskonto ändern
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#RechnungseinheitskontoAendern - Dokumente erzeugen
Die Dokumentenerzeugung erfolgt analog zu den weiteren Vertragsprozessen. - Vertragsprozess abschließen
Schleupen.CS.ksp.vpm.anr.VertragsprozessDatenAnreichernActivityService#VertragsprozessVerarbeitungAbschliessen
Details zu den Verarbeitungsschritten
Personenkonto validieren
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#PersonenkontenValidieren
Zunächst prüft das System, ob alle erforderlichen Personen-, Kontaktweg- und Rechnungseinheitskontodaten vollständig und eindeutig vorliegen.
- das zugehörige Rechnungseinheitskonto und die Personenrollen werden ermittelt und validiert
- ist kein eindeutiges Personenkonto vorhanden, wird das Vertragsprozessobjekt fehlerhaft bzw. zur manuellen Prüfung gegeben
- E-Mail-Änderungen müssen eindeutig einer Personenrolle zugeordnet sein:
- eine Person: fehlende Zuordnung erfolgt automatisch
- ,ehrere Personen: ist keine eindeutige Zuordnung möglich, wechselt der Prozess in InManuellerPruefung
- Ergebnis: Die Daten sind eindeutig zugeordnet und für die weitere Verarbeitung vorbereitet
Rechnungseinheitstarifoptionen prüfen
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#RechnungseinheitsTarifoptionenPruefen
Im nächsten Schritt prüft das System über den RechnungseinheitsTarifoptionenErmittelnActivityService, ob der gewünschte Versandweg für die Rechnungseinheit zulässig ist.
- Die Tarifoptionen bestimmen die verfügbaren Versandwege, z. B. Papier oder E-Mail.
- der gewünschte Versandweg wird mit den zulässigen Optionen abgeglichen.
- sind keine Tarifoptionen vorhanden, erscheint:
„Es konnten keine Rechnungseinheitstarifoptionen ermittelt werden.“ - wird der Versandweg nicht unterstützt, erscheint:
„Die Rechnungseinheitstarifoptionen unterstützen den Versandweg '…' nicht.“ - in beiden Fällen werden betroffene Vertragsprozessobjekte in Bearbeitung auf fehlerhaft gesetzt.
- Ergebnis: Der gewünschte Versandweg ist fachlich zulässig.
Rechnungseinheitskonto ändern
Schleupen.CS.ksp.vpm.rek.VersandwegAendernActivityService#RechnungseinheitskontoAendern
Ist der Versandweg zulässig, übernimmt der PersonenkontoAendernController die eigentliche Änderung.
- nur wenn sich neuer und aktueller Versandweg unterscheiden, wird das Rechnungseinheitskonto aktualisiert. Andernfalls erfolgt kein Schreibzugriff.
- für die sichere Änderung wird das Personenkonto gesperrt, aktualisiert und anschließend wieder freigegeben.
- kann das Konto nicht gesperrt werden, erscheint:
„Das Personenkonto konnte nicht gesperrt werden.“ - schlägt die Änderung fehl, erscheint:
„Das Personenkonto konnte nicht geändert werden.“ - betroffene Vertragsprozessobjekte werden im Fehlerfall als fehlerhaft markiert.
- Alter und neuer Wert werden in der Prozesshistorie protokolliert.
- Ergebnis: Der neue Versandweg ist am Rechnungseinheitskonto wirksam.
Nach erfolgreicher Verarbeitung können Sie als Anwender den neuen Versandweg unter Kundenserviceprozesse > Auskunft > Rechnungseinheitskonto anzeigen nachvollziehen.
Standardisiertes Rückläuferschreiben erzeugen
Haben Sie bei der Versandwegsänderung die Checkbox „Rückläuferschreiben erzeugen“ aktiviert, wird die Dokumentenerzeugung automatisch in den Prozess eingebunden.
Voraussetzung ist, dass das entsprechende Kennzeichen (Flag) für die Dokumentenerstellung an den Vertragsprozess übergeben wurde.
Die technische Verarbeitung der Dokumentenerzeugung erfolgt anschließend automatisiert. Eine detaillierte Beschreibung der einzelnen Verarbeitungsschritte finden Sie Vertragsprozesse – Schleupen.CS Developer Campus
Im Zuge der Dokumentenerzeugung werden die ETL-Tabellen für die Vertragsdokumente und das Rückläuferschreiben befüllt und die entsprechenden Änderungen übernommen.