ZagTrader

setr: Securities Trade

setr.013 Switch Order

Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked

setr.013 is the ISO 20022 SwitchOrder message in the Securities Trade business area (setr). The latest version is setr.013.001.04, and 3 versions are in the repository.

Message
SwitchOrder
Latest version
setr.013.001.04
Submitting organisation
Not read from the catalogue
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What setr.013 is for

The SwitchOrder message is sent by an instructing party, for example, an investment manager or its authorised representative, to the executing party, for example, a transfer agent, to instruct a switch transaction from a financial instrument or multiple financial instruments to a different specified financial instrument or instruments for a specified amount/quantity.

The SwitchOrder message is used to either:

- instruct one switch transaction comprising one or more redemption legs and one or more subscription legs, that is, a single switch transaction that can be a one to one, many to one, many to many or one to many switch transaction, or,

- instruct one or many switch transactions each comprising one redemption leg and one subscription leg, that is, multiple simple switch transactions.

The SwitchOrder message may be used to either:

- instruct a switch transaction for one investment account, or,

- instruct a switch transaction for separate accounts at the redemption and subscription leg levels.

The message caters for a switch from one financial instrument to another financial instrument (within the same fund family), many to one, many to many and one to many.

The message caters for switch transactions that result in an additional cash payment from the investor or a transaction that results in a net payment to the investor. Not all institutions or funds permit this type of switch and acceptance is therefore not automatic.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

setr.013 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

VersionRegistration statusPublished in
setr.013.001.04latestRegisteredLatest version set
setr.013.001.03RegisteredPrevious version set
setr.013.001.02RegisteredArchive

setr.013 message structure

The building blocks of setr.013.001.04 to three levels, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

  • Document [1..1]
    • SwtchOrdr SwitchOrder [1..1]
      • MsgId Message Identification [1..1]MessageIdentification1

        Reference that uniquely identifies the message from a business application standpoint.

        • Id Identification [1..1]Max35Text

          Identification of the message.

        • CreDtTm Creation Date Time [1..1]ISODateTime

          Date of creation of the message.

      • PoolRef Pool Reference [0..1]AdditionalReference9

        Collective reference identifying a set of messages.

        • Ref Reference [1..1]Max35Text

          Reference identifying a set of messages.

        • RefIssr Reference Issuer [0..1]PartyIdentification113

          Issuer of the reference.

          • Pty Party [1..1]PartyIdentification90Choice (choice)
          • LEI LEI [0..1]LEIIdentifier
        • MsgNm Message Name [0..1]Max35Text

          Name of the message.

      • PrvsRef Previous Reference [0..*]AdditionalReference8

        Reference to a linked message that was previously sent.

        • Ref Reference [1..1]Max35Text

          Reference issued by a party to identify an instruction, transaction or a message.

        • RefIssr Reference Issuer [0..1]PartyIdentification113

          Issuer of the reference.

          • Pty Party [1..1]PartyIdentification90Choice (choice)
          • LEI LEI [0..1]LEIIdentifier
        • MsgNm Message Name [0..1]Max35Text

          Name of the message.

      • MsgPgntn Message Pagination [0..1]Pagination

        Pagination of the message.

        • PgNb Page Number [1..1]Max5NumericText

          Page number.

        • LastPgInd Last Page Indicator [1..1]YesNoIndicator

          Indicates the last page.

      • SwtchOrdrDtls Switch Order Details [1..*]SwitchOrder7

        Information related to the switch order.

        • MstrRef Master Reference [0..1]Max35Text

          Unique and unambiguous identifier for a group of individual orders, as assigned by the instructing party.

        • OrdrDtTm Order Date Time [0..1]ISODateTime

          Date and time the order is placed by the investor or its agent.

        • PlcOfTrad Place Of Trade [0..1]PlaceOfTradeIdentification1Choice (choice)

          Market in which the advised trade transaction was executed.

          • Ctry Country [1..1]CountryCode
          • Xchg Exchange [1..1]MICIdentifier
          • Pty Party [1..1]AnyBICIdentifier
          • OverTheCntr Over The Counter [1..1]Max35Text
        • OrdrRef Order Reference [1..1]Max35Text

          Unique and unambiguous identifier for the order, as assigned by the instructing party.

        • ClntRef Client Reference [0..1]Max35Text

          Unique and unambiguous investor's identification of the order.

        • InvstmtAcctDtls Investment Account Details [0..1]InvestmentAccount58

          Account impacted by the investment fund order.

          • AcctId Account Identification [1..1]Max35Text
          • AcctNm Account Name [0..1]Max35Text
          • AcctDsgnt Account Designation [0..1]Max35Text
          • OwnrId Owner Identification [0..*]PartyIdentification113
          • AcctSvcr Account Servicer [0..1]PartyIdentification113
          • OrdrOrgtrElgblty Order Originator Eligibility [0..1]OrderOriginatorEligibility1Code
          • SubAcctDtls Sub Account Details [0..1]SubAccount6
        • RltdPtyDtls Related Party Details [0..10]Intermediary40

          Party related to the transaction.

          • Id Identification [1..1]PartyIdentification113
          • Acct Account [0..1]Account22
          • OrdrOrgtrElgblty Order Originator Eligibility [0..1]OrderOriginatorEligibility1Code
          • Role Role [0..1]InvestmentFundRole2Choice (choice)
        • ReqdFutrTradDt Requested Future Trade Date [0..1]ISODate

          Future date at which the investor requests the order to be executed.

        • SttlmAmt Settlement Amount [0..1]ActiveCurrencyAndAmount

          Total amount of money paid /to be paid or received in exchange for the financial instrument in the individual order.

        • CshSttlmDt Cash Settlement Date [0..1]ISODate

          Date on which cash is available.

        • SttlmMtd Settlement Method [0..1]DeliveryReceiptType2Code

          Method by which the transaction is settled.

        • AddtlAmt Additional Amount [0..1]AdditionalAmount1Choice (choice)

          Choice between additional cash in or resulting cash out.

          • AddtlCshIn Additional Cash In [1..1]ActiveOrHistoricCurrencyAndAmount
          • RsltgCshOut Resulting Cash Out [1..1]ActiveOrHistoricCurrencyAndAmount
        • XpryDtTm Expiry Date Time [0..1]DateAndDateTimeChoice (choice)

          Date on which the order expires.

          • Dt Date [1..1]ISODate
          • DtTm Date Time [1..1]ISODateTime
        • CxlRght Cancellation Right [0..1]CancellationRight1Choice (choice)

          Cancellation right of the investor with respect to the investment fund order.

          • Cd Code [1..1]CancellationRight1Code
          • Prtry Proprietary [1..1]GenericIdentification47
        • RedLegDtls Redemption Leg Details [1..*]SwitchRedemptionLegOrder6

          Part of the investment fund switch order that is a redemption.

          • LegId Leg Identification [0..1]Max35Text
          • FinInstrmDtls Financial Instrument Details [1..1]FinancialInstrument57
          • FinInstrmQtyChc Financial Instrument Quantity Choice [0..1]FinancialInstrumentQuantity29Choice (choice)
          • InvstmtAcctDtls Investment Account Details [0..1]InvestmentAccount58
          • IncmPref Income Preference [0..1]IncomePreference1Code
          • Grp1Or2Units Group1 Or2 Units [0..1]UKTaxGroupUnit1Code
          • ReqdSttlmCcy Requested Settlement Currency [0..1]ActiveCurrencyCode
          • ReqdNAVCcy Requested NAV Currency [0..1]ActiveOrHistoricCurrencyCode
          • TxOvrhd Transaction Overhead [0..1]FeeAndTax1
          • SttlmAndCtdyDtls Settlement And Custody Details [0..1]FundSettlementParameters12
          • PhysDlvryInd Physical Delivery Indicator [1..1]YesNoIndicator
          • PhysDlvryDtls Physical Delivery Details [0..1]DeliveryParameters3
          • NonStdSttlmInf Non Standard Settlement Information [0..1]Max350Text
          • Equlstn Equalisation [0..1]Equalisation1
        • SbcptLegDtls Subscription Leg Details [1..*]SwitchSubscriptionLegOrder6

          Part of the investment fund switch order that is a subscription.

          • LegId Leg Identification [0..1]Max35Text
          • FinInstrmDtls Financial Instrument Details [1..1]FinancialInstrument57
          • FinInstrmQtyChc Financial Instrument Quantity Choice [0..1]FinancialInstrumentQuantity26Choice (choice)
          • InvstmtAcctDtls Investment Account Details [0..1]InvestmentAccount58
          • IncmPref Income Preference [0..1]IncomePreference1Code
          • ReqdSttlmCcy Requested Settlement Currency [0..1]ActiveCurrencyCode
          • ReqdNAVCcy Requested NAV Currency [0..1]ActiveOrHistoricCurrencyCode
          • TxOvrhd Transaction Overhead [0..1]FeeAndTax1
          • SttlmAndCtdyDtls Settlement And Custody Details [0..1]FundSettlementParameters11
          • PhysDlvryInd Physical Delivery Indicator [1..1]YesNoIndicator
          • PhysDlvryDtls Physical Delivery Details [0..1]NameAndAddress4
          • NonStdSttlmInf Non Standard Settlement Information [0..1]Max350Text
          • Equlstn Equalisation [0..1]Equalisation1
        • CshSttlmDtls Cash Settlement Details [0..1]PaymentTransaction71

          Payment process for the transfer of cash from the debtor to the creditor.

          • CshInOrOut Cash In Or Out [1..1]CashInOrOut7Choice (choice)
        • FXDtls Foreign Exchange Details [0..1]ForeignExchangeTerms32

          Information needed to process a currency exchange or conversion.

          • UnitCcy Unit Currency [1..1]ActiveCurrencyCode
          • QtdCcy Quoted Currency [1..1]ActiveCurrencyCode
          • XchgRate Exchange Rate [1..1]BaseOneRate
          • QtnDt Quotation Date [0..1]ISODateTime
          • QtgInstn Quoting Institution [0..1]PartyIdentification113
        • FinAdvc Financial Advice [0..1]FinancialAdvice1Code

          Specifies if advice has been received from an independent financial advisor.

        • NgtdTrad Negotiated Trade [0..1]NegotiatedTrade1Code

          Specifies whether the trade is negotiated.

        • CstmrCndctClssfctn Customer Conduct Classification [0..1]CustomerConductClassification1Choice (choice)

          Assessment of the customer’s behaviour at the time of the account opening application.

          • Cd Code [1..1]ConductClassification1Code
          • Prtry Proprietary [1..1]GenericIdentification47
        • TxChanlTp Transaction Channel Type [0..1]TransactionChannelType1Choice (choice)

          Means by which the investor or account owner submits the open account form.

          • Cd Code [1..1]TransactionChannel2Code
          • Prtry Proprietary [1..1]GenericIdentification47
        • SgntrTp Signature Type [0..1]SignatureType1Choice (choice)

          Type of signature.

          • Cd Code [1..1]SignatureType2Code
          • Prtry Proprietary [1..1]GenericIdentification47
        • OrdrWvrDtls Order Waiver Details [0..1]OrderWaiver1

          Information about a non-standard order.

          • OrdrWvrRsn Order Waiver Reason [0..*]OrderWaiverReason3Choice (choice)
          • InfVal Information Value [0..1]Max350Text
      • CpyDtls Copy Details [0..1]CopyInformation4

        Information provided when the message is a copy of a previous message.

        • CpyInd Copy Indicator [1..1]YesNoIndicator

          Indicates whether the message is a copy.

        • OrgnlRcvr Original Receiver [0..1]AnyBICIdentifier

          Original receiver of the message, if this message is a copy.

      • Xtnsn Extension [0..*]Extension1

        Additional information that cannot be captured in the structured elements and/or any other specific block.

        • PlcAndNm Place And Name [1..1]Max350Text

          Name qualifying the information provided in the Text field, and place where this information should be inserted.

        • Txt Text [1..1]Max350Text

          Text of the extension.

Have a setr.013 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in setr.013

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

setr.013 questions

What is the latest version of setr.013?
The latest version in the ISO 20022 e-Repository release of 24 April 2025 is setr.013.001.04.
What is the root element of setr.013?
The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:setr.013.001.04, and its message element is SwtchOrdr (SwitchOrder).
Is there an MT equivalent of setr.013?
No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.