Seitenhistorie

...

Bei der Anbindung des SEPA-Nuclets sind Wrapper-Klassen für Kreditoren (Lieferanten, o.ä.), Debitoren (Kunden, o.ä.), Referenzen (Rechnungen, Belege, o.ä.) und Zahlungsreferenzen (Forderungen, Rechnungspositionen, o.ä.) anzupassen.

Die folgende Übersicht führt alle Wrapper-Klassen gruppiert nach Anwendungsfall auf. Alle Klassen befinden sich im Java-Package org.nuclet.sepa.wrapper.

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.

org.nuclet.sepa.wrapper
Debitoren, Kunden, o.ä.

Wrapper-Klasse	Anmerkung	FunktionJava-Package	Anwendungsfall
CreditorWrapperCreditorReferenceWrapper	neu ab v2.0.0	Anbindung an verwendete Kreditoren, Lieferantengenutzte Referenzobjekte (Eingangsrechnungen, Gutschriften,o.ä.)	Überweisungen
CreditorWrapper	neu ab v2.	CreditorReferenceWrapper		neu ab v2.0.0	Anbindung an genutzte Referenzobjekte (Eingangsrechnungen, Gutschriftenverwendete Kreditoren, Lieferanten, o.ä.)	DebitorWrapper
CreditTransferReferenceWrapper	neu ab v2.0.0	Anbindung an verwendete		Zahlungsreferenzobjekte (Forderungen, Rechnungspositionen, Buchungen, etc.)
DebitorReferenceWrapper	neu ab v2.0.0, ersetzt ReferenceWrapper	Anbindung an genutzte Referenzobjekte (Ausgangsrechnungen,o.ä.)	Lastschriften
DebitorWrapper		Anbindung an verwendete Debitoren, Kunden, o.ä.
DirectDebitReferenceWrapper	neu ab v2.0.0	Anbindung an verwendete Zahlungsreferenzobjekte (Forderungen, Rechnungspositionen, Buchungen, etc.)
~~ReferenceWrapper~~	obsolet ab v2.0.0, wird ersetzt durch DebitReferenceWrapper	Anbindung an genutzte Referenzobjekte (Rechnungen,o.ä.)	~~Lastschriften~~
~~PaymentReferenceWrapper~~	obsolet ab v2.0.0, wird ersetzt durch DirectDebitReferenceWrapper	Anbindung an verwendete Zahlungsreferenzobjekte (Forderungen, Rechnungspositionen, etc.)	~~Lastschriften~~

Tabelle 4.8.1: Übersicht Nuclet-Schnittstellen

...

Info

Bitte beachten Sie, dass es in diesem Integrationsschritt nur darum geht, die Anbindung an die Attribute der tatsächlich genutzten Businessobjekte herzustellen.

Es ist von Ihnen an dieser Stelle im Normalfall keinerlei Prozesslogik zu implementieren.

4.

...

8.1.1

...

CreditorReferenceWrapper

Die Klasse DebitorWrapper ReferenceWrapper dient als Nuclet-Schnittstelle zum tatsächlich genutzten Debitoren-Businessobjekt.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ückliefernfür tatsächlich genutzte Referenzobjekte (Rechnungen, Forderungen, Belege, etc.).

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

getDateOfSEPAMandateSignature Datum, an dem das SEPA-Mandat vom Debitoren ausgestellt/unterzeichnet wurde

Methode	Funktion	Anpassung optional?
DebitorWrapperCreditorReferenceWrapper	Zuordnung des tatsächlich genutzten Businessobjektes	nein

getBicgetCreditorId()	liefert die BIC des Debitoren, d.h. das Geschäftskennzeichen der Bank des Debitoren (BIC = Business Identifier Code, früher: Bank Identifier Code)	nein	Datenbank-ID des Kreditoren	ja
getCreditTransferReference	()	liefert das	nein
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 hat	nein
getName()	liefert den Namen des Debitoren	nein
getOriginalDebitorAccount()	liefert die letzte IBAN des Debitoren, falls sich diese seit dem letzten SEPA-Export geändet haben sollte	nein
getSEPAMandateIdentification()	liefert die SEPA-Mandatskennung des Debitoren	nein
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 hat	nein
setOriginalDebitorAccount()	setzt die letzte IBAN des Debitoren, falls sich diese seit dem letzten SEPA-Export geändet haben sollte	nein
setSEPASequenceTypeId()	setzt die SEPA-Laufzeit für den Debitoren (ist die SEPA-Lastschrift erstmals, einmalig oder wiederkehrend?)	nein

Tabelle 4.7.1.1: Anpassungen in DebitorWrapper

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an die tatsächlich genutzte Währungsbusinessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

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

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an das tatsächlich genutzte Businessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

Codeblock

language	java
title	org.nuclet.sepa.wrapper.CreditorReferenceWrapper
linenumbers	true
collapse	true

package org.nuclet.sepa.wrapper;

Codeblock

language	java
title	org.nuclet.sepa.wrapper.DebitorWrapper
linenumbers	true
collapse	true

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.AbstractCreditorReferenceWrapper;

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


/**
 * WrapperAbstract implementationwrapper class for debitors (supplier billings, invoices, etc.)
 * 
 * @version 1.01
 * @date 2111.0301.20142016
 * @nuclet org.nuclet.SEPA
 * @nucletversion 2.1.0.03
 * @sincenucletversion 1.0.0
 * @since 2130.0301.20142015
 * 
 * @author frank.lehmann@nuclos.de
 * 
 */
public class DebitorWrapperCreditorReferenceWrapper extends AbstractDebitorWrapperAbstractCreditorReferenceWrapper
{         
    public DebitorWrapperCreditorReferenceWrapper(final Modifiable reference)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // if (reference instanceof ClientSupplierBilling) {
        //     this.businessObject = reference;
        // }
    }
    
    
    /**
     * Liefert dendie NamenDatenbank-ID des DebitorsKreditoren
     * 
     */
    public StringLong getNamegetCreditorId()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientSupplierBilling)this.businessObject).getNamegetSupplierId();
        
        return null;
    }
    
    
    /**
     * Liefert die SEPA-Mandatskennungdas Identifizierungsmerkmal für Lastschriften (z.B. die Rechnungsnummer)
     * 
     */
    public String getSEPAMandateIdentificationgetCreditTransferReference()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // 
        // return ((ClientSupplierBilling)this.businessObject).getSEPAMandateIdentificationgetBillingNumber();
        
        return null;
    }
           
    
    /**
     * Liefert ein Referenzdatum (bspw. das Ausstellungsdatum des SEPA-MandatsRechnungsdatum)
     * 
     */
    public Date getDateOfSEPAMandateSignaturegetReferenceDate()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientSupplierBilling)this.businessObject).getDateOfSEPAMandateSignaturegetBillingDate();
        
        return null;
    }    
    
    /**
     * Liefert Informationenden darüber, ob sich das SEPA-Mandat auf Debitorenseite Gesamtbetrag (bspw. den Rechnungsbetrag)
     * 
     * @note Falls die Implementierung *null* zurückliefert, werden die Beträge aus den
     * geändert hat Einzelbeträgen ermittelt (d.h. aus den CreditTransferReferenceWrapper-Objekten)
     */
    public BooleanBigDecimal getHasSEPAMandateChangedgetTotalAmount()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientSupplierBilling)this.businessObject).getHasSEPAMandateChangedgetTotalAmountGross();
        
        return nullBigDecimal.ZERO;
    }
    
}

4.8.1.2 CreditorWrapper

Die Klasse CreditorWrapper dient als Nuclet-Schnittstelle zum tatsächlich genutzten Kreditoren-Businessobjekt.

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.

Methode	Funktion	Anpassung optional?
CreditorWrapper	Zuordnung des tatsächlich genutzten Businessobjektes	nein

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 Debitoren	nein

Tabelle 4.8.1.2: Anpassungen in CreditorWrapper

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an die tatsächlich genutzte Währungsbusinessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

Codeblock

language	java
title	org.nuclet.sepa.wrapper.CreditorWrapper
linenumbers	true
collapse	true

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.AbstractCreditorWrapper;

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


/**
 * Wrapper implementation for creditors 
 * 
 * @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 CreditorWrapper extends AbstractCreditorWrapper
{
 public CreditorWrapper(final Modifiable reference)
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // if (reference instanceof Supplier) {
 // this.businessObject = reference;
 // }
 }
 
 
 /**
 * Liefert den Namen des Debitors
 * 
 */
 public String getName()
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // return ((Supplier)this.businessObject).getName();
 
 return null;
 }
 
 
 
 
 /**
 * Liefert den BIC für SEPA-Zahlungen
 * 
 */
 public String getBic()
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // return ((Supplier)this.businessObject).getBic();
 
 return null;
 } 

 /**
 * Liefert den IBAN für SEPA-Zahlungen
 * 
 */
 public String getIban()
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
 //
 // Beispiel:
 //
 // return ((Supplier)this.businessObject).getIban();
 
 return null;
 } 

}

4.8.1.3 CreditTransferReferenceWrapper

Die Klasse CreditTransferReferenceWrapper dient als Nuclet-Schnittstelle zum tatsächlich genutzten Businessobjekt für Zahlungsreferenzen.

Mit Zahlungsreferenzen sind jene Objekte gemeint, :

Methode	Funktion	Anpassung optional?
CreditTransferReferenceWrapper()	Zuordnung des tatsächlich genutzten Businessobjektes	nein

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-Export	nein

Tabelle 4.8.1.3: Anpassungen in CreditTransferReferenceWrapper

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an das tatsächlich genutzte Businessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

Codeblock

language	java
title	org.nuclet.sepa.wrapper.CreditTransferReferenceWrapper
linenumbers	true
collapse	true

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.AbstractPaymentReferenceWrapper;

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


/**
 * Wrapper implementation for SEPA credit transfer references (invoices, due payments, etc.)
 * 
 * @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 CreditTransferReferenceWrapper extends AbstractCreditTransferReferenceWrapper
{
    public CreditTransferReferenceWrapper(final Modifiable reference)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // if (reference instanceof SupplierBillingPosition) {
        //     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 ((SupplierBillingPosition)this.businessObject).getClientBillingId();
        
        return null;
    }
    
    /**
     * Liefert den Zahlungsbetrag
     * 
     */
    public BigDecimal getAmount()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((SupplierBillingPosition)this.businessObject).getAmount();
        
        return null;
    }        
    
    public void setSEPATransactionId(final Long lngSEPATransactionId)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // ((SupplierBillingPosition)this.businessObject).setSEPATransactionId(lngSEPATransactionId);
    }
    
    public void setSEPAExportDate(final Date datSEPAExportDate)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // ((SupplierBillingPosition)this.businessObject).setSEPAExportDate(datSEPAExportDate);
    }

}

4.8.1.4 DebitorReferenceWrapper

Die Klasse ReferenceWrapper dient als Nuclet-Schnittstelle für tatsächlich genutzte Referenzobjekte (Rechnungen, Forderungen, Belege, etc.).

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

Methode	Funktion	Anpassung optional?
DebitorReferenceWrapper	Zuordnung des tatsächlich genutzten Businessobjektes	nein

getDebitorId()	liefert die Datenbank-ID des Debitoren	ja
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

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an das tatsächlich genutzte Businessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

Codeblock

language	java
title	org.nuclet.sepa.wrapper.ReferenceWrapper
linenumbers	true
collapse	true

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.AbstractDebitorReferenceWrapper;

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


/**
 * Abstract wrapper class for debitors (client billings, invoices, etc.)
 * 
 * @note replaces the original class ReferenceWrapper
 * 
 * @version 2.1
 * @date 11.01.2016
 * @nuclet org.nuclet.SEPA
 * @nucletversion 2.1.3
 * @sincenucletversion 2.0.0
 * @since 30.01.2015
 * 
 * @author frank.lehmann@nuclos.de
 * 
 */
public class DebitorReferenceWrapper extends AbstractDebitorReferenceWrapper
{         
    public DebitorReferenceWrapper(final Modifiable reference)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // if (reference instanceof ClientBilling) {
        //     this.businessObject = reference;
        // }
    }

    /**
     * Liefert die Datenbank-ID des Debitoren
     * 
     */
    public Long getDebitorId()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientBilling)this.businessObject).getClientId();
        
        return null;
    }
    
    /**
     * Liefert das Identifizierungsmerkmal für Lastschriften (z.B. die Rechnungsnummer)
     * 
     */
    public String getDirectDebitReference()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // 
        // return ((ClientBilling)this.businessObject).getBillingNumber();
        
        return null;
    }        
    
    /**
     * Liefert ein Referenzdatum (bspw. das Rechnungsdatum)
     * 
     */
    public Date getReferenceDate()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientBilling)this.businessObject).getBillingDate();
        
        return null;
    }
    
    /**
     * Liefert den Gesamtbetrag (bspw. den Rechnungsbetrag)
     * 
     * @note Falls die Implementierung *null* zurückliefert, werden die Beträge aus den
     * Einzelbeträgen ermittelt (d.h. aus den DirectDebitReferenceWrapper-Objekten)
     */
    public BigDecimal getTotalAmount() {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientBilling)this.businessObject).getTotalAmountGross();
        
        return BigDecimal.ZERO;
    }
}

4.8.1.5 DebitorWrapper

Die Klasse DebitorWrapper dient als Nuclet-Schnittstelle zum tatsächlich genutzten Debitoren-Businessobjekt.

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.

Methode	Funktion	Anpassung optional?
DebitorWrapper	Zuordnung des tatsächlich genutzten Businessobjektes	nein

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 wurde	nein
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 hat	nein
getName()	liefert den Namen des Debitoren	nein
getOriginalDebitorAccount()	liefert die letzte IBAN des Debitoren, falls sich diese seit dem letzten SEPA-Export geändet haben sollte	nein
getSEPAMandateIdentification()	liefert die SEPA-Mandatskennung des Debitoren	nein
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 hat	nein
setOriginalDebitorAccount()	setzt die letzte IBAN des Debitoren, falls sich diese seit dem letzten SEPA-Export geändet haben sollte	nein
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

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an die tatsächlich genutzte Währungsbusinessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

Codeblock

language	java
title	org.nuclet.sepa.wrapper.DebitorWrapper
linenumbers	true
collapse	true

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;

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


/**
 * Wrapper implementation for debitors 
 * 
 * @version 1.0
 * @date 21.03.2014
 * @nuclet org.nuclet.SEPA
 * @nucletversion 1.0.0
 * @sincenucletversion 1.0.0
 * @since 21.03.2014
 * 
 * @author frank.lehmann@nuclos.de
 * 
 */
public class DebitorWrapper extends AbstractDebitorWrapper
{
    public DebitorWrapper(final Modifiable reference    /**
     * Setzt die Informationen darüber, ob sich das SEPA-Mandat auf Debitorenseite 
     * geändert hat
     */
    public void setHasSEPAMandateChanged(final Boolean blnHasSEPAMandateChanged)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // ((Client)this.businessObject).setHasSEPAMandateChanged(blnHasSEPAMandateChanged);
    }
    
    /**
     * Liefert Informationen darüber, ob sich das Kreditinstitut auf Debitorenseite
     * gewechselt wurde
     */
    public Boolean getIsNewDebitorAgent()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // if (reference instanceof Client) {
        //  return  ((Client)this.businessObject).getIsNewDebitorAgent() = reference;
        // }
        return null;}
    }
    
    /**
     * SetztLiefert dieden InformationenNamen darüber, ob sich das Kreditinstitut auf Debitorenseitedes Debitors
     * gewechselt wurde
     */
    public voidString setIsNewDebitorAgentgetName(final Boolean blnIsNewDebitorAgent)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((Client)this.businessObject).setIsNewDebitorAgent(blnIsNewDebitorAgent)getName();
        
        return null;
    }
    
    
    /**
     * Liefert die Datenbank-ID der SEPA-LaufzeitMandatskennung
     * 
     */
    public LongString getSEPASequenceTypeIdgetSEPAMandateIdentification()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((Client)this.businessObject).getSEPASequenceTypeIdgetSEPAMandateIdentification();
        
        return null;
    }
               
    /**
     * SetztLiefert diedas Datenbank-IDAusstellungsdatum derdes SEPA-LaufzeitMandats
     * 
     */
    public voidDate setSEPASequenceTypeIdgetDateOfSEPAMandateSignature(final Long lngSEPASequenceTypeId)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((Client)this.businessObject).setSEPASequenceTypeIdgetDateOfSEPAMandateSignature(lngSEPASequenceTypeId);
       }

   
        return null;
    }
    
    /**
     * Liefert Informationen darüber, denob BICsich fürdas SEPA-ZahlungenMandat auf Debitorenseite 
     * geändert hat
     */
    public StringBoolean getBicgetHasSEPAMandateChanged()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((Client)this.businessObject).getBicgetHasSEPAMandateChanged();
        
        return null;
    }
    

    /**
     * Liefert den IBAN für SEPA-Zahlungen Setzt die Informationen darüber, ob sich das SEPA-Mandat auf Debitorenseite 
     * geändert hat
     */
    public Stringvoid getIbansetHasSEPAMandateChanged(final Boolean blnHasSEPAMandateChanged)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((Client)this.businessObject).getIban();
        
        return nullsetHasSEPAMandateChanged(blnHasSEPAMandateChanged);
    }
    
    /**
     * Liefert die alte IBAN bei SEPA-Mandatsänderungen Informationen darüber, ob sich das Kreditinstitut auf Debitorenseite
     * gewechselt wurde
     */
    public StringBoolean getOriginalDebitorAccountgetIsNewDebitorAgent()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((Client)this.businessObject).getOriginalDebitorAccountgetIsNewDebitorAgent();
        
        return null;
    }
    
    /**
     * Setzt die alte IBAN bei SEPA-Mandatsänderungen Informationen darüber, ob sich das Kreditinstitut auf Debitorenseite
     * gewechselt wurde
     */
    public void setOriginalDebitorAccountsetIsNewDebitorAgent(final StringBoolean strOriginalDebitorAccountblnIsNewDebitorAgent)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel: mit eigenem Code ersetzen!
        //
        // ((Client)this.businessObject).setOriginalDebitorAccount(strOriginalDebitorAccount);Beispiel:
    }
    

}

4.8.1.2 ReferenceWrapper

Die Klasse ReferenceWrapper dient als Nuclet-Schnittstelle für tatsächlich genutzte Referenzobjekte (Rechnungen, Forderungen, Belege, etc.).

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

Methode	Funktion	Anpassung optional?
ReferenceWrapper	Zuordnung des tatsächlich genutzten Businessobjektes	nein

getDebitorId()	liefert die Datenbank-ID des Debitoren	ja
getDirectDebitReference()	liefert das Identifizierungsmerkmal für Lastschriften (also z.B. die Rechnungsnummer)	ja
getReferenceDate()	liefert ein Referenzdatum (bspw. das Rechnungsdatum)	ja

Tabelle 4.7.1.2: Anpassungen in ReferenceWrapper

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an das tatsächlich genutzte Businessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

Codeblock

language	java
title	org.nuclet.sepa.wrapper.ReferenceWrapper
linenumbers	true
collapse	true

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;

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


/**
 * Abstract wrapper class for debitors (client billings, invoices, etc.)
 * 
 * @version 1.0
 * @date 21.03.2014
 * @nuclet org.nuclet.SEPA
 * @nucletversion 1.0.0
 * @sincenucletversion 1.0.0
 * @since 21.03.2014
 * 
 * @author frank.lehmann@nuclos.de
 * 
 */
public class ReferenceWrapper extends AbstractReferenceWrapper
{         
    public ReferenceWrapper(final Modifiable reference//
        // ((Client)this.businessObject).setIsNewDebitorAgent(blnIsNewDebitorAgent);
    }
 
    /**
     * Liefert die Datenbank-ID der SEPA-Laufzeit
     * 
     */
    public Long getSEPASequenceTypeId()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((Client)this.businessObject).getSEPASequenceTypeId();
        
        return null;
    }
    
    /**
     * Setzt die Datenbank-ID der SEPA-Laufzeit
     * 
     */
    public void setSEPASequenceTypeId(final Long lngSEPASequenceTypeId)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // ((Client)this.businessObject).setSEPASequenceTypeId(lngSEPASequenceTypeId);
    }

          
    /**
     * Liefert den BIC für SEPA-Zahlungen
     * 
     */
    public String getBic()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // if (reference instanceof ClientBilling) {
return ((Client)this.businessObject).getBic();
        
  //     this.businessObject =return referencenull;
        // }
    }

    /**
     * Liefert dieden Datenbank-IDIBAN desfür DebitorenSEPA-Zahlungen
     * 
     */
    public LongString getDebitorIdgetIban()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientBillingClient)this.businessObject).getClientIdgetIban();
        
        return null;
    }
    
    /**
     * Liefert das Identifizierungsmerkmal fürdie Lastschriften (z.B. die Rechnungsnummer)alte IBAN bei SEPA-Mandatsänderungen
     * 
     */
    public String getDirectDebitReferencegetOriginalDebitorAccount()
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // 
        // return ((ClientBillingClient)this.businessObject).getBillingNumbergetOriginalDebitorAccount();
        
        return null;
    }        
    
    /**
     * LiefertSetzt eindie Referenzdatumalte (bspw.IBAN das Rechnungsdatum)bei SEPA-Mandatsänderungen
     * 
     */
    public Datevoid getReferenceDatesetOriginalDebitorAccount(final String strOriginalDebitorAccount)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // return ((ClientBillingClient)this.businessObject).getBillingDatesetOriginalDebitorAccount();
        
   strOriginalDebitorAccount);
     return null;}
    }

}

4.

...

8.1.

...

6 DirectDebitReferenceWrapper

Die Klasse PaymentReferenceWrapper CreditTransferReferenceWrapper dient als Nuclet-Schnittstelle zum tatsächlich genutzten Businessobjekt für Zahlungsreferenzen.

...

Methode	Funktion	Anpassung optional?
PaymentReferenceWrapperDirectDebitReferenceWrapper()	Zuordnung des tatsächlich genutzten Businessobjektes	nein

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-Export	nein

Tabelle 4.78.1.3: Anpassungen in PaymentReferenceWrapperDirectDebitReferenceWrapper

Beispiele dazu sind in Kommentarblöcken angegeben; diese Beispiele sind bei der Integration also an das tatsächlich genutzte Businessobjekt (bzw. deren BusinessObject-Klasse) anzupassen.

Codeblock

language	java
title	org.nuclet.sepa.wrapper.PaymentReferenceWrapperDirectDebitReferenceWrapper
linenumbers	true
collapse	true

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 2130.0301.20142015
 * @nuclet org.nuclet.SEPA
 * @nucletversion 12.0.0
 * @sincenucletversion 12.0.0
 * @since 2130.0301.20142015
 * 
 * @author frank.lehmann@nuclos.de
 * 
 */
public class PaymentReferenceWrapperDirectDebitReferenceWrapper extends AbstractPaymentReferenceWrapperAbstractDirectDebitReferenceWrapper
{
    public PaymentReferenceWrapperDirectDebitReferenceWrapper(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 setSEPAPaymentInformationIdsetSEPATransactionId(final Long lngSEPAPaymentInformationId)
    {
        Long lngSEPATransactionId)
 {
 // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // ((ClientBillingPosition)this.businessObject).setSEPAPaymentInformationIdsetSEPATransactionId(lngSEPAPaymentInformationIdlngSEPATransactionId);
    }
    
    public void setSEPAExportDate(final Date datSEPAExportDate)
    {
        // @replace! Bitte bei Nuclet-Integration mit eigenem Code ersetzen!
        //
        // Beispiel:
        //
        // ((ClientBillingPosition)this.businessObject).setSEPAExportDate(datSEPAExportDate);
    }

}

Seitenhierarchie

Versionen im Vergleich

Alte Version 11

Neue Version Aktuell

Schlüssel

4.

8.1.1

CreditorReferenceWrapper

4.8.1.2 CreditorWrapper

4.8.1.3 CreditTransferReferenceWrapper

4.8.1.4 DebitorReferenceWrapper

4.8.1.5 DebitorWrapper

4.8.1.2 ReferenceWrapper

4.

8.1.

6 DirectDebitReferenceWrapper