Das SEPA-Nuclet setzt im Normalfall die Existenz dreier Businessobjekte voraus, die in den SEPA-Exporten berücksichtigt werden:
- Debitoren ("Debitor")
- Referenzobjekte ("Reference")
- Zahlungsreferenzen ("PaymentReference")
Diese Dreiheit an Objekten geht davon aus, dass es zusätzlich zu Debitoren (bspw. Kunden) und Referenzen (z.B. Rechnungen) ein Businessobjekt für explizite Zahlungsreferenzen gibt (bspw. Rechnungspositionen).
Es ist möglich und vom Nuclet auch vorgesehen, diese "Dreiheit" von Objekten auf eine "Zweiheit" zu reduzieren, falls im Zielnuclet keine gesonderten Zahlungsreferenzen gibt.
In diesem Fall fallen also bspw. Rechnung und Rechnungsposition zusammen.
| Typ | Beschreibung | Umsetzung bei drei Entitäten | Umsetzung mit zwei Entitäten |
|---|---|---|---|
| Debitoren | repräsentiert eine Person oder Firma, von der Lastschriften einzuziehen sind | Kunde, Mitglied, Person, etc. | Kunde, Mitglied, Person, etc. |
| Referenzen | repräsentiert einen Zahlungsbeleg | Rechnung, Forderung, Beleg, etc. | Rechnung, Forderung, Beleg, etc. |
| Zahlungsreferenzen | referenziert/repräsentiert eine konkrete Zahlung | Rechnungsposition, Forderungsposition, Belegposition,etc. | Rechnung, Forderung, Beleg, etc. |
Tabelle 3: Voraussetzungen
3.1 Debitoren
Es wird die Existenz eines Debitoren-Businessobjektes vorausgesetzt. Die Debitoren repräsentieren Kunden, Mitglieder, Personen, etc.
Businessobjekt und Attribut können im Zielnuclet beliebig benannt sein. Die Anbindung erfolgt über eine Schnittstelle, die in der aktuellen Version in einer Java-Klasse realisiert ist.
| Attribut | Java-Datentyp | Nuclos-Datentyp | Pflichtfeld? | Eindeutig? | Beschreibung |
|---|---|---|---|---|---|
| Name | String | Text | ja | nein | dient als Identifizierungsmerkmal für die Debitoren |
| SEPA Mandate Identification | String | Text | ja, falls der Debitor in SEPA-Exporten zu berücksichtigen ist | nein | SEPA-Mandatskennung |
| Date of SEPA Mandate Signature | Date | Datum | ja, falls der Debitor in SEPA-Exporten zu berücksichtigen ist | nein | Ausstellungsdatum des SEPA-Mandats |
| Has SEPA Mandate Changed | Boolean | Ja/Nein | ja | nein | liefert Informationen darüber, ob sich das SEPA-Mandat auf Debitorenseite geändet hat |
| Is New Debitor Agent | Boolean | Ja/Nein | ja | nein | liefert Informationen darüber, ob das Kreditinstitut auf Debitorenseite gewechselt wurde |
| SEPA Sequence Type | SEPASequenceType | Referenzfeld | ja | nein | SEPA-Laufzeit (erstmals, wiederkehrend, einmalig) |
| BIC | String | Text | ja | nein | BIC (Business Identifier Code, früher: Bank Identifier Code) |
| IBAN | String | Text | ja | nein | IBAN (Internationel Bankkontonummer, englisch: International Bank Account Number) |
| Original Debitor Account | String | Text | nein | nein | liefert die alte IBAN bei SEPA-Mandatsänderungen |
Tabelle 3.1: Debitoren-Businessobjekt
3.2 Referenzobjekte
Referenzobjekte repräsentieren Zahlungsbelege, die in den SEPA-Exporten zu berücksichtigen sind. Im Fall von Lastschriften sind dies also bspw. Rechnungen, Forderungen, Belege, o.ä.
Businessobjekt und Attribut können im Zielnuclet beliebig benannt sein. Die Anbindung erfolgt über eine Schnittstelle, die in der aktuellen Version in einer Java-Klasse realisiert ist.
| Attribut | Java-Datentyp | Nuclos-Datentyp | Pflichtfeld? | Eindeutig? | Beschreibung |
|---|---|---|---|---|---|
| Debitor | Wrapper-Klasse | Referenzfeld | ja | nein | der Debitor (Kunde, Mitglied, Person, etc.) |
| Direct Debit Reference | String | Text | ja | nein | ein Identifizierungsmerkmal für Lastschriften (z.B. die Rechnungsnummer) |
| Reference Date | Date | Datum | ja | nein | ein Referenzdatum (bspw. das Rechnungsdatum) |
Tabelle 3.2: Referenzobjekte
3.3 Zahlungsreferenzen
Zahlungsreferenzen repräsentieren Positionen, die auf den in 3.2 beschriebenen Zahlunsbelegen mit explizitem Zahlbetrag ausgewiesen sind. Wenn als Referenzobjekt bspw. Rechnungen verwendet werden,
dann wären die dazugehörigen Zahlungsreferenzen typischerweise die Rechnungspositionen.
Businessobjekt und Attribut können im Zielnuclet beliebig benannt sein. Die Anbindung erfolgt über eine Schnittstelle, die in der aktuellen Version in einer Java-Klasse realisiert ist.
| Attribut | Java-Datentyp | Nuclos-Datentyp | Pflichtfeld? | Eindeutig? | Beschreibung |
|---|---|---|---|---|---|
| Reference | Wrapper-Klasse | Referenzfeld | ja | nein | das übergeordnete Referenzobjekt (im Fall von Rechnungspositionen wäre das also die Rechnung) |
| Amount | BigDecimal | Kommazahl (9,2) | ja | nein | der zu zahlende Betrag (z.B. "Rechnungsbetrag, brutto") |
| Payment Information | SEPAPaymentInformation | Referenzfeld | nein | nein | Referenz auf die Zahlungsinformationen eines SEPA-Exportes (dient der Anzeige der exportierten Objekte) |
| SEPA Export Date | Date | Datum | nein | nein | Zahlungsdatum |
Tabelle 3.3: Zahlungsreferenzen
Überblick
Inhalte