Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Auszug
hiddentrue

SEPA-Nuclet – 4.8.1 SEPA: Nuclet-Schnittstellen: Ziel dieses Schrittes ist, das tatsächlich im Zielnuclet verwendeten Businessobjekt an den Java-Code des SEPA-Nuclets anzubinden. Dazu wird der Ansatz

globe with meridians Sprache: Deutsch · English (in Aufbau)

open book 4.8.1 SEPA: Nuclet-Schnittstellen

Ziel dieses Schrittes ist, das tatsächlich im Zielnuclet verwendeten Businessobjekt an den Java-Code des SEPA-Nuclets anzubinden. Dazu wird der Ansatz verfolgt, Nuclet-unabhängige …

Status
colourGrey
titleReferenz
Status
colourBlue
titleIntegratoren
Status
colourGreen
titleStand: Jul 2026
Status
colourGrey
titlegilt fuer Nuclos 4.2026.x

Panel
bgColor#F4F5F7

Auf dieser Seite

Inhalt
maxLevel2
minLevel2

Ziel dieses Schrittes ist, das tatsächlich im Zielnuclet verwendeten Businessobjekt an den Java-Code des SEPA-Nuclets anzubinden. Dazu wird der Ansatz verfolgt, Nuclet-unabhängige Wrapper-Klassen zu verwenden – anstelle der zu den Businessobjekten generierten Businessobjekt-Klassen.

Zu den technischen Hintergründen lesen Sie dazu bitte auch den Artikel "Schnittstellen in Java-Regeln".

Hinweis

Dieser Integrationsschritt kann erst durchgeführt werden, sobald die Vorbedingungen aus Abschnitt 3 erfüllt sind – d.h. sobald entsprechende Attribute in den genutzten Businessobjekten existieren.

...

Sollten Sie das SEPA-Nuclet entweder nur für Lastschriften oder nur für Überweisungen verwenden wollen, dann müssen nur die jeweiligen Klassen für Ihren Anwendungsfall angepasst werden. Die restlichen Klassen können Sie ignorieren.

Wrapper-KlasseAnmerkungFunktionAnwendungsfall
CreditorReferenceWrapperneu ab v2.0.0Anbindung an genutzte Referenzobjekte (Eingangsrechnungen, Gutschriften,o.ä.)Überweisungen

CreditorWrapperneu ab v2.0.0Anbindung an verwendete Kreditoren, Lieferanten, o.ä.
CreditTransferReferenceWrapperneu ab v2.0.0Anbindung an verwendete Zahlungsreferenzobjekte (Forderungen, Rechnungspositionen, Buchungen, etc.)
DebitorReferenceWrapperneu ab v2.0.0, ersetzt ReferenceWrapperAnbindung an genutzte Referenzobjekte (Ausgangsrechnungen,o.ä.)Lastschriften
DebitorWrapper
Anbindung an verwendete Debitoren, Kunden, o.ä.
DirectDebitReferenceWrapperneu ab v2.0.0Anbindung an verwendete Zahlungsreferenzobjekte (Forderungen, Rechnungspositionen, Buchungen, etc.)
ReferenceWrapperobsolet ab v2.0.0, wird ersetzt durch DebitReferenceWrapperAnbindung an genutzte Referenzobjekte (Rechnungen,o.ä.)Lastschriften
PaymentReferenceWrapperobsolet ab v2.0.0, wird ersetzt durch DirectDebitReferenceWrapperAnbindung an verwendete Zahlungsreferenzobjekte (Forderungen, Rechnungspositionen, etc.)Lastschriften

Tabelle 4.8.1: Übersicht Nuclet-Schnittstellen

...

Das sind jene Objekte, die bei SEPA-Exporten als Referenz für Zahlungsanweisungen verwendet werden.

MethodeFunktionAnpassung optional?
CreditorReferenceWrapperZuordnung des tatsächlich genutzten Businessobjektesnein



getCreditorId()liefert die Datenbank-ID des Kreditorenja
getCreditTransferReference()

liefert das Identifizierungsmerkmal für Überweisungen (also z.B. die Rechnungsnummer)

ja
getReferenceDate()

liefert ein Referenzdatum (bspw. das Rechnungsdatum)

ja
getTotalAmount()

liefert den Gesamtbetrag einer Transaktion (bspw. den Rechnungsbetrag);

falls die Implementierung null zurückliefert, werden die Beträge aus den Einzelbeträgen ermittelt

(siehe unten: CreditTransferReferenceWrapper)

ja

Tabelle 4.8.1.1: Anpassungen in CreditorReferenceWrapper

...

Der Konstruktor der Klasse und die Methode getIso4217Code() sind mit anwendungsspezifischem Verhalten zu befüllen. Letztere Methode sollte den ISO-4217-Währungscode (siehe dazu Wikipedia) des Währunsobjektes zurückliefern.

MethodeFunktionAnpassung optional?
CreditorWrapperZuordnung des tatsächlich genutzten Businessobjektesnein


getBic()liefert die BIC des Debitoren, d.h. das Geschäftskennzeichen der Bank des Debitoren (BIC = Business Identifier Code, früher: Bank Identifier Code)nein
getIban()liefert die IBAN des Debitoren, d.h. die internationale Bankkontonummer (IBAN = International Bank Account Number)nein
getName()liefert den Namen des Debitorennein

Tabelle 4.8.1.2: Anpassungen in CreditorWrapper

...

Mit Zahlungsreferenzen sind jene Objekte gemeint, :

MethodeFunktionAnpassung optional?
CreditTransferReferenceWrapper()Zuordnung des tatsächlich genutzten Businessobjektesnein



getAmount()

liefert den zu zahlenden Betrag;

wird genutzt, wenn die Methode getTotalAmount() aus dem übergeordneten

CreditorReferenceWrapper null zurückliefert

nein
getReferenceId()liefert die Datenbank-ID des übergeordneten Referenzobjektes (siehe 4.7.1.2)nein



setSEPAExportDate()

setzt das Export-Datum nach erfolgtem SEPA-Export

nein
setSEPAPaymentInformationId()setzt die SEPA-Zahlungsinformation nach erfolgtem SEPA-Exportnein

Tabelle 4.8.1.3: Anpassungen in CreditTransferReferenceWrapper

...

Das sind jene Objekte, die bei SEPA-Exporten als Referenz für Zahlungsanweisungen verwendet werden.

MethodeFunktionAnpassung optional?
DebitorReferenceWrapperZuordnung des tatsächlich genutzten Businessobjektesnein



getDebitorId()liefert die Datenbank-ID des Debitorenja
getDirectDebitReference()

liefert das Identifizierungsmerkmal für Lastschriften (also z.B. die Rechnungsnummer)

ja
getReferenceDate()

liefert ein Referenzdatum (bspw. das Rechnungsdatum)

ja
getTotalAmount()

liefert den Gesamtbetrag einer Transaktion (bspw. den Rechnungsbetrag);

falls die Implementierung null zurückliefert, werden die Beträge aus den Einzelbeträgen ermittelt

(siehe unten: DirectDebitReferenceWrapper)
ja

Tabelle 4.8.1.4: Anpassungen in DebitorReferenceWrapper

...

Der Konstruktor der Klasse und die Methode getIso4217Code() sind mit anwendungsspezifischem Verhalten zu befüllen. Letztere Methode sollte den ISO-4217-Währungscode (siehe dazu Wikipedia) des Währunsobjektes zurückliefern.

MethodeFunktionAnpassung optional?
DebitorWrapperZuordnung des tatsächlich genutzten Businessobjektesnein


getBic()liefert die BIC des Debitoren, d.h. das Geschäftskennzeichen der Bank des Debitoren (BIC = Business Identifier Code, früher: Bank Identifier Code)nein
getDateOfSEPAMandateSignature()liefert das Datum, an dem das SEPA-Mandat vom Debitoren ausgestellt/unterzeichnet wurdenein
getHasSEPAMandateChanged()liefert Informationen darüber, ob sich das SEPA-Mandat des Debitoren verändert hat (d.h. ob die Bankverbindung geändert wurde)nein
getIban()liefert die IBAN des Debitoren, d.h. die internationale Bankkontonummer (IBAN = International Bank Account Number)nein
getIsNewDebitorAgent()liefert Informationen darüber, ob der Debitor seit dem letzten SEPA-Exort das Kreditinstitut gewechselt hatnein
getName()liefert den Namen des Debitorennein
getOriginalDebitorAccount()liefert die letzte IBAN des Debitoren, falls sich diese seit dem letzten SEPA-Export geändet haben solltenein
getSEPAMandateIdentification()liefert die SEPA-Mandatskennung des Debitorennein
getSEPASequenceTypeId()liefert die SEPA-Laufzeit für den Debitoren (ist die SEPA-Lastschrift erstmals, einmalig oder wiederkehrend?)nein



setHasSEPAMandateChanged()setzt Informationen darüber, ob sich das SEPA-Mandat des Debitoren verändert hat (d.h. ob die Bankverbindung geändert wurde)nein
setIsNewDebitorAgent()setzt Informationen darüber, ob der Debitor seit dem letzten SEPA-Exort das Kreditinstitut gewechselt hatnein
setOriginalDebitorAccount()setzt die letzte IBAN des Debitoren, falls sich diese seit dem letzten SEPA-Export geändet haben solltenein
setSEPASequenceTypeId()setzt die SEPA-Laufzeit für den Debitoren (ist die SEPA-Lastschrift erstmals, einmalig oder wiederkehrend?)nein

Tabelle 4.8.1.5: Anpassungen in DebitorWrapper

...

Mit Zahlungsreferenzen sind jene Objekte gemeint, :

MethodeFunktionAnpassung optional?
DirectDebitReferenceWrapper()Zuordnung des tatsächlich genutzten Businessobjektesnein



getAmount()

liefert den zu zahlenden Betrag;

wird genutzt, wenn die Methode getTotalAmount() aus dem übergeordneten

DebitorReferenceWrapper null zurückliefert

nein
getReferenceId()liefert die Datenbank-ID des übergeordneten Referenzobjektes (siehe 4.7.1.2)nein



setSEPAExportDate()

setzt das Export-Datum nach erfolgtem SEPA-Export

nein
setSEPAPaymentInformationId()setzt die SEPA-Zahlungsinformation nach erfolgtem SEPA-Exportnein

Tabelle 4.8.1.3: Anpassungen in DirectDebitReferenceWrapper

...

Codeblock
languagejava
titleorg.nuclet.sepa.wrapper.DirectDebitReferenceWrapper
linenumberstrue
collapsetrue
package org.nuclet.sepa.wrapper;


import java.math.BigDecimal;
import java.util.Date;
import java.util.List;

import org.nuclos.api.businessobject.BusinessObject;
import org.nuclos.api.businessobject.facade.Modifiable;
import org.nuclos.api.businessobject.facade.Stateful;

import org.nuclet.sepa.wrapper.AbstractDirectDebitReferenceWrapper;

// @replace!
// 
// import org.nuclet.businesstemplate.ClientBillingPosition;


/**
 * Wrapper implementation for SEPA direct debit references (invoices, due payments, etc.)
 * 
 * @note replaces the original class AbstractPaymentReferenceWrapper
 * 
 * @version 1.0
 * @date 30.01.2015
 * @nuclet org.nuclet.SEPA
 * @nucletversion 2.0.0
 * @sincenucletversion 2.0.0
 * @since 30.01.2015
 * 
 * @author frank.lehmann@nuclos.de
 * 
 */
public class DirectDebitReferenceWrapper extends AbstractDirectDebitReferenceWrapper
{
 public DirectDebitReferenceWrapper(final Modifiable reference)
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // if (reference instanceof ClientBillingPosition) {
 // this.businessObject = reference;
 // }
 }
 
 /**
 * Liefert die Datenbank-ID des übergeordneten Referenzobjektes
 * (also bspw. die ID der Rechnung, falls es sich bei den Zahlungsreferenzen um
 * Rechnungspositionen handelt) 
 * 
 */
 public Long getReferenceId()
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // return ((ClientBillingPosition)this.businessObject).getClientBillingId();
 
 return null;
 }
 
 /**
 * Liefert den Zahlungsbetrag
 * 
 */
 public BigDecimal getAmount()
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // return ((ClientBillingPosition)this.businessObject).getAmount();
 
 return null;
 } 
 
 public void setSEPATransactionId(final Long lngSEPATransactionId)
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // ((ClientBillingPosition)this.businessObject).setSEPATransactionId(lngSEPATransactionId);
 }
 
 public void setSEPAExportDate(final Date datSEPAExportDate)
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // ((ClientBillingPosition)this.businessObject).setSEPAExportDate(datSEPAExportDate);
 }

}

Verwandte Seiten

open book Nuclet: SEPA (sind im Handelsnuclet verfügbar)


SEPA-Datenblatt

Öffnen →

open book Schnittstellen


Alle Integrationen

Öffnen →