Struct Field36

pub struct Field36 {
    pub rate: f64,
    pub raw_rate: String,
}

Field 36: Exchange Rate

Overview

Field 36 specifies the exchange rate to be applied between the currencies in Field 33B (Instructed Currency and Amount) and Field 32A (Value Date/Currency/Amount) in SWIFT payment messages. This field is only present when the currency codes in these two fields differ, indicating a foreign exchange transaction is required.

Format Specification

Format: 12d

• 12d: Up to 12 digits including decimal separator
• Decimal separator: Comma (,) as per SWIFT convention
• Precision: Up to 6 decimal places (trailing zeros removed)
• Character set: Digits 0-9 and comma (,)
• Validation: Must be positive, non-zero value

Usage Context

Field 36 is commonly used in:

• MT103: Single Customer Credit Transfer (when currency conversion required)
• MT202: General Financial Institution Transfer (FX transactions)
• MT202COV: Cover for customer credit transfer with FX
• MT200: Financial Institution Transfer (simple FX)

Business Applications

• Currency conversion: Applying agreed exchange rates to international payments
• FX transparency: Providing clear rate information to receiving institutions
• Reconciliation: Enabling accurate settlement calculations
• Compliance: Meeting regulatory requirements for FX rate disclosure
• Audit trails: Maintaining records of applied exchange rates

Examples

:36:1,2345
└─── USD/EUR rate of 1.2345 (1 USD = 1.2345 EUR)

:36:0,8765
└─── EUR/USD rate of 0.8765 (1 EUR = 0.8765 USD)

:36:110,5
└─── USD/JPY rate of 110.5 (1 USD = 110.5 JPY)

:36:1
└─── 1:1 rate (special cases, same currency family)

Fields

rate: f64

Exchange rate value

raw_rate: String

Raw rate string as received (preserves original formatting)

Implementations

impl Field36

pub fn new(rate: f64) -> Result<Self, ParseError>

Create a new Field36 with validation

pub fn from_raw(raw_rate: impl Into<String>) -> Result<Self, ParseError>

Create from raw rate string

pub fn rate(&self) -> f64

Get the exchange rate value

pub fn raw_rate(&self) -> &str

Get the raw rate string

pub fn format_rate(rate: f64) -> String

Format rate for SWIFT output (preserving decimal places, using comma)

pub fn is_reasonable_rate(&self) -> bool

Check if this is a reasonable exchange rate (between 0.0001 and 10000)

pub fn description(&self) -> String

Get human-readable description

Trait Implementations

impl Clone for Field36

fn clone(&self) -> Field36

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Field36

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Field36

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Field36

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Field36

fn eq(&self, other: &Field36) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Field36

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SwiftField for Field36

fn parse(value: &str) -> Result<Self, ParseError>

Parse field value from string representation

fn to_swift_string(&self) -> String

Convert field back to SWIFT string format

fn validate(&self) -> ValidationResult

Validate field according to SWIFT format rules

fn format_spec() -> &'static str

Get field format specification

impl StructuralPartialEq for Field36