Dateinamen, Platzhalter und Dateimuster

konfipaySync 2.0 wurde am 31.10.2026 veröffentlicht.

Abbildungen zu diesem Artikel werden noch ergänzt.

Beim Abruf bestimmt das Dateinamensmuster, wie die abgelegten Dateien heißen. Bei der Übertragung bestimmt das Dateimuster, welche Dateien aus dem Quellverzeichnis übertragen werden.

Dateinamen beim Abruf

Vorlagen

Im Teilschritt Wo sollen die Dateien abgelegt werden? wählen Sie unter Dateiname eine Vorlage. Zu jeder Vorlage zeigt konfipaySync den Namen, der dabei herauskommt. Die Dateiendung setzt konfipaySync selbst, passend zum Format.

Aufgabentyp	Vorlagen	Vorgabe
Kontoumsätze abrufen	Datum und IBAN · Datum, IBAN und Kennung · Ursprünglicher Dateiname	Datum, IBAN und Kennung: `{r.YYYY}{r.MM}{r.DD}_{IBAN}_{RID}`
Sonstige Dokumente abrufen	Datum, Dateiname und Kennung · Datum, Auftragsart und Kennung · Ursprünglicher Dateiname · Datum und Kennung	Datum, Dateiname und Kennung: `{r.YYYY}{r.MM}{r.DD}_{FILENAME}_{RID}`
PayPal-Transaktionen abrufen	Datum, Konto und Kennung · Datum und Kennung	Datum und Kennung: `{r.YYYY}{r.MM}{r.DD}_{RID}`

Eigenes Muster

Passt keine Vorlage, wählen Sie Eigenes Muster. Dann erscheinen das Musterfeld, die Platzhalter als Bausteine – ein Klick auf einen Baustein hängt ihn an – und eine Vorschau des entstehenden Namens. Das Muster muss jede Datei eindeutig machen, sonst überschreiben sich die Dateien gegenseitig. Dafür sorgt entweder {RID}, die eindeutige Kennung bei konfipay, oder {_Counter}, der bei Gleichnamigkeit hochzählt.

Ein Muster muss mindestens einen Platzhalter enthalten und darf keine Zeichen enthalten, die Windows in Dateinamen nicht erlaubt. Ist der entstehende Name zu lang, meldet konfipaySync das schon bei der Eingabe.

Platzhalter

Platzhalter	Bedeutung
`{r.YYYY}` `{r.YY}` `{r.MM}` `{r.DD}`	Datum der Bank: Jahr vier- oder zweistellig, Monat, Tag, z. B. 2026, 26, 08, 11
`{r.hh}` `{r.mm}` `{r.ss}` `{r.sss}`	Uhrzeit der Bank: Stunde, Minute, Sekunde, Millisekunde
`{l.YYYY}` `{l.YY}` `{l.MM}` `{l.DD}` `{l.hh}` `{l.mm}` `{l.ss}` `{l.sss}`	Datum und Uhrzeit dieses Servers zum Zeitpunkt des Abrufs
`{IBAN}`	IBAN des Kontos
`{ACCOUNTNAME}`	Bezeichnung des Kontos, wie in konfipay hinterlegt
`{RID}`	Eindeutige Kennung bei konfipay – macht den Dateinamen garantiert eindeutig
`{FORMAT}`	Format der Datei, z. B. camt.053 (Bedeutung je Aufgabentyp siehe unten)
`{FILENAME}`	Dateiname, wie ihn konfipay liefert
`{STATEMENTNUMBER}`	Auszugsnummer des Kontoauszugs – dieselbe, die auf dem Auszug steht
`{ELECTRONICSTATEMENTNUMBER}`	Elektronische Auszugsnummer – die laufende Nummer der elektronisch abgerufenen Auszüge
`{_Counter}`	Fortlaufende Nummer, die nur bei gleichem Namen hochzählt

Welche Platzhalter je Aufgabentyp gefüllt sind

Nicht jede Quelle liefert jede Angabe. konfipaySync bietet deshalb nur die Bausteine an, die für den Aufgabentyp gefüllt sind, und weist ein Muster mit einem Platzhalter ab, der leer bliebe.

Platzhalter	Kontoumsätze	Sonstige Dokumente	PayPal-Transaktionen
Datum und Uhrzeit, `{RID}`, `{_Counter}`	ja	ja	ja
`{IBAN}`	ja	nein	nein
`{ACCOUNTNAME}`	ja	nein	ja – Bezeichnung des PayPal-Kontos
`{FORMAT}`	das Format, z. B. camt.053	die EBICS-Auftragsart, z. B. CRZ	fest „paypal“
`{FILENAME}`	ja	ja	nein
`{STATEMENTNUMBER}`, `{ELECTRONICSTATEMENTNUMBER}`	ja	nein	nein

Weitere Einstellungen zur Ablage

Unter Erweiterte Optionen im Teilschritt Wo sollen die Dateien abgelegt werden?:

Unterverzeichnismuster (optional): Es gelten dieselben Platzhalter wie beim Dateinamen. Ein Schrägstrich trennt die Ebenen: {r.YYYY}/{r.MM} ergibt 2026/08. Die Ordner werden bei Bedarf angelegt. Leer lassen, wenn alles in ein Verzeichnis soll.
Wenn die Zieldatei existiert: Zähler anhängen (empfohlen) – es geht nie eine Datei verloren; Überspringen; Überschreiben – nur zulässig, wenn der Dateiname {RID} oder {_Counter} enthält; Als Fehler behandeln – bricht den Lauf ab und ist für Fälle gedacht, in denen eine Dublette auf ein Problem hinweist.
Zeichensatz: UTF-8 passt fast immer. ISO-8859-1 oder US-ASCII nur, wenn das einlesende System Umlaute sonst falsch darstellt.
Zeilenenden: Wie geliefert übernimmt die Datei unverändert. CRLF (Windows) oder LF (Unix) nur, wenn das einlesende System auf einer bestimmten Form besteht.
Byte Order Mark (BOM) schreiben: ein unsichtbares Zeichen am Dateianfang, an dem manche Programme UTF-8 erkennen. Nur einschalten, wenn das einlesende System es erwartet.

Dateimuster bei der Übertragung

Bei Zahlungsdateien übertragen und Dokumente einreichen werden nur Dateien übertragen, deren Name zu einem der Muster passt. Das Sternchen steht für beliebige Zeichen.

Mehrere Muster trennen Sie mit Semikolon, z. B. *.xml; *.txt.
Unter dem Feld steht eine Schnellwahl häufiger Muster, die ein Muster per Klick ein- oder ausschaltet: bei Zahlungsdateien *.xml und *.txt, bei Dokumenten *.pdf, *.xml, *.csv und *.zip.
Die Zeile Erkannt zeigt beim Tippen, welche einzelnen Muster konfipaySync erkannt hat.
Eine Endung ohne Sternchen (xml) passt nur auf eine Datei, die genau so heißt, und mehrere durch Leerzeichen getrennte Muster gelten als ein einziges Muster. In beiden Fällen schlägt konfipaySync die richtige Schreibweise vor; ein Klick übernimmt sie.
Ein Muster ist ein Dateiname, kein Pfad. Ein Muster für alle Dateien (*.*) ist nicht möglich.