Änderung von Bankverbindungen | CURSOR Help Center

Änderungsvorgang	Schleupen Webservice	Aufrufadresse (Beispiel)	Beschreibung	EVI Prozess	Auslösendes EVI-Event
Bankverbindung ändern	Änderung von Bankverbindungen	http://{Servername}/Schleupen/IVP/SchnittstelleProzessanbindung/Person/{PIN_der_Person}/ Bankverbindung/	Prozess zur Übermittlung einer in EVI durchgeführten Änderung einer Bankverbindung. Es wird in EVI ein Event SLP_CHANGE_BANKDATA ausgelöst, welches auf die relevanten Daten in der Transaktionstabelle C12EDITBANKA verweist. Ein Event beinhaltet immer genau einen Transaktionsdatensatz und ruft den jeweiligen Webservice in Schleupen auf. Es werden aktuell nur IBANs beginnend mit DE…unterstützt. Ausländische Bankverbindungen bitte direkt in CS.VA erfassen.	Bankverbindung ändern	SLP_CHANGE_BANKDATA

Änderungsvorgang

Schleupen Webservice

Aufrufadresse (Beispiel)

Beschreibung

EVI Prozess

Auslösendes EVI-Event

Bankverbindung ändern

Änderung von Bankverbindungen

http://{Servername}/Schleupen/IVP/SchnittstelleProzessanbindung/Person/{PIN_der_Person}/ Bankverbindung/

Prozess zur Übermittlung einer in EVI durchgeführten Änderung einer Bankverbindung.

Es wird in EVI ein Event SLP_CHANGE_BANKDATA ausgelöst, welches auf die relevanten Daten in der Transaktionstabelle C12EDITBANKA verweist. Ein Event beinhaltet immer genau einen Transaktionsdatensatz und ruft den jeweiligen Webservice in Schleupen auf.

warning Es werden aktuell nur IBANs beginnend mit DE…unterstützt. Ausländische Bankverbindungen bitte direkt in CS.VA erfassen.

Bankverbindung ändern

SLP_CHANGE_BANKDATA

Komponentenübersicht Verarbeitung

SC12SCHLEUPENCallUtils.isStartCheckEvi2Schleupen
SC12SCHLEUPENCallUtils.startEvi2Schleupen
- SC12SCHLEUPENCallUtils.ebGetDataFprChangeEditBank
- SC12SCHLEUPENCallUtils.postChangeEditBank

Feldmapping

EVI				Schleupen CS.VA
Feldbezeichnung	techn. Feldbezeichnung	Schlüssel / Entität	Besonderheit	Feld der WSDL	Bemerkung
Eingangszahlweg (EZ/AZ) für Bankeinzug (AZ, wenn “Ein- und Auszahlungsweg gleich”). Fall: neue Bankverbindung EZ/AZ			Wenn “Zahlungsweg EZ” (PaymentTypeIn.C12EDITBANKA) = BANKEINZUG	Bankverbindungen	Liste von Objekten vom Typ Bankverbindung
BIC EZ	BIC.BankHouse BICKeyIn.C12EDITBANKA		Aus BIC.BankHouse, wenn BankAccIn.C12EDITBANKA und BICKey.BankAccount gefüllt (Bank vorhanden), sonst BICKeyIn.C12EDITBANKA (Bank nicht vorhanden)	BIC	Angabe der BIC der Bank Wenn es sich nicht um eine deutsche IBAN handelt, muss die BIC angegeben werden
Bankname EZ	BankName.BankHouse		Aus BankName.BankHouse, wenn BankAccIn.C12EDITBANKA und BICKey.BankAccount gefüllt (Bank vorhanden), sonst leer (Bank nicht vorhanden)	Bankname	Name der Bank
IBAN EZ	IBAN.BankAccount IBANIn.C12EDITBANKA		Aus IBAN.BankAccount, wenn BankAccIn.C12EDITBANKA gefüllt (Konto vorhanden), sonst IBANIn.C12EDITBANKA	IBAN	Angabe der IBAN der Bankverbindung
Kontoinhaber EZ	AccOwner.BankAccount AccOwnerIn.C12EDITBANKA		Nur Inhaber setzen, wenn Flag “Abw. Kontoinhaber EZ” gesetzt (DiffAccOwnIn.C12EDITBANKA = true): Aus AccOwner.BankAccount, wenn BankAccIn.C12EDITBANKA gefüllt (Konto vorhanden), sonst AccOwnerIn.C12EDITBANKA (Konto nicht vorhanden)	Inhaber	Angabe des Inhabers der Bankverbindung Erg. CURSOR: Ist der Abw. Kontoinhaber und damit nur gesetzt, wenn der Kontoinhaber abweichend zur Person ist.
Gültig ab EZ	ValidFromIn.C12EDITBANKA			GueltigAb	Datum, ab wann die Bankverbindung gültig ist und somit verwendet werden kann Format: yyyy-MM-dd Beispiele: 2019-12-31
	InOutSame.C12EDITBANKA		“Ein- und Auszahlungsweg gleich” (InOutSame.C12EDITBANKA) = TRUE, dann FG, sonst: FO	Art	Mögliche Werte: FG – Forderungen und Guthaben FO – nur Forderungen GH – nur Guthaben Default: FG
Eingangszahlweg (EZ) NICHT Bankeinzug Fall: EZ Bankverbindung beenden			Wenn “Zahlungsweg EZ” (PaymentTypeIn.C12EDITBANKA) != BANKEINZUG (BAR, UEBERWEISUNG, KEINE) ODER beenden der alten Bankverbindung, wenn eine neue Bankverbindung erfasst wurde. In diesem Fall werden zwei Bankverbindungsobjekte übertragen	Bankverbindungen	Liste von Objekten vom Typ Bankverbindung
IBAN EZ	IBAN.BankAccount		Aus IBAN.BankAccount über ContractAccPk.C12EDITBANKA => KtoIDEingang.ContractAccount (altes Konto)	IBAN	Angabe der IBAN der Bankverbindung die Beendet werden soll
Gültig ab EZ	Freedate1.ContractAccount ggf. Feld in den Moduleinstellungen sichtbar machen.		Aus Freedate1.ContractAccount über ContractAccPk.C12EDITBANKA => KtoIDEingang.ContractAccount (altes Konto)	GueltigAb	Datum, ab wann die Bankverbindung gültig ist und somit verwendet werden kann Format: yyyy-MM-dd Beispiele: 2019-12-31
gültig ab EZ	ValidFromIn.C12EDITBANKA		ValidFromIn.C12EDITBANKA	GueltigBis	Datum, bis wann die Bankverbindung gültig ist und somit verwendet werden kann Format: yyyy-MM-dd Beispiele: 2019-12-31
Ausgangszahlweg (AZ) für Überweisung Fall: neue Bankverbindung AZ			EZ nicht gleich AZ (AZ=Überweisung) Wenn “Ein- und Auszahlungsweg gleich” (InOutSame.C12EDITBANKA) = FALSE und wenn “Zahlungsweg AZ” (PaymentTypeOut.C12EDITBANKA) = ÜBERWEISUNG	Bankverbindungen	Liste von Objekten vom Typ Bankverbindung
BIC AZ	BIC.BankHouse BICKeyOut.C12EDITBANKA		Aus BIC.BankHouse, wenn BankAccOut.C12EDITBANKA und BICKey.BankAccount gefüllt (Bank vorhanden), sonst BICKeyOut.C12EDITBANKA (Bank nicht vorhanden)	BIC	Angabe der BIC der Bank Wenn es sich nicht um eine deutsche IBAN handelt, muss die BIC angegeben werden
Bankname AZ	BankName.BankHouse		Aus BankName.BankHouse, wenn BankAccOut.C12EDITBANKA und BICKey.BankAccount gefüllt (Bank vorhanden), sonst leer (Bank nicht vorhanden)	Bankname	Name der Bank
IBAN AZ	IBAN.BankAccount IBANOut.C12EDITBANKA		Aus IBAN.BankAccount, wenn BankAccOut.C12EDITBANKA gefüllt (Konto vorhanden), sonst IBANOut.C12EDITBANKA	IBAN	Angabe der IBAN der Bankverbindung
Kontoinhaber AZ	AccOwner.BankAccount AccOwnerOut.C12EDITBANKA		Nur Inhaber setzen, wenn Flag “Abw. Kontoinhaber AZ” gesetzt (DiffAccOwnOut.C12EDITBANKA = true): Aus AccOwner.BankAccount, wenn BankAccOut.C12EDITBANKA gefüllt (Konto vorhanden), sonst AccOwnerOut.C12EDITBANKA (Konto nicht vorhanden)	Inhaber	Angabe des Inhabers der Bankverbindung Erg. CURSOR: Ist der Abw. Kontoinhaber und damit nur gesetzt, wenn der Kontoinhaber abweichend zur Person ist.
Gültig ab AZ	ValidFromOut.C12EDITBANKA			GueltigAb	Datum, ab wann die Bankverbindung gültig ist und somit verwendet werden kann Format: yyyy-MM-dd Beispiele: 2019-12-31
			fest GH	Art	Mögliche Werte: FG – Forderungen und Guthaben FO – nur Forderungen GH – nur Guthaben Default: FG
Ausgangszahlweg (AZ) NICHT Überweisung Fall: AZ Bankverbindung beenden			EZ nicht gleich AZ (AZ!=Überweisung) Wenn “Ein- und Auszahlungsweg gleich” (InOutSame.C12EDITBANKA) = FALSE und wenn “Zahlungsweg AZ” (PaymentTypeOut.C12EDITBANKA) != ÜBERWEISUNG (BAR, BANKEINZUG, KEINE)	Bankverbindungen	Liste von Objekten vom Typ Bankverbindung
IBAN AZ	IBAN.BankAccount		Aus IBAN.BankAccount über ContractAccPk.C12EDITBANKA => KtoIDAusgang.ContractAccount (altes Konto)	IBAN	Angabe der IBAN der Bankverbindung die Beendet werden soll
Gültig ab AZ	Freedate2.ContractAccount ggf. Feld in den Moduleinstellungen sichtbar machen.		Aus Freedate2.ContractAccount über ContractAccPk.C12EDITBANKA => KtoIDAusgang.ContractAccount (altes Konto)	GueltigAb	Datum, ab wann die Bankverbindung gültig ist und somit verwendet werden kann Format: yyyy-MM-dd Beispiele: 2019-12-31
gültig ab AZ	ValidFromIn.C12EDITBANKA		ValidFromIn.C12EDITBANKA	GueltigBis	Datum, bis wann die Bankverbindung gültig ist und somit verwendet werden kann Format: yyyy-MM-dd Beispiele: 2019-12-31
Wird immer übertragen (für EZ und AZ)
Vertragskonto-Nr.	ContAccountNo.ContractAccount		Aus ContAccountNo.ContractAccount über ContractAccPk.C12EDITBANKA	RechnungseinheitId	Angabe der Id der Rechnungseinheit, wenn die Bankverbindung für den Zahlungsverkehr dieser Rechnungseinheit genutzt werden soll
2026.3 Brief erzeugen	PrintLetter.C12EDITBANKA	Boolean	true = “J”, false = “N”	BriefErzeugen	Gibt an, ob ein Brief zur Bankverbindungsänderung abgestellt werden soll. Wenn nicht angegeben, werden die Druckeinstellung aus CS.VA genutzt. Mögliche Werte: • ‚J‘ – Ja, Brief wird abgestellt • ‚N‘ – Ja, Brief wird nicht abgestellt
2026.3 Formularvorlage	PrintTemplate.C12EDITBANKA	Schlüssel	Muss aus Schleupen angelegt werden	BriefdruckFormular oder BriefFormular	Das Kürzel des zu verwendenden Briefformulars. Wenn nicht angegeben, werden die Druckeinstellung aus CS.VA genutzt. Zeichenkette (20)
2026.3 Druckdatum	PrintDate.C12EDITBANKA	Datum	Muss in der Zukunft liegen	BriefdruckDatum	Das gewünschte Druckdatum des Briefes. Muss in der Zukunft liegen. Format: yyyy-MM-dd Beispiele: 2019-12-31
				Response
EventResult	Description.C12EVENTRES		Übernahme der Location bei erfolgreicher Übermittlung	location	Antwort-Kopf wird im Element „Location“ die relative Adresse zur Abfrage des Prozessstatus übermittelt
				Fehlertext
				Status

Beispiele aus Schleupen Dokumentation

Beispieldatensatz für die Anlage einer Bankverbindung mit Zuordnung zu einer Rechnungseinheit

Das Beispiel erzeugt eine neue Bankverbindung an einer Person und ordnet diese der Rechnungseinheit zu. Wenn die Bankverbindung bereits existiert, wird nur die Zuordnung hergestellt.

Content-Type: application/sag.bankverbindungsaenderung.v1+json
[
  {
    "IBAN": "DE66123456789012345678901234567890",
    "GueltigAb": "2021-06-25",
    "RechnungseinheitId": "988743"
  }
]

Beispieldatensatz für das Beenden der Zuordnung zu einer Rechnungseinheit:

Das Beispiel beendet die Zuordnung einer Bankverbindung zu einer Rechnungseinheit. Die Bankverbindung selbst bleibt weiterhin gültig und kann an anderen Rechnungseinheiten weiterverwendet werden.

Content-Type: application/sag.bankverbindungsaenderung.v1+json
[
  {
    "IBAN": "DE66123456789012345678901234567890",
    "GueltigAb": "2021-06-25",
    "GueltigBis": "2021-06-31",
    "RechnungseinheitId": "988743"
  }
]

Beispieldatensatz für das Beenden einer bestehenden und die Anlage einer neuen Bankverbindung mit Zuordnung zu einer Rechnungseinheit für die Art FG (Forderung + Guthaben)

Das Beispiel beendet die Zuordnung der alten Bankverbindung und erzeugt eine neue zur Rechnungseinheit.

Content-Type: application/sag.bankverbindungsaenderung.v1+json
[
  {
    "IBAN": "DE66123456789012345678901234567890",
    "GueltigAb": "2021-06-25",
    "GueltigBis": "2021-06-31",
    "RechnungseinheitId": "988743"
  },
  {
    "IBAN": "DE66123456789012345678901234567999",
    "GueltigAb": "2021-07-01",
    "Art": "FG",
    "Inhaber": "Klaus Müller",
    "RechnungseinheitId": "988743"
  }
]

Beispieldatensatz für das Beenden bestehender und die Anlage einer neuen Bankverbindungen mit Zuordnung zu einer Rechnungseinheit für die Art FO (Forderung) und GH (Guthaben)

Das Beispiel beendet die Zuordnung der alten Bankverbindung und erzeugt eine neue zur Rechnungseinheit.

Content-Type: application/sag.bankverbindungsaenderung.v1+json
[
  {
    "IBAN": "DE66123456789012345678901234567891",
    "GueltigAb": "2021-06-25",
    "GueltigBis": "2021-06-31",
    "RechnungseinheitId": "988743"
  },
  {
    "IBAN": "DE66123456789012345678901234567892",
    "GueltigAb": "2021-06-25",
    "GueltigBis": "2021-06-31",
    "RechnungseinheitId": "988743"
  },
  {
    "IBAN": "DE66123456789012345678901234567893",
    "GueltigAb": "2021-07-01",
    "Art": "FO",
    "Inhaber": "Klaus Müller",
    "RechnungseinheitId": "988743"
  },
  {
    "IBAN": "DE66123456789012345678901234567894",
    "GueltigAb": "2021-07-01",
    "Art": "GH",
    "Inhaber": "Klaus Müller",
    "RechnungseinheitId": "988743"
  }
]

Brieferzeugung

Administratoren können die Standardwerte für die Brieferzeugung konfigurieren. Folgende Einstellungen können getätigt werden:

Brieferzeugung aktivieren: Die Methode SC12SLPUtils.letterGenerationActiveForChangeBankData() liefert true (Standard), wenn die Brieferzeugung für die Bankverbindungsänderung aktiv sein soll, false wenn nicht.
Vorlage vorgeben: Die Methode SC12SLPUtils.getLetterTemplateForChangeBankData() liefert den Leerschlüssel (Standard) als Vorlage, die bei der Brieferzeugung für die Bankverbindungsänderung verwendet werden soll. Hier muss ein gültiger Nachschlagewert auf die zu verwendende Standardvorlage verwendet werden. Die Schlüssel hierfür sind im Schlüsselbereich “Prozess-Formularvorlage“ zu pflegen.
Druckdatum vorgeben: Die Methode SC12SLPUtils.getPrintDateForChangeBankData liefert 0 als Offset in Tagen zum aktuellen Datum für den Druck des Briefes. Hier dürfen nur positive Zahlen eingegeben werden.