SWIFT module of the Python FinTech package.

This module defines functions to parse SWIFT messages.

• parse_mt940()
• SWIFTParserError

fintech.swift.parse_mt940(data)

Parses a SWIFT message of type MT940 or MT942.

It returns a list of bank account statements which are represented as usual dictionaries. Also all SEPA fields are extracted. All values are converted to unicode strings.

A dictionary has the following structure:

• order_reference: string (Auftragssreferenz)

• reference: string or None (Bezugsreferenz)

• bankcode: string (Bankleitzahl)

• account: string (Kontonummer)

• number: string (Auszugsnummer)

• balance_open: dict (Anfangssaldo)

  • amount: Decimal (Betrag)
  • currency: string (Währung)
  • date: date (Buchungsdatum)

• balance_close: dict (Endsaldo)

  • amount: Decimal (Betrag)
  • currency: string (Währung)
  • date: date (Buchungsdatum)

• balance_booked: dict or None (Valutensaldo gebucht)

  • amount: Decimal (Betrag)
  • currency: string (Währung)
  • date: date (Buchungsdatum)

• balance_noted: dict or None (Valutensaldo vorgemerkt)

  • amount: Decimal (Betrag)
  • currency: string (Währung)
  • date: date (Buchungsdatum)

• sum_credits: dict or None (Summe Gutschriften / MT942 only)

  • amount: Decimal (Betrag)
  • currency: string (Währung)
  • count: int (Anzahl Buchungen)

• sum_debits: dict or None (Summe Belastungen / MT942 only)

  • amount: Decimal (Betrag)
  • currency: string (Währung)
  • count: int (Anzahl Buchungen)

• transactions: list of dictionaries (Auszugsposten)

  • description: string or None (Beschreibung)

  • valuta: date (Wertstellungsdatum)

  • date: date or None (Buchungsdatum)

  • amount: Decimal (Betrag)

  • reversal: bool (Rückbuchung)

  • booking_key: string (Buchungsschlüssel)

  • booking_text: string or None (Buchungstext)

  • reference: string (Kundenreferenz)

  • bank_reference: string or None (Bankreferenz)

  • gvcode: string (Geschäftsvorfallcode)

  • primanota: string or None (Primanoten-Nr.)

  • bankcode: string or None (Bankleitzahl)

  • account: string or None (Kontonummer)

  • iban: string or None (IBAN)

  • amount_original: dict or None (Originalbetrag in Fremdwährung)

    • amount: Decimal (Betrag)
    • currency: string (Währung)

  • charges: dict or None (Gebühren)

    • amount: Decimal (Betrag)
    • currency: string (Währung)

  • textkey: int or None (Textschlüssel)

  • name: list of strings (Name)

  • purpose: list of strings (Verwendungszweck)

  • sepa: dictionary of SEPA fields

  • [nn]: Unknown structured fields are added with their numeric ids.

Parameters:	data – The SWIFT message.
Returns:	A list of dictionaries.

exception fintech.swift.SWIFTParserError

SWIFT parser returned an error.