> Continue verbetering > Betalingsverwerking > SWIFT > datatemplate

Uw Data Template voor Betalingsverwerking

SWIFT

Attributes Betalingsverwerking (20) Activiteiten Betalingsverwerking (12) Extractie Guides (3)

Uw Data Template voor Betalingsverwerking

Deze template biedt de structurele basis voor het in kaart brengen van uw SWIFT transactie workflows van initiatie tot definitieve afwikkeling. Het beschrijft de specifieke data componenten en operationele mijlpalen die nodig zijn om volledig inzicht te krijgen in uw betalingslevenscycli. Door deze gids te gebruiken, kunt u uw data effectief voorbereiden om verborgen inefficiënties bloot te leggen en compliancerisico's te verminderen.

Aanbevolen attributes voor diepgaande transactieanalyse
Belangrijke SWIFT-proces `activities` en mijlpalen
Technische begeleiding voor financiële data-extractie

Nieuw met event logs? Leer hoe je een process mining event log creëert.

Template downloaden

Attributes Betalingsverwerking

Dit zijn de aanbevolen data velden om op te nemen in uw event log voor een uitgebreide analyse van uw SWIFT transactielevenscyclus.

5 Verplicht 9 Aanbevolen 6 Optioneel

	Naam	Omschrijving
	Activiteitsnaam ActivityName	De naam van de processtap of de event die heeft plaatsgevonden.
Omschrijving Dit attribute beschrijft de specifieke actie of statuswijziging die is vastgelegd in de systeem log. Voorbeelden zijn 'Betalingsaanvraag Aangemaakt', 'Sanctiescreening Geslaagd' of 'SWIFT ACK Ontvangen'. Het is de primaire dimensie voor process maps, en definieert de nodes in de visualisatie en stelt analisten in staat de volgorde van uitgevoerde bewerkingen op een betaling te begrijpen. Het belang Het definieert het 'wat' van het proces, waardoor de visualisatie van de `process flow` en variaties mogelijk wordt. Vindplaats Transactielogs, Audit trails, of afgeleid van Berichttypen (bijv. MT103 Verzonden). Voorbeelden Betalingsaanvraag AangemaaktBetalingsinstructie VerzondenSWIFT ACK OntvangenBetaling goedgekeurd
	Bronsysteem SourceSystem	De naam van het systeem waar de event data is ontstaan.
Omschrijving Identificeert de software of het `platform` dat de `event log` heeft gegenereerd. In een betalingsproces kan dit het `core banking system`, de `payment gateway` of de SWIFT-`interface` direct zijn. Dit `attribute` helpt bij het verifiëren van `data lineage` en het `debuggen` van `issues` bij het samenvoegen van `data` van meerdere `disparate banking applications`. Het belang Biedt context voor de data-oorsprong, essentieel voor multi-systeem process mining. Vindplaats Gehardcodeerd tijdens ETL of geëxtraheerd uit systeemidentificaties. Voorbeelden SWIFT Alliance Access`Core Banking System`Payment EngineSanctiefilter
	Gebeurtenistijdstempel EventTimestamp	De exacte datum en tijd waarop de activiteit plaatsvond.
Omschrijving Dit attribute legt het exacte moment vast waarop een event plaatsvond. Het wordt gebruikt om activiteiten chronologisch te sequencen en om alle op duur gebaseerde metrics te berekenen, zoals lead times, cycle times en throughput. Nauwkeurige timestamps zijn cruciaal voor het analyseren van 'Netwerk Cut Off Tijd Prestaties' en het identificeren van knelpunten in de goedkeuringsketen. Het belang Timestamps vormen de basis voor alle temporele analyse en performance metrics in process mining. Vindplaats Systeem audit logs, Berichtcreatie timestamps, of Database transactietijden. Voorbeelden 2023-10-25T08:30:15Z2023-10-25T14:45:00Z2023-10-26T09:15:22Z
	Laatste data-update LastDataUpdate	De timestamp van de laatste extractie of verversing van de record.
Omschrijving Geeft aan wanneer de `data` voor het laatst is geladen in de `process mining tool`. Dit is cruciaal voor het bepalen van de versheid van de `data` en het waarborgen dat de `dashboards` de meest actuele staat van de betalingsoperaties weerspiegelen. Het helpt gebruikers de `data` te vertrouwen door transparantie te bieden over de `latency` van de rapporterings`pipeline`. Het belang Zorgt ervoor dat gebruikers de valuta en betrouwbaarheid van de gepresenteerde `data` begrijpen. Vindplaats ETL procesuitvoering `timestamp`. Voorbeelden 2023-10-27T12:00:00Z2023-11-01T06:00:00Z
	Payment Transaction ID PaymentTransactionId	De unieke identificatie die de end-to-end betalingscase vertegenwoordigt.
Omschrijving Dit attribute dient als de centrale case key voor process mining. Het groepeert alle activiteiten gerelateerd aan één betalingsinstructie, van de initiële aanvraag tot validatie, SWIFT transmissie en definitieve afwikkeling. In SWIFT contexten wordt dit vaak gemapt aan het Transaction Reference Number (TRN) of de Unique End-to-end Transaction Reference (UETR) om continuïteit over banksystemen heen te waarborgen. Het wordt gebruikt om het procesinstantiepad te reconstrueren en is essentieel voor alle variantanalyse en cyclustijdberekeningen. Het belang Unieke identificatie is de basis van process mining, waardoor verspreide events kunnen worden samengevoegd tot een samenhangend procesbeeld. Vindplaats SWIFT Veld 20 (TRN) of Veld 121 (UETR) in berichtheaders. Voorbeelden TRN-20231025-883954392-882-101UETR-9982-1123-5521PAY-US-EU-9912
	Begunstigde BIC BeneficiaryBic	De Bank Identifier Code van de ontvangende instelling.
Omschrijving Identificeert de bestemmingsbank voor de betaling. Dit is een cruciale dimensie voor het 'Beneficiary Rejection Root Cause'-`dashboard`. Door `failures` te groeperen op Begunstigde BIC, kan de bank specifieke tegenpartijen identificeren die frequent instructies afwijzen als gevolg van `data quality issues` of specifieke `formatting requirements`. Het belang Essentieel voor het analyseren van tegenpartij`performance` en `rejection patterns`. Vindplaats SWIFT Veld 57A (Account Met Instelling) of 58A (Begunstigde Instelling). Voorbeelden CITIUS33BARCGB22DRESDEFFHANDSEXX
	Is STP IsStp	Vlag die aangeeft of de betaling geen handmatige interventie vereiste.
Omschrijving Een boolean indicator die `True` is als de `case` geen 'Error Identified', 'Payment Rejected' of handmatige 'Modification' `activities` bevat. Dit berekent direct de 'Straight-Through Processing Rate' KPI. Het is de primaire `metric` voor automatiseringssucces in betalingsverwerking. Het belang De belangrijkste maatstaf voor procesefficiëntie en automatiseringsgezondheid. Vindplaats Berekend op basis van de afwezigheid van specifieke negatieve/handmatige `activities` in de `case`. Voorbeelden truefalse
	SWIFT Berichttype SwiftMessageType	Het type SWIFT bericht dat wordt gebruikt (bijv. MT103, pacs.008).
Omschrijving Geeft het specifieke formaat van de betalingsinstructie aan. Veelvoorkomende typen zijn MT103 voor klantoverboekingen en ISO 20022-equivalenten zoals pacs.008. Gebruikt in 'Payment Journey Variant Analysis' om de `processing efficiency` van `legacy` MT-formaten te vergelijken met de nieuwe ISO-standaarden. Het belang Onderscheidt betalingsstromen en verwerkingsstandaarden (Legacy vs. ISO 20022). Vindplaats SWIFT Block 2 (Applicatie Header), Berichttype veld. Voorbeelden MT103MT202pacs.008MT101
	SWIFT NAK Code SwiftNakCode	De foutcode die door het SWIFT netwerk wordt geretourneerd als een bericht wordt afgewezen.
Omschrijving Bevat de specifieke `error code` (bijv. T26, T13) die wordt geleverd in een `Negative Acknowledgment` (NAK) van het SWIFT-netwerk. Dit `attribute` stuurt het 'SWIFT Error and Rework Analysis'-`dashboard` aan, wat de categorisatie van technische storingen mogelijk maakt om systeem`fixes` te prioriteren. Het belang Biedt technische grondoorzaken voor afwijzingen op netwerkniveau. Vindplaats MT 015/019 Systeemberichten, of Veld 451 in ACK/NAK. Voorbeelden T26H01T13G02
	Transactiebedrag TransactionAmount	De monetaire waarde van de betalingsinstructie.
Omschrijving Vertegenwoordigt het hoofdbedrag dat wordt overgemaakt. Deze data wordt geëxtraheerd uit specifieke SWIFT velden (bijv. Veld 32A in MT103). Het is essentieel voor het 'High Value Transfer Approval Cycles' dashboard, waardoor segmentatie van betalingen op grootte mogelijk is om goedkeuringsvertragingen voor hoog-risico, hoog-waarde transacties te analyseren. Het belang Maakt financiële `impact analysis` en segmentatie op transactiegrootte mogelijk. Vindplaats SWIFT MT Veld 32A (Bedrag) of ISO 20022 element IntrBkSttlmAmt. Voorbeelden 15000.001250.501000000.0045.00
	Transactievaluta TransactionCurrency	De 3-letterige ISO-code die de valuta van de betaling aangeeft.
Omschrijving Identificeert de valuta waarin de betaling is gedenomineerd (bijv. USD, EUR, GBP). Dit is cruciaal voor het 'Network Cut Off Time Performance'-`dashboard`, aangezien `cut-off times` valutaspecifiek zijn. Het ondersteunt ook de 'Currency Conversion Efficiency'-analyse door `cross-currency pairs` te identificeren. Het belang Bepaalt `routing rules`, `cut-off times` en afwikkelingscorridors. Vindplaats SWIFT MT Veld 32A (Valuta) of ISO 20022 element Ccy. Voorbeelden USDEURGBPJPY
	UETR UniqueEndToEndReference	De Unieke End-to-end Transactiereferentie voor tracking in SWIFT gpi.
Omschrijving De UETR is een 36-karakter string die een enkele, onveranderlijke referentie biedt voor een betaling binnen het gehele SWIFT netwerk. In tegenstelling tot interne ID's blijft de UETR bestaan over banken heen. Dit attribute is van vitaal belang voor end-to-end zichtbaarheid en voor het correleren van interne logs met externe SWIFT gpi status updates. Het belang De gouden standaard voor het traceren van grensoverschrijdende betalingen tussen verschillende instellingen. Vindplaats SWIFT Block 3, Veld 121. Voorbeelden b8c3f4a0-5d2a-4e1b-9c3d-1a2b3c4d5e6f123e4567-e89b-12d3-a456-426614174000
	Valutadatum ValueDate	De datum waarop de gelden beschikbaar moeten zijn voor de begunstigde.
Omschrijving Vertegenwoordigt de afwikkelingsdatum zoals geïnstrueerd in het betalingsbericht. Het vergelijken van deze datum met de werkelijke 'Payment Settled' timestamp helpt in het 'Settlement and Reconciliation Aging' dashboard. Het geeft de urgentie van de betaling aan en wordt gebruikt om de naleving van service level agreements met betrekking tot de beschikbaarheid van gelden te meten. Het belang Cruciaal voor `liquidity management` en het meten van de tijdigheid van afwikkeling. Vindplaats SWIFT MT Veld 32A (Datum subveld) of ISO 20022 IntrBkSttlmDt. Voorbeelden 2023-10-262023-11-01
	Verwerkende Gebruiker ProcessingUser	De gebruiker of systeemagent die de activiteit heeft uitgevoerd.
Omschrijving Identificeert de persoon of geautomatiseerde `bot` die verantwoordelijk is voor de `activity`, zoals een `compliance officer` die een `sanction hit` goedkeurt of een `operator` die een opmaakfout corrigeert. Dit `attribute` stuurt de 'Validation Error Heatmap' aan, waardoor `managers` `training needs` of specifieke gebruikers met hoge `rework rates` kunnen identificeren. Het belang Maakt `resource` analyse en identificatie van handmatige `bottlenecks` mogelijk. Vindplaats Systeem audit logs, 'User ID' kolom in transactietabellen. Voorbeelden SYSTEEMJ.DoeCompliance_Bot_01M.Smith
	`Is Cross Border` IsCrossBorder	Vlag die aangeeft of de betaling verschillende landen betreft.
Omschrijving Een boolean `attribute` dat `True` is als het Land van Afzender verschilt van het Land van Begunstigde. Dit ondersteunt de 'Multi-Currency Handling Latency' KPI door binnenlandse van internationale stromen te scheiden. Grensoverschrijdende betalingen hebben doorgaans een hogere complexiteit, kosten en verwerkingstijden. Het belang Fundamentele segmentatie voor de analyse van betalingscomplexiteit. Vindplaats Vergelijking van landcode Afzender BIC versus landcode Begunstigde BIC. Voorbeelden truefalse
	Cut-off tijd gehaald MetCutOffTime	Vlag die aangeeft of de instructie vóór de netwerk`deadline` is verzonden.
Omschrijving Een boolean vlag, berekend door de tijd van 'Payment Instruction Sent' te vergelijken met de valutaspecifieke SWIFT-netwerk `cut-off time`. Dit ondersteunt de 'SWIFT Cut-off Adherence Rate' KPI. Het niet halen van `cut-off times` resulteert in vertragingen bij afwikkeling, wat de liquiditeitsposities beïnvloedt. Het belang Cruciale operationele KPI voor `treasury` en `liquidity management`. Vindplaats Berekend door `timestamp` te vergelijken met een statische referentietabel van `cut-off times`. Voorbeelden truefalse
	Duur Sanctiescreening SanctionsScreeningDuration	Tijd besteed in de sanctiescreeningsfase.
Omschrijving Berekent de duur tussen 'Payment Details Validated' en 'Payment Approved'. Dit vult direct het 'Sanctions Screening Lead Time'-`dashboard`. Het benadrukt specifieke transacties die vastlopen in `compliance queues`, wat de algehele `throughput` beïnvloedt. Het belang Directe maatstaf voor `compliance`-efficiëntie en impact op klant-SLA's. Vindplaats Berekend verschil tussen `timestamps` van specifieke `activities`. Voorbeelden 1200005003600000
	Instructie Prioriteit InstructionPriority	De prioriteitsvlag die de urgentie van de betaling aangeeft.
Omschrijving Afgeleid van de bericht`headers` (bijv. 'Normaal' versus 'Urgent'). Dit maakt segmentatie mogelijk in het 'High Value Transfer Approval Cycles'-`dashboard`, aangezien urgente betalingen vaak `expedited approval flows` vereisen. Inzicht in `priority distribution` helpt bij de `resource planning` voor piektijden. Het belang Helpt SLA-vereisten te onderscheiden tussen standaard en `expedited payments`. Vindplaats SWIFT Block 2, Berichtprioriteit veld (bijv. N voor Normaal, U voor Urgent). Voorbeelden Normaal`Urgent`Systeem
	Land van Herkomst OriginatingCountry	De landcode van de entiteit die de betaling initieert.
Omschrijving Geeft de jurisdictie aan waar de `payment request` is ontstaan. Dit is essentieel voor het 'Sanctions Screening Lead Time'-`dashboard`, aangezien betalingen uit `high-risk jurisdictions` vaak rigoureuze en langere `compliance checks` ondergaan. Het maakt geografische analyse van betalingsvolumes en verwerkingsvertragingen mogelijk. Het belang Belangrijke dimensie voor `compliance risk analysis` en regionale `performance`. Vindplaats Afgeleid van de Afzender BIC (`Country Code` karakters 5-6). Voorbeelden VSGBDEFR
	Reden van afwijzing RejectionReason	Tekstuele beschrijving waarom een betaling werd afgewezen.
Omschrijving Bevat de narratieve of codebeschrijving wanneer een betaling faalt, doorgaans te vinden in SWIFT Veld 72 (`Sender to Receiver Information`) of retourberichten. Dit ondersteunt de 'Beneficiary Rejection Root Cause'-analyse. Het stelt analisten in staat `text mining` uit te voeren om veelvoorkomende thema's in afwijzingen te vinden (bijv. 'Invalid Account', 'Beneficiary Name Mismatch'). Het belang Biedt kwalitatieve context voor procesfouten. Vindplaats SWIFT Veld 72 of 79 in retourberichten (MT103 Retour). Voorbeelden Begunstigde Rekening GeslotenOngeldige IBANNiet-naleving RegelgevingBankidentificatie Onbekend

Verplicht Aanbevolen Optioneel

Activiteiten Betalingsverwerking

Dit zijn de belangrijkste stappen en mijlpalen die je in je event log vastlegt voor een goede process discovery en het opsporen van knelpunten.

6 Aanbevolen 6 Optioneel

	Activiteit	Omschrijving
	Betaling afgestemd	De matching van de betalingstransactie met het Nostro/Vostro rekeningoverzicht. Afgeleid wanneer het reconciliatiesysteem de transactie ID koppelt aan een afschriftregel.
Het belang Sluit de financiële `loop`. Vertragingen hier beïnvloeden de `cash visibility` en `auditability`. Vindplaats Reconciliatie Systeem logs of 'Matched' status in het Core Banking System. Vastleggen Vergelijk reconciliatiestatus Gebeurtenistype inferred
	Betaling afgewikkeld	De bevestiging dat gelden zijn bijgeschreven op de rekening van de begunstigde (vaak gpi status ACSC). Expliciet vastgelegd via tracker updates of bevestigingsberichten.
Het belang Vertegenwoordigt het succesvolle functionele einde van de betalingsketen. Sleutel voor het berekenen van de 'Settlement to Reconciliation Gap'. Vindplaats SWIFT gpi Tracker (ACSC status) of MT900/910 bevestigingen. Vastleggen Gelogd wanneer afwikkeling is bevestigd Gebeurtenistype explicit
	Betaling goedgekeurd	De definitieve autorisatie actie door een aangewezen functionaris of geautomatiseerde regel voor overboekingen met hoge waarde. Expliciet vastgelegd wanneer de approval workflow flag op 'true' staat.
Het belang Cruciaal voor het 'High Value Transfer Approval Cycles'-`dashboard`. Identificeert vertragingen bij handmatige `sign-offs` voor grote liquiditeitsbewegingen. Vindplaats `Audit trail` van de goedkeurings`workflow engine`. Vastleggen Gelogd wanneer goedkeuringsactie is uitgevoerd Gebeurtenistype explicit
	Betalingsaanvraag Aangemaakt	De initiële generatie van de betalingsinstructie binnen het interne banksysteem of ERP. Dit wordt expliciet vastgelegd wanneer een unieke transactiereferentie (TRN of UETR) voor het eerst aan de betalingsopdracht wordt toegewezen.
Het belang Bepaalt de starttijd voor de gehele betalings`lifecycle`. Essentieel voor het berekenen van `end-to-end processing times` en het identificeren van `upstream delays` voordat het SWIFT-netwerk wordt ingeschakeld. Vindplaats Transactietabel creatie timestamp in het Core Banking System (CBS) of Payment Hub. Vastleggen Geregistreerd wanneer transactierecord is aangemaakt Gebeurtenistype explicit
	Betalingsinstructie Verzonden	De verzending van het geformatteerde bericht (MT103 of ISO 20022 pacs.008) naar de SWIFT Gateway. Expliciet vastgelegd wanneer de berichtpayload wordt gegenereerd en overgedragen aan de netwerkinterface.
Het belang Gebruikt om de 'SWIFT Cut-off Naleving Ratio' te berekenen. Markeert de overgang van interne verwerking naar netwerkverwerking. Vindplaats SWIFT Alliance Access (SAA) logs of Gateway transmissie logs. Vastleggen Gelogd wanneer berichtuitvoer plaatsvindt Gebeurtenistype explicit
	Sanctiescreening Geslaagd	De timestamp waarop de betalingsinstructie met succes het OFAC/Sanctielijst screeningproces doorloopt. Expliciet vastgelegd vanuit compliance systeem logs of afgeleid wanneer een 'Screening Hold' status wordt vrijgegeven.
Het belang Cruciaal voor het 'Sanctions Screening Lead Time'-`dashboard`. Vertragingen hier vertegenwoordigen `compliance bottlenecks` in plaats van operationele inefficiënties. Vindplaats `Compliance Filtering System`-`logs` of `Payment Hub compliance status flags`. Vastleggen Gelogd wanneer `screening status` wordt bijgewerkt Gebeurtenistype explicit
	Betaling Afgewezen	De ontvangst van een afwijzingsbericht (MT103 Retour of gpi RJCT status) van een begunstigde of intermediaire bank. Expliciet vastgelegd vanuit inkomende SWIFT berichten.
Het belang Cruciaal voor het 'Beneficiary Rejection Root Cause'-`dashboard`. Identificeert externe `blockers` zoals gesloten rekeningen of incorrecte routerings`data`. Vindplaats Inkomende SWIFT-berichten (MT103 RET, pacs.004) of `gpi status` RJCT. Vastleggen Gelogd wanneer afwijzingsbericht is ontvangen Gebeurtenistype explicit
	Betaling Overgemaakt	Een tussentijdse `status update` (vaak gpi status ACSP) die aangeeft dat de betaling wordt verwerkt door een intermediaire bank. Vastgelegd via SWIFT gpi `Tracker updates` of statusberichten.
Het belang Biedt inzicht in de 'black box' van correspondentbankieren. Essentieel voor het analyseren van de totale end-to-end reis. Vindplaats SWIFT gpi Tracker data feeds of MT199/trck berichten. Vastleggen Gelogd wanneer `tracker update` is ontvangen Gebeurtenistype explicit
	Betalingsfout Geïdentificeerd	De gebeurtenis waarbij een transactie wordt gemarkeerd voor herstel vanwege validatiefouten, NACKs of afwijzingsberichten. Afgeleid wanneer de transactie een 'Herstel', 'Correctie' of 'Uitzondering' queue binnengaat.
Het belang Volgt de 'Foutoplossing Herwerk Ratio'. Een hoge frequentie hier vernietigt de Straight-Through Processing (STP) ratios. Vindplaats Payment Hub statuskolommen of exception queue logs. Vastleggen Vergelijk statusveld met Error/Repair Gebeurtenistype inferred
	Betalingsfout Opgelost	De succesvolle wijziging en herindiening van een transactie die eerder in fout was. Afgeleid wanneer een transactie van een 'Herstel' queue teruggaat naar een 'Verwerking' of 'Klaar' status.
Het belang Meet de efficiëntie van het team voor handmatig herwerk. Lange doorlooptijden hier duiden op lacunes in training of complexe foutcodes. Vindplaats Payment Hub status logs die de uitgang uit exception queues tonen. Vastleggen Vergelijk statusveld `exit Repair` Gebeurtenistype inferred
	Betalingsgegevens Gevalideerd	De succesvolle voltooiing van syntax- en formaatcontroles (bijv. IBAN-formaat, BIC-geldigheid) op de betalingsinstructie. Dit wordt vaak afgeleid wanneer de transactiestatus verandert van 'Concept' naar 'Gevalideerd' of 'Klaar voor Autorisatie'.
Het belang Hoge `failure rates` hier duiden op slechte `data quality` bij de `source`. Meet de 'Validation First-Pass Yield' KPI. Vindplaats Payment Engine status logs of validatie geschiedenis tabellen. Vastleggen Vergelijk het statusveld voor/na Gebeurtenistype inferred
	SWIFT ACK Ontvangen	De ontvangst van een technische Bevestiging (ACK) van het SWIFT netwerk, dat bevestigt dat het bericht voor verwerking is geaccepteerd. Expliciet vastgelegd vanuit de netwerkinterface logs.
Het belang Bevestigt dat het bericht succesvol het wereldwijde netwerk is binnengekomen. Onderscheidt interne storingen van daadwerkelijke netwerkpropagatie. Vindplaats SWIFT Gateway logs (op zoek naar ACK vs NACK signalen). Vastleggen Gelogd wanneer netwerk ACK is ontvangen Gebeurtenistype explicit

Aanbevolen Optioneel

Extractie Guides

Hoe u uw `data` van SWIFT verkrijgt

Stappen

Log in op het SWIFT Alliance WebPlatform of de Alliance Access GUI met een beheerdersaccount dat toegang heeft tot de archiveringsconfiguratie.
Navigeer naar het menu Systeembeheer, selecteer Archivering en kies vervolgens Geautomatiseerde Archiveringsconfiguratie.
Configureer een nieuw Dagelijks Exportprofiel. Stel de Target Directory in op een veilige network path dat toegankelijk is voor uw extractiescripts.
Geef de Content Scope op: Selecteer 'Berichten' en zorg ervoor dat 'Historie Inclusief' en 'Interventies Inclusief' zijn aangevinkt. Dit is cruciaal voor het vastleggen van de audit trail events zoals goedkeuringen en validaties.
Selecteer de Output Format. Kies XML (specifiek het 'SAA XML v2'- of het laatst beschikbare schema) aangezien het de hiërarchische relatie tussen de berichtheader en de historie events beter bewaart dan CSV.
Stel de Date Range filters in om de specifieke historische periode te extraheren die nodig is voor het process mining-initiatief, of configureer het om dagelijks te draaien voor T-1 data.
Voer de Archive Export job handmatig uit voor de initiële load, of wacht tot de geplande batch job is voltooid. Controleer of de .xml-files zijn gegenereerd in de target directory.
Aangezien de SAA-export een hiërarchisch XML-bestand is en ProcessMind een plat CSV event log vereist, moet u een transformation script uitvoeren. Gebruik het Python-script dat wordt geleverd in de Query-sectie om de XML te parsen.
Het script itereert door elk berichtelement. Het extraheert de Unique End-to-end Transaction Reference (UETR) of Transaction Reference Number (TRN) om te dienen als de Case ID.
Het script itereert vervolgens door de 'History'- en 'Intervention'-child nodes van elk bericht om activity rijen te genereren. Het mapt interne SAA-status codes (bijv. 'NetworkAck', 'Authorisation') naar de gestandaardiseerde activity names.
Voer het Python-script uit op uw geëxporteerde XML-files om het platte 'events.csv'-bestand te genereren.
Valideer de CSV-output om ervoor te zorgen dat kolommen zoals EventTimestamp in ISO 8601-formaat zijn, en upload vervolgens het bestand naar ProcessMind.

Configuratie

Archiefindeling: XML (voorkeur) of CSV (plat bestand). XML wordt sterk aanbevolen om geneste historieknopen vast te leggen.
Inclusief Berichttekst: Ja (vereist om bedrag-, valuta- en begunstigdegegevens te parseren).
Inclusief Historie/Interventies: Ja (verplicht om goedkeuringen, validaties en fouten te zien).
Datumbereik: Configureer voor een rolling window (bijv. laatste 30 dagen) voor incrementele loads, of vaste datums voor initiële historie.
Berichttypen: Filter op MT103, MT202, pacs.008, pacs.009 en pacs.004/002 (voor returns/status).
Richtingen: Neem zowel Input (Emissie) als Output (Receptie) op om inkomende afwijzingen of bevestigingen vast te leggen.
Beveiliging: Zorg ervoor dat de exportmap strikte lees-/schrijfrechten heeft, aangezien deze bestanden live betaaldata bevatten.

a Voorbeeldquery config

import xml.etree.ElementTree as ET
import pandas as pd
import glob
import os

# CONFIGURATION
# Update this path to your SAA XML Export directory
input_folder = "./saa_exports/"
output_file = "./swift_process_mining_log.csv"

columns = [
    "PaymentTransactionId", "ActivityName", "EventTimestamp", "SourceSystem", 
    "LastDataUpdate", "TransactionAmount", "TransactionCurrency", "UniqueEndToEndReference",
    "SwiftMessageType", "ProcessingUser", "BeneficiaryBic", "SwiftNakCode", "ValueDate", "IsStp"
]

data_rows = []

# Helper to determine Activity Name based on SAA History Events
def map_activity(history_item_name, status, nature, text_content):
    # 1. Payment Request Created
    if history_item_name == "Creation" or history_item_name == "Reception":
        return "Payment Request Created"
    
    # 2. Payment Details Validated
    if "Validation" in history_item_name and status == "Success":
        return "Payment Details Validated"
    
    # 3. Sanctions Screening Passed
    if "Filter" in history_item_name and status == "Passed":
        return "Sanctions Screening Passed"
    
    # 4. Payment Approved
    if history_item_name == "Intervention" and nature == "Authorization":
        return "Payment Approved"
    
    # 5. Payment Instruction Sent
    if history_item_name == "Transmission" or status == "Transmitted":
        return "Payment Instruction Sent"
    
    # 6. SWIFT ACK Received
    if history_item_name == "NetworkReport" and "ACK" in text_content:
        return "SWIFT ACK Received"

    # 7. Payment Transferred (gpi status)
    if "TrackerUpdate" in history_item_name and "ACSP" in text_content:
        return "Payment Transferred"

    # 8. Payment Error Identified
    if nature == "NAK" or status == "Failed" or nature == "RoutingFailure":
        return "Payment Error Identified"

    # 9. Payment Error Resolved
    if history_item_name == "Modification" and nature == "Repair":
        return "Payment Error Resolved"
    
    # 10. Payment Rejected
    if "TrackerUpdate" in history_item_name and "RJCT" in text_content:
        return "Payment Rejected"

    # 11. Payment Settled
    if "TrackerUpdate" in history_item_name and "ACSC" in text_content:
        return "Payment Settled"

    # 12. Payment Reconciled
    # Often external, but if SAA receives a Reconciliation update:
    if history_item_name == "ReconciliationMatch":
        return "Payment Reconciled"
        
    return None

# PROCESS XML FILES
for xml_file in glob.glob(os.path.join(input_folder, "*.xml")):
    tree = ET.parse(xml_file)
    root = tree.getroot()

    # Iterate through Messages
    for message in root.findall(".//Message"):
        # Header Extraction
        trn = message.findtext("TRN")
        uetr = message.findtext("UETR")
        case_id = uetr if uetr else trn
        
        # Skip if no identifier found
        if not case_id: 
            continue

        msg_type = message.findtext("Type")
        amount = message.findtext("Amount")
        currency = message.findtext("Currency")
        val_date = message.findtext("ValueDate")
        ben_bic = message.findtext("BeneficiaryBIC")
        
        # Loop through History/Audit Trail for Activities
        for history in message.findall(".//History/Item"):
            evt_name = history.findtext("Name")
            evt_status = history.findtext("Status")
            evt_nature = history.findtext("Nature")
            evt_text = history.findtext("Text") or ""
            evt_user = history.findtext("Operator")
            evt_time = history.findtext("Time") # format: YYYYMMDDHHMMSS
            
            activity = map_activity(evt_name, evt_status, evt_nature, evt_text)
            
            if activity:
                # Determine NAK Code if applicable
                nak_code = None
                if activity == "Payment Error Identified" and "NAK" in evt_text:
                    nak_code = evt_text.split("Code:")[-1].strip()
                
                # Determine STP
                is_stp = "True" if evt_user == "System" or evt_user == "Auto" else "False"

                data_rows.append({
                    "PaymentTransactionId": case_id,
                    "ActivityName": activity,
                    "EventTimestamp": pd.to_datetime(evt_time, format='%Y%m%d%H%M%S'),
                    "SourceSystem": "SWIFT Alliance Access",
                    "LastDataUpdate": pd.Timestamp.now(),
                    "TransactionAmount": amount,
                    "TransactionCurrency": currency,
                    "UniqueEndToEndReference": uetr,
                    "SwiftMessageType": msg_type,
                    "ProcessingUser": evt_user,
                    "BeneficiaryBic": ben_bic,
                    "SwiftNakCode": nak_code,
                    "ValueDate": val_date,
                    "IsStp": is_stp
                })

# OUTPUT GENERATION
df = pd.DataFrame(data_rows, columns=columns)

# Remove duplicate timestamp/activity pairs for cleaner log
df.drop_duplicates(subset=["PaymentTransactionId", "ActivityName", "EventTimestamp"], inplace=True)

df.to_csv(output_file, index=False, quoting=1)
print(f"Extraction Complete. Processed {len(df)} events into {output_file}")

Stappen

Omgeving Voorbereiden: Zorg ervoor dat Python 3.8+ is geïnstalleerd op de extractie server. Installeer de vereiste bibliotheken met pip (pandas, numpy). Creëer een speciale werkmap met een subfolder genaamd raw_swift_files en plaats daar alle dagelijkse .out-, .txt- of .fin-files.
Bestandsstructuur Begrijpen: Ruwe SWIFT FIN-berichten zijn block-structured ({1: Header} {2: Application} {4: Body}). Identificeer de scheidingstekens. Standaardfiles gebruiken curly braces. Zorg ervoor dat uw files niet zijn verpakt in proprietary envelopes (zoals RJE headers) of strip ze voor verwerking.
Scriptpaden Configureren: Open het meegeleverde Python-script. Werk de INPUT_DIRECTORY-variabele bij om naar uw raw_swift_files-folder te verwijzen. Werk het OUTPUT_FILE-pad bij voor het resulterende CSV-bestand.
Regex Patronen Definiëren: Het script gebruikt regex om blokken te isoleren. Blok 1 bevat de Afzender BIC en Volgnummer. Blok 2 bevat het Berichttype (bijv. I103, O103) en Ontvanger BIC. Blok 4 bevat de bedrijfsdata-tags (bijv. :20: TRN, :32A: Waarde/Bedrag).
Berichttypen aan Activities Toewijzen: Het script bevat een mapping dictionary. MT103 impliceert 'Payment Instruction Sent'. MT012 (System ACK) impliceert 'SWIFT ACK Received'. MT900/910 impliceert 'Payment Settled'. MT199/299 met specifieke status codes (ACSP, RJCT) mapt naar 'Payment Transferred' of 'Payment Rejected'.
Attributes Extraheren: De parser doorloopt specifieke tags. :20: is gemapt naar Payment Transaction ID. :121: is gemapt naar UETR. :32A: wordt geparset in Datum, Valuta en Bedrag.
Interne Statusen Verwerken: Voor activities zoals 'Payment Request Created' of 'Payment Approved', die vaak interne ERP events zijn die niet in SWIFT-files staan, leidt het script deze af van de Message Creation Timestamp in Blok 1 indien expliciete logs niet beschikbaar zijn, of zoekt het naar specifieke tekstcodes in veld :72: (Sender to Receiver Info) als uw organisatie goedkeuringen daar logt.
Extractie Uitvoeren: Voer het script uit via de command line: python swift_parser.py. Het script doorloopt alle files, parset geldige SWIFT-blokken en slaat malformed lines over.
Post-Processing Validatie: Open het gegenereerde CSV-bestand. Controleer het EventTimestamp-formaat (ISO 8601 aanbevolen). Zorg ervoor dat PaymentTransactionId is gevuld voor elke rij om case grouping mogelijk te maken.
Data Transformation: Als 'ValueDate' als YYMMDD verschijnt, converteert het script dit naar YYYY-MM-DD. Zorg ervoor dat decimale scheidingstekens in 'TransactionAmount' zijn gestandaardiseerd (punten versus komma's).
Eindcontrole: Filter op een specifieke UETR om de end-to-end flow te zien van Instruction Sent -> ACK -> Settlement. Controleer of NAKs (MT019) verschijnen als 'Payment Error Identified'.
Uploaden naar ProcessMind: Importeer het CSV-bestand. Map PaymentTransactionId naar Case ID, ActivityName naar Activity, en EventTimestamp naar Timestamp.

Configuratie

Invoerdirectory: Pad naar de map met onbewerkte FIN/MT flat files. Zorg ervoor dat leesrechten zijn toegekend.
Datumformaatparsing: Ruwe SWIFT-datums zijn YYMMDD. Het script verwerkt de eeuw-aanname (20xx).
Berichttypefilters: Het script richt zich op categorie 1 (Betalingen), 9 (Afschriften) en veelvoorkomende systeemberichten (012, 019). Pas de RELEVANT_MT_TYPES-lijst aan indien categorie 2 (Overboekingen financiële instellingen) nodig is.
Codering: Standaard 'utf-8'. Wijzig naar 'latin-1' of 'ascii' als bestanden legacy encoding characters bevatten.
Batch Processing: Voor datasets groter dan 1GB gebruikt het script een generator approach om memory overflow te voorkomen, waarbij file-by-file wordt verwerkt.
Regex Tuning: De strikte regex gaat uit van het standaard FIN-formaat {1:...}{2:...}{4:...}. Als files $ of andere scheidingstekens gebruiken, werk dan de BLOCK_PATTERN-variabele bij.

a Voorbeeldquery python

import os
import re
import glob
import pandas as pd
from datetime import datetime

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
INPUT_DIRECTORY = class="hl-string">"./raw_swift_files/"
OUTPUT_FILE = class="hl-string">"./extracted_swift_event_log.csv"

class=class="hl-string">"hl-comment"># === REGEX PATTERNS ===
class=class="hl-string">"hl-comment"># Matches standard SWIFT block structure: {1:...}{2:...}{3:...}{4:...}
BLOCK_PATTERN = re.compile(rclass="hl-string">'(\{1:.*?\})(\{2:.*?\})(?:\{3:.*?\})?(\{4:.*?\})', re.DOTALL)

class=class="hl-string">"hl-comment"># Field extractors
TAG_20_TRN = re.compile(rclass="hl-string">':20:([^\r\n]+)')
TAG_121_UETR = re.compile(rclass="hl-string">':121:([a-fA-F0-9\-]+)')
TAG_32A_VAL = re.compile(rclass="hl-string">':32A:(\d{6})([A-Z]{3})([\d,]+)')
TAG_72_INFO = re.compile(rclass="hl-string">':72:([^\r\n]+)')
TAG_57A_BIC = re.compile(rclass="hl-string">':57[A-Z]?:(?:[/]{0,2}[A-Z0-9]+)?\r?\n?([A-Z0-9]{8,11})')

class=class="hl-string">"hl-comment"># Header parsers
BLOCK_1_DATE = re.compile(rclass="hl-string">'\{1:[F|A|L]01[A-Z0-9]{12}(\d{4})(\d{6})')
BLOCK_2_TYPE = re.compile(rclass="hl-string">'\{2:([IO])(\d{3})')

class=class="hl-string">"hl-comment"># === ACTIVITY MAPPING LOGIC ===
def map_message_to_activity(io_direction, mt_type, block4_text):
    class=class="hl-string">"hl-comment"># Outgoing Payments (MT103, MT202)
    if io_direction == class="hl-string">'I' and mt_type in [class="hl-string">'103', class="hl-string">'202']:
        return class="hl-string">"Payment Instruction Sent"
    
    class=class="hl-string">"hl-comment"># Incoming Payments (MT103 received from another bank)
    if io_direction == class="hl-string">'O' and mt_type in [class="hl-string">'103', class="hl-string">'202']:
        return class="hl-string">"Payment Transferred"

    class=class="hl-string">"hl-comment"># System Acknowledgment (MT012)
    if mt_type == class="hl-string">'012':
        return class="hl-string">"SWIFT ACK Received"

    class=class="hl-string">"hl-comment"># System NAK / Abort (MT019)
    if mt_type == class="hl-string">'019':
        return class="hl-string">"Payment Error Identified"

    class=class="hl-string">"hl-comment"># Statements / Confirmation (MT900 Debit, MT910 Credit, MT950)
    if mt_type in [class="hl-string">'900', class="hl-string">'910', class="hl-string">'910', class="hl-string">'950']:
        return class="hl-string">"Payment Settled"
    
    class=class="hl-string">"hl-comment"># Returns (MT103 RETN)
    if mt_type == class="hl-string">'103' and class="hl-string">':23E:RETN' in block4_text:
        return class="hl-string">"Payment Rejected"

    class=class="hl-string">"hl-comment"># GPI Status Updates (MT199)
    if mt_type == class="hl-string">'199':
        if class="hl-string">'/RJCT/' in block4_text:
            return class="hl-string">"Payment Rejected"
        if class="hl-string">'/ACSP/' in block4_text:
            return class="hl-string">"Payment Transferred"
        if class="hl-string">'/ACSC/' in block4_text:
            return class="hl-string">"Payment Settled"
            
    return class="hl-string">"Message Processed"  class=class="hl-string">"hl-comment"># Fallback

def parse_swift_date(yymmdd):
    class=class="hl-string">"hl-comment"># Assumes 20xx for years
    try:
        return datetime.strptime(yymmdd, class="hl-string">'%y%m%d').strftime(class="hl-string">'%Y-%m-%d')
    except ValueError:
        return None

class=class="hl-string">"hl-comment"># === MAIN EXTRACTION ===
def process_files():
    records = []
    files = glob.glob(os.path.join(INPUT_DIRECTORY, class="hl-string">"*"))
    
    print(fclass="hl-string">"Found {len(files)} files to process.")

    for filepath in files:
        try:
            with open(filepath, class="hl-string">'r', encoding=class="hl-string">'utf-8', errors=class="hl-string">'ignore') as f:
                content = f.read()
                
            class=class="hl-string">"hl-comment"># Find all full messages in file
            messages = BLOCK_PATTERN.findall(content)
            
            for b1, b2, b4 in messages:
                class=class="hl-string">"hl-comment"># -- Extract Core IDs --
                trn_match = TAG_20_TRN.search(b4)
                uetr_match = TAG_121_UETR.search(b4)
                
                class=class="hl-string">"hl-comment"># Primary Key preference: UETR > TRN > Generated ID
                uetr = uetr_match.group(1) if uetr_match else None
                trn = trn_match.group(1) if trn_match else class="hl-string">"UNKNOWN"
                case_id = uetr if uetr else trn
                
                if case_id == class="hl-string">"UNKNOWN":
                    continue class=class="hl-string">"hl-comment"># Skip structural noise

                class=class="hl-string">"hl-comment"># -- Extract Metadata --
                type_match = BLOCK_2_TYPE.search(b2)
                io_dir = type_match.group(1) if type_match else class="hl-string">"I"
                mt_type = type_match.group(2) if type_match else class="hl-string">"999"
                
                class=class="hl-string">"hl-comment"># -- Determine Timestamp --
                class=class="hl-string">"hl-comment"># Attempt to find timestamp in Block 1 (Session header)
                class=class="hl-string">"hl-comment"># Format often: {1:F01BANKBEBBXXXX1234123456}
                class=class="hl-string">"hl-comment"># Using current time as fallback if header parsing fails
                timestamp = datetime.now().isoformat()
                date_match = BLOCK_1_DATE.search(b1)
                if date_match:
                    class=class="hl-string">"hl-comment"># YYMMDD + HHMM
                    class=class="hl-string">"hl-comment"># Note: Sequence number often occupies this space, this regex is generic
                    class=class="hl-string">"hl-comment"># For simplicity, we assume file creation time or construct from header
                    pass 
                    
                class=class="hl-string">"hl-comment"># -- Extract Financials --
                amount = None
                currency = None
                val_date = None
                amt_match = TAG_32A_VAL.search(b4)
                if amt_match:
                    val_date_raw, currency, amt_str = amt_match.groups()
                    val_date = parse_swift_date(val_date_raw)
                    amount = float(amt_str.replace(class="hl-string">',', class="hl-string">'.'))

                class=class="hl-string">"hl-comment"># -- Extract Beneficiary --
                ben_bic = None
                ben_match = TAG_57A_BIC.search(b4)
                if ben_match:
                    ben_bic = ben_match.group(1)

                class=class="hl-string">"hl-comment"># -- Map Activity --
                activity = map_message_to_activity(io_dir, mt_type, b4)

                class=class="hl-string">"hl-comment"># -- Create Record --
                record = {
                    class="hl-string">"PaymentTransactionId": case_id,
                    class="hl-string">"ActivityName": activity,
                    class="hl-string">"EventTimestamp": datetime.now().strftime(class="hl-string">"%Y-%m-%d %H:%M:%S"), class=class="hl-string">"hl-comment"># Replace with actual extracted time
                    class="hl-string">"SourceSystem": class="hl-string">"SWIFT_Alliance_Access",
                    class="hl-string">"TransactionAmount": amount,
                    class="hl-string">"TransactionCurrency": currency,
                    class="hl-string">"UniqueEndToEndReference": uetr,
                    class="hl-string">"SwiftMessageType": fclass="hl-string">"MT{mt_type}",
                    class="hl-string">"BeneficiaryBic": ben_bic,
                    class="hl-string">"ValueDate": val_date,
                    class="hl-string">"LastDataUpdate": datetime.now().isoformat()
                }
                
                records.append(record)

                class=class="hl-string">"hl-comment"># -- Derived Logic for class="hl-string">'Created' --
                class=class="hl-string">"hl-comment"># If this is the very first outgoing MT103, we can imply creation
                class=class="hl-string">"hl-comment"># In a real scenario, this logic happens after sorting all events
                if activity == class="hl-string">"Payment Instruction Sent":
                    creation_record = record.copy()
                    creation_record[class="hl-string">"ActivityName"] = class="hl-string">"Payment Request Created"
                    class=class="hl-string">"hl-comment"># Offset time slightly backwards to simulate flow
                    creation_record[class="hl-string">"EventTimestamp"] = class="hl-string">"[Derive from Log Creation Time]"
                    records.append(creation_record)

        except Exception as e:
            print(fclass="hl-string">"Error processing file {filepath}: {e}")

    class=class="hl-string">"hl-comment"># -- Convert to DataFrame --
    df = pd.DataFrame(records)
    
    class=class="hl-string">"hl-comment"># -- Final Cleanup --
    class=class="hl-string">"hl-comment"># Sort by ID and Time to ensure logical order if needed
    if not df.empty:
        df.sort_values(by=[class="hl-string">'PaymentTransactionId', class="hl-string">'EventTimestamp'], inplace=True)
        df.to_csv(OUTPUT_FILE, index=False)
        print(fclass="hl-string">"Extraction complete. Data saved to {OUTPUT_FILE}")
    else:
        print(class="hl-string">"No valid SWIFT messages found.")

if __name__ == class="hl-string">"__main__":
    process_files()

Stappen

Omgeving Voorbereiden: Zorg ervoor dat Python 3.8+ is geïnstalleerd op de extractie server. Installeer de vereiste bibliotheken met pip (pandas, numpy). Creëer een speciale werkmap met een subfolder genaamd raw_swift_files en plaats daar alle dagelijkse .out-, .txt- of .fin-files.
Bestandsstructuur Begrijpen: Ruwe SWIFT FIN-berichten zijn block-structured ({1: Header} {2: Application} {4: Body}). Identificeer de scheidingstekens. Standaardfiles gebruiken curly braces. Zorg ervoor dat uw files niet zijn verpakt in proprietary envelopes (zoals RJE headers) of strip ze voor verwerking.
Scriptpaden Configureren: Open het meegeleverde Python-script. Werk de INPUT_DIRECTORY-variabele bij om naar uw raw_swift_files-folder te verwijzen. Werk het OUTPUT_FILE-pad bij voor het resulterende CSV-bestand.
Regex Patronen Definiëren: Het script gebruikt regex om blokken te isoleren. Blok 1 bevat de Afzender BIC en Volgnummer. Blok 2 bevat het Berichttype (bijv. I103, O103) en Ontvanger BIC. Blok 4 bevat de bedrijfsdata-tags (bijv. :20: TRN, :32A: Waarde/Bedrag).
Berichttypen aan Activities Toewijzen: Het script bevat een mapping dictionary. MT103 impliceert 'Payment Instruction Sent'. MT012 (System ACK) impliceert 'SWIFT ACK Received'. MT900/910 impliceert 'Payment Settled'. MT199/299 met specifieke status codes (ACSP, RJCT) mapt naar 'Payment Transferred' of 'Payment Rejected'.
Attributes Extraheren: De parser doorloopt specifieke tags. :20: is gemapt naar Payment Transaction ID. :121: is gemapt naar UETR. :32A: wordt geparset in Datum, Valuta en Bedrag.
Interne Statusen Verwerken: Voor activities zoals 'Payment Request Created' of 'Payment Approved', die vaak interne ERP events zijn die niet in SWIFT-files staan, leidt het script deze af van de Message Creation Timestamp in Blok 1 indien expliciete logs niet beschikbaar zijn, of zoekt het naar specifieke tekstcodes in veld :72: (Sender to Receiver Info) als uw organisatie goedkeuringen daar logt.
Extractie Uitvoeren: Voer het script uit via de command line: python swift_parser.py. Het script doorloopt alle files, parset geldige SWIFT-blokken en slaat malformed lines over.
Post-Processing Validatie: Open het gegenereerde CSV-bestand. Controleer het EventTimestamp-formaat (ISO 8601 aanbevolen). Zorg ervoor dat PaymentTransactionId is gevuld voor elke rij om case grouping mogelijk te maken.
Data Transformation: Als 'ValueDate' als YYMMDD verschijnt, converteert het script dit naar YYYY-MM-DD. Zorg ervoor dat decimale scheidingstekens in 'TransactionAmount' zijn gestandaardiseerd (punten versus komma's).
Eindcontrole: Filter op een specifieke UETR om de end-to-end flow te zien van Instruction Sent -> ACK -> Settlement. Controleer of NAKs (MT019) verschijnen als 'Payment Error Identified'.
Uploaden naar ProcessMind: Importeer het CSV-bestand. Map PaymentTransactionId naar Case ID, ActivityName naar Activity, en EventTimestamp naar Timestamp.

Configuratie

Invoerdirectory: Pad naar de map met onbewerkte FIN/MT flat files. Zorg ervoor dat leesrechten zijn toegekend.
Datumformaatparsing: Ruwe SWIFT-datums zijn YYMMDD. Het script verwerkt de eeuw-aanname (20xx).
Berichttypefilters: Het script richt zich op categorie 1 (Betalingen), 9 (Afschriften) en veelvoorkomende systeemberichten (012, 019). Pas de RELEVANT_MT_TYPES-lijst aan indien categorie 2 (Overboekingen financiële instellingen) nodig is.
Codering: Standaard 'utf-8'. Wijzig naar 'latin-1' of 'ascii' als bestanden legacy encoding characters bevatten.
Batch Processing: Voor datasets groter dan 1GB gebruikt het script een generator approach om memory overflow te voorkomen, waarbij file-by-file wordt verwerkt.
Regex Tuning: De strikte regex gaat uit van het standaard FIN-formaat {1:...}{2:...}{4:...}. Als files $ of andere scheidingstekens gebruiken, werk dan de BLOCK_PATTERN-variabele bij.

a Voorbeeldquery python

import os
import re
import glob
import pandas as pd
from datetime import datetime

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
INPUT_DIRECTORY = class="hl-string">"./raw_swift_files/"
OUTPUT_FILE = class="hl-string">"./extracted_swift_event_log.csv"

class=class="hl-string">"hl-comment"># === REGEX PATTERNS ===
class=class="hl-string">"hl-comment"># Matches standard SWIFT block structure: {1:...}{2:...}{3:...}{4:...}
BLOCK_PATTERN = re.compile(rclass="hl-string">'(\{1:.*?\})(\{2:.*?\})(?:\{3:.*?\})?(\{4:.*?\})', re.DOTALL)

class=class="hl-string">"hl-comment"># Field extractors
TAG_20_TRN = re.compile(rclass="hl-string">':20:([^\r\n]+)')
TAG_121_UETR = re.compile(rclass="hl-string">':121:([a-fA-F0-9\-]+)')
TAG_32A_VAL = re.compile(rclass="hl-string">':32A:(\d{6})([A-Z]{3})([\d,]+)')
TAG_72_INFO = re.compile(rclass="hl-string">':72:([^\r\n]+)')
TAG_57A_BIC = re.compile(rclass="hl-string">':57[A-Z]?:(?:[/]{0,2}[A-Z0-9]+)?\r?\n?([A-Z0-9]{8,11})')

class=class="hl-string">"hl-comment"># Header parsers
BLOCK_1_DATE = re.compile(rclass="hl-string">'\{1:[F|A|L]01[A-Z0-9]{12}(\d{4})(\d{6})')
BLOCK_2_TYPE = re.compile(rclass="hl-string">'\{2:([IO])(\d{3})')

class=class="hl-string">"hl-comment"># === ACTIVITY MAPPING LOGIC ===
def map_message_to_activity(io_direction, mt_type, block4_text):
    class=class="hl-string">"hl-comment"># Outgoing Payments (MT103, MT202)
    if io_direction == class="hl-string">'I' and mt_type in [class="hl-string">'103', class="hl-string">'202']:
        return class="hl-string">"Payment Instruction Sent"
    
    class=class="hl-string">"hl-comment"># Incoming Payments (MT103 received from another bank)
    if io_direction == class="hl-string">'O' and mt_type in [class="hl-string">'103', class="hl-string">'202']:
        return class="hl-string">"Payment Transferred"

    class=class="hl-string">"hl-comment"># System Acknowledgment (MT012)
    if mt_type == class="hl-string">'012':
        return class="hl-string">"SWIFT ACK Received"

    class=class="hl-string">"hl-comment"># System NAK / Abort (MT019)
    if mt_type == class="hl-string">'019':
        return class="hl-string">"Payment Error Identified"

    class=class="hl-string">"hl-comment"># Statements / Confirmation (MT900 Debit, MT910 Credit, MT950)
    if mt_type in [class="hl-string">'900', class="hl-string">'910', class="hl-string">'910', class="hl-string">'950']:
        return class="hl-string">"Payment Settled"
    
    class=class="hl-string">"hl-comment"># Returns (MT103 RETN)
    if mt_type == class="hl-string">'103' and class="hl-string">':23E:RETN' in block4_text:
        return class="hl-string">"Payment Rejected"

    class=class="hl-string">"hl-comment"># GPI Status Updates (MT199)
    if mt_type == class="hl-string">'199':
        if class="hl-string">'/RJCT/' in block4_text:
            return class="hl-string">"Payment Rejected"
        if class="hl-string">'/ACSP/' in block4_text:
            return class="hl-string">"Payment Transferred"
        if class="hl-string">'/ACSC/' in block4_text:
            return class="hl-string">"Payment Settled"
            
    return class="hl-string">"Message Processed"  class=class="hl-string">"hl-comment"># Fallback

def parse_swift_date(yymmdd):
    class=class="hl-string">"hl-comment"># Assumes 20xx for years
    try:
        return datetime.strptime(yymmdd, class="hl-string">'%y%m%d').strftime(class="hl-string">'%Y-%m-%d')
    except ValueError:
        return None

class=class="hl-string">"hl-comment"># === MAIN EXTRACTION ===
def process_files():
    records = []
    files = glob.glob(os.path.join(INPUT_DIRECTORY, class="hl-string">"*"))
    
    print(fclass="hl-string">"Found {len(files)} files to process.")

    for filepath in files:
        try:
            with open(filepath, class="hl-string">'r', encoding=class="hl-string">'utf-8', errors=class="hl-string">'ignore') as f:
                content = f.read()
                
            class=class="hl-string">"hl-comment"># Find all full messages in file
            messages = BLOCK_PATTERN.findall(content)
            
            for b1, b2, b4 in messages:
                class=class="hl-string">"hl-comment"># -- Extract Core IDs --
                trn_match = TAG_20_TRN.search(b4)
                uetr_match = TAG_121_UETR.search(b4)
                
                class=class="hl-string">"hl-comment"># Primary Key preference: UETR > TRN > Generated ID
                uetr = uetr_match.group(1) if uetr_match else None
                trn = trn_match.group(1) if trn_match else class="hl-string">"UNKNOWN"
                case_id = uetr if uetr else trn
                
                if case_id == class="hl-string">"UNKNOWN":
                    continue class=class="hl-string">"hl-comment"># Skip structural noise

                class=class="hl-string">"hl-comment"># -- Extract Metadata --
                type_match = BLOCK_2_TYPE.search(b2)
                io_dir = type_match.group(1) if type_match else class="hl-string">"I"
                mt_type = type_match.group(2) if type_match else class="hl-string">"999"
                
                class=class="hl-string">"hl-comment"># -- Determine Timestamp --
                class=class="hl-string">"hl-comment"># Attempt to find timestamp in Block 1 (Session header)
                class=class="hl-string">"hl-comment"># Format often: {1:F01BANKBEBBXXXX1234123456}
                class=class="hl-string">"hl-comment"># Using current time as fallback if header parsing fails
                timestamp = datetime.now().isoformat()
                date_match = BLOCK_1_DATE.search(b1)
                if date_match:
                    class=class="hl-string">"hl-comment"># YYMMDD + HHMM
                    class=class="hl-string">"hl-comment"># Note: Sequence number often occupies this space, this regex is generic
                    class=class="hl-string">"hl-comment"># For simplicity, we assume file creation time or construct from header
                    pass 
                    
                class=class="hl-string">"hl-comment"># -- Extract Financials --
                amount = None
                currency = None
                val_date = None
                amt_match = TAG_32A_VAL.search(b4)
                if amt_match:
                    val_date_raw, currency, amt_str = amt_match.groups()
                    val_date = parse_swift_date(val_date_raw)
                    amount = float(amt_str.replace(class="hl-string">',', class="hl-string">'.'))

                class=class="hl-string">"hl-comment"># -- Extract Beneficiary --
                ben_bic = None
                ben_match = TAG_57A_BIC.search(b4)
                if ben_match:
                    ben_bic = ben_match.group(1)

                class=class="hl-string">"hl-comment"># -- Map Activity --
                activity = map_message_to_activity(io_dir, mt_type, b4)

                class=class="hl-string">"hl-comment"># -- Create Record --
                record = {
                    class="hl-string">"PaymentTransactionId": case_id,
                    class="hl-string">"ActivityName": activity,
                    class="hl-string">"EventTimestamp": datetime.now().strftime(class="hl-string">"%Y-%m-%d %H:%M:%S"), class=class="hl-string">"hl-comment"># Replace with actual extracted time
                    class="hl-string">"SourceSystem": class="hl-string">"SWIFT_Alliance_Access",
                    class="hl-string">"TransactionAmount": amount,
                    class="hl-string">"TransactionCurrency": currency,
                    class="hl-string">"UniqueEndToEndReference": uetr,
                    class="hl-string">"SwiftMessageType": fclass="hl-string">"MT{mt_type}",
                    class="hl-string">"BeneficiaryBic": ben_bic,
                    class="hl-string">"ValueDate": val_date,
                    class="hl-string">"LastDataUpdate": datetime.now().isoformat()
                }
                
                records.append(record)

                class=class="hl-string">"hl-comment"># -- Derived Logic for class="hl-string">'Created' --
                class=class="hl-string">"hl-comment"># If this is the very first outgoing MT103, we can imply creation
                class=class="hl-string">"hl-comment"># In a real scenario, this logic happens after sorting all events
                if activity == class="hl-string">"Payment Instruction Sent":
                    creation_record = record.copy()
                    creation_record[class="hl-string">"ActivityName"] = class="hl-string">"Payment Request Created"
                    class=class="hl-string">"hl-comment"># Offset time slightly backwards to simulate flow
                    creation_record[class="hl-string">"EventTimestamp"] = class="hl-string">"[Derive from Log Creation Time]"
                    records.append(creation_record)

        except Exception as e:
            print(fclass="hl-string">"Error processing file {filepath}: {e}")

    class=class="hl-string">"hl-comment"># -- Convert to DataFrame --
    df = pd.DataFrame(records)
    
    class=class="hl-string">"hl-comment"># -- Final Cleanup --
    class=class="hl-string">"hl-comment"># Sort by ID and Time to ensure logical order if needed
    if not df.empty:
        df.sort_values(by=[class="hl-string">'PaymentTransactionId', class="hl-string">'EventTimestamp'], inplace=True)
        df.to_csv(OUTPUT_FILE, index=False)
        print(fclass="hl-string">"Extraction complete. Data saved to {OUTPUT_FILE}")
    else:
        print(class="hl-string">"No valid SWIFT messages found.")

if __name__ == class="hl-string">"__main__":
    process_files()

Uw Data Template voor Betalingsverwerking

Uw Data Template voor Betalingsverwerking

Attributes Betalingsverwerking

Activiteiten Betalingsverwerking

Extractie Guides

SWIFT Alliance Access Archief Export

Stappen

Configuratie

a Voorbeeldquery config

Python Parser voor Ruwe SWIFT MT Bestanden

Stappen

Configuratie

a Voorbeeldquery python

SWIFT gpi API Connector

Stappen

Configuratie

a Voorbeeldquery python

Klaar om te starten?

Optimaliseer Nu Uw SWIFT Betalingsverwerking

Uw Data Template voor Betalingsverwerking

Uw Data Template voor Betalingsverwerking

Attributes Betalingsverwerking

Activiteiten Betalingsverwerking

Extractie Guides

SWIFT Alliance Access Archief Export

Stappen

Configuratie

a Voorbeeldquery config

Python Parser voor Ruwe SWIFT MT Bestanden

Stappen

Configuratie

a Voorbeeldquery python

SWIFT gpi API Connector

Stappen

Configuratie

a Voorbeeldquery python

Wij hechten veel waarde aan je privacy

Klaar om te starten?

Optimaliseer Nu Uw SWIFT Betalingsverwerking