Skip to main content
Skip table of contents

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). 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.