Zum Inhalt springen
Developer

Kontoauszug CAMT (XML)

Ihr übernehmt Kontoauszüge im Format CAMT (XML) aus eurem Onlinebanking.

Format
XML (CAMT.052, CAMT.053 oder CAMT.054), UTF-8
Rechte
Administrator, Schreibrecht Zahlungen
Beispieldatei
camt_beispiel.xml (herunterladen)

Kurz gesagt: Ladet den Kontoauszug als XML-Datei aus dem Onlinebanking hoch, ohne sie zu ändern. vynst übernimmt die gebuchten Umsätze und ordnet sie danach Rechnungen, Lastschriften und Konten zu.

Wofür ihr das braucht

Kontoauszüge aus dem Onlinebanking sollen in vynst ankommen, damit Zahlungen nicht von Hand erfasst werden müssen.

Bevor ihr startet

  • Rechte: Administrator mit Schreibrecht für Zahlungen.
  • Zahlungsprofil: Hat euer Konto in vynst ein Zahlungsprofil, sucht vynst es über die eigene IBAN im Auszug. Gibt es mehrere, nimmt vynst das, dessen Bezeichnung im Dateinamen vorkommt. Sonst das erste.

Datei vorbereiten

  • Nichts ändern: Die Datei so hochladen, wie die Bank sie liefert.
  • Dateiname: Der Name muss .xml enthalten. Beginnt er mit camt_, erkennt vynst die Datei sicher.
  • Format: CAMT.052, CAMT.053 oder CAMT.054 im ISO-20022-Format.

Was übernommen wird

Information Wo in vynst
Betrag und Währung Betrag der Buchung
Buchungsdatum Datum der Buchung
Name aus dem Verwendungszweck, sonst der Name des Gegenübers Name der Buchung
IBAN und Name des Gegenübers Bankdaten der Buchung
Mandatsreferenz Bankdaten der Buchung
End-to-End-Referenz Kennung zur Dublettenprüfung
Status, Valuta, Gebühren, Sammlerreferenz Zusatzdaten

Nur gebuchte Umsätze werden übernommen. Andere Buchungen stehen im Protokoll unter SKIPPED ENTRY.

Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.053.001.02">
  <BkToCstmrStmt>
    <GrpHdr>
      <MsgId>BSP-STMT-20260930</MsgId>
      <CreDtTm>2026-09-30T08:00:00</CreDtTm>
    </GrpHdr>
    <Stmt>
      <Id>BSP-STMT-20260930</Id>
      <CreDtTm>2026-09-30T08:00:00</CreDtTm>
      <Acct>
        <Id>
          <IBAN>DE89370400440532013000</IBAN>
        </Id>
        <Ccy>EUR</Ccy>
      </Acct>
      <Bal>
        <Tp><CdOrPrtry><Cd>OPBD</Cd></CdOrPrtry></Tp>
        <Amt Ccy="EUR">1000.00</Amt>
        <CdtDbtInd>CRDT</CdtDbtInd>
        <Dt><Dt>2026-09-01</Dt></Dt>
      </Bal>
      <Bal>
        <Tp><CdOrPrtry><Cd>CLBD</Cd></CdOrPrtry></Tp>
        <Amt Ccy="EUR">1012.50</Amt>
        <CdtDbtInd>CRDT</CdtDbtInd>
        <Dt><Dt>2026-09-30</Dt></Dt>
      </Bal>
      <Ntry>
        <Amt Ccy="EUR">12.50</Amt>
        <CdtDbtInd>CRDT</CdtDbtInd>
        <Sts>BOOK</Sts>
        <BookgDt>
          <Dt>2026-09-01</Dt>
        </BookgDt>
        <ValDt>
          <Dt>2026-09-01</Dt>
        </ValDt>
        <BkTxCd>
          <Prtry>
            <Cd>LASTSCHRIFT</Cd>
          </Prtry>
        </BkTxCd>
        <NtryDtls>
          <TxDtls>
            <Refs>
              <EndToEndId>E2E-2026-0003</EndToEndId>
              <MndtId>M-1001</MndtId>
            </Refs>
            <RltdPties>
              <Dbtr>
                <Nm>Familie Hartmann</Nm>
              </Dbtr>
              <DbtrAcct>
                <Id>
                  <IBAN>DE02120300000000202051</IBAN>
                </Id>
              </DbtrAcct>
            </RltdPties>
            <RmtInf>
              <Ustrd>Beitrag 09/2026 Hartmann</Ustrd>
            </RmtInf>
          </TxDtls>
        </NtryDtls>
      </Ntry>
    </Stmt>
  </BkToCstmrStmt>
</Document>

Beispieldatei: camt_beispiel.xml

So geht’s

  1. Kontoauszug als XML aus dem Onlinebanking laden.
  2. Abrechnung → Bank-Importe → Hinzufügen, Datei auswählen.
  3. Die Datei erscheint in der Liste. Protokoll prüfen.
  4. Die Zuordnung läuft danach im Hintergrund.

Gut zu wissen

  • Bereits importierte Buchungen erkennt vynst und überspringt sie. Überlappende Zeiträume sind also unproblematisch.
  • Jede Datei erzeugt eine neue Gruppe in der Liste der Bank-Importe. Auch wenn alle Buchungen Dubletten sind, bleibt die leere Gruppe bestehen.
  • Gebühren stehen in den Zusatzdaten der Buchung. Rücklastschrift-Informationen stehen nur im Protokoll.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped duplicate Die Buchung gibt es schon. Darunter steht duplicate id: <ID>. Nichts tun.
SKIPPED ENTRY Eine Buchung mit anderem Status als gebucht wurde nicht übernommen. Die Details folgen. Prüfen, ob es sich um eine erwartete Buchung handelt.
Own IBAN: <IBAN> Die eigene IBAN aus dem Auszug. Nur zur Kontrolle. Stimmt die IBAN?
Read: N statements Anzahl der Kontoauszüge in der Datei, nicht der Buchungen. Nichts tun.
FAILED: User missing rights to import. Das Recht für Zahlungen fehlt. Administrator fragen.
FAILED: No matching processor found. Die Datei wird nicht als CAMT erkannt. Dateiname und Format prüfen.

Siehe auch