Angebotskalkulation mit AnKa-fix (AKF)
Voraussetzungen
Das Modul bietet eine Erweiterung des Geschäftskunden-Angebotsprozesses, daher muss die Lizenz EVI-RLM eingespielt sein.
Das Modul baut auf dem EVI-BASIS Modul auf, daher muss die Lizenz EVI-BASIS eingespielt sein.
Die globalen Variablen des AnKa-fix Moduls müssen eingerichtet werden.
Diverse Felder auf dem Angebot und dem Anlagenkonto müssen als Pflichtfelder gekennzeichnet sein.
Ggf. gibt es weitere Voraussetzungen für die Verwendung von AnKa-fix seitens Kisters, folgende sind bereits bekannt:
Für die Bearbeitung werden seitens AKF nur Firefox und Chrome unterstützt.
In AKF ist derzeit eine separate Anmeldung erforderlich und für jede Kalkulation müsste sich der Nutzer neu anmelden.
Wird LDAP eingesetzt, kann auch ein Single Sign On verwendet werden. Ansonsten kann durch das Speichern der Anmeldeinformationen im Browser die redundante Anmeldung umgangen werden.
Technische Dokumentation
Schnittstellentechnologie
Einsatz REST-Webservice für beide Richtungen (EVI ↔ AnKa-fix).
Asynchrone (bevorzugt) oder bei Bedarf synchrone Übertragung.
EVI-REST Services können nur SSL-verschlüsselt aufgerufen werden.
Der Aufruf erfolgt in beiden Systemen über einen technischen Benutzer.
Komponentenübersicht
Modul
EVI-AnKa-fix
Prozesse
Beim Einspielen des Moduls werden die Prozesse automatisch veröffentlicht, dennoch ist eine Prüfung des Veröffentlichungsstatus empfehlenswert. Entsprechende Hinweise werden auch beim Import des Moduls ausgegeben.
Skriptbibliothek
SC12AnkafixUtils
SC12EVIBaseUtils
SC0InterfaceUtils
Globale Variablen
C12VarianteVerwenden
C12AnkafixClientId
C12AnkafixClientSecret
C12AnkafixStatusURL
C12AnkafixTokenURL
C12AnkafixURL
Transaktionstabellen/Events
Event (C12Event) vom Typ QUOTE_CALCULATION
Ablaufbeschreibung
Durch die Standardschnittstelle zu Kisters AnKa-fix (AKF) wird die Kalkulation von Strom und Gas Angeboten mit Daten aus dem CRM-System im AKF durchgeführt und die kalkulierten Daten wieder im CRM eingespielt. Die Übertragung findet mittels REST-API statt.
Prozess | Startbedingung | Beschreibung |
---|---|---|
C12ANKAFIX_KALKULATION | Modul C12ANKAFIX ist vorhanden und Event "QUOTE_CALCULATION" wurde angelegt | Dieser BPM-Prozess sammelt die Daten aus EVI und überträgt diese per REST an AnKa-fix. Vorgelagert werden Pflichtfelder geprüft. Das Ergebnis wird als EventResult-Satz dokumentiert. |
C12ANKAFIX_ERGEBNIS | - | Dieser BPM-Prozess wird von AnKa-fix über REST aufgerufen, um die Kalkulationsergebnisse an EVI zu übertragen. Dieser Aufruf findet aus Sicht des EVI-Anwenders im Hintergrund statt. Das Ergebnis wird als EventResult-Satz dokumentiert. |
C12ANKAFIX_Benachrichtigung | EventResult-Satz mit SystemID = "ANKAFIX" && Subject = "Ergebnis Verarbeitung Kalkulationsergebnisse AnKa-fix" | Über diesen BPM-Prozess wird der EVI-Anwender über das Ergebnis der Anlieferung der Kalkulationsergebnisse von AnKa-fix an EVI (Prozess C12ANKAFIX_ERGEBNIS) informiert. |
ANKAFIX_STATUS | Modul C12ANKAFIX ist vorhanden und Event xxx wurde angelegt. | xxx kann folgende Werte haben: "SLP_QUOTE_ACCEPTED", "SLP_QUOTE_DECLINED", "SLP_QUOTE_EXPIRED" "RLM_QUOTE_ACCEPTED", "RLM_QUOTE_DECLINED", "RLM_QUOTE_EXPIRED" Über diesen BPM-Prozess wird das Ergebnis des Angebotsprozesses in EVI (angenommen, abgelehnt, abgelaufen) per REST an AnKa-fix kommuniziert. |
Die Angebotskalkulation mittels AKF wurde hierzu in den bereits bestehenden Geschäftskunden-Angebotsprozess eingearbeitet.
Sonstige Erweiterungen
AnKa-fix Webclient öffnen inkl. Kalkulation
Nach erfolgreichen Übertragung der Angebotsdaten aus dem CRM nach AKF kann über eine URL (ssl verschlüsselt) der AnKa-fix Webclient gestartet werden.
In der Rückgabe des Aufrufs Zählpunktkalkulation wird je Variante eine URL zurückgegeben und in der Variante hinterlegt.
Somit muss je Variante ein Browesertab geöffnet werden.
Seitens AKF werden nur Firefox und Chrome unterstützt.
Es ist eine separate Anmeldung in AKF erforderlich. Wenn LDAP verwendet wird kann auch Single Sign On eingesetzt werden. Für jede Kalkulation muss der Nutzer sich aktuell neu anmelden. Erleichterung: Anmeldeinformationen im Browser speichern.
Nach erfolgreicher Anmeldung kann der Nutzer wie gewohnt die Kalkulation anhand der übergebenen Daten manuell im AKF durchführen.
Pflichtfelder
Folgende Felder sind als Mussfeld gekennzeichnet sein, wenn das Modul AnKa-fix aktiv ist.
Entität | Feld | intern | Bedingung |
---|---|---|---|
Angebot | Sparte | C12Medium.Quote | |
Kalkulationsvorlage | C12CalcTempKey.Quote | ||
Bindefrist | C12BindingPerio.Quote | ||
Abgabe bis | C12DeliveryUnt.Quote | ||
Anlagenkonto | Netzebene | GridLevel.C12INSTACC | |
Spannungsebene | VoltageLevel.C12INSTACC | nur bei Strom Pflicht | |
Medium | Medium.C12INSTACC | ||
Messverfahren | MeasuringMethod.C12INSTACC | ||
Lastprofil | LoadProfile.C12INSTACC | ||
Jahresverbr. (progn.) | C12YearConsProg.C12INSTACC oder C12YearConsMeas.C12INSTACC | eines der beiden Felder muss gefüllt sein | |
Straße | Street.C12INSTACC | wenn Feld Anlage leer | |
PLZ | ZIP.C12INSTACC | wenn Feld Anlage leer | |
Ort | City.C12INSTACC | wenn Feld Anlage leer | |
Land | CountryKey.C12INSTACC | wenn Feld Anlage leer | |
Bundesland/Kanton | State.C12INSTACC | wenn Feld Anlage leer |
Preiskalkulation
Zu dem aktuell bestehendem Prozess "Preiskalkulation erzeugen" wurde ein zweiter, separater Prozess "Preiskalkulation inkl. Variante für AKF erzeugen" eingerichtet.
Der neue Prozess kann ebenfalls über den Button "Preiskalkulation erzeugen" in der Aktionsbox des Angebotes aufgerufen weden. Die Unterscheidung welcher Prozess aufgerufen wird, erfolgt automatisch im Maskenskript anhand der Globale Variable C12VarianteVerwenden.
Der Prozess startet mit der Abfrage der Laufzeiten, hierbei können bis zu 3 angegeben werden. Dabei wird sichergestellt, dass das Ende jeder Vertragslaufzeit mindestens 1 Tag nach Beginn ist. Für jede Vertragslaufzeit wird eine Variante angelegt.
Zu alle Anlagenkonten, die im Prozessschritt "Anlagenkonten verwalten" mit dem Angebot verknüpft wurden, werden hier unter Berücksichtigung der jeweiligen Variante die Preiskalkulationen erzeugt. Genauer bedeutet dies: werden dem Angebot 2 Anlagenkonten zugeordnet und 3 Varianten (Laufzeiten) gefüllt, so werden 6 Preiskalkulationen erzeugt. Die Aktion "Preiskalkulation erzeugen" kann beliebig oft wiederholt werden
Angebot kopieren
Bei der vorhandenen Aktion Angebot kopieren (Maske Angebot) wird folgendes ausgeführt:
Verknüpfung zu allen Anlagenkonten
alle Preiskalkulationen (wie gehabt)
Neu: Das Feld Variante (C12VARIANTPK.PriceCalc) wird auf die zuvor kopierte Variante aktualisiert, wenn Varianten benutzt werden (Globale Variable C12VarinteVerwenden = true).
alle Varianten wenn vorhanden (neu):
Feld | In Kopie | Anmerkung |
---|---|---|
Varianten ID | leeren | Kommt aus AKF |
Varianten Name | aus Org. übernehmen | Da nur auf Ebene Angebot kopiert wird, kann der Varianten Name gleich bleiben. |
URL-Variante | leeren | |
Angebot | Verweis auf neues Angebot | |
Lieferbeginn | aus Original übernehmen | |
Lieferende | aus Original übernehmen | |
Alle anderen Felder | leeren |
Preiskalkulation kopieren
Bei der Aktion Preiskalkulation kopieren (Maske Preiskalkulation) wird das Feld Variante (C12VARIANTPK.PriceCalc) ebenfalls mit kopiert, wenn Varianten benutzt werden (Globale Variable C12VarinteVerwenden = true).