Seitenhistorie
Lastschriften
Das SEPA-Nuclet setzt im Anwendungsfall "Lastschriften" die Existenz dreier Businessobjekte voraus, die in den SEPA-Exporten berücksichtigt werden:
- Debitoren ("Debitor")
- Referenzobjekte ("DebitorReference")
- Zahlungsreferenzen ("DirectDebitReference")
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.
Überweisungen
Analog setzt das SEPA-Nuclet Anwendungsfall "Überweisungen" die Existenz dreier Businessobjekte voraus, die in den SEPA-Exporten berücksichtigt werden:
- Kreditoren ("Creditor")
- Referenzobjekte ("CreditorReference")
- Zahlungsreferenzen ("CreditTransferReference")
Diese Dreiheit an Objekten geht davon aus, dass es zusätzlich zu Kreditoren (bspw. Lieferanten) und Referenzen (z.B. Rechnungen) ein Businessobjekt für explizite Zahlungsreferenzen gibt (bspw. Rechnungspositionen).
Es ist auch hier möglich und vom Nuclet 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 | Anwendungsfall |
|---|---|---|---|---|
| Debitoren | repräsentiert eine Person oder Firma, von der Lastschriften einzuziehen sind | Kunde, Mitglied, Person, etc. | Kunde, Mitglied, Person, etc. | Lastschriften |
| Debitorenreferenzen | repräsentiert einen Lastschriftzahlungsbeleg | Rechnung, Forderung, Beleg, etc. | Rechnung, Forderung, Beleg, etc. | |
| Zahlungsreferenzen | referenziert/repräsentiert eine konkrete Zahlung | Rechnungsposition, Forderungsposition, Belegposition,etc. | Rechnung, Forderung, Beleg, etc. | |
| Kreditoren | repräsentiert eine Person oder Firma, an die Überweisungen tu tätigen sind | Lieferant, Kunde, Person, etc. | Lieferant, Kunde, Person, etc. | Überweisungen |
| Krediorenreferenzen | repräsentiert einen Überweisungszahlungsbeleg | Eingangsrechnung, Gutschrift, Beleg, etc. | Rechnung, Gutschrift, Beleg, etc. | |
| Zahlungsreferenzen | referenziert/repräsentiert eine konkrete Zahlung | Rechnungsposition, Gutschriftsposition, Belegposition,etc. | Rechnung, Gutschrift, 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") |
| SEPA Transaction | SEPATransaction | Referenzfeld | nein | nein | Referenz auf die Transaktionen eines SEPA-Exportes (dient der Anzeige der exportierten Objekte) |
| SEPA Export Date | Date | Datum | nein | nein | Zahlungsdatum |
stellt ab Version 2.0.0 Exportfunktionalität sowohl für SEPA-Lastschriften als auch für SEPA-Überweisungen zur Verfügung.
Bei der Integration des SEPA-Nuclets muss nur derjenige Anwendungsfall berücksichtigt werden, den Sie in Ihrem Zielnuclet benötigen.
Die beiden folgenden Unterabschnitte beschreiben die notwendigen Voraussetzungen je Anwendungsfall:
3.1 Voraussetzungen im Anwendungsfall "Lastschriften"
3.2 Voraussetzungen im Anwendungsfall "Überweisungen"Tabelle 3.3: Zahlungsreferenzen
Überblick
Inhalte