Welche camt-Versionen prüft SepaCheck?
camt.053.001.02, camt.053.001.08, camt.054.001.02 und camt.054.001.08, gegen die offiziellen ISO-20022-XML-Schemas. Andere camt-Versionen werden erkannt und mit valid: false zurückgegeben.
Kontoauszüge
camt.053- und camt.054-Prüfung
Kontoauszug oder Umsatzavis gegen das offizielle ISO-20022-Schema prüfen, oder nach JSON und CSV wandeln. Kein API-Schlüssel. English
Versionen
camt.053.001.02undcamt.053.001.08(BankToCustomerStatement)camt.054.001.02undcamt.054.001.08(BankToCustomerDebitCreditNotification)
Die Prüfung nutzt diese vier offiziellen XML-Schemas. POST /v1/validate bleibt die pain.001-Prüfung. Eine camt-Datei dorthin wird erkannt und mit valid: false beantwortet. Auszüge gehören auf die Endpunkte dieser Seite.
Freikontingent
- Kein API-Schlüssel.
- 30 Anfragen pro IP und Stunde und 200 pro UTC-Tag, gemeinsam mit
POST /v1/validate. - Höchstens 2 MB. Größere Dateien erhalten HTTP 413 und verbrauchen das Kontingent nicht.
- Darüber: HTTP 429,
Retry-Afterund die HeaderX-RateLimit-*.
Prüfen
POST /v1/camt/validate. Multipart-Feld file oder ein roher XML-Body. HTTP 200 ist der Bericht. valid ist nur wahr, wenn das offizielle Schema die Datei annimmt. GET liefert 405.
curl -F "file=@camt053.xml" https://checksepa.com/v1/camt/validateJeder Fund hat code, message, path und line. Schema-Codes sind XSD-REQUIRED, XSD-TYPE, XSD-UNEXPECTED und XSD. Eine nicht unterstützte Version ist XSD-VERSION. Unlesbares XML ist XSD-PARSE.
Umwandeln
POST /v1/camt/convert?format=json oder format=csv. Ohne Angabe gilt json. Bei einer Gutschrift (CRDT) ist die Gegenpartei der Debtor, bei einer Belastung (DBIT) der Creditor. camt.054 hat in diesen Versionen Umsätze und keine Auszugssalden, daher ist balances leer.
curl -F "file=@camt053.xml" "https://checksepa.com/v1/camt/convert?format=json"curl -F "file=@camt053.xml" "https://checksepa.com/v1/camt/convert?format=csv"JSON enthält format, version und statements. Jeder Auszug hat id, accountIban, accountCurrency, balances und entries. Ein Umsatz hat amount, currency, creditDebit, bookingDate, valueDate, counterpartyName, counterpartyIban, remittanceInfo und endToEndId.
CSV hat eine Kopfzeile und eine Zeile je Saldo oder Umsatz. Die Spalte row_type ist balance oder entry.
Die Umwandlung liest ein unterstütztes camt-Dokument auch dann, wenn die Schema-Prüfung scheitern würde. pain.001 und andere Nachrichten erhalten HTTP 400 mit unsupported_message. Ein leerer Body ist 400. Über 2 MB ist 413. GET ist 405.
Datenschutz
- Die Datei bleibt im Speicher dieser Anfrage und wird verworfen. Sie wird nicht auf die Platte geschrieben.
- DOCTYPE und Entity-Deklarationen werden abgelehnt und nicht aufgelöst.
- Logs enthalten Version, Größe und Fehlercodes. XML, IBANs und Namen werden nicht geloggt.
Fragen
Was liefert die Konvertierung?
POST /v1/camt/convert?format=json liefert Kontoauszüge mit IBAN, Salden und Umsätzen. Jeder Umsatz hat Betrag, Währung, Credit oder Debit, Buchungsdatum, Valuta, Name und IBAN der Gegenpartei, Verwendungszweck und End-to-End-Id. format=csv liefert dieselben Zeilen als CSV. Bei einer Gutschrift ist die Gegenpartei der Debtor, bei einer Belastung der Creditor.
Werden Kontoauszüge gespeichert?
Nein. Prüfung und Konvertierung laufen nur im Speicher dieser Anfrage. Das XML wird verworfen. Logs enthalten Version, Größe und Fehlercodes, nicht den Auszug.
Heißt gültig, dass die Salden stimmen?
Nein. valid heißt, dass die Datei zum offiziellen Schema passt. Es ist keine Abstimmung des Kontos und keine Prüfung der bankeigenen Implementierungsrichtlinie.
Haben camt-Anfragen ein eigenes Freikontingent?
Nein. POST /v1/validate, POST /v1/camt/validate und POST /v1/camt/convert teilen sich ein Freikontingent: 30 Anfragen pro IP und Stunde, 200 pro UTC-Tag, höchstens 2 MB, ohne API-Schlüssel.