mt940
| Crates.io | mt940 |
| lib.rs | mt940 |
| version | 1.0.2 |
| source | src |
| created_at | 2018-11-13 19:26:27.113603 |
| updated_at | 2022-10-05 19:42:31.985832 |
| description | A strict MT940 bank statement parser |
| homepage | |
| repository | https://github.com/svenstaro/mt940-rs |
| max_upload_size | |
| id | 96485 |
| size | 470,236 |
transitfeed-publishers (github:georust:transitfeed-publishers)
documentation
README
mt940-rs
A strict MT940 bank statement parser in Rust.
Features
- Parse MT940 bank statements.
- Strict and well-researched.
- Super simple API and nice Rusty structs.
- Small commandline utility that allows for quick and easy conversion of MT940 statements to JSON.
- Well tested with many automated tests to find weird corner cases.
- Pretty fast.
Planned features
- MT941 support
- MT942 support
Library usage example
use mt940::parse_mt940;
fn main() {
let input = "\
:20:3996-11-11111111\r\n\
:25:DABADKKK/111111-11111111\r\n\
:28C:00001/001\r\n\
:60F:C090924EUR54484,04\r\n\
:61:0909250925DR583,92NMSC1110030403010139//1234\r\n\
:86:11100304030101391234\r\n\
Beneficiary name\r\n\
Something else\r\n\
:61:0910010930DR62,60NCHGcustomer id//bank id\r\n\
:86:Fees according to advice\r\n\
:62F:C090930EUR53126,94\r\n\
:64:C090930EUR53189,31\r\n\
\r\n";
let input_parsed = parse_mt940(input).unwrap();
assert_eq!(input_parsed[0].transaction_ref_no, "3996-11-11111111");
}
CLI usage example
cargo run --bin sta2json tests/data/mt940/full/danskebank/MT940_DK_Example.sta
Documentation
Documentation is here.
Performance
Time to parse the provided MT940_FI_Example.sta:
| mt940-rs (this crate) | mt940-js (NodeJS) | mt-940 (Python) | |
|---|---|---|---|
| Time for file | 0.054ms | 0.08ms | 1.15ms |
| Performance | 600000 lines per sec | 400000 lines per sec | 28000 lines per sec |
Strictness
Some banks bank use weird derivates of MT940 that do not strictly follow the specification. In that case you should try to do some pre-processing either by yourself or using one of the provided sanitizers.
Resources and acknowledgements
Referencing proper docs is important because because banks seem to be somewhat lenient about their strictness in implementing MT940. Below I assembled a list of resources that I reference.
Other projects
- Lots of test data copied from https://github.com/WoLpH/mt940
iotafinance.com
Amazing interactive docs.
DanskeBank
They provide tons of good docs.
- https://danskebank.com/en-uk/ci/Products-Services/Transaction-Services/Online-Services/Integration-Services/Documents/Formats/FormatDescriptionSWIFT_MT940/MT940.pdf
- https://danskebank.com/en-uk/ci/Products-Services/Transaction-Services/Online-Services/Integration-Services/Documents/Formats/FormatDescriptionSWIFT_MT942/MT942.pdf
- https://danskebank.com/en-uk/ci/Products-Services/Transaction-Services/Online-Services/Integration-Services/Formats/Pages/SWIFT-formats.aspx
- https://www-2.danskebank.com/Link/ExtendedMT940/$file/Extended_MT940.pdf
Bank Austria
Deutsche Bank
ABN AMRO
- https://www.abnamro.nl/nl/images/Generiek/PDFs/020_Zakelijk/03_OfficeNet/Formatenboek_MT94_(engels).pdf
- https://www.abnamro.nl/en/images/Generiek/PDFs/020_Zakelijk/04_Migratie/Derde_banken_Specificaties_EN.pdf