ISO 20022 Migration Guide

TL;DR: Iretiro ng SWIFT ang MT940 bago ang Nobyembre 2028. Pinangangasiwaan ng Bank Statement Parser ang MT940 at CAMT.053 gamit ang iisang API, kaya gumagana ang iyong parsing pipeline sa panahon ng transisyon at pagkatapos nito.

Bakit Mahalaga ang Migration na Ito

Ihihinto ng SWIFT ang mga legacy na MT message format pabor sa mas mayamang ISO 20022 standard. Para sa mga treasury at finance team, nangangahulugan ito na ang iyong mga bank statement processing pipeline ay dapat mag-evolve mula MT940 patungong CAMT.053 bago ang mga matatag na deadline.

SWIFT Migration Timeline

Anong mga Pagbabago para sa Iyong Code

Bago: MT940 Lamang

from bankstatementparser import Mt940Parser

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

Pagkatapos: Parehong Format na may Auto-Detection

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

Kinikilala ng detect_statement_format() function kung ang file ay MT940, CAMT.053, PAIN.001, o anumang iba pang sinusuportahang format. Ibinabalik ng create_parser() function ang tamang parser. Gumagana ang iyong downstream code nang magkapareho anuman ang source format.

CAMT.053 vs MT940: Mga Pangunahing Pagkakaiba

Tampok	MT940	CAMT.053
Kayamanan ng data	Limitadong mga field	3-5x na mas maraming data bawat transaksyon
Character set	Limitado (SWIFT charset)	Buong Unicode
Istruktura	Flat text na may mga tag	XML na may mga namespace
Pag-uulat ng balanse	Opening/closing lamang	Maramihang uri ng balanse
Mga sanggunian	Isang reference field	Maramihang uri ng reference
Paghawak ng currency	Basic	Buong multi-currency na may mga exchange rate

Paano Nakakatulong ang Bank Statement Parser

• Unified API: I-parse ang MT940, CAMT.053, at mga PDF statement gamit ang parehong workflow, na gumagawa ng consistent na DataFrame output.
• Auto-detection: Hindi kailangang malaman ang format nang maaga. Awtomatikong kinikilala ito ng detect_statement_format().
• Hybrid PDF pipeline: Pinangangasiwaan ng smart_ingest() ang mga bangko na nagbibigay ng PDF-only na statement sa panahon ng transisyon, na may awtomatikong beripikasyon ng balanse.
• Namespace-agnostic: Pinangangasiwaan ang anumang CAMT.053 variant (001.02, 001.04, o bank-specific na wrapper) nang walang configuration.
• Multi-currency na beripikasyon: Pinapatakbo ng verify_balance_multi_currency() ang Golden Rule sa bawat currency group — mahalaga para sa multi-currency na CAMT statement.
• Streaming: Iproseso ang malalaking CAMT file (50 MB+, 50K+ na transaksyon) na may bounded memory.
• Ledger export: Direktang i-export sa hledger o beancount journal format para sa treasury accounting.
• Pagsusuri sa migration: Patakbuhin ang parehong parser nang magkatabi sa parehong date range upang i-verify ang consistency ng output bago lumipat.

Pagsisimula

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

Para sa mga PDF statement mula sa mga bangko na hindi pa nag-aalok ng structured na CAMT export:

from bankstatementparser.hybrid import smart_ingest

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

Basahin ang buong dokumentasyon

Ihambing sa mga alternatibo ❯ | Tingnan ang mga real-world use case ❯