Defining new Segment classes

Base types

class fints.types.Field(length=None, min_length=None, max_length=None, count=None, min_count=None, max_count=None, required=True, _d=None)[source]
render(value)[source]
class fints.types.TypedField(type=None, *args, **kwargs)[source]
class fints.types.ValueList(parent)[source]
class fints.types.ContainerMeta[source]
class fints.types.Container(*args, **kwargs)[source]
classmethod naive_parse(data)[source]
is_unset()[source]

Field types

class fints.fields.DataElementField(*args, **kwargs)[source]
class fints.fields.ContainerField(type=None, *args, **kwargs)[source]
class fints.fields.DataElementGroupField(*args, **kwargs)[source]
class fints.fields.GenericField(*args, **kwargs)[source]
type = None
class fints.fields.GenericGroupField(*args, **kwargs)[source]
type = None
class fints.fields.TextField(*args, **kwargs)[source]
type = 'txt'
class fints.fields.AlphanumericField(*args, **kwargs)[source]
type = 'an'
class fints.fields.DTAUSField(*args, **kwargs)[source]
type = 'dta'
class fints.fields.NumericField(*args, **kwargs)[source]
type = 'num'
class fints.fields.ZeroPaddedNumericField(*args, **kwargs)[source]
type = ''
class fints.fields.DigitsField(*args, **kwargs)[source]
type = 'dig'
class fints.fields.FloatField(*args, **kwargs)[source]
type = 'float'
class fints.fields.AmountField(*args, **kwargs)[source]
type = 'wrt'
class fints.fields.BinaryField(*args, **kwargs)[source]
type = 'bin'
class fints.fields.IDField(*args, **kwargs)[source]
type = 'id'
class fints.fields.BooleanField(*args, **kwargs)[source]
type = 'jn'
class fints.fields.CodeFieldMixin(enum=None, *args, **kwargs)[source]
class fints.fields.CodeField(enum=None, *args, **kwargs)[source]
type = 'code'
class fints.fields.IntCodeField(enum=None, *args, **kwargs)[source]
type = ''
class fints.fields.CountryField(*args, **kwargs)[source]
type = 'ctr'
class fints.fields.CurrencyField(*args, **kwargs)[source]
type = 'cur'
class fints.fields.DateField(*args, **kwargs)[source]
type = 'dat'
class fints.fields.TimeField(*args, **kwargs)[source]
type = 'tim'
class fints.fields.PasswordField(*args, **kwargs)[source]
type = ''
class fints.fields.SegmentSequenceField(*args, **kwargs)[source]
type = 'sf'

Constructed and helper types

class fints.formals.DataElementGroup(*args, **kwargs)[source]
class fints.formals.SegmentHeader(*args, **kwargs)[source]

Segmentkopf

type

Segmentkennung

Type:str
number

Segmentnummer

Type:int
version

Segmentversion

Type:int
reference

Bezugssegment

Type:int
class fints.formals.ReferenceMessage(*args, **kwargs)[source]
dialog_id
Type:str
message_number
Type:int
class fints.formals.SecurityMethod(*args, **kwargs)[source]

An enumeration.

DDV = 'DDV'
RAH = 'RAH'
RDH = 'RDH'
PIN = 'PIN'
class fints.formals.SecurityProfile(*args, **kwargs)[source]

Sicherheitsprofil

security_method

Sicherheitsverfahren

Type:fints.formals.SecurityMethod
security_method_version

Version des Sicherheitsverfahrens

Type:int
class fints.formals.IdentifiedRole(*args, **kwargs)[source]

An enumeration.

MS = '1'

Message Sender

MR = '2'

Message Receiver

class fints.formals.SecurityIdentificationDetails(*args, **kwargs)[source]
identified_role
Type:fints.formals.IdentifiedRole
cid
Type:bytes
identifier
Type:str
class fints.formals.DateTimeType(*args, **kwargs)[source]

An enumeration.

STS = '1'

Sicherheitszeitstempel

CRT = '6'

Certificate Revocation Time

class fints.formals.SecurityDateTime(*args, **kwargs)[source]
date_time_type
Type:fints.formals.DateTimeType
date
Type:datetime.date
time
Type:datetime.time
class fints.formals.UsageEncryption(*args, **kwargs)[source]

An enumeration.

OSY = '2'

Owner Symmetric

class fints.formals.OperationMode(*args, **kwargs)[source]

An enumeration.

CBC = '2'

Cipher Block Chaining

ISO_9796_1 = '16'

ISO 9796-1 (bei RDH)

ISO_9796_2_RANDOM = '17'

ISO 9796-2 mit Zufallszahl (bei RDH)

PKCS1V15 = '18'

RSASSA-PKCS#1 V1.5 (bei RDH); RSAES-PKCS#1 V1.5 (bei RAH, RDH)

PSS = '19'

RSASSA-PSS (bei RAH, RDH)

ZZZ = '999'

Gegenseitig vereinbart (DDV: Retail-MAC)

class fints.formals.EncryptionAlgorithmCoded(*args, **kwargs)[source]

An enumeration.

TWOKEY3DES = '13'

2-Key-Triple-DES

AES256 = '14'

AES-256

class fints.formals.AlgorithmParameterName(*args, **kwargs)[source]

An enumeration.

KYE = '5'

Symmetrischer Schlüssel, verschlüsselt mit symmetrischem Schlüssel

KYP = '6'

Symmetrischer Schlüssel, verschlüsselt mit öffentlichem Schlüssel

class fints.formals.AlgorithmParameterIVName(*args, **kwargs)[source]

An enumeration.

IVC = '1'

Initialization value, clear text

class fints.formals.EncryptionAlgorithm(*args, **kwargs)[source]
usage_encryption
Type:fints.formals.UsageEncryption
operation_mode
Type:fints.formals.OperationMode
encryption_algorithm
Type:fints.formals.EncryptionAlgorithmCoded
algorithm_parameter_value
Type:bytes
algorithm_parameter_name
Type:fints.formals.AlgorithmParameterName
algorithm_parameter_iv_name
Type:fints.formals.AlgorithmParameterIVName
algorithm_parameter_iv_value
Type:bytes
class fints.formals.HashAlgorithm(*args, **kwargs)[source]
usage_hash
Type:str
hash_algorithm
Type:str
algorithm_parameter_name
Type:str
algorithm_parameter_value
Type:bytes
class fints.formals.SignatureAlgorithm(*args, **kwargs)[source]
usage_signature
Type:str
signature_algorithm
Type:str
operation_mode
Type:str
class fints.formals.BankIdentifier(*args, **kwargs)[source]
COUNTRY_ALPHA_TO_NUMERIC = {'AT': '040', 'BE': '056', 'BG': '100', 'CA': '124', 'CH': '756', 'CZ': '203', 'DE': '280', 'DK': '208', 'ES': '724', 'EU': '978', 'FI': '246', 'FR': '250', 'GB': '826', 'GR': '300', 'HR': '191', 'HU': '348', 'IE': '372', 'IS': '352', 'IT': '380', 'JP': '392', 'LI': '438', 'LU': '442', 'NL': '528', 'PL': '616', 'PT': '620', 'RO': '642', 'RU': '643', 'SE': '752', 'SI': '705', 'SK': '703', 'TR': '792', 'US': '840'}
COUNTRY_NUMERIC_TO_ALPHA = {'040': 'AT', '056': 'BE', '100': 'BG', '124': 'CA', '191': 'HR', '203': 'CZ', '208': 'DK', '246': 'FI', '250': 'FR', '276': 'DE', '280': 'DE', '300': 'GR', '348': 'HU', '352': 'IS', '372': 'IE', '380': 'IT', '392': 'JP', '438': 'LI', '442': 'LU', '528': 'NL', '616': 'PL', '620': 'PT', '642': 'RO', '643': 'RU', '703': 'SK', '705': 'SI', '724': 'ES', '752': 'SE', '756': 'CH', '792': 'TR', '826': 'GB', '840': 'US', '978': 'EU'}
country_identifier
Type:str
bank_code
Type:str
class fints.formals.KeyType(*args, **kwargs)[source]

Schlüsselart

D = 'D'

Schlüssel zur Erzeugung digitaler Signaturen

S = 'S'

Signierschlüssel

V = 'V'

Chiffrierschlüssel

class fints.formals.KeyName(*args, **kwargs)[source]
bank_identifier
Type:fints.formals.BankIdentifier
user_id
Type:str
key_type

Schlüsselart

Type:fints.formals.KeyType
key_number
Type:int
key_version
Type:int
class fints.formals.Certificate(*args, **kwargs)[source]
certificate_type
Type:str
certificate_content
Type:bytes
class fints.formals.UserDefinedSignature(*args, **kwargs)[source]
pin
Type:fints.utils.Password
tan
Type:str
class fints.formals.Response(*args, **kwargs)[source]
code
Type:str
reference_element
Type:str
text
Type:str
parameters
Type:str
class fints.formals.Amount1(*args, **kwargs)[source]

Betrag

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

amount

Wert

Type:decimal.Decimal
currency

Währung

Type:str
class fints.formals.AccountInformation(*args, **kwargs)[source]
account_number
Type:str
subaccount_number
Type:str
bank_identifier
Type:fints.formals.BankIdentifier
class fints.formals.AccountLimit(*args, **kwargs)[source]
limit_type
Type:str
limit_amount
Type:fints.formals.Amount1
limit_days
Type:int
class fints.formals.AllowedTransaction(*args, **kwargs)[source]
transaction
Type:str
required_signatures
Type:int
limit_type
Type:str
limit_amount
Type:fints.formals.Amount1
limit_days
Type:int
class fints.formals.TANTimeDialogAssociation(*args, **kwargs)[source]

An enumeration.

NOT_ALLOWED = '1'

TAN nicht zeitversetzt / dialogübergreifend erlaubt

ALLOWED = '2'

TAN zeitversetzt / dialogübergreifend erlaubt

BOTH = '3'

beide Verfahren unterstützt

NOT_APPLICABLE = '4'

nicht zutreffend

class fints.formals.AllowedFormat(*args, **kwargs)[source]

An enumeration.

NUMERIC = '1'

numerisch

ALPHANUMERIC = '2'

alfanumerisch

class fints.formals.TANListNumberRequired(*args, **kwargs)[source]

An enumeration.

NO = '0'

Nein

YES = '2'

Ja

class fints.formals.InitializationMode(*args, **kwargs)[source]

An enumeration.

CLEARTEXT_PIN_NO_TAN = '00'

Initialisierungsverfahren mit Klartext-PIN und ohne TAN

ENCRYPTED_PIN_NO_TAN = '01'

Schablone 01: Verschlüsselte PIN und ohne TAN

MASK_02 = '02'

Schablone 02: Reserviert, bei FinTS zur Zeit nicht verwendet

class fints.formals.DescriptionRequired(*args, **kwargs)[source]

An enumeration.

MUST_NOT = '0'

Bezeichnung des TAN-Mediums darf nicht angegeben werden

MAY = '1'

Bezeichnung des TAN-Mediums kann angegeben werden

MUST = '2'

Bezeichnung des TAN-Mediums muss angegeben werden

class fints.formals.SMSChargeAccountRequired(*args, **kwargs)[source]

An enumeration.

MUST_NOT = '0'

SMS-Abbuchungskonto darf nicht angegeben werden

MAY = '1'

SMS-Abbuchungskonto kann angegeben werden

MUST = '2'

SMS-Abbuchungskonto muss angegeben werden

class fints.formals.PrincipalAccountRequired(*args, **kwargs)[source]

An enumeration.

MUST_NOT = '0'

Auftraggeberkonto darf nicht angegeben werden

MUST = '2'

Auftraggeberkonto muss angegeben werden, wenn im Geschäftsvorfall enthalten

class fints.formals.TaskHashAlgorithm(*args, **kwargs)[source]

An enumeration.

NONE = '0'

Auftrags-Hashwert nicht unterstützt

RIPEMD_160 = '1'

RIPEMD-160

SHA_1 = '2'

SHA-1

class fints.formals.TwoStepParametersCommon(*args, **kwargs)[source]
VERSION

TAN mechanism version

security_function

Sicherheitsfunktion kodiert

Type:str
tan_process

TAN-Prozess

Type:str
tech_id

Technische Identifikation TAN-Verfahren

Type:str
class fints.formals.TwoStepParameters1(*args, **kwargs)[source]
name

Name des Zwei-Schritt-Verfahrens

Type:str
max_length_input

Maximale Länge des Eingabewertes im Zwei-Schritt-Verfahren

Type:int
allowed_format

Erlaubtes Format im Zwei-Schritt-Verfahren

Type:fints.formals.AllowedFormat
text_return_value

Text zur Belegung des Rückgabewertes im Zwei-Schritt-Verfahren

Type:str
max_length_return_value

Maximale Länge des Rückgabewertes im Zwei-Schritt-Verfahren

Type:int
number_of_supported_lists

Anzahl unterstützter aktiver TAN-Listen

Type:int
multiple_tans_allowed

Mehrfach-TAN erlaubt

Type:bool
tan_time_delayed_allowed

TAN zeitversetzt/dialogübergreifend erlaubt

Type:bool
class fints.formals.TwoStepParameters2(*args, **kwargs)[source]
name

Name des Zwei-Schritt-Verfahrens

Type:str
max_length_input

Maximale Länge des Eingabewertes im Zwei-Schritt-Verfahren

Type:int
allowed_format

Erlaubtes Format im Zwei-Schritt-Verfahren

Type:fints.formals.AllowedFormat
text_return_value

Text zur Belegung des Rückgabewertes im Zwei-Schritt-Verfahren

Type:str
max_length_return_value

Maximale Länge des Rückgabewertes im Zwei-Schritt-Verfahren

Type:int
number_of_supported_lists

Anzahl unterstützter aktiver TAN-Listen

Type:int
multiple_tans_allowed

Mehrfach-TAN erlaubt

Type:bool
tan_time_dialog_association

TAN Zeit- und Dialogbezug

Type:fints.formals.TANTimeDialogAssociation
tan_list_number_required

TAN-Listennummer erforderlich

Type:fints.formals.TANListNumberRequired
cancel_allowed

Auftragsstorno erlaubt

Type:bool
challenge_class_required

Challenge-Klasse erforderlich

Type:bool
challenge_value_required

Challenge-Betrag erforderlich

Type:bool
class fints.formals.TwoStepParameters3(*args, **kwargs)[source]
name

Name des Zwei-Schritt-Verfahrens

Type:str
max_length_input

Maximale Länge des Eingabewertes im Zwei-Schritt-Verfahren

Type:int
allowed_format

Erlaubtes Format im Zwei-Schritt-Verfahren

Type:fints.formals.AllowedFormat
text_return_value

Text zur Belegung des Rückgabewertes im Zwei-Schritt-Verfahren

Type:str
max_length_return_value

Maximale Länge des Rückgabewertes im Zwei-Schritt-Verfahren

Type:int
number_of_supported_lists

Anzahl unterstützter aktiver TAN-Listen

Type:int
multiple_tans_allowed

Mehrfach-TAN erlaubt

Type:bool
tan_time_dialog_association

TAN Zeit- und Dialogbezug

Type:fints.formals.TANTimeDialogAssociation
tan_list_number_required

TAN-Listennummer erforderlich

Type:fints.formals.TANListNumberRequired
cancel_allowed

Auftragsstorno erlaubt

Type:bool
challenge_class_required

Challenge-Klasse erforderlich

Type:bool
challenge_value_required

Challenge-Betrag erforderlich

Type:bool
initialization_mode

Initialisierungsmodus

Type:fints.formals.InitializationMode
description_required

Bezeichnung des TAN-Medium erforderlich

Type:fints.formals.DescriptionRequired
supported_media_number

Anzahl unterstützter aktiver TAN-Medien

Type:int
class fints.formals.TwoStepParameters4(*args, **kwargs)[source]
zka_id

ZKA TAN-Verfahren

Type:str
zka_version

Version ZKA TAN-Verfahren

Type:str
name

Name des Zwei-Schritt-Verfahrens

Type:str
max_length_input

Maximale Länge des Eingabewertes im Zwei-Schritt-Verfahren

Type:int
allowed_format

Erlaubtes Format im Zwei-Schritt-Verfahren

Type:fints.formals.AllowedFormat
text_return_value

Text zur Belegung des Rückgabewertes im Zwei-Schritt-Verfahren

Type:str
max_length_return_value

Maximale Länge des Rückgabewertes im Zwei-Schritt-Verfahren

Type:int
number_of_supported_lists

Anzahl unterstützter aktiver TAN-Listen

Type:int
multiple_tans_allowed

Mehrfach-TAN erlaubt

Type:bool
tan_time_dialog_association

TAN Zeit- und Dialogbezug

Type:fints.formals.TANTimeDialogAssociation
tan_list_number_required

TAN-Listennummer erforderlich

Type:fints.formals.TANListNumberRequired
cancel_allowed

Auftragsstorno erlaubt

Type:bool
sms_charge_account_required

SMS-Abbuchungskonto erforderlich

Type:bool
challenge_class_required

Challenge-Klasse erforderlich

Type:bool
challenge_value_required

Challenge-Betrag erforderlich

Type:bool
challenge_structured

Challenge strukturiert

Type:bool
initialization_mode

Initialisierungsmodus

Type:fints.formals.InitializationMode
description_required

Bezeichnung des TAN-Medium erforderlich

Type:fints.formals.DescriptionRequired
supported_media_number

Anzahl unterstützter aktiver TAN-Medien

Type:int
class fints.formals.TwoStepParameters5(*args, **kwargs)[source]
zka_id

ZKA TAN-Verfahren

Type:str
zka_version

Version ZKA TAN-Verfahren

Type:str
name

Name des Zwei-Schritt-Verfahrens

Type:str
max_length_input

Maximale Länge des Eingabewertes im Zwei-Schritt-Verfahren

Type:int
allowed_format

Erlaubtes Format im Zwei-Schritt-Verfahren

Type:fints.formals.AllowedFormat
text_return_value

Text zur Belegung des Rückgabewertes im Zwei-Schritt-Verfahren

Type:str
max_length_return_value

Maximale Länge des Rückgabewertes im Zwei-Schritt-Verfahren

Type:int
number_of_supported_lists

Anzahl unterstützter aktiver TAN-Listen

Type:int
multiple_tans_allowed

Mehrfach-TAN erlaubt

Type:bool
tan_time_dialog_association

TAN Zeit- und Dialogbezug

Type:fints.formals.TANTimeDialogAssociation
tan_list_number_required

TAN-Listennummer erforderlich

Type:fints.formals.TANListNumberRequired
cancel_allowed

Auftragsstorno erlaubt

Type:bool
sms_charge_account_required

SMS-Abbuchungskonto erforderlich

Type:fints.formals.SMSChargeAccountRequired
principal_account_required

Auftraggeberkonto erforderlich

Type:fints.formals.PrincipalAccountRequired
challenge_class_required

Challenge-Klasse erforderlich

Type:bool
challenge_structured

Challenge strukturiert

Type:bool
initialization_mode

Initialisierungsmodus

Type:fints.formals.InitializationMode
description_required

Bezeichnung des TAN-Medium erforderlich

Type:fints.formals.DescriptionRequired
supported_media_number

Anzahl unterstützter aktiver TAN-Medien

Type:int
class fints.formals.TwoStepParameters6(*args, **kwargs)[source]
zka_id

ZKA TAN-Verfahren

Type:str
zka_version

Version ZKA TAN-Verfahren

Type:str
name

Name des Zwei-Schritt-Verfahrens

Type:str
max_length_input

Maximale Länge des Eingabewertes im Zwei-Schritt-Verfahren

Type:int
allowed_format

Erlaubtes Format im Zwei-Schritt-Verfahren

Type:fints.formals.AllowedFormat
text_return_value

Text zur Belegung des Rückgabewertes im Zwei-Schritt-Verfahren

Type:str
max_length_return_value

Maximale Länge des Rückgabewertes im Zwei-Schritt-Verfahren

Type:int
multiple_tans_allowed

Mehrfach-TAN erlaubt

Type:bool
tan_time_dialog_association

TAN Zeit- und Dialogbezug

Type:fints.formals.TANTimeDialogAssociation
cancel_allowed

Auftragsstorno erlaubt

Type:bool
sms_charge_account_required

SMS-Abbuchungskonto erforderlich

Type:fints.formals.SMSChargeAccountRequired
principal_account_required

Auftraggeberkonto erforderlich

Type:fints.formals.PrincipalAccountRequired
challenge_class_required

Challenge-Klasse erforderlich

Type:bool
challenge_structured

Challenge strukturiert

Type:bool
initialization_mode

Initialisierungsmodus

Type:fints.formals.InitializationMode
description_required

Bezeichnung des TAN-Medium erforderlich

Type:fints.formals.DescriptionRequired
response_hhd_uc_required

Antwort HHD_UC erforderlich

Type:bool
supported_media_number

Anzahl unterstützter aktiver TAN-Medien

Type:int
class fints.formals.ParameterTwostepCommon(*args, **kwargs)[source]
onestep_method_allowed
Type:bool
multiple_tasks_allowed
Type:bool
task_hash_algorithm

Auftrags-Hashwertverfahren

Type:fints.formals.TaskHashAlgorithm
class fints.formals.ParameterTwostepTAN1(*args, **kwargs)[source]
security_profile_bank_signature
Type:str
twostep_parameters
Type:fints.formals.TwoStepParameters1
class fints.formals.ParameterTwostepTAN2(*args, **kwargs)[source]
twostep_parameters
Type:fints.formals.TwoStepParameters2
class fints.formals.ParameterTwostepTAN3(*args, **kwargs)[source]
twostep_parameters
Type:fints.formals.TwoStepParameters3
class fints.formals.ParameterTwostepTAN4(*args, **kwargs)[source]
twostep_parameters
Type:fints.formals.TwoStepParameters4
class fints.formals.ParameterTwostepTAN5(*args, **kwargs)[source]
twostep_parameters
Type:fints.formals.TwoStepParameters5
class fints.formals.ParameterTwostepTAN6(*args, **kwargs)[source]
twostep_parameters
Type:fints.formals.TwoStepParameters6
class fints.formals.TransactionTanRequired(*args, **kwargs)[source]
transaction
Type:str
tan_required
Type:bool
class fints.formals.ParameterPinTan(*args, **kwargs)[source]
min_pin_length
Type:int
max_pin_length
Type:int
max_tan_length
Type:int
user_id_field_text
Type:str
customer_id_field_text
Type:str
transaction_tans_required
Type:fints.formals.TransactionTanRequired
class fints.formals.Language2(*args, **kwargs)[source]

Dialogsprache

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Formals

DEFAULT = '0'

Standard

DE = '1'

Deutsch, ‘de’, Subset Deutsch, Codeset 1 (Latin 1)

EN = '2'

Englisch, ‘en’, Subset Englisch, Codeset 1 (Latin 1)

FR = '3'

Französisch, ‘fr’, Subset Französisch, Codeset 1 (Latin 1)

class fints.formals.SupportedLanguages2(*args, **kwargs)[source]
languages
Type:fints.formals.Language2
class fints.formals.SupportedHBCIVersions2(*args, **kwargs)[source]
versions
Type:str
class fints.formals.KTZ1(*args, **kwargs)[source]

Kontoverbindung ZV international, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

is_sepa

Kontoverwendung SEPA

Type:bool
iban

IBAN

Type:str
bic

BIC

Type:str
account_number

Konto-/Depotnummer

Type:str
subaccount_number

Unterkontomerkmal

Type:str
bank_identifier

Kreditinstitutskennung

Type:fints.formals.BankIdentifier
as_sepa_account()[source]
classmethod from_sepa_account(acc)[source]
class fints.formals.KTI1(*args, **kwargs)[source]

Kontoverbindung international, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

iban

IBAN

Type:str
bic

BIC

Type:str
account_number

Konto-/Depotnummer

Type:str
subaccount_number

Unterkontomerkmal

Type:str
bank_identifier

Kreditinstitutskennung

Type:fints.formals.BankIdentifier
classmethod from_sepa_account(acc)[source]
class fints.formals.Account2(*args, **kwargs)[source]

Kontoverbindung, version 2

Source: HBCI Homebanking-Computer-Interface, Schnittstellenspezifikation

account_number

Konto-/Depotnummer

Type:str
subaccount_number

Unterkontomerkmal

Type:str
country_identifier

Länderkennzeichen

Type:str
bank_code

Kreditinstitutscode

Type:str
classmethod from_sepa_account(acc)[source]
class fints.formals.Account3(*args, **kwargs)[source]

Kontoverbindung, version 3

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

account_number

Konto-/Depotnummer

Type:str
subaccount_number

Unterkontomerkmal

Type:str
bank_identifier

Kreditinstitutskennung

Type:fints.formals.BankIdentifier
classmethod from_sepa_account(acc)[source]
class fints.formals.SecurityRole(*args, **kwargs)[source]

Rolle des Sicherheitslieferanten, kodiert, version 2

Kodierte Information über das Verhältnis desjenigen, der bezüglich der zu si-chernden Nachricht die Sicherheit gewährleistet. Die Wahl ist von der bankfachlichen Auslegung der Signatur, respektive vom vertraglichen Zustand zwischen Kunde und Kreditinstitut abhängig.

Source: FinTS Financial Transaction Services, Sicherheitsverfahren HBCI

ISS = '1'

Erfasser, Erstsignatur

CON = '3'

Unterstützer, Zweitsignatur

WIT = '4'

Zeuge/Übermittler, nicht Erfasser

class fints.formals.CompressionFunction(*args, **kwargs)[source]

Komprimierungsfunktion, version 2

Source: FinTS Financial Transaction Services, Sicherheitsverfahren HBCI

NULL = '0'

Keine Kompression

LZW = '1'

Lempel, Ziv, Welch

COM = '2'

Optimized LZW

LZSS = '3'

Lempel, Ziv

LZHuf = '4'

LZ + Huffman Coding

ZIP = '5'

PKZIP

GZIP = '6'

deflate (http://www.gzip.org/zlib)

BZIP2 = '7'

bzip2 (http://sourceware.cygnus.com/bzip2/)

ZZZ = '999'

Gegenseitig vereinbart

class fints.formals.SecurityApplicationArea(*args, **kwargs)[source]

Bereich der Sicherheitsapplikation, kodiert, version 2

Informationen darüber, welche Daten vom kryptographischen Prozess verarbeitet werden.

Source: FinTS Financial Transaction Services, Sicherheitsverfahren HBCI

SHM = '1'

Signaturkopf und HBCI-Nutzdaten

SHT = '2'

Von Signaturkopf bis Signaturabschluss

class fints.formals.SecurityClass(*args, **kwargs)[source]

Sicherheitsklasse, version 1

Die Sicherheitsklasse gibt für jede Signatur den erforderlichen Sicherheitsdienst an.

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Formals

NONE = 0

Kein Sicherheitsdienst erforderlich

AUTH = 1

Sicherheitsdienst ‘Authentikation’

AUTH_ADV = 2

Sicherheitsdienst ‘Authentikation’ mit fortgeschrittener elektronischer Signatur, optionaler Zertifikatsprüfung

NON_REPUD = 3

Sicherheitsdienst ‘Non-Repudiation’ mit fortgeschrittener elektronischer Signatur, optionaler Zertifikatsprüfung

NON_REPUD_QUAL = 4

Sicherheitsdienst ‘Non-Repudiation’ mit fortgeschrittener bzw. qualifizierter elektronischer Signatur, zwingende Zertifikatsprüfung

class fints.formals.UPDUsage(*args, **kwargs)[source]

UPD-Verwendung, version 2

Kennzeichen dafür, wie diejenigen Geschäftsvorfälle zu interpretieren sind, die bei der Beschreibung der Kontoinformationen nicht unter den erlaubten Geschäftsvorfällen aufgeführt sind.

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Formals

UPD_CONCLUSIVE = '0'

Die nicht aufgeführten Geschäftsvorfälle sind gesperrt

UPD_INCONCLUSIVE = '1'

Bei nicht aufgeführten Geschäftsvorfällen ist keine Aussage möglich, ob diese erlaubt oder gesperrt sind

class fints.formals.SystemIDStatus(*args, **kwargs)[source]

Kundensystem-Status, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Formals

ID_UNNECESSARY = '0'

Kundensystem-ID wird nicht benötigt

ID_NECESSARY = '1'

Kundensystem-ID wird benötigt

class fints.formals.SynchronizationMode(*args, **kwargs)[source]

Synchronisierungsmodus, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Formals

NEW_SYSTEM_ID = '0'

Neue Kundensystem-ID zurückmelden

LAST_MESSAGE = '1'

Letzte verarbeitete Nachrichtennummer zurückmelden

SIGNATURE_ID = '2'

Signatur-ID zurückmelden

class fints.formals.CreditDebit2(*args, **kwargs)[source]

Soll-Haben-Kennzeichen, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

CREDIT = 'C'

Haben

DEBIT = 'D'

Soll

class fints.formals.Balance1(*args, **kwargs)[source]

Saldo, version 1

Source: HBCI Homebanking-Computer-Interface, Schnittstellenspezifikation

credit_debit

Soll-Haben-Kennzeichen

Type:fints.formals.CreditDebit2
amount

Wert

Type:decimal.Decimal
currency

Währung

Type:str
date

Datum

Type:datetime.date
time

Uhrzeit

Type:datetime.time
as_mt940_Balance()[source]
class fints.formals.Balance2(*args, **kwargs)[source]

Saldo, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

credit_debit

Soll-Haben-Kennzeichen

Type:fints.formals.CreditDebit2
amount

Betrag

Type:fints.formals.Amount1
date

Datum

Type:datetime.date
time

Uhrzeit

Type:datetime.time
as_mt940_Balance()[source]
class fints.formals.Timestamp1(*args, **kwargs)[source]

Zeitstempel

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

date

Datum

Type:datetime.date
time

Uhrzeit

Type:datetime.time
class fints.formals.TANMediaType2(*args, **kwargs)[source]

TAN-Medium-Art

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

ALL = '0'

Alle

ACTIVE = '1'

Aktiv

AVAILABLE = '2'

Verfügbar

class fints.formals.TANMediaClass3(*args, **kwargs)[source]

TAN-Medium-Klasse, version 3

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

ALL = 'A'

Alle Medien

LIST = 'L'

Liste

GENERATOR = 'G'

TAN-Generator

MOBILE = 'M'

Mobiltelefon mit mobileTAN

SECODER = 'S'

Secoder

class fints.formals.TANMediaClass4(*args, **kwargs)[source]

TAN-Medium-Klasse, version 4

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

ALL = 'A'

Alle Medien

LIST = 'L'

Liste

GENERATOR = 'G'

TAN-Generator

MOBILE = 'M'

Mobiltelefon mit mobileTAN

SECODER = 'S'

Secoder

BILATERAL = 'B'

Bilateral vereinbart

class fints.formals.TANMediumStatus(*args, **kwargs)[source]

Status

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

ACTIVE = '1'

Aktiv

AVAILABLE = '2'

Verfügbar

ACTIVE_SUCCESSOR = '3'

Aktiv Folgekarte

AVAILABLE_SUCCESSOR = '4'

Verfügbar Folgekarte

class fints.formals.TANMedia4(*args, **kwargs)[source]

TAN-Medium-Liste, version 4

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

tan_medium_class

TAN-Medium-Klasse

Type:fints.formals.TANMediaClass3
status

Status

Type:fints.formals.TANMediumStatus
card_number

Kartennummer

Type:str
card_sequence

Kartenfolgenummer

Type:str
card_type

Kartenart

Type:int
account

Kontonummer Auftraggeber

Type:fints.formals.Account3
valid_from

Gültig ab

Type:datetime.date
valid_until

Gültig bis

Type:datetime.date
tan_list_number

TAN-Listennummer

Type:str
tan_medium_name

Bezeichnung des TAN-Mediums

Type:str
mobile_number_masked

Mobiltelefonnummer, verschleiert

Type:str
mobile_number

Mobiltelefonnummer

Type:str
sms_charge_account

SMS-Abbuchungskonto

Type:fints.formals.KTI1
number_free_tans

Anzahl freie TANs

Type:int
last_use

Letzte Benutzung

Type:datetime.date
active_since

Freigeschaltet am

Type:datetime.date
class fints.formals.TANMedia5(*args, **kwargs)[source]

TAN-Medium-Liste, version 5

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

tan_medium_class

TAN-Medium-Klasse

Type:fints.formals.TANMediaClass4
status

Status

Type:fints.formals.TANMediumStatus
security_function

Sicherheitsfunktion, kodiert

Type:int
card_number

Kartennummer

Type:str
card_sequence

Kartenfolgenummer

Type:str
card_type

Kartenart

Type:int
account

Kontonummer Auftraggeber

Type:fints.formals.Account3
valid_from

Gültig ab

Type:datetime.date
valid_until

Gültig bis

Type:datetime.date
tan_list_number

TAN-Listennummer

Type:str
tan_medium_name

Bezeichnung des TAN-Mediums

Type:str
mobile_number_masked

Mobiltelefonnummer, verschleiert

Type:str
mobile_number

Mobiltelefonnummer

Type:str
sms_charge_account

SMS-Abbuchungskonto

Type:fints.formals.KTI1
number_free_tans

Anzahl freie TANs

Type:int
last_use

Letzte Benutzung

Type:datetime.date
active_since

Freigeschaltet am

Type:datetime.date
class fints.formals.TANUsageOption(*args, **kwargs)[source]

TAN-Einsatzoption

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

ALL_ACTIVE = '0'

Kunde kann alle “aktiven” Medien parallel nutzen

EXACTLY_ONE = '1'

Kunde kann genau ein Medium zu einer Zeit nutzen

MOBILE_AND_GENERATOR = '2'

Kunde kann ein Mobiltelefon und einen TAN-Generator parallel nutzen

class fints.formals.ParameterChallengeClass(*args, **kwargs)[source]

Parameter Challenge-Klasse

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

parameters
Type:str
class fints.formals.ResponseHHDUC(*args, **kwargs)[source]

Antwort HHD_UC

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

atc

ATC

Type:str
ac

Application Cryptogram AC

Type:bytes
ef_id_data

EF_ID Data

Type:bytes
cvr

CVR

Type:bytes
version_info_chiptan

Versionsinfo der chipTAN-Applikation

Type:bytes
class fints.formals.ChallengeValidUntil(*args, **kwargs)[source]

Gültigkeitsdatum und -uhrzeit für Challenge

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Sicherheitsverfahren PIN/TAN

date

Datum

Type:datetime.date
time

Uhrzeit

Type:datetime.time
class fints.formals.BatchTransferParameter1(*args, **kwargs)[source]

Parameter SEPA-Sammelüberweisung, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

max_transfer_count

Maximale Anzahl CreditTransferTransactionInformation

Type:int
sum_amount_required

Summenfeld benötigt

Type:bool
single_booking_allowed

Einzelbuchung erlaubt

Type:bool
class fints.formals.ServiceType2(*args, **kwargs)[source]

An enumeration.

T_ONLINE = 1

T-Online

TCP_IP = 2

TCP/IP (Protokollstack SLIP/PPP)

HTTPS = 3

https

class fints.formals.CommunicationParameter2(*args, **kwargs)[source]

Kommunikationsparameter, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Formals

service_type

Kommunikationsdienst

Type:fints.formals.ServiceType2
address

Kommunikationsadresse

Type:str
address_adjunct

Kommunikationsadresszusatz

Type:str
filter_function

Filterfunktion

Type:str
filter_function_version

Version der Filterfunktion

Type:int
class fints.formals.ScheduledDebitParameter1(*args, **kwargs)[source]

Parameter terminierte SEPA-Einzellastschrift einreichen, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

min_advance_notice_FNAL_RCUR

Minimale Vorlaufzeit FNAL/RCUR

Type:int
max_advance_notice_FNAL_RCUR

Maximale Vorlaufzeit FNAL/RCUR

Type:int
min_advance_notice_FRST_OOFF

Minimale Vorlaufzeit FRST/OOFF

Type:int
max_advance_notice_FRST_OOFF

Maximale Vorlaufzeit FRST/OOFF

Type:int
class fints.formals.ScheduledDebitParameter2(*args, **kwargs)[source]

Parameter terminierte SEPA-Einzellastschrift einreichen, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

min_advance_notice

Minimale Vorlaufzeit SEPA-Lastschrift

Type:str
max_advance_notice

Maximale Vorlaufzeit SEPA-Lastschrift

Type:str
allowed_purpose_codes

Zulässige purpose codes

Type:str
supported_sepa_formats

Unterstützte SEPA-Datenformate

Type:str
class fints.formals.ScheduledBatchDebitParameter1(*args, **kwargs)[source]

Parameter terminierte SEPA-Sammellastschrift einreichen, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

min_advance_notice_FNAL_RCUR

Minimale Vorlaufzeit FNAL/RCUR

Type:int
max_advance_notice_FNAL_RCUR

Maximale Vorlaufzeit FNAL/RCUR

Type:int
min_advance_notice_FRST_OOFF

Minimale Vorlaufzeit FRST/OOFF

Type:int
max_advance_notice_FRST_OOFF

Maximale Vorlaufzeit FRST/OOFF

Type:int
max_debit_count

Maximale Anzahl DirectDebitTransfer TransactionInformation

Type:int
sum_amount_required

Summenfeld benötigt

Type:bool
single_booking_allowed

Einzelbuchung erlaubt

Type:bool
class fints.formals.ScheduledBatchDebitParameter2(*args, **kwargs)[source]

Parameter terminierte SEPA-Sammellastschrift einreichen, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

min_advance_notice

Minimale Vorlaufzeit SEPA-Lastschrift

Type:str
max_advance_notice

Maximale Vorlaufzeit SEPA-Lastschrift

Type:str
max_debit_count

Maximale Anzahl DirectDebitTransfer TransactionInformation

Type:int
sum_amount_required

Summenfeld benötigt

Type:bool
single_booking_allowed

Einzelbuchung erlaubt

Type:bool
allowed_purpose_codes

Zulässige purpose codes

Type:str
supported_sepa_formats

Unterstützte SEPA-Datenformate

Type:str
class fints.formals.ScheduledCOR1DebitParameter1(*args, **kwargs)[source]

Parameter terminierte SEPA-COR1-Einzellastschrift, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

min_advance_notice_FNAL_RCUR

Minimale Vorlaufzeit FNAL/RCUR

Type:int
max_advance_notice_FNAL_RCUR

Maximale Vorlaufzeit FNAL/RCUR

Type:int
min_advance_notice_FRST_OOFF

Minimale Vorlaufzeit FRST/OOFF

Type:int
max_advance_notice_FRST_OOFF

Maximale Vorlaufzeit FRST/OOFF

Type:int
allowed_purpose_codes

Zulässige purpose codes

Type:str
supported_sepa_formats

Unterstützte SEPA-Datenformate

Type:str
class fints.formals.ScheduledCOR1BatchDebitParameter1(*args, **kwargs)[source]

Parameter terminierte SEPA-COR1-Sammellastschrift, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

max_debit_count

Maximale Anzahl DirectDebitTransfer TransactionInformation

Type:int
sum_amount_required

Summenfeld benötigt

Type:bool
single_booking_allowed

Einzelbuchung erlaubt

Type:bool
min_advance_notice_FNAL_RCUR

Minimale Vorlaufzeit FNAL/RCUR

Type:int
max_advance_notice_FNAL_RCUR

Maximale Vorlaufzeit FNAL/RCUR

Type:int
min_advance_notice_FRST_OOFF

Minimale Vorlaufzeit FRST/OOFF

Type:int
max_advance_notice_FRST_OOFF

Maximale Vorlaufzeit FRST/OOFF

Type:int
allowed_purpose_codes

Zulässige purpose codes

Type:str
supported_sepa_formats

Unterstützte SEPA-Datenformate

Type:str
class fints.formals.SupportedSEPAPainMessages1(*args, **kwargs)[source]

Unterstützte SEPA pain messages, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

sepa_descriptors

SEPA Descriptor

Type:str
class fints.formals.QueryScheduledDebitParameter1(*args, **kwargs)[source]

Parameter Bestand terminierter SEPA-Einzellastschriften, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

date_range_allowed

Zeitraum möglich

Type:bool
max_number_responses_allowed

Eingabe Anzahl Einträge erlaubt

Type:bool
class fints.formals.QueryScheduledDebitParameter2(*args, **kwargs)[source]

Parameter Bestand terminierter SEPA-Einzellastschriften, version 2

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

max_number_responses_allowed

Eingabe Anzahl Einträge erlaubt

Type:bool
date_range_allowed

Zeitraum möglich

Type:bool
supported_sepa_formats

Unterstützte SEPA-Datenformate

Type:str
class fints.formals.QueryScheduledBatchDebitParameter1(*args, **kwargs)[source]

Parameter Bestand terminierter SEPA-Sammellastschriften, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

max_number_responses_allowed

Eingabe Anzahl Einträge erlaubt

Type:bool
date_range_allowed

Zeitraum möglich

Type:bool
class fints.formals.QueryCreditCardStatements2(*args, **kwargs)[source]

Parameter Kreditkartenumsätze anfordern, version 2

Source: reverse engineered

cutoff_days

Maximale Vorhaltezeit der Umsätze

Type:int
max_number_responses_allowed

Eingabe Anzahl Einträge erlaubt

Type:bool
date_range_allowed

Zeitraum möglich

Type:bool
class fints.formals.SEPACCode1(*args, **kwargs)[source]

An enumeration.

REVERSAL = '1'

Reversal

REVOCATION = '2'

Revocation

DELETION = '3'

Delete

class fints.formals.StatusSEPATask1(*args, **kwargs)[source]

An enumeration.

PENDING = '1'

In Terminierung

DECLINED = '2'

Abgelehnt von erster Inkassostelle

IN_PROGRESS = '3'

in Bearbeitung

PROCESSED = '4'

Creditoren-seitig verarbeitet, Buchung veranlasst

REVOKED = '5'

R-Transaktion wurde veranlasst

class fints.formals.GetSEPAAccountParameter1(*args, **kwargs)[source]

Parameter SEPA-Kontoverbindung anfordern, version 1

Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages – Multibankfähige Geschäftsvorfälle

single_account_query_allowed

Einzelkontenabruf erlaubt

Type:bool
national_account_allowed

Nationale Kontoverbindung erlaubt

Type:bool
structured_purpose_allowed

Strukturierter Verwendungszweck erlaubt

Type:bool
supported_sepa_formats

Unterstützte SEPA-Datenformate

Type:str
class fints.formals.SupportedMessageTypes(*args, **kwargs)[source]

Unterstützte camt-Messages

Source: Messages - Multibankfähige Geschäftsvorfälle (SEPA) - C.2.3.1.1.1

expected_type

Unterstützte camt-messages

Type:str
class fints.formals.BookedCamtStatements1(*args, **kwargs)[source]

Gebuchte camt-Umsätze

Source: Messages - Multibankfähige Geschäftsvorfälle (SEPA)

camt_statements

camt-Umsätze gebucht

Type:bytes