swift_mt_message/messages/

mt196.rs

use crate::fields::*;
use serde::{Deserialize, Serialize};
use swift_mt_message_macros::{SwiftMessage, serde_swift_fields};

/// # MT196: Answers (Customer Messages)
///
/// This message is sent by a financial institution to provide answers, confirmations,
/// or status information in response to queries or requests related to customer messages.
/// MT196 is used for answering customer credit transfer queries and other customer-related inquiries.
///
/// ## Key Features
/// - **Answer provision**: Official responses to customer message queries
/// - **Reference tracking**: Links to the original message through reference fields
/// - **Conditional structure**: Either narrative (field 79) or copy of original message fields
/// - **Answer codes**: Standardized answer codes with supplementary data
/// - **Narrative support**: Additional narrative description capability
///
/// ## Field Structure
/// The message follows a conditional structure where either field 79 (narrative description)
/// or a copy of the mandatory fields from the original message may be present, but not both.
///
/// ## Answer Process
/// Used when a receiver needs to provide answers, confirmations, or status updates
/// regarding previously received customer messages, including confirmations of execution,
/// status updates, or responses to specific queries.
#[serde_swift_fields]
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, SwiftMessage)]
#[validation_rules(MT196_VALIDATION_RULES)]
pub struct MT196 {
    /// **Transaction Reference Number** - Field 20
    ///
    /// Unique reference assigned by the sender for this answer message.
    /// This reference is used throughout the answer lifecycle for tracking,
    /// acknowledgment, and audit purposes. Must be unique within sender's system per business day.
    #[field("20", mandatory)]
    pub field_20: GenericReferenceField,

    /// **Related Reference** - Field 21
    ///
    /// Contains the reference from field 20 of the message being answered.
    /// This creates a direct link between the answer and the original
    /// message, enabling complete audit trails and transaction tracking.
    #[field("21", mandatory)]
    pub field_21: GenericReferenceField,

    /// **Answers** - Field 76
    ///
    /// Contains response codes, narratives, and supplementary data.
    /// Includes confirmation codes (1-33), cancellation codes (CNCL, PDCR, RJCR),
    /// and reason codes with optional supplementary details in parentheses.
    #[field("76", mandatory)]
    pub field_76: GenericMultiLine6x35,

    /// **Narrative** - Field 77A (Optional)
    ///
    /// Free-form narrative description that supplements the answer codes in field 76.
    /// Used for providing additional context, explanations, or details about the answers.
    #[field("77A", optional)]
    pub field_77a: Option<GenericMultiLine20x35>,

    /// **MT and Date of the Original Message** - Field 11a (Optional)
    ///
    /// Specifies the message type and date of the original message being answered.
    /// Can be in Option R format (with session/ISN) or Option S format (date only).
    #[field("11a", optional)]
    pub field_11a: Option<GenericTextField>,

    /// **Narrative Description of Original Message** - Field 79 (Conditional)
    ///
    /// Contains narrative description of the original message being answered.
    /// Must be present if copy of original message fields is not included.
    /// Cannot be used together with copy of original message fields.
    #[field("79", optional)]
    pub field_79: Option<GenericMultiLine6x35>,

    /// **Copy of Mandatory Fields from Original Message** - Multiple Fields (Conditional)
    ///
    /// When present, contains a copy of at least the mandatory fields from the original message.
    /// This helps identify the exact transaction being answered.
    /// Cannot be used together with field 79 according to conditional rule C1.
    ///
    /// For customer messages (MT103): Would include fields 23B, 32A, 50, 59, 71A
    #[field("23B", optional)]
    pub field_23b: Option<GenericTextField>,

    #[field("32A", optional)]
    pub field_32a: Option<Field32A>,

    #[field("50", optional)]
    pub field_50: Option<Field50>,

    #[field("59", optional)]
    pub field_59: Option<Field59>,

    #[field("71A", optional)]
    pub field_71a: Option<GenericTextField>,
}

/// Enhanced validation rules for MT196
const MT196_VALIDATION_RULES: &str = r#"{
  "rules": [
    {
      "id": "CONDITIONAL_C1",
      "description": "Field 79 or copy of original message fields may be present, but not both",
      "condition": {
        "!": {
          "and": [
            {"!!": {"var": "field_79"}},
            {
              "or": [
                {"!!": {"var": "field_23b"}},
                {"!!": {"var": "field_32a"}},
                {"!!": {"var": "field_50"}},
                {"!!": {"var": "field_59"}},
                {"!!": {"var": "field_71a"}}
              ]
            }
          ]
        }
      }
    },
    {
      "id": "REFERENCE_FORMAT",
      "description": "Reference fields must not have invalid slash patterns",
      "condition": {
        "and": [
          {"!": {"startsWith": [{"var": "field_20.value"}, "/"]}},
          {"!": {"endsWith": [{"var": "field_20.value"}, "/"]}},
          {"!": {"includes": [{"var": "field_20.value"}, "//"]}},
          {"!": {"startsWith": [{"var": "field_21.value"}, "/"]}},
          {"!": {"endsWith": [{"var": "field_21.value"}, "/"]}},
          {"!": {"includes": [{"var": "field_21.value"}, "//"]}}
        ]
      }
    },
    {
      "id": "FIELD_11A_FORMAT",
      "description": "Field 11a must have proper format when present",
      "condition": {
        "if": [
          {"!!": {"var": "field_11a"}},
          {">": [{"strlen": {"var": "field_11a.reference"}}, 8]},
          true
        ]
      }
    },
    {
      "id": "REQUIRED_FIELDS",
      "description": "All mandatory fields must be present and non-empty",
      "condition": {
        "and": [
          {"!=": [{"var": "field_20.value"}, ""]},
          {"!=": [{"var": "field_21.value"}, ""]},
          {"!!": {"var": "field_76"}},
          {">": [{"count": {"var": "field_76.answer_lines"}}, 0]}
        ]
      }
    },
    {
      "id": "ANSWER_CODE_VALIDATION",
      "description": "Field 76 must contain valid answer codes",
      "condition": {
        "all": [
          {"var": "field_76.answer_lines"},
          {"!=": [{"var": ""}, ""]}
        ]
      }
    }
  ]
}"#;