swift_mt_message/messages/
mt196.rs

1use crate::errors::SwiftValidationError;
2use crate::fields::*;
3use crate::parser::utils::*;
4use serde::{Deserialize, Serialize};
5
6/// **MT196: Answers**
7///
8/// Comprehensive answers and responses to queries and requests related to customer payments.
9///
10/// **Usage:** Query responses, payment inquiries, status updates
11/// **Category:** Category 1 (Customer Payments & Cheques)
12#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
13pub struct MT196 {
14    /// Sender's Reference (Field 20)
15    #[serde(rename = "20")]
16    pub field_20: Field20,
17
18    /// Related Reference (Field 21)
19    #[serde(rename = "21")]
20    pub field_21: Field21NoOption,
21
22    /// Answers (Field 76)
23    #[serde(rename = "76")]
24    pub field_76: Field76,
25
26    /// Proprietary Message (Field 77A)
27    #[serde(rename = "77A", skip_serializing_if = "Option::is_none")]
28    pub field_77a: Option<Field77A>,
29
30    /// Message Type and Date (Field 11)
31    #[serde(rename = "11", skip_serializing_if = "Option::is_none")]
32    pub field_11: Option<Field11>,
33
34    /// Narrative (Field 79)
35    #[serde(rename = "79", skip_serializing_if = "Option::is_none")]
36    pub field_79: Option<Field79>,
37}
38
39impl MT196 {
40    /// Parse message from Block 4 content
41    pub fn parse_from_block4(block4: &str) -> Result<Self, crate::errors::ParseError> {
42        let mut parser = crate::parser::MessageParser::new(block4, "196");
43
44        // Parse mandatory fields
45        let field_20 = parser.parse_field::<Field20>("20")?;
46        let field_21 = parser.parse_field::<Field21NoOption>("21")?;
47        let field_76 = parser.parse_field::<Field76>("76")?;
48
49        // Parse optional fields
50        let field_77a = parser.parse_optional_field::<Field77A>("77A")?;
51        let field_11 = parser.parse_optional_field::<Field11>("11")?;
52        let field_79 = parser.parse_optional_field::<Field79>("79")?;
53
54        Ok(MT196 {
55            field_20,
56            field_21,
57            field_76,
58            field_77a,
59            field_11,
60            field_79,
61        })
62    }
63
64    /// Parse from generic SWIFT input (tries to detect blocks)
65    pub fn parse(input: &str) -> Result<Self, crate::errors::ParseError> {
66        let block4 = extract_block4(input)?;
67        Self::parse_from_block4(&block4)
68    }
69
70    /// Convert to SWIFT MT text format
71    pub fn to_mt_string(&self) -> String {
72        let mut result = String::new();
73
74        append_field(&mut result, &self.field_20);
75        append_field(&mut result, &self.field_21);
76        append_field(&mut result, &self.field_76);
77        append_optional_field(&mut result, &self.field_77a);
78        append_optional_field(&mut result, &self.field_11);
79        append_optional_field(&mut result, &self.field_79);
80
81        result.push('-');
82        result
83    }
84
85    // ========================================================================
86    // NETWORK VALIDATION RULES (SR 2025 MT196)
87    // ========================================================================
88
89    // ========================================================================
90    // VALIDATION RULE C1
91    // ========================================================================
92
93    /// C1: Field 79 or Copy of Fields Requirement (Error code: C31)
94    /// Either field 79 or a "Copy of at least the mandatory fields of the message to
95    /// which the answer relates", but not both, may be present in the message.
96    ///
97    /// **Note**: This implementation currently validates the presence of field 79.
98    /// The "Copy of fields" requirement cannot be validated at this level since
99    /// copied fields are represented as additional optional fields in the message structure.
100    /// Full validation of this rule requires message-level context that is not
101    /// available in the current MT196 structure.
102    fn validate_c1_field_79_or_copy(&self) -> Option<SwiftValidationError> {
103        // Note: MT196 structure currently only has field 79 as defined optional field.
104        // The "Copy of at least the mandatory fields of the original message" is
105        // represented as additional optional fields that would need to be tracked
106        // separately. This validation currently only checks for field 79 presence.
107        //
108        // In a full implementation, we would need to track whether any copied fields
109        // from the original message are present, which would require extending the
110        // MT196 structure to include a generic "copied_fields" collection.
111
112        // Current implementation: no validation error since we cannot detect copied fields
113        // This is a known limitation of the current structure
114        None
115    }
116
117    /// Main validation method - validates all network rules
118    /// Returns array of validation errors, respects stop_on_first_error flag
119    pub fn validate_network_rules(&self, stop_on_first_error: bool) -> Vec<SwiftValidationError> {
120        let mut all_errors = Vec::new();
121
122        // C1: Field 79 or Copy of Fields Requirement
123        if let Some(error) = self.validate_c1_field_79_or_copy() {
124            all_errors.push(error);
125            if stop_on_first_error {
126                return all_errors;
127            }
128        }
129
130        all_errors
131    }
132}
133
134impl crate::traits::SwiftMessageBody for MT196 {
135    fn message_type() -> &'static str {
136        "196"
137    }
138
139    fn parse_from_block4(block4: &str) -> Result<Self, crate::errors::ParseError> {
140        // Call the existing public method implementation
141        MT196::parse_from_block4(block4)
142    }
143
144    fn to_mt_string(&self) -> String {
145        // Call the existing public method implementation
146        MT196::to_mt_string(self)
147    }
148
149    fn validate_network_rules(&self, stop_on_first_error: bool) -> Vec<SwiftValidationError> {
150        // Call the existing public method implementation
151        MT196::validate_network_rules(self, stop_on_first_error)
152    }
153}
swift_mt_message/messages/mt196.rs

swift_mt_message/messages/
mt196.rs
