Importieren von Sammelzahlungen

CSV-Import

Sie können über einen CSV-Import für mehrere bestehende Kunden gleichzeitig einzelne Zahlungen erstellen.

WICHTIG: Bitte beachten Sie Folgendes:

Sie können in der CSV-Datei keine Daten für bestehende Kunden hinzufügen oder aktualisieren. Der Upload würde in diesem Fall einen Fehler zurückgeben.
Es gilt eine Grenze von 100 Zeichen pro Zelle.

Klicken Sie auf Zahlungen
Wählen Sie Importieren aus
Klicken Sie auf Vorlage herunterladen
Klicken Sie nach dem Herunterladen im Exportfenster auf den blauen CSV-Link, um die Datei zu öffnen

Sie erhalten den Link zum Herunterladen des Exports ebenfalls per E-Mail
Geben Sie den Zahlungsbetrag, die Beschreibung und die Abbuchungsdaten* in die entsprechenden Zeilen der Kunden ein, für die Sie die Zahlungen erstellen möchten (Spalten G, I und J). Hinweis: Es gilt eine Grenze von 100 Zeichen pro Zelle.
Speichern Sie die aktualisierte CSV-Datei
Kehren Sie zu Ihrem Dashboard zurück und klicken Sie auf Datei auswählen, um die gespeicherte CSV-Datei hochzuladen
Klicken Sie auf Zahlungen importieren

Sollte Ihre hochgeladene Datei Fehler enthalten, werden diese auf der Seite „Importe" hervorgehoben. Sie müssen die Fehler korrigieren und die CSV-Datei dann erneut hochladen.
Nach der Validierung des Uploads erscheint auf der Seite „Importe" eine Bestätigung.

Hier können Sie sehen, ob die Zahlungen für jeden Kundeneintrag im Bereich Gültige Zeilen am Ende korrekt erstellt wurden.
Wenn Sie bereit sind, klicken Sie auf Zahlungen verarbeiten.

Wenn Sie jetzt über das blaue Menü links in Ihrem Dashboard zur Zahlungsseite navigieren, sollten Sie die Zahlungen mit dem Status „Ausstehende Einsendung" sehen.

* Eingabe von Abbuchungstagen

Das Abbuchungsdatum muss im Format JJJJ-MM-TT eingegeben werden.

Sie müssen ein Datum eingeben, das vor dem Einzug ausreichend Bearbeitungszeit ermöglicht. Das richtet sich nach den Fristen für die Vorabankündigung und Übermittlung, die für das Lastschriftschema im Wohnsitzland Ihrer Kunden gelten.

Wenn Sie die Zahlung so schnell wie möglich einziehen möchten, können Sie das Feld payment.charge_date (Spalte J) leer lassen.

SPALTE	SPALTENÜBERSCHRIFT	ERFORDERT EINGABE/AKTION
A	mandate.id	Nein
B	customer.id	Nein
C	customer.given_name	Nein
D	customer.family_name	Nein
E	customer.company_name	Nein
F	customer.email	Nein
G	payment.amount	Ja
H	payment.currency	Nein
I	payment.description	Optional
J	payment.charge_date	Optional
K	payment.metadata.YOUR_CUSTOM_FIELD	Optional

Hinweis: Geben Sie Spalte K „payment.metadata.YOUR_CUSTOM_FIELD" einen eindeutigen Namen.

Umgang mit Akzenten im Sammel-Upload-Tool

Wenn die Daten Ihres Kunden Akzente oder andere Sonderzeichen enthalten, gibt die automatische Überprüfung möglicherweise einen Fehler aus.

Eine Tabellensoftware wie Excel kann diese Sonderzeichen nicht verarbeiten. Wenn Sie die Datei also speichern und wieder hochladen, sind die Sonderzeichen beschädigt und die Daten stimmen nicht mehr überein. Excel kann die „UTF-8-Kodierung" nicht richtig umsetzen.

Sie können diesen Fehler in Excel auf Windows korrigieren, indem Sie das Tool „Textdatei importieren" zum Öffnen der CSV-Datei verwenden.

Unter Mac kann Excel keine UTF-8-Dateien öffnen. Sie müssen eine andere Tabellensoftware verwenden (z. B. Numbers von Apple) oder die CSV-Datei vorsichtig mit einem Textbearbeitungsprogramm bearbeiten.

XML-Import

GoCardless unterstützt die Erstellung von Sammelzahlungen über XML-Dateien im Format PAIN.008 — dem Standardformat, das von ERP- und Buchhaltungssystemen für den Export verwendet wird. Sie können sofort mit der Verarbeitung von SEPA-Lastschriftzahlungen beginnen, indem Sie die Dateien verwenden, die Ihr System bereits generiert, ganz ohne manuelle Konvertierung.

Stellen Sie Folgendes sicher, bevor Sie beginnen:

Ihre Organisation hat SEPA-Lastschriften für Ihr GoCardless-Konto aktiviert
Ihre Datei liegt im Format PAIN.008.001.08 oder PAIN.008.001.02 vor (andere Versionen werden nicht unterstützt)
Ihre Datei ist nicht größer als 20 MB
Ihre Lastschriftmandate sind bereits in GoCardless vorhanden und die Mandatsreferenzen Ihrer Datei stimmen mit den bei GoCardless hinterlegten überein

So funktioniert es:

Klicken Sie auf Zahlungen
Wählen Sie Importieren aus
Laden Sie Ihre XML-Datei im Format PAIN.008.001.08 hoch — GoCardless erkennt den Dateityp automatisch
Überprüfen Sie die Zahlungen auf dem Bestätigungsbildschirm, einschließlich aller markierten Fehler auf Transaktionsebene
Klicken Sie auf Zahlungen verarbeiten, wenn Sie bereit sind.

Der Bestätigungsbildschirm, die Fehlerbehebung und die Verarbeitungsschritte sind identisch mit denen des bestehenden CSV-Importablaufs. Wenn Sie mit CSV-Importen umgehen können, können Sie auch XML-Importe vornehmen.

FAQs

Steht die Importfunktion von XML-Dateien allen GoCardless-Händlern zur Verfügung?
Kann ich im GoCardless-Dashboard eine XML-Datei hochladen, um SEPA-Lastschriftzahlungen zu erstellen?
Welches XML-Dateiformat unterstützt GoCardless?
Benötige ich eine Vorlage, um eine XML-Datei zu erstellen?
Wie unterscheidet sich der Upload einer XML-Datei von dem einer CSV-Datei?
Wie groß darf eine hochzuladende Datei maximal sein?
Ich verwende ein ERP-System (wie SAP oder Microsoft Dynamics), das XML-Dateien im Format PAIN.008 exportiert. Funktioniert das?
Muss ich die Kunden über die Migration des Lastschriftmandats informieren?
Was passiert, wenn ein Lastschriftmandat in meiner XML-Datei noch nicht in GoCardless vorhanden ist?
Einige Transaktionen in meiner Datei sind fehlgeschlagen. Bedeutet das, dass die gesamte Datei abgelehnt wurde?
Welche Fehler könnten dazu führen, dass die gesamte XML-Datei abgelehnt wird?
Ich habe eine XML-Datei hochgeladen, erhalte aber die Fehlermeldung, dass die falsche Version verwendet wird. Was kann ich tun?
Ich habe eine XML-Datei hochgeladen, aber ich bekomme den Fehler, dass in GoCardless kein Lastschriftmandat existiert. Was kann ich tun?
Wie kann ich sehen, ob mein Import als CSV- oder XML-Datei verarbeitet wurde?

Erste Schritte & Voraussetzungen

Steht die Importfunktion von XML-Dateien allen GoCardless-Händlern zur Verfügung?

XML-Importe stehen Händlern zur Verfügung, die SEPA-Lastschriften für ihr GoCardless-Konto aktiviert haben. Falls Sie noch keinen Zugriff auf XML-Importe haben, wenden Sie sich bitte an Ihren Account Manager oder unseren Support. Wir helfen Ihnen gerne bei der Einrichtung.

Kann ich im GoCardless-Dashboard eine XML-Datei hochladen, um SEPA-Lastschriftzahlungen zu erstellen?

Ja! Wenn das SEPA-Lastschriftschema Ihrer Organisation aktiviert ist, können Sie eine XML-Datei im Format PAIN.008.001.08 direkt über das Dashboard hochladen, ohne sie zu konvertieren. Es handelt sich um dieselbe Datei, die Ihr ERP- oder Buchhaltungssystem bereits für die Übermittlung an Banken generiert. Sie können nach dem Upload also direkt mit der Bearbeitung von Zahlungen beginnen.

Welches XML-Dateiformat unterstützt GoCardless?

GoCardless unterstützt das Format PAIN.008.001.08, das dem ISO-20022-Standard für die Initiierung von SEPA-Lastschriften entspricht. Wenn Sie versuchen, eine ältere Version hochzuladen (z. B. PAIN.008.001.02), erhalten Sie eine eindeutige Fehlermeldung mit der Information, dass nur Version 001.08 akzeptiert wird.

Ihre Datei hochladen

Benötige ich eine Vorlage, um eine XML-Datei zu erstellen?

Nein, es ist keine Vorlage nötig. Anders als beim Import von CSV-Dateien sollte Ihre XML-Datei direkt aus Ihrem ERP- oder Buchhaltungssystem (z. B. SAP, Microsoft Dynamics oder Sage) im Format PAIN.008.001.08 exportiert werden. GoCardless liest diese Datei so, wie sie ist. Sie müssen also nichts ausfüllen oder vor dem Hochladen neu formatieren.

Wie unterscheidet sich der Upload einer XML-Datei von dem einer CSV-Datei?

Der Ablauf ist identisch. GoCardless erkennt automatisch, ob Ihre Datei im XML- oder CSV-Format vorliegt, sodass Sie keine Einstellungen umschalten oder Ihren Workflow ändern müssen. Sie sehen in beiden Fällen denselben Bestätigungsbildschirm, dieselbe Fehlermeldungsanzeige und dieselben Verarbeitungsschritte.

Wie groß darf eine hochzuladende Datei maximal sein?

Die maximale Dateigröße beträgt 20 MB, dieselbe Grenze, die auch für CSV-Importe gilt. Für die meisten Händler reicht dies bequem für Zehntausende Transaktionen pro Datei aus.

Lastschriftmandate & Kunden

Ich verwende ein ERP-System (wie SAP oder Microsoft Dynamics), das XML-Dateien im Format PAIN.008 exportiert. Funktioniert das?

Ja, genau dafür ist diese Funktion gedacht. GoCardless liest die Mandatsreferenz (genannt „MndtId") aus Ihrer XML-Datei aus, dieselbe Referenz, die Ihr ERP-System intern verwendet. Sie müssen diese Referenzen nicht durch GoCardless-spezifische IDs ersetzen.

Muss ich die Kunden über die Migration des Lastschriftmandats informieren?

Ja, gemäß den Anforderungen des Lastschriftschemas sind Sie verpflichtet, Kunden über jede Änderung des SEPA-Lastschriftanbieters sowie über jede Änderung ihrer Mandatsreferenz zu informieren und ihnen die alte und neue Gläubiger-Identifikationsnummer zu bestätigen. Das Schreiben muss außerdem das Datum der Änderung nennen. Weitere Informationen zu den Anforderungen finden Sie hier

Was passiert, wenn ein Lastschriftmandat in meiner XML-Datei noch nicht in GoCardless vorhanden ist?

Im Rahmen Ihres Onboardings bei GoCardless empfehlen wir, Ihre bestehenden Lastschriftmandate im Voraus über unseren Massenmigrationsprozess in Ihr GoCardless-Konto zu übertragen und dabei eine Option zu wählen, die Ihre ursprünglichen Mandatsreferenzen beibehält. So werden Ihre XML-Dateien von Anfang an reibungslos verarbeitet. Weitere Informationen zum Massenmigrationsprozess finden Sie hier.

Eine spontane Migration von Lastschriftmandaten ist in manchen Fällen nach Prüfung im Einzelfall verfügbar. Wenn Sie diese Option nutzen möchten, wenden Sie sich an Ihren Account Manager. Wenn in diesem Fall eine Mandatsreferenz in Ihrer Datei nicht mit einem bestehenden Lastschriftmandat in GoCardless übereinstimmt, zum Beispiel, weil das Lastschriftmandat nicht in Ihrer ursprünglichen Migration enthalten war, migriert GoCardless das Lastschriftmandat automatisch mithilfe der Daten in Ihrer XML-Datei. Sie müssen diese Migration jedoch im Dashboard bestätigen.
Dies dient als Sicherheitsnetz, damit keine Zahlungen übersehen werden. Wir empfehlen jedoch nicht, sich beim Onboarding allein darauf zu verlassen, statt eine vollständige Kundenmigration durchzuführen, da zeitliche Abweichungen zwischen der Erstellung von Zahlungen und der Aktivierung von Lastschriftmandaten Ihre Verarbeitung beeinträchtigen können.

Fehler & Fehlerbehebung

Einige Transaktionen in meiner Datei sind fehlgeschlagen. Bedeutet das, dass die gesamte Datei abgelehnt wurde?

Nicht unbedingt. Es besteht ein Unterschied zwischen Fehlern auf Dateiebene und Fehlern auf Transaktionsebene:

Fehler auf Dateiebene (z. B. eine nicht unterstützte XML-Version oder eine beschädigte Datei) führen zur Ablehnung des gesamten Uploads. Der Grund dafür wird deutlich auf der Importdetailseite angezeigt.
Fehler auf Transaktionsebene (wie z. B. eine ungültige Bankkontonummer für eine bestimmte Zahlung) wirken sich nur auf die betroffenen einzelnen Transaktionen aus. Der Rest Ihrer Zahlungen wird normal verarbeitet, und Sie können einen Fehlerbericht als CSV herunterladen, um genau zu sehen, welche Transaktionen Aufmerksamkeit benötigen und warum.

Welche Fehler könnten dazu führen, dass die gesamte XML-Datei abgelehnt wird?

Ihre Datei wird abgelehnt, wenn einer der folgenden Punkte zutrifft:

Sie liegt in einer nicht unterstützten PAIN.008-Version vor (PAIN.008.001.08 und PAIN.008.001.02 werden akzeptiert)
Sie ist kein gültiges oder lesbares XML-Dokument
Sie besteht nicht die strukturelle Validierung gemäß dem PAIN.008.001.08/PAIN.008.001.02-Standard
Sie enthält einen anderen Zahlungstyp als das SEPA-Basislastschriftverfahren (B2B-Lastschriften werden nicht unterstützt)
Die Anzahl der Transaktionen oder der Gesamtbetrag im Datei-Header stimmen nicht mit dem tatsächlichen Inhalt überein
Die Datei wurde bereits importiert (GoCardless erkennt Duplikate anhand der eindeutigen Message-ID der Datei)

In jedem Fall wird Ihnen eine spezifische Fehlermeldung angezeigt, die erklärt, was schiefgelaufen ist.

Ich habe eine XML-Datei hochgeladen, erhalte aber die Fehlermeldung, dass die falsche Version verwendet wird. Was kann ich tun?

GoCardless unterstützt PAIN.008.001.08 und PAIN.008.001.02. Falls Ihre ERP- oder Banksoftware eine ältere Version generiert, müssen Sie Ihre Exporteinstellungen auf eine dieser unterstützten Versionen aktualisieren. Überprüfen Sie Ihre Exportkonfiguration oder wenden Sie sich an Ihren ERP-Anbieter, um Hilfe zu erhalten.

Ich habe eine XML-Datei hochgeladen, aber ich bekomme den Fehler, dass in GoCardless kein Lastschriftmandat existiert. Was kann ich tun?

Dieser Fehler bedeutet, dass die Mandatsreferenz in Ihrer Datei keine Übereinstimmung in Ihrem GoCardless-Konto hat. Meistens liegt das an einem der folgenden Gründe:

Das Lastschriftmandat wurde nie in GoCardless migriert, oder
Es wurde migriert, jedoch mit einer anderen Referenznummer als der, die Ihr ERP verwendet

So prüfen Sie das:

Nehmen Sie die Mandatsreferenz aus Ihrer XML-Datei
Vergleichen Sie sie mit den Mandatsreferenzen in Ihrem GoCardless-Konto

Wenn sie nicht übereinstimmen:

Wenn das Lastschriftmandat in GoCardless unter einer anderen Referenz existiert, aktualisieren Sie Ihr ERP mit der korrekten GoCardless-Referenz, damit zukünftige Exporte übereinstimmen
Wenn das Lastschriftmandat überhaupt noch nicht migriert wurde, wählen Sie bei der Einrichtung der Massenmigration eine der Optionen, die Ihre ursprünglichen Mandatsreferenzen beibehält. So stellen Sie sicher, dass Ihre exportierte Datei und GoCardless von Anfang an übereinstimmen. Weitere Informationen zum Massenmigrationsprozess finden Sie hier.

Importverlauf & Tracking

Wie kann ich sehen, ob mein Import als CSV- oder XML-Datei verarbeitet wurde?

In Ihrem Importverlauf im Dashboard wird neben jedem Import eine Kennzeichnung, entweder „CSV" oder „XML", angezeigt, sodass Sie die Importe leicht unterscheiden können.