Question: Parsing camt.053 xml files

[Roba1993]

Is it possible to also parse camt.053 xml files? I tried it with the following naive approach but failed:

let file = include_str!("../data/camt-053-P-CH-wsl-001.xml");

type Header = mx_message::header::bah_camt_053_001_08::BusinessApplicationHeaderV02;
type Body = mx_message::document::camt_053_001_08::BankToCustomerStatementV08;

let res = mx_message::from_mx_xml::<Header, Body>(file);
println!("{:?}", res);

Did I missed the right Header/Body or is it in general not supported and I need to implement it manually?

[shankar-gpio]

Yes, camt.053 XML parsing is fully supported! The library supports BankToCustomerStatementV08 (camt.053.001.08).

The Recommended Approach

Instead of attempting to deserialize the header and body separately, utilize the unified MxMessage type, which automatically handles both tasks.

  use mx_message::MxMessage;

  fn main() -> Result<(), Box<dyn std::error::Error>> {
      let xml_content = std::fs::read_to_string("your_camt053_file.xml")?;

      // Parse the complete MX message (AppHdr + Document)
      let message = MxMessage::from_xml(&xml_content)?;

      // Access the document - it will be Document::Camt053 variant
      match &message.document {
          mx_message::mx_envelope::Document::Camt053(statement) => {
              // Access BankToCustomerStatementV08 fields
              println!("Statement parsed successfully!");
              // statement.grp_hdr, statement.stmt, etc.
          }
          _ => println!("Unexpected document type"),
      }

      Ok(())
  }

Key Points

1. Use MxMessage::from_xml() - This automatically detects the document type from the XML element name () and deserializes to the correct struct.

2. XML Structure Expected - The library expects either:
   - Full envelope format with + wrapper
   - Or just the section containing

3. Supported Structures (from src/mx_envelope.rs:54-55):
   #[serde(rename = "BkToCstmrStmt")] Camt053(Box<camt_053_001_08::BankToCustomerStatementV08>)

4. There are test scenarios available in test_scenarios/camt053/:
   - daily_account_statement.json
   - correspondent_banking.json
   - high_volume_batch.json
   - And more...

Verification:
You can verify camt.053 works, you can run:
TEST_MESSAGE_TYPE=camt.053 TEST_SAMPLE_COUNT=1 TEST_DEBUG=1 cargo test round_trip_scenarios -- --nocapture

Why Direct Deserialization Might Fail:
If you attempted to use quick_xml::de::from_str::() directly, the problem is likely due to:

1. The XML contains namespace prefixes or attributes that require handling.
2. The element names in the XML use abbreviated forms (e.g., BkToCstmrStmt) while the struct name is the full form.

The MxMessage wrapper automatically handles these transformations.