WIP: Add VoP segments

Author: rhn

fints/client.py

@@ -793,6 +793,7 @@ def _find_supported_sepa_version(self, candidate_versions):
             return candidate_versions[0]
 
         bank_supported = list(hispas.parameter.supported_sepa_formats)
+        print(hispas)
 
         for candidate in candidate_versions:
             if "urn:iso:std:iso:20022:tech:xsd:{}".format(candidate) in bank_supported:
@@ -827,7 +828,7 @@ def simple_sepa_transfer(self, account: SEPAAccount, iban: str, bic: str,
             "batch": False,
             "currency": "EUR",
         }
-        version = self._find_supported_sepa_version(['pain.001.001.03', 'pain.001.003.03'])
+        version = self._find_supported_sepa_version(['pain.001.001.03'])
         sepa = SepaTransfer(config, version)
         payment = {
             "name": recipient_name,

fints/fields.py

@@ -291,6 +291,19 @@ def _render_value(self, value):
         return super()._render_value(val)
 
 
+# FIXME: stub
+class TimestampField(DataElementField):
+    type = 'tsp'
+    _DOC_TYPE = bytes
+
+    def _render_value(self, value):
+        retval = bytes(value)
+        self._check_value_length(retval)
+
+        return retval
+
+    def _parse_value(self, value): return bytes(value)
+
 class PasswordField(AlphanumericField):
     type = ''
     _DOC_TYPE = Password

fints/segments/auth.py

@@ -97,6 +97,68 @@ class HKTAN6(FinTS3Segment):
     response_hhd_uc = DataElementGroupField(type=ResponseHHDUC, required=False, _d="Antwort HHD_UC")
 
 
+class PSRD1(DataElementGroup):
+    """Unterstütze Payment Status Reports
+
+    Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Messages -- Multibankfähige Geschäftsvorfälle, version 3.0 Rel 2022, FV """
+    psrd = DataElementField(type='an', max_length=256, required=True, _d="Payment Status Report Descriptor", max_count=99)
+    # urn:iso:std:iso:20022:tech:xsd:pain.002.001.14
+
+class HKVPP(FinTS3Segment):
+    """Namensabgleich Prüfauftrag, version 1
+    Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Verification of Payee"""
+    supported_reports = DataElementField(type=PSRD1, required=True, _d="Unterstützte Payment Status Reports")
+    polling_id = DataElementField(type='bin', required=False, _d="Polling-ID")
+    max_queries = DataElementField(type='num', max_length=4, required=False, _d="Maximale Anzahl Einträge")
+    aufsetzpunkt = DataElementField(type='an', max_length=35, required=False, _d="Aufsetzpunkt")
+
+
+class EVPE(DataElementGroup):
+    """Ergebnis VOP-Prüfung Einzeltransaktion
+
+    Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Verification of Payee"""
+    recipient_IBAN = DataElementField(type='an', max_length=34, required=False, _d="IBAN Empfänger")
+    info_IBAN = DataElementField(type='an', max_length=140, required=False, _d="IBAN-Zusatzinformationen")
+    close_match_name = DataElementField(type='an', max_length=140, required=False, _d="Abweichender Empfängername")
+    other_identification = DataElementField(type='an', max_length=256, required=False, _d="Anderes Identifikationmerkmal")
+    # RVMC, RCVC, RVNM,  RVNA, PDNG
+    result = DataElementField(type='code', length=4, required=False, _d="VOP-Prüfergebnis")
+    na_reason = DataElementField(type='an', max_length=256, required=False, _d="Grund RVNA")
+
+
+class HIVPP(FinTS3Segment):
+    """Namensabgleich Namensabgleich Prüfergebnis, version 1
+    Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Verification of Payee"""
+    vop_id = DataElementField(type='bin', required=False, _d="VOP-ID")
+    vop_id_valid_until = DataElementField(type='tsp', required=False, _d="VOP-ID gültig bis")
+    polling_id = DataElementField(type='bin', required=False, _d="Polling-ID")
+    payment_status_report_descriptor = DataElementField(type='an', max_length=256, required=False, _d="Payment Status Report Descriptor")
+    payment_status_report = DataElementField(type='bin', required=False, _d="Payment Status Report")
+    # Only for a single transaction. Mutually exclusive with payment status report.
+    vop_single_result = DataElementField(type=EVPE, required=False, _d="Ergebnis VOP-Prüfung Einzeltransaktion")
+    manual_authorization_notice = DataElementField(type='an', max_length=65535, required=False, _d="Aufklärungstext Autorisierung trotz Abweichung")
+    wait_for_seconds = DataElementField(type='num', length=1, required=False, _d="Wartezeit vor nächster Abfrage")
+
+class ParameterVoP(DataElementGroup):
+    max_trans = DataElementField(type='num', max_length=7, required=False, _d="Maximale Anzahl CreditTransferTransactionInformation OptIn")
+    notice_is_structured = DataElementField(type='jn', required=False, _d="Aufklärungstext strukturiert")
+    # complete: V, piecemeal: S
+    report_complete = DataElementField(type='code', length=1, required=False, _d="Art der Lieferung Payment Status Report")
+    batch_payment-allowed = DataElementField(type='jn', required=False, _d="Sammelzahlungen mit einem Auftrag erlaubt")
+    multiple_allowed = DataElementField(type='jn', required=False, _d="Eingabe Anzahl Einträge erlaubt")
+    supported_report_formats = DataElementField(type='an', max_length=1024, required=False, _d="Unterstützte Payment Status Report Daten-formate")
+    # FIXME: count is "n"
+    payment_order_segment = DataElementField(type='an', max_length=6, required=False, _d="VOP-pflichtiger Zahlungsverkehrsauftrag")
+    
+
+class HIVPPS(ParameterSegment):
+    """Namensabgleich Prüfauftrag Parameter, version 1
+
+    Source: FinTS Financial Transaction Services, Schnittstellenspezifikation, Verification of Payee"""
+    parameter = DataElementGroupField(type=ParameterVoP, _d="Parameter Namensabgleich Prüfauftrag") 
+
+
+
 class HKTAN7(FinTS3Segment):
     """Zwei-Schritt-TAN-Einreichung, version 7
 
@@ -114,7 +176,6 @@ class HKTAN7(FinTS3Segment):
     tan_medium_name = DataElementField(type='an', max_length=32, required=False, _d="Bezeichnung des TAN-Mediums")
     response_hhd_uc = DataElementGroupField(type=ResponseHHDUC, required=False, _d="Antwort HHD_UC")
 
-
 class HITAN2(FinTS3Segment):
     """Zwei-Schritt-TAN-Einreichung Rückmeldung, version 2