Versandwegsänderung
Neben der Durchführung über die Benutzeroberfläche können Sie als Kundenbetreuer eines Energieversorgers die Versandwegsänderung auch aus externen Systemen über den CRM-Konnektor anstoßen.
Hierfür steht folgender Endpunkt zur Verfügung:
POST /api/rechnungseinheitskonten/{rechnungseinheitskontoId}/versandweg/v3.1
Für die Versandwegsänderung werden folgende Parameter benötigt:
- PersonkontoID
- Versandweg
- Objekt: email
- bestehendeEmail
- emailId (UUID)
- ruecklaeuferschreibenerzeugen: true oder false
Über den CRM-Konnektor haben Sie darüber hinaus die Möglichkeit, die Gültigkeit einer E-Mail-Adresse auf Ebene der Kontaktwegverwendung über ein Verwendung-bis-Datum zu beenden.
Das ist insbesondere dann relevant, wenn bereits ein fehlgeschlagener Zustellversuch bekannt ist. Die betreffende E-Mail-Adresse kann damit für die jeweilige Verwendung gezielt beendet werden, ohne den Kontaktweg selbst auf Personenebene ungültig zu setzen. So bleiben die personenbezogenen Kontaktdaten erhalten und nachgelagerte Prozesse, beispielsweise Mahnläufe, werden nicht unnötig beeinträchtigt.
Die vollständige Beschreibung der Schnittstelle und der verfügbaren Funktionen finden Sie in der Dokumentation zur Schleupen CRM-Schnittstelle. Den Endpunkt für die Versandwegsänderung finden Sie dort im Bereich„Rechnungseinheitskonten“.
E-Mail auf ungültig setzen und abfragen von Vertragspartner und Rechnungsempfänger
E-Mail auf ungültig setzen
Auch nach einer bereits durchgeführten Versandwegsänderung können Sie als Kundenservicemitarbeiter die Verwendung einer E-Mail-Adresse über die jeweilige Personenrolle beenden, sofern dies nicht bereits im Zuge der Versandwegsänderung erfolgt ist.
Damit können notwendige Anpassungen auch nachträglich vorgenommen und der für die jeweilige Personenrolle gültige Kommunikationsweg entsprechend gesteuert werden.
Über den CRM-Konnektor kann hierfür ein Gültigkeitsende zur E-Mail-Adresse gesetzt werden. Die betreffende Kontaktwegverwendung wird über eingueltigBis-Datum zeitlich beendet.
Das Verwendungsende einer E-Mail-Adresse können Sie gezielt für die betroffene Personenrolle über folgende Endpunkte setzen:
- Vertragspartner
POST /api/rechnungseinheitskonten/{rechnungseinheitskontoId}/vertragspartner - Rechnungsempfänger
POST /api/rechnungseinheitskonten/{rechnungseinheitskontoId}/rechnungsempfaenger
Hinweis:
Dabei wird die Kontaktwegverwendung beendet. Die E-Mail-Adresse selbst bleibt an der Person gültig und kann somit weiterhin auf Personenebene bzw. für andere gültige Verwendungen genutzt werden.Diese Trennung ist insbesondere dann wichtig, wenn die E-Mail-Adresse grundsätzlich noch aktuell ist, es jedoch bei einer konkreten Verwendung zu Zustellproblemen gekommen ist. Meldet sich der Endkunde beispielsweise nach Erhalt des Rückläuferschreibens und soll die E-Mail-Adresse weiterhin genutzt werden, steht der Kontaktweg auf Personenebene weiterhin zur Verfügung.
Die detaillierte Beschreibung der beiden Endpunkte finden Sie ebenfalls in der Dokumentation zur Changelog – Schleupen.CS Developer Campus
Gültigkeit von Kontaktwegen erkennen
Als Kundenservicemitarbeiter können Sie über den CRM-Konnektor auch die aktuellen Daten und damit die Gültigkeit der hinterlegten Kontaktwege abfragen.
Je nachdem, welche Informationen Sie benötigen, stehen Ihnen folgende Endpunkte zur Verfügung:
- Ein einzelnes Rechnungseinheitskonto abfragen
- GET /api/rechnungseinheitskonten/{rechnungseinheitskontoId}
- Personenstammdaten anfragen
- /api/personen/{personId}/rechnungseinheitskonten
- Mehrere Rechnungseinheitskonten abfragen
- /api/rechnungseinheitskonten
Die genaue Beschreibung der Endpunkte und ihrer Verwendung finden Sie in der Dokumentation zur Schleupen CRM-Schnittstelle.