pixi

Import von Zahlungen im Format camt.053


Der Zahlungsimport für ESR Zahlungen wurde erweitert so dass nicht nur ESR|ISR Zahlungen verarbeitet werden können, sondern auch QRR Zahlungen anhand des BTC (Bank Transaction Codes)|GVC (Geschäftsvorfälle) und der dazugehörigen Family Codes aus den camt.053 Bankdateien ausgelesen werden können. Den unterstützten camt-Standard aktualisieren wir regelmäßig.

Das alte Verfahren, die ESR|ISR Reference aus dem Tag <Ref></Ref> auszulesen, wurde hierdurch ersetzt.

Wir unterstützen derzeit die folgenden Family-Codes inkl. aller darunterliegenden Sub-Family-Codes:

  • <Fmly><Cd>RCHQ </Cd></Fmly> = Received Cheques

  • <Fmly><Cd>RCDT</Cd></Fmly> = Received Credit Transfers

  • <Fmly><Cd>RDDT</Cd></Fmly> = Received Direct Debits

  • <Fmly><Cd>CNTR </Cd></Fmly> = Counter Transactions

  • <Fmly><Cd>RRCT </Cd></Fmly> = Receivable Real-Time Credit Transfers (Echtzeitüberweisungen)

  • ... sowie: MCRD, MDOP, IDDT, ICDT, ICHQ, ICCN, CCRD, CNTR, CAPL, OPCL, MCOP


Wichtige Links / Spezifikationen


Für pixi relevante Felder

Die folgende Tabelle enthält alle Felder, die aus der camt.053-Datei zu pixi importiert werden.
In pixi wird die Transaktion nach dem Import so angezeigt:




Name des XML Tags

Beschreibung

Import zu pixi

BookgDt
(Booking Date)

enthält das Buchungsdatum der Transaktion

pixi Zahlungen > Zahlungsdetails > Gebucht
Format: "MMTT"

ValDt
(Validation Date)

enthält das Wertstellungsdatum der Transaktion

pixi Zahlungen > Zahlungsübersicht > Datum
bzw.
pixi Zahlungen > Zahlungsübersicht > Zahlungsdetails > Bankdatum

Refs
(References)

enthält Referenzen, die zur Transaktion gehören:

  • <EndToEndId>: Ende-zu-Ende Referenz

pixi Zahlungen > Zahlungsübersicht > Zahlungsdetails > Betreff/Text 2

Amt Ccy
(Amount)

enthält den Betrag und die Währung der Transaktion

pixi Zahlungen > Zahlungsübersicht > (Zahlungsdetails >) Betrag / Währung

CdtDbtInd
(Credit Debit Indicator)

enthält entweder CRDT oder DBIT und legt die Art der Transaktion fest

wird in die pixi Datenbank importiert, aber in der Applikation nicht angezeigt

BkTxCd
(Bank Transaction Code)

enthält unterschiedliche Domain Codes, Family Codes, SubFamily Codes, die die Transaktion kennzeichnen

<BkTxCd>
 <Domn>
  <Cd>PMNT</Cd>
    <Fmly>
     <Cd>RCDT</Cd>
      <SubFmlyCd>VCOM</SubFmlyCd>
    </Fmly>
  </Domn>
 </BkTxCd>

Wir unterstützen derzeit die folgenden Family Codes inkl. aller darunterliegenden SubFamily Codes:

  • <Fmly><Cd>RCHQ </Cd></Fmly> = Received Cheques

  • <Fmly><Cd>RCDT</Cd></Fmly> = Received Credit Transfers

  • <Fmly><Cd>RDDT</Cd></Fmly> = Received Direct Debits

  • <Fmly><Cd>CNTR </Cd></Fmly> = Counter Transactions

  • <Fmly><Cd>RRCT</Cd></Fmly> = Receivable Real-Time Credit Transfers (Echtzeitüberweisungen)

  • ..und MCRD, MDOP, IDDT, ICDT, ICHQ, ICCN, CCRD, CNTR, CAPL, OPCL, MCOP

wird in die pixi Datenbank importiert und für das Einlesen der ESR|QRR Zahlungen berücksichtigt, aber in der Applikation nicht angezeigt

RltdPties
(Related Parties)

enthält die Parteien, die an der Transaktion beteiligt sind:

  • <Dbtr> oder <Cdtr><Nm>: Name des Debitors/Kreditors

  • <DbtrAcct> oder <CdtrAcct><Id><IBAN>: IBAN des Debitors/Kreditors

  • für Lastschriften: Debitor = Händler

  • für Gutschriften: Debitor = Endkunde

Kundenname: pixi Zahlungen > Zahlungsübersicht > (Zahlungsdetails >) Von

IBAN: pixi Zahlungen > Zahlungsübersicht > Zahlungsdetails > IBAN

RltAgts
(Related Agents)

enthält Informationen zum Kreditinstitut (BIC)

  • <DbtrAgt> oder <CdtrAgt><FinInstnId><BICFI>: BIC der Bank des Endkunden

pixi Zahlungen > Zahlungsübersicht > Zahlungsdetails > BIC

RmtInf
(Remittance Information)

Dieser Abschnitt enthält die für pixi wichtigen Daten:

  • <Ustrd>: unstrukturierte Informationen zur Transaktion; wird nur importiert, wenn <Strd> nicht gefüllt

  • <Strd>: strukturierte Informationen zur Transaktion

    • <CdtrRefInf><Tp><CdOrPrtry><Prtry>: Enthält dieser Tag den Wert "ISR Reference", nur dann wird die Transaktion zu pixi importiert. (bis pixi 21.02)

    • <CdtrRefInf><Ref>: Der Inhalt dieses Tags enthält den ESR Code und wird ohne führende Nullen und ohne Prüfziffer am Ende in den Betreff 1 importiert.

Führende Nullen und die letzte (Prüf)ziffer werden nicht importiert. Das bedeutet:

  • Bei Import einer Zahlung ohne ISR-Referenz wird die letzte Ziffer des BankText01 nicht abgeschnitten.

  • Bei Import einer Zahlung mit ISR-Referenz wird die letzte Ziffer das BankText01 abgeschnitten. (Verhalten wie bisher)

pixi Zahlungen > Zahlungsübersicht > (Zahlungsdetails >) Betreff / Text 1

CreDtTm
(Creation Date Time)

enthält das Erstellungsdatum bzw. den Erstellungszeitpunkt des Kontoauszugs / Reports

wird als Erstellungsdatum des Reports geparst; kein eigener sichtbarer Standardwert in der pixi Zahlungsübersicht

Acct / Ccy
(Account Currency)

enthält die Währung des Kontos

wird für die Kontowährung bzw. als Fallback für die Währung verwendet; in der Applikation in der Regel nicht separat angezeigt

Acct / Svcr / FinInstnId / BIC (Account BIC)

enthält den BIC der kontoführenden Bank

wird als Konto-/Bank-BIC importiert; kein eigener sichtbarer Standardwert in der pixi Zahlungsübersicht

BkTxCd / Prtry / Cd (Bank Transaction Code Proprietary)

enthält den proprietären Bank-Transaktionscode, z. B. PMNT-RCDT-051; dient als zusätzlicher TransactionCode / BusinessCode

wird in die pixi Datenbank importiert und zur bankfachlichen Zuordnung verwendet, aber in der Applikation nicht angezeigt

AmtDtls / TxAmt / Amt Ccy
(Transaction Amount Details)

enthält den Betrag und die Währung der Transaktion in einer alternativen Struktur unterhalb von AmtDtls; in XML 2 ist dies der 2. mögliche Pfad für den Betrag

wird als alternativer Betragspfad importiert, falls TxDtls/Amt nicht vorhanden ist; Anzeige wie bei Amt Ccy: pixi Zahlungen > Zahlungsübersicht > (Zahlungsdetails >) Betrag / Währung

Ntry / Amt Ccy
(Entry Amount)

enthält den Betrag und die Währung auf Entry-Ebene; in XML 2 ist dies der 3. mögliche Pfad für den Betrag

wird als weiterer Fallback-Betragspfad importiert, falls kein Betrag auf TxDtls-Ebene vorhanden ist; Anzeige wie bei Amt Ccy: pixi Zahlungen > Zahlungsübersicht > (Zahlungsdetails >) Betrag / Währung

Btch / NbOfTxs
(Number of Transactions in Batch)

enthält die Anzahl der Transaktionen in einem Batch / Sammelposten

wird in die pixi Datenbank importiert; in der Applikation normalerweise nicht separat angezeigt

Zum Seitenanfang

Vollständiges XML-Beispiel

Nachfolgend ein vollständiges XML-Beispiel im camt.053-Format mit auskommentierten Felderklärungen:

<?xml version="1.0" encoding="UTF-8"?>

<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.053.001.04">
<BkToCstmrStmt>
<Stmt>
<CreDtTm>2024-12-31T12:00:00</CreDtTm> <!-- CreateDate: parsed as report creation date -->
<Acct>
<Ccy>EUR</Ccy> <!-- AccountCurrency: currency of the account -->
<Svcr>
<FinInstnId>
<BIC>DEUTDEFF</BIC> <!-- AccountBic: BIC of the account's bank -->
</FinInstnId>
</Svcr>
</Acct>
<Ntry>
<BookgDt>
<Dt>2024-12-31</Dt> <!-- BookingDate: booking date of the transaction -->
</BookgDt>
<ValDt>
<Dt>2024-12-31</Dt> <!-- BankDate: value date of the transaction -->
</ValDt>
<Amt Ccy="EUR">123.45</Amt> <!-- Amount: transaction amount and currency (3rd option) -->
<CdtDbtInd>CRDT</CdtDbtInd> <!-- FundsCode: CRDT (credit) or DBIT (debit) (2nd option) -->
<BkTxCd>
<Domn>
<Cd>PMNT</Cd> <!-- BankTransactionCodeDomain: transaction domain code (2nd option)-->
<Fmly>
<Cd>RCDT</Cd> <!-- BankTransactionCodeFamilyDomain: family code, used in WHERE clause - used, if not specified in NtryDtls/TxDtls/BkTxCd/Domn/Fmly/Cd (line 49) -->
<!-- currently supported (2026.01): RCHQ, RCDT, RDDT, CNTR, RRCT, MCRD, MDOP, IDDT, ICDT, ICHQ, ICCN, CCRD, CAPL, OPCL, MCOP, ESCT -->
</Fmly>
</Domn>
<Prtry>
<Cd>PMNT-RCDT-051</Cd> <!-- BankTransactionCodeProprietary: proprietary code, TransactionCode/BusinessCode -->
</Prtry>
</BkTxCd>
<NtryDtls>
<TxDtls>
<Refs>
<EndToEndId>ABC123456789</EndToEndId> <!-- BankText02: end-to-end reference -->
</Refs>
<Amt Ccy="EUR">123.45</Amt> <!-- Amount: transaction amount and currency (1st option) -->
<AmtDtls>
<TxAmt>
<Amt Ccy="EUR">123.45</Amt> <!-- Amount: transaction amount and currency (2nd option) -->
</TxAmt>
</AmtDtls>
<CdtDbtInd>CRDT</CdtDbtInd> <!-- FundsCode: CRDT (credit) or DBIT (debit) (1st option) -->
<BkTxCd>
<Domn>
<Cd>PMNT</Cd> <!-- BankTransactionCodeDomain: transaction domain code (1st option)-->
<Fmly>
<Cd>RCDT</Cd> <!-- BankTransactionCodeFamilyDomain: family code -->
</Fmly>
</Domn>
<Prtry>
<Cd>PMNT-RCDT-051</Cd>
</Prtry>
</BkTxCd>
<RltdPties>
<Dbtr>
<Nm>John Doe</Nm> <!-- CreditorCustomerName: name of the debtor (payer) (1st option)-->
</Dbtr>
<Dbtr>
<Pty>
<Nm>John Doe</Nm> <!-- CreditorCustomerName: name of the debtor (payer) (2nd option)-->
</Pty>
</Dbtr>
<DbtrAcct>
<Id>
<IBAN>DE89370400440532013000</IBAN> <!-- CreditorIBAN: IBAN of the debtor (payer) -->
</Id>
</DbtrAcct>
<Cdtr>
<Nm>Jane Smith</Nm> <!-- DebitorCustomerName: name of the creditor (payee) (1st option) -->
</Cdtr>
<Cdtr>
<Pty>
<Nm>Jane Smith</Nm> <!-- DebitorCustomerName: name of the creditor (payee) (2nd option)-->
</Pty>
</Cdtr>
<CdtrAcct>
<Id>
<IBAN>DE12500105170648489890</IBAN> <!-- DebitorIBAN: IBAN of the creditor (payee) -->
</Id>
</CdtrAcct>
</RltdPties>
<RltdAgts>
<CdtrAgt>
<FinInstnId>
<BICFI>COBADEFFXXX</BICFI> <!-- DebitorBIC: BIC of the creditor's bank -->
</FinInstnId>
</CdtrAgt>
<DbtrAgt>
<FinInstnId>
<BICFI>DEUTDEFFXXX</BICFI> <!-- CreditorBIC: BIC of the debtor's bank -->
</FinInstnId>
</DbtrAgt>
</RltdAgts>
<RmtInf>
<Ustrd>Invoice 12345</Ustrd> <!-- BankText01Unstrd: unstructured remittance info 1 -->
<Ustrd>Payment for services</Ustrd> <!-- BankText02Unstrd: unstructured remittance info 2 -->
<Strd>
<CdtrRefInf>
<Ref>987654321</Ref> <!-- BankText01Strd: structured reference info -->
<Tp>
<CdOrPrtry>
<Prtry>ISR</Prtry> <!-- ISR_ref: Swiss reference type -->
</CdOrPrtry>
</Tp>
</CdtrRefInf>
</Strd>
</RmtInf>
</TxDtls>
</NtryDtls>
<Btch>
<NbOfTxs>1</NbOfTxs> <!-- NumOfTxInBatch: number of transactions in batch -->
</Btch>
</Ntry>
</Stmt>
</BkToCstmrStmt>Stmt>
</Document>


Zum Seitenanfang