CSV-Dateiformat
1. Allgemeines
Die Importfunktion von PayMaker kann Dateien verarbeiten, die den folgenden Regeln entsprechen:
- Die Datei ist eine reine Textdatei.
- Pro Zeile wird eine Zahlung definiert.
- Jede Zeile wird mit CR/LF oder LF abgeschlossen.
- Die Felder in den Zeilen werden mit TAB, Komma oder Semikolon getrennt.
- Für jeden Datensatz müssen genau 28 Felder vorhanden sein, auch wenn sie gemäss Spezifikation optional oder nicht relevant sind.
2. Beschreibung der Felder
2.1 Zahlungsart
PayMaker akzeptiert die folgenden Zahlungsarten (gemäss ISO 20022 Standard):
- 1: Einzahlungsschein mit Referenznummer (ESR) / Oranger Einzahlungsschein.
- 2: Roter Einzahlungsschein. Empfehlung: Als Zahlungsart 3 erfassen.
- 3: Zahlung in CHF oder EUR auf Konten in der Schweiz oder Liechtenstein.
- 4: Zahlung in Fremdwährungen auf Konten in der Schweiz oder Liechtenstein.
- 6: Zahlung auf Konten im Ausland.
2.2 Belastungskonto
IBAN eines in der PayMaker-Datenbank existierenden Belastungskontos.
2.3 Betrag
Gültiger Betrag grösser als 0.00.
2.4 Währung
Dreistelliger ISO-Währungscode (ISO 4217), z.B. CHF oder EUR.
2.5 Ausführungsdatum
Datum in der Form TT.MM.JJJJ.
2.6 Kontonummer des Begünstigten
- Bei Zahlungsart 1:
- Falls der Begünstigte selber eine ESR-Teilnehmernummer hat: ESR-Teilnehmernummer.
- Falls der Begünstigte ein Konto bei einer Bank hat: Leer.
- Bei Zahlungsart 2 :
- Falls der Begünstigte selber ein Postkonto hat: Postkontonummer.
- Falls der Begünstigte ein Konto bei einer Bank hat: IBAN des Begünstigten.
- Grundsätzlich können Zahlungen mit Zahlungsart 2 auch als Zahlungsart 3 erfasst werden — dies wird empfohlen.
- Bei Zahlungsart 3 und 4: Schweizer oder Liechtensteiner IBAN.
- Bei Zahlungsart 6: Kontonummer, IBAN falls vorhanden.
2.7 Kontonummer der Bank
- Bei Zahlungsart 1:
- Falls der Begünstigte selber eine ESR-Teilnehmernummer hat: Leer.
- Falls der Begünstigte ein Konto bei einer Bank hat: ESR-Teilnehmernummer der Bank.
- Bei Zahlungsart 2:
- Falls der Begünstigte selber ein Postkonto hat: Leer.
- Falls der Begünstigte ein Konto bei einer Bank hat: Postkontonummer der Bank.
- Bei Zahlungsart 3, 4 und 6: Leer.
2.8 ID der Bank
- Bei Zahlungsart 1, 2, 3 und 4: Leer.
- Bei Zahlungsart 6: Identifikationscode der Bank, wenn möglich der BIC.
2.9 Ist Bank ID ein BIC
- Bei Zahlungsart 1, 2, 3 und 4: Leer.
- Bei Zahlungsart 6:
- 1: Die in Feld 8 angegebene ID der Bank ist ein BIC.
- 0: Die in Feld 8 angegebene ID der Bank kein BIC ist.
2.10 Buchungstext
Frei wählbarer Text, kann leer sein.
2.11 Rechnungsnummer
Frei wählbarer Text, kann leer sein.
2.12 Rechnungsdatum
Datum in der Form TT.MM.JJJJ, kann leer sein.
2.13 Salärzahlung
- Bei Zahlungsart 1 und 6: Leer — andere Werte werden ignoriert.
- Bei Zahlungsart 2, 3 und 4:
- 1: Die Zahlung ist eine Salärzahlung.
- 0 oder leer: Die Zahlung ist keine Salärzahlung.
2.14 Tags
Optional: Eine mit Komma getrennte Liste von Tags (Etiketten).
2.15 Message
Optional: Die Meldung, die an den Begünstigten übermittelt wird. Zeilenumbrüche können mit \n eingefügt werden.
2.16 Name des Begünstigten
Obligatorisch.
2.17 Strasse des Begünstigten
Optional.
2.18 PLZ des Begünstigten
- Obligatorisch für Zahlungsart 2, 3 und 4.
- Optional für Zahlungsart 1 und 6.
2.19 Ort des Begünstigten
- Obligatorisch für Zahlungsart 2, 3, 4 und 6.
- Optional für Zahlungsart 1.
2.20 Land des Begünstigten
Zweistelliger ISO-Ländercode (ISO 3166 ALPHA-2), z.B. CH oder DE.
- Obligatorisch für Zahlungsart 6.
- Optional für Zahlungsart 1, 2, 3 und 4.
2.21 Name der Bank
- Obligatorisch in den folgenden Fällen:
- Bei Zahlungsart 1 und 2, wenn der Begünstigte ein Konto bei einer Bank hat.
- Bei Zahlungsart 6, wenn die Bank nicht durch einen BIC identifiziert wird.
- In allen anderen Fällen: Leer.
2.22 Strasse der Bank
Optional.
2.23 PLZ der Bank
- Obligatorisch in den folgenden Fällen:
- Bei Zahlungsart 1 und 2, wenn der Begünstigte ein Konto bei einer Bank hat.
- In allen anderen Fällen: Leer.
2.24 Ort der Bank
- Obligatorisch in den folgenden Fällen:
- Bei Zahlungsart 1 und 2, wenn der Begünstigte ein Konto bei einer Bank hat.
- Bei Zahlungsart 6, wenn die Bank nicht durch einen BIC identifiziert wird.
- Optional in allen anderen Fällen.
2.25 Land der Bank
Zweistelliger ISO-Ländercode (ISO 3166 ALPHA-2), z.B. CH oder DE.
- Obligatorisch für Zahlungsart 6, wenn die Bank nicht durch einen BIC identifiziert wird.
- Optional in allen anderen Fällen.
2.26 Referenznummer
- Obligatorisch bei Zahlungsart 1.
- Leer bei allen anderen Zahlungsarten.
2.27 Zahlungsinformationen
- Nur für Zahlungsart 6:
- SHAR: Die Gebühren werden geteilt.
- CRED: Die Gebühren werden vom Begünstigten bezahlt.
- DEBT: Die Gebühren werden vom Auftraggeber bezahlt.
- Leer bei allen anderen Zahlungsarten.
2.28 Dringende Zahlung
- Nur für Zahlungsart 6:
- 1: Die Zahlung erhält den Vermerk “Dringend”.
- 0: Die Zahlung erhält keinen Vermerk.
- Leer bei allen anderen Zahlungsarten.