Angebot annehmen

Änderungsvorgang

Schleupen Webservice

Aufrufadresse (Beispiel)

Beschreibung

EVI Prozess

Auslösendes EVI-Event

Angebot annehmen

Anlage von Verträgen für Lieferantenwechsel und Neuanmeldung

http://{Servername}/Schleupen/IVP/SchnittstelleProzessanbindung/Vertragsanlage

Prozess zur Übermittlung eines in EVI angenommenen Angebots zur Vertragsneuanlage.

Bei Annahme eines Angebotes wird in EVI ein Event SLP_QUOTE_ACCEPTED oder QUOTE_APPROVED (aus PK-Prozesscockpit)
ausgelöst, welches auf die relevanten Daten in der Transaktionstabelle Quote (Angebote) verweist. Ein Event beinhaltet immer genau eine Angebot und ruft den jeweiligen Webservice in Schleupen auf. 

Angebot abschließen (Admin)

SLP_QUOTE_ACCEPTED,

QUOTE_APPROVED
(aus PK-Prozesscockpit)

Komponentenübersicht Verarbeitung

  • SC12SCHLEUPENCallUtils.isStartCheckEvi2Schleupen

  • SC12SCHLEUPENCallUtils.startEvi2Schleupen

    • SC12SCHLEUPENCallUtils.quPrepareChangeQuote

    • SC12SCHLEUPENCallUtils.quGetDataForPostCreateContract

    • SC12SCHLEUPENCallUtils.postCreateContract

Feldmapping

EVI

Schleupen CS.VA

Feldbezeichnung

techn. Feldbezeichnung

Schlüssel / Entität

Besonderheit

Feld der WSDL

Bemerkung

Preiskalkulation (PriceCalc)



Selektion der Preiskalkulation über C12QuotePk.PriceCalc

Gilt für alle folgenden Felder der Preiskalkulation:



Angebots-Nr.

Quoteno.Quote



ExternerIdentifier

Optionale Angabe eines Datensatzschlüssels des Vorsystems, welcher zu Identifikationszwecken an die Vorgänge im Schleupen-System übernommen werden soll

Lieferbeginn

C2CalcStart.PriceCalc



Vertragsbeginn

Datum, ab wann die Belieferung erfolgen soll; Wenn kein Wert angegeben wird, so erfolgt die Ermittlung anhand des nächstmöglichen Termins auf Basis der Kündigungsanfrage beim Vorlieferanten. Bei einer Neuanmeldung bzw. eines Lieferantenwechsels mit bereits erfolgter Kündigung muss der Vertragsbeginn angegeben werden.

Sparte

C12Medium.PriceCalc



Geschaeftsbereich

Die Angabe des Geschäftsbereichskürzels laut Schleupen.CS

Zählerummer

C12MeterNo.PriceCalc



Zaehlernummer

Nummer des Gerätes, für welches der Vertrag abgeschlossen werden soll (wird bei unregulierten Sparten nicht gebraucht)

Liefersituation

C12DelSituation.PriceCalc


Key

Transaktionsgrund

Angabe eines gültigen Kürzels laut Definition UTILMD für den Transaktionsgrund, welcher in der Marktkommunikation genutzt wird
Wenn kein Wert übergeben wird, so wird

  • E01 genutzt, wenn kein Wert im Feld Vorlieferant gesetzt ist

  • E03 genutzt, wenn ein Wert im Feld Vorlieferant gesetzt ist

Marktpartnernummer

SupplierNumber.PriceCalc


Wenn leer, "*" übertragen.

Lieferantenschluessel

Angabe eines Schlüsselwertes, welcher zur Identifikation des Energiehändlerkontos verwendet wird. Die Zuordnung eines Kontos zu einem Schlüsselwert erfolgt über einen Konfigurationsdialog.

Vertragskonto-Nr

ContAccountNo.ContractAccount


Über C12ContractAcc.PriceCalc
auf den Datensatz Vertragskonto.

RechnungseinheitId

Optionale Angabe der Id einer Rechnungseinheit, wenn eine bestehende Rechnungseinheit für die Vertragsanlage genutzt werden soll

Service ID

Serviceid.C12SERVPROV


Über C12ActSupplier.PriceCalc
auf den Datensatz Serviceprovider.

Vorlieferant

Angabe der Marktnummer (VDEW, ILN) des Vorlieferanten. Bei Neueinzug erfolgt hier keine Angabe. Für einen Lieferantenwechsel ist es ein Pflichtfeld.




info wird nicht gefüllt.

VorlieferantEIC

Angabe des Bilanzkreises des Vorlieferanten. Wenn hier keine Angabe erfolgt, müssen die Energiehändlerkonten in Schleupen.CS eindeutig über die Identifikationsnummer ermittelbar sein.

Vertragsnummer

C12ActSupContNr.PriceCalc



VorlieferantKundennummer

Kundennummer beim Vorlieferant




info wird nicht gefüllt (siehe Standardwert)

VorlieferantKuendigen

Gibt an, ob dem Vorlieferant eine Kündigung geschickt werden soll.

  • Wert „J“: Kündigung auslösen, Bedingung, es handelt sich um einen Lieferantenwechsel, d.h. das Element Vorlieferant ist gefüllt

  • Wert „N“: keine Kündigung auslösen, ebenfalls nur bei einem Lieferantenwechsel relevant; in diesem Fall ist bspw. die Kündigung durch den Kunden selbst bereits erfolgt

Standardwert: „J“, wenn Vorlieferant gefüllt ist




info wird akt. nicht gesetzt (optional)

Aussteuerkennzeichen

Aussteuerkennzeichen an der Rechnungseinheit, welches hinterlegt werden soll




info wird akt. nicht gesetzt (optional)

Abschlagshoehe

Höhe des Abschlags zum Zeitpunkt der Vertragsanlage

Tarif (C12RATETYPE) und Serviceprovider (C12SERVPROV)





Tarifzeitscheibe

AB 26.1

Shortcut.C12RATETYPE


Über C12RateTimeSlPk.PriceCalc weiter auf C12RTIMESL. Über RateTypePk.C12RTIMESL auf C12RATETYPE

Tarifkuerzel

Kürzel des Tarifs, welcher für den Vertragsabschluss genutzt werden soll

Service ID

Serviceid.C12SERVPROV


Über C12GridOperator.PriceCalc
auf den Datensatz Serviceprovider.

Netzbetreiber

Angabe der Marktnummer (VDEW, ILN) des Netzbetreibers

(wird bei unregulierten Sparten nicht gebraucht)

Anlagenkonto (C12INSTACC)



Selektion Anlagenkonto über C1InstAccPk.PriceCalc.

Gilt für alle folgenden Felder des Anlagenkontos:

Abnahmestelle

Adressdaten der Abnahmestelle

Anschlussobjekt-Nr.

ReferenceNumber.Location


Vom Anlagenkonto über InstallationPk.C12INSTACC auf Anlage. Über LocationPk.Installation auf Anschlussobjekt.


  • Wird gesetzt, wenn Anschlussobjekt vorhanden, sonst werden die Adressfelder gefüllt (s.u.).

Abnahmestelle.Id

Technischer Schlüssel der Abnahmestelle, wenn bekannt Wenn ein Wert angegeben wird, dann ist keine Angabe der Fachdaten notwendig. Es wird die Abnahmestelle laut Id-Wert genutzt. Wenn kein Wert angegeben wird, so übernimmt der Vertragsdatenmanager die Identifikation der Abnahmestelle anhand der Fachdaten des Vorgangs und legt ggf. eine neue Abnahmestelle an.

PLZ

ZIP.C12INSTACC


*

Abnahmestelle.PLZ

Postleitzahl der Abnahmestelle

Ort

City.C12INSTACC


*

Abnahmestelle.Ort

Ort der Abnahmestelle

Ortsteil

District.C12INSTACC


*

Abnahmestelle.Ortsteil

Ortsteil der Abnahmestelle

Strasse

Street.C12INSTACC


*

Abnahmestelle.Strasse

Strasse der Abnahmestelle

Hausnummer

.C12INSTACC + StreetNoAdd.C12INSTACC



Hausnummer und Zusatz werden zusammen übergeben

Abnahmestelle.Hausnummer

Hausnummer der Abnahmestelle




info wird nicht gefüllt (optional).

ZaehlerstandHT

Angabe eines Zählerstandes für das ET bzw. HT Zählwerk




info wird nicht gefüllt (optional).

ZaehlerstandNT

Angabe eines Zählerstandes für das NT Zählwerk

AB 26.3 Jahresverbr. (progn.)

YearConsProg.C12INSTACC



PrognoseHT

Angabe des jüngsten prognostizierten Jahresverbrauchs ET bzw. HT

AB 26.3Jahresverbr. NT(progn.)

YearConsProgNT.C12INSTACC



PrognoseNT

Angabe des jüngsten prognostizierten Jahresverbrauchs NT

Geschäftspartner (Customer)



Selektion Geschäftspartner über DefaultCustomer.Quote

Gilt für alle folgenden Felder des Geschäftspartners:

Vertragspartner

Personendaten des Vertragspartners

ERP-Nummer

CustomerNo2.Customer

info Aktuell muss der Geschäftspartner eine ERP-GP-Nr. (PIN; CustomerNo2.Customer) haben. Andernfalls läuft der Aufruf CS.VA-seitig in einen Fehler.

Da aktuell immer alle GPs bei der Neuanlage übertragen werden, sollten alle auch eine PIN haben.

Sollten zukünftig (Ausbaustufe) nicht alle GPs nach CS.VA übertragen werden, muss der GP vorab über den Service Änderung und Neuanlage von Kundenstammdaten erzeugt werden (inkl. direkte Bereitstellung der PIN). Andernfalls würden GP-Dubletten erzeugt.

Vertragspartner.PIN

Die PIN der Person




Die Attribute werden nicht gesetzt. Details s.o. bei ERP-Nummer

Vertragspartner.Art, .Anrede, .Titel, .Geburtsdatum, .Vorname, .Name, .Zusatz1, .Zusatz2

Vertragspartner.Televerbindungen…

Vertragspartner.AllgemeineAnschrift…


ERP-Nummer

CustomerNo2.Customer

über “Abw. Rechn. Empf.“ (C12AbwRechempf.PriceCalc) wenn gefüllt, sonst leer.

Wenn ein vorhandenes Vertragskonto gewählt wurde, wird dieser ebenfalls hier nicht gesetzt (siehe RechnungseinheitId).

info allgemein zum Thema PIN s.o. Vertragspartner.PIN

AbweichenderRechnungsempfaenger

Datentyp Person

Personendaten eines abweichenden Rechnungsempfängers

Rechnungsanschrift


Selektion mehrstufig:

  1. Rechnungsadresse aus Vertragskonto über Preiskalkulation (C12ContractAcc.PriceCalc => C12InvAddress.ContractAccount)

  2. Alternativ Postadresse aus Abw. Rechnungsempfänger
    (C12AbwRechempf.PriceCalc)

  3. Alternativ Postadresse des Vertragspartners (Geschäftspartner aus Angebot (C12QuotePk.PriceCalc => DefaultCustomer.Quote)

Rechnungsanschrift

Anschriftsdaten des Vertragspartners; wenn AbweichenderRechnungsempfänger gefüllt ist, dann dessen Anschriftsdaten

PLZ

ZIPKey.Address



Rechnungsanschrift.PLZ

Postleitzahl der Anschrift

Ort

City.Address



Rechnungsanschrift.Ort

Ortsangabe der Anschrift





Rechnungsanschrift.Ortsteil

Angabe des Ortsteiles

Strasse

Street.Address


Wenn AddressType.Address !=POSTFACH

Rechnungsanschrift.Strasse

Straßenangabe der Anschrift




Wenn AddressType.Address=POSTFACH

Postfach

Angabe des Postfachs

Hausnummer

StreetNumber.Address


Wenn AddressType.Address != POSTFACH

Rechnungsanschrift.Hausnummer

Hausnummernangabe der Anschrift

Hausnummer Zusatz

StreetNumberAddition.Address


Wenn AddressType.Address != POSTFACH

Rechnungsanschrift.Hausnummernzusatz


Land

CountryKey.Address



Rechnungsanschrift.Land

Landeskürzel der Anschrift (z.B. D für Deutschland) Standardwert: D

Bankverbindung (MIT Vertragskonto in Preiskalkulation)

info entfällt, wenn RechnungseinheitId übertragen wurde. Dort ist die BV bereits vorhanden

BankAccount

Selektion Bankverbindung aus Vertragskonto über Preiskalkulation (C12ContractAcc.PriceCalc => KtoIDEingang.ContractAccount / KtoIDAusgang.ContractAccount)

info Wenn als EZ und AZ unterschiedliche Bankverbindungen hinterlegt sind, werden zwei Objekte vom Typ Bankverbindung erzeugt. Wenn nur EZ oder nur AZ gepflegt ist entsprechend nur ein Objekt.

Liste Bankverbindungen vom Typ Bankverbindung

Angabe der Bankverbindungsdaten für Abbucher



  • FG: Wenn KtoIDEingang.ContractAccount == KtoIDAusgang.ContractAccount

  • FO: KtoIDEingang.ContractAccount != KtoIDAusgang.ContractAccount UND KtoIDEingang.ContractAccount gefüllt

  • GH: KtoIDEingang.ContractAccount != KtoIDAusgang.ContractAccount UND KtoIDAusgang.ContractAccount gefüllt

Bankverbindung.Art

Mögliche Werte:

FG – Forderungen und Guthaben

FO – nur Forderungen

GH – nur Guthaben

Default: FG

IBAN

IBAN.BankAccount



Bankverbindung.IBAN

Angabe der IBAN der Bankverbindung

BIC

BIC.BankHouse


über BICKey.BankAccount

Bankverbindung.BIC

Angabe der BIC der Bank Wenn es sich nicht um eine deutsche IBAN handelt, muss die BIC angegeben werden

Bankleitzahl

BLZ.BankHouse



Bankverbindung.BLZ

Angabe der Bankleitzahl Wenn es sich nicht um eine deutsche IBAN handelt, muss die Bankleitzahl angegeben werden.

Kontoinhaber

AccOwner.BankAccount


Logik zum Füllen Abw. Kontoinhabers + Flag fehlt noch warning

Bankverbindung.Inhaber

Angabe des Abweichenden Inhabers der Bankverbindung

Bankverbindung (OHNE Vertragskonto in Preiskalkulation)

BankAccount

Kein Vertragskonto in Preiskalkulation (C12ContractAcc.PriceCalc) hinterlegt


Angabe der Bankverbindungsdaten für Abbucher




info Fest auf FG

Bankverbindung.Art

Mögliche Werte:

FG – Forderungen und Guthaben

FO – nur Forderungen

GH – nur Guthaben

Default: FG

IBAN

C12IBAN.PriceCalc



Bankverbindung.IBAN

Angabe der IBAN der Bankverbindung

BLZ

C12BANK_KEY.PriceCalc


info nur gefüllt, wenn Bank bereits vorhanden in Entität Bank

Bankverbindung.BLZ

Angabe der Bankleitzahl Wenn es sich nicht um eine deutsche IBAN handelt, muss die Bankleitzahl angegeben werden.

BIC

BIC.BankHouse


über C12BICKey.PriceCalc auf Bank

info Aktuell können nur IBANs bzw. BICs erfasst werden, bei denen es die Bank / BIC bereits im System gibt.

Bankverbindung.BIC

Angabe der BIC der Bank Wenn es sich nicht um eine deutsche IBAN handelt, muss die BIC angegeben werden

Kontoinhaber

C12AccOwner.PriceCalc


info aktuell wird für CS.VA im Angebotsprozess der Abw.-Kontoinhaber gepflegt und wenn gefüllt nach CS.VA übertragen. In einer Ausbaustufe soll dies an den Prozess “Bankverbindung ändern” angeglichen werden.

Bankverbindung.Inhaber

Angabe des Inhabers der Bankverbindung

Gilt immer (mit und ohne Vertragskonto in Preiskalkulation









info fest auf AR

Bankverbindung.Zweck

Mögliche Werte:
AR – Abschläge und Rechnungen
AB – nur Abschläge
RE – nur Rechnungen
Default: AR




info wird aktuell nicht gesetzt.

Bankverbindung.Kontonummer

Angabe der Kontonummer
Wenn es sich nicht um eine deutsche IBAN handelt, muss die Kontonummer angegeben werden.




info wird nicht gesetzt (siehe Standardwert)

Bankverbindung.GueltigAb

Datum, ab wann die Bankverbindung gültig ist und somit verwendet werden kann Format: yyyy-MM-dd Beispiele: 2019-12-31

Standardwert: Datum zum Zeitpunkt der Anlage des Prozesses




info wird aktuell nicht gesetzt.

Bankverbindung.GueltigBis

Datum, bis wann die Bankverbindung gültig ist und somit verwendet werden kann
Format: yyyy-MM-dd
Beispiele: 2019-12-31




info wird aktuell nicht gefüllt

Bankverbindung.AbwKontoinhaber

Objekt Typ Person

Angabe des Kontoinhabers, wenn dieser vom Vertragspartner abweicht




info wird aktuell nicht gesetzt.

Bankverbindung.AbwKontoinhaber.PIN

Angabe des Kontoinhabers, wenn dieser vom Vertragspartner abweicht




info wird aktuell nicht gesetzt.

Bankverbindung.Bankname

Name der Bank

Abrechnungsdatenfelder




Liste von Objekten vom Typ Abrechnungsfeldwert


Optionale Angabe von Abrechnungsfeldwerten, welche an den Vertrag übernommen werden sollen

Feldreferenz

FieldReference.BillContFields



Abrechnungsfeldwert.Feldreferenz

Feldreferenz, welche das Abrechnungsfeld des Tarifs identifiziert, für welches ein Wert an den Vertrag gesetzt werden soll

Wert

BillingValue.BillContFields



Abrechnungsfeldwert.Wert

Wert, welcher für dieses Abrechnungsfeld am Vertrag gesetzt werden soll