42 — SEPA-XML-Export

PartnerDesk kann alle freigegebenen Auszahlungen als pain.001.001.03-konforme SEPA-Datei exportieren. Diese laden Sie in Ihr Online-Banking → eine Sammelüberweisung erledigt alle Auszahlungen in einem Schritt.

Wann sinnvoll?

• Sie wollen monatlich/quartalsweise alle Partner per Banküberweisung auszahlen.
• Sie haben keine Stripe-Connect-Integration (siehe 43).
• Sie wollen Bulk-Auszahlungen ohne manuelles Einzeln-Klicken.

Workflow

1. Approved-Payouts vorbereiten

Alle Payouts, die ausgezahlt werden sollen, müssen Status approved haben (siehe 40).

2. SEPA-Export auslösen

Admin → „Auszahlungen" → „SEPA-XML exportieren". PartnerDesk:

• Sammelt alle Payouts mit Status approved (über alle Partner).
• Bündelt sie in eine einzelne pain.001-Datei.
• Triggert Download.

3. Datei ins Online-Banking laden

Login bei der Tenant-eigenen Bank → SEPA-Sammelüberweisung-Funktion → Datei hochladen → Freigabe (i. d. R. mit TAN).

4. Nach Bestätigung der Bank

Admin markiert die einzelnen Payouts in PartnerDesk als paid mit Bankreferenz. Optional automatisch via easybill/lexoffice-Webhook (siehe 44), falls die Banküberweisung darüber abgewickelt wird.

Inhalt der SEPA-Datei

Die Datei enthält pro Payout:

Element	Inhalt
EndToEndId	Die PartnerDesk-Payout-Nummer (für spätere Rückverfolgung)
InstdAmt	Brutto-Betrag mit Währung
Cdtr (Empfänger)	Partner-Name aus Stammdaten oder Bank-Account-Holder
CdtrAcct/IBAN	Partner-IBAN
CdtrAgt/BIC	Partner-BIC
RmtInf/Ustrd	Verwendungszweck: „Gutschrift {payoutNumber}"

Header:

• MsgId — eindeutige Datei-ID.
• CreDtTm — Erstellungszeit.
• NbOfTxs — Anzahl Überweisungen.
• CtrlSum — Summe aller Beträge.

Debtor (Sie als Tenant): Aus den Tenant-Legal-Settings (Firmenname, IBAN, BIC).

Voraussetzungen pro Partner

Damit ein Partner im SEPA-Export erscheint, muss er haben:

• preferredPayoutMethod=bank (nicht PayPal).
• IBAN gefüllt.
• BIC gefüllt (optional, aber empfohlen).
• Account-Holder (oder Vor-/Nachname fallback).

Partner ohne diese Daten werden vom Export ausgeschlossen — Sie müssen sie manuell (oder via PayPal/Stripe Connect) auszahlen.

Voraussetzungen für Sie als Tenant

In den Legal-Settings (siehe 94):

• Firmenname als Auftraggeber.
• IBAN des Auftraggebers (Tenant-Bankkonto).
• BIC des Auftraggebers.

Ohne diese drei Felder schlägt der Export fehl.

Execution Date

Die SEPA-Datei nennt ein Ausführungs-Datum (ReqdExctnDt). PartnerDesk setzt dieses standardmäßig auf heute + 2 Tage — typischer DTAUS/SEPA-Vorlauf. Wenn die Bank ein anderes Datum akzeptiert, können Sie es vor dem Upload manuell ändern.

Tipps

• Pro Bank funktioniert die Sammelüberweisung etwas anders — manche akzeptieren die Datei nur, wenn der MsgId strikt eindeutig ist. PartnerDesk garantiert das (Timestamp + Zufalls-Hex).
• Nicht-EU-Partner brauchen einen anderen Workflow (SWIFT statt SEPA). PartnerDesk bietet aktuell nur SEPA — bei Bedarf nutzen Sie für diese Partner Stripe Connect oder PayPal.
• Bei Großvolumen: manche Banken haben Tageslimits. Im Zweifel mehrere kleinere SEPA-Dateien statt einer riesigen.

Verwandte Kapitel

• 40 — Auszahlungs-Workflow
• 43 — Stripe Connect (Alternative)
• 94 — Legal-Pages (Stammdaten für Debtor)

---

Technische Tiefen-Doku: ../001-initial-setup.md (PayoutService.generateSepaXml)