Guida alla migrazione ISO 20022

In breve: SWIFT ritirerà MT940 entro novembre 2028. Bank Statement Parser gestisce sia MT940 che CAMT.053 con un'unica API, quindi la pipeline di parsing funziona durante la transizione e oltre.

Perché questa migrazione è importante

SWIFT sta ritirando i formati di messaggi MT legacy a favore del più ricco standard ISO 20022. Per i team di tesoreria e finanza, le pipeline di elaborazione degli estratti conto devono evolversi da MT940 a CAMT.053 prima delle scadenze definitive.

Timeline della migrazione SWIFT

Cosa cambia nel codice

Prima: solo MT940

from bankstatementparser import Mt940Parser

parser = Mt940Parser("statement.mt940")
df = parser.parse()

Dopo: entrambi i formati con rilevamento automatico

from bankstatementparser import create_parser, detect_statement_format

fmt = detect_statement_format("statement.xml")  # or .mt940
parser = create_parser("statement.xml", fmt)
df = parser.parse()  # Same DataFrame schema regardless of format

La funzione detect_statement_format() identifica se il file è MT940, CAMT.053, PAIN.001 o qualsiasi altro formato supportato. La funzione create_parser() restituisce il parser corretto. Il codice a valle funziona in modo identico indipendentemente dal formato sorgente.

CAMT.053 vs MT940: differenze chiave

Caratteristica	MT940	CAMT.053
Ricchezza dati	Campi limitati	3-5x più dati per transazione
Set di caratteri	Limitato (charset SWIFT)	Unicode completo
Struttura	Testo piano con tag	XML con namespace
Reporting del saldo	Solo apertura/chiusura	Molteplici tipi di saldo
Riferimenti	Campo di riferimento singolo	Tipi di riferimento multipli
Gestione valutaria	Base	Multi-valuta completa con tassi di cambio

Come aiuta Bank Statement Parser

• API unificata: analizza MT940, CAMT.053 e estratti conto PDF con lo stesso flusso di lavoro, producendo output DataFrame coerenti.
• Rilevamento automatico: non serve conoscere il formato in anticipo. detect_statement_format() lo identifica automaticamente.
• Pipeline PDF ibrida: le banche che forniscono solo estratti PDF durante la transizione vengono gestite da smart_ingest() con verifica automatica del saldo.
• Indipendente dal namespace: gestisce qualsiasi variante CAMT.053 (001.02, 001.04 o wrapper specifici della banca) senza configurazione.
• Verifica multi-valuta: verify_balance_multi_currency() esegue la Golden Rule per ogni gruppo di valuta — essenziale per gli estratti CAMT multi-valuta.
• Streaming: elabora file CAMT di grandi dimensioni (50 MB+, 50K+ transazioni) con memoria limitata.
• Esportazione contabile: esporta direttamente in formato journal hledger o beancount per la contabilità di tesoreria.
• Test di migrazione: eseguire entrambi i parser in parallelo sullo stesso periodo per verificare la coerenza dell'output prima del passaggio.

Per iniziare

pip install bankstatementparser

from bankstatementparser import create_parser, detect_statement_format

# Works with MT940 today, CAMT.053 tomorrow, PDF anytime
for file in bank_statement_files:
    fmt = detect_statement_format(file)
    parser = create_parser(file, fmt)
    df = parser.parse()
    process(df)  # Your code doesn't change

Per gli estratti conto PDF da banche che non offrono ancora esportazioni CAMT strutturate:

from bankstatementparser.hybrid import smart_ingest

result = smart_ingest("statement.pdf")
assert result.verification.status == "VERIFIED"

Leggi la documentazione completa

Confronta con le alternative ❯ | Scopri i casi d'uso reali ❯