swift_mt_message/messages/
mt290.rs

1use crate::errors::{ParseError, SwiftValidationError};
2use crate::fields::*;
3use crate::parser::MessageParser;
4use crate::parser::utils::*;
5use serde::{Deserialize, Serialize};
6
7/// **MT290: Advice of Charges, Interest and Other Adjustments**
8///
9/// Notification to beneficiary institution of charges and adjustments.
10///
11/// **Usage:** Interbank charge notifications, interest advice
12/// **Category:** Category 2 (Financial Institution Transfers)
13#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
14pub struct MT290 {
15    /// Transaction Reference Number (Field 20)
16    #[serde(rename = "20")]
17    pub field_20: Field20,
18
19    /// Related Reference (Field 21)
20    #[serde(rename = "21")]
21    pub field_21: Field21NoOption,
22
23    /// Account Identification (Field 25)
24    #[serde(rename = "25")]
25    pub field_25: Field25NoOption,
26
27    /// Value Date, Currency Code, Amount (Field 32)
28    #[serde(flatten)]
29    pub field_32: Field32AmountCD,
30
31    /// Ordering Institution (Field 52)
32    #[serde(flatten, skip_serializing_if = "Option::is_none")]
33    pub field_52: Option<Field52OrderingInstitution>,
34
35    /// Details of Charges (Field 71B)
36    #[serde(rename = "71B")]
37    pub field_71b: Field71B,
38
39    /// Sender to Receiver Information (Field 72)
40    #[serde(rename = "72", skip_serializing_if = "Option::is_none")]
41    pub field_72: Option<Field72>,
42}
43
44impl MT290 {
45    /// Parse MT290 from a raw SWIFT message string
46    pub fn parse_from_block4(block4: &str) -> Result<Self, ParseError> {
47        let mut parser = MessageParser::new(block4, "290");
48
49        // Parse mandatory fields
50        let field_20 = parser.parse_field::<Field20>("20")?;
51        let field_21 = parser.parse_field::<Field21NoOption>("21")?;
52
53        // Parse Field 25 - Account Identification
54        let field_25 = parser.parse_field::<Field25NoOption>("25")?;
55
56        // Parse Field 32 - variant field (32C or 32D only per spec)
57        let field_32 = parser.parse_variant_field::<Field32AmountCD>("32")?;
58
59        // Parse optional Field 52 - Ordering Institution
60        let field_52 = parser.parse_optional_variant_field::<Field52OrderingInstitution>("52")?;
61
62        // Parse mandatory Field 71B
63        let field_71b = parser.parse_field::<Field71B>("71B")?;
64
65        // Parse optional Field 72
66        let field_72 = parser.parse_optional_field::<Field72>("72")?;
67
68        Ok(MT290 {
69            field_20,
70            field_21,
71            field_25,
72            field_32,
73            field_52,
74            field_71b,
75            field_72,
76        })
77    }
78
79    /// Parse from generic SWIFT input (tries to detect blocks)
80    pub fn parse(input: &str) -> Result<Self, ParseError> {
81        let block4 = extract_block4(input)?;
82        Self::parse_from_block4(&block4)
83    }
84
85    /// Convert to SWIFT MT text format
86    pub fn to_mt_string(&self) -> String {
87        let mut result = String::new();
88
89        append_field(&mut result, &self.field_20);
90        append_field(&mut result, &self.field_21);
91        append_field(&mut result, &self.field_25);
92        append_field(&mut result, &self.field_32);
93        append_optional_field(&mut result, &self.field_52);
94        append_field(&mut result, &self.field_71b);
95        append_optional_field(&mut result, &self.field_72);
96
97        finalize_mt_string(result, false)
98    }
99
100    // ========================================================================
101    // NETWORK VALIDATION RULES (SR 2025 MT290)
102    // ========================================================================
103
104    /// Main validation method - validates all network rules
105    ///
106    /// **Note**: MT290 has no network validated rules according to SR 2025 specification.
107    /// This method is provided for API consistency and always returns an empty vector.
108    ///
109    /// Returns array of validation errors, respects stop_on_first_error flag
110    pub fn validate_network_rules(&self, _stop_on_first_error: bool) -> Vec<SwiftValidationError> {
111        // MT290 has no network validated rules per SR 2025 specification
112        Vec::new()
113    }
114}
115
116impl crate::traits::SwiftMessageBody for MT290 {
117    fn message_type() -> &'static str {
118        "290"
119    }
120
121    fn parse_from_block4(block4: &str) -> Result<Self, crate::errors::ParseError> {
122        // Call the existing public method implementation
123        MT290::parse_from_block4(block4)
124    }
125
126    fn to_mt_string(&self) -> String {
127        // Call the existing public method implementation
128        MT290::to_mt_string(self)
129    }
130
131    fn validate_network_rules(&self, stop_on_first_error: bool) -> Vec<SwiftValidationError> {
132        // Call the existing public method implementation
133        MT290::validate_network_rules(self, stop_on_first_error)
134    }
135}
swift_mt_message/messages/mt290.rs

swift_mt_message/messages/
mt290.rs
