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.
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.
| Version | Registration status | Published in |
|---|---|---|
| setr.013.001.04latest | Registered | Latest version set |
| setr.013.001.03 | Registered | Previous version set |
| setr.013.001.02 | Registered | Archive |
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]SwtchOrdrSwitchOrder [1..1]MsgIdMessage Identification [1..1]MessageIdentification1Reference that uniquely identifies the message from a business application standpoint.
IdIdentification [1..1]Max35TextIdentification of the message.
CreDtTmCreation Date Time [1..1]ISODateTimeDate of creation of the message.
PoolRefPool Reference [0..1]AdditionalReference9Collective reference identifying a set of messages.
RefReference [1..1]Max35TextReference identifying a set of messages.
RefIssrReference Issuer [0..1]PartyIdentification113Issuer of the reference.
PtyParty [1..1]PartyIdentification90Choice (choice)LEILEI [0..1]LEIIdentifier
MsgNmMessage Name [0..1]Max35TextName of the message.
PrvsRefPrevious Reference [0..*]AdditionalReference8Reference to a linked message that was previously sent.
RefReference [1..1]Max35TextReference issued by a party to identify an instruction, transaction or a message.
RefIssrReference Issuer [0..1]PartyIdentification113Issuer of the reference.
PtyParty [1..1]PartyIdentification90Choice (choice)LEILEI [0..1]LEIIdentifier
MsgNmMessage Name [0..1]Max35TextName of the message.
MsgPgntnMessage Pagination [0..1]PaginationPagination of the message.
PgNbPage Number [1..1]Max5NumericTextPage number.
LastPgIndLast Page Indicator [1..1]YesNoIndicatorIndicates the last page.
SwtchOrdrDtlsSwitch Order Details [1..*]SwitchOrder7Information related to the switch order.
MstrRefMaster Reference [0..1]Max35TextUnique and unambiguous identifier for a group of individual orders, as assigned by the instructing party.
OrdrDtTmOrder Date Time [0..1]ISODateTimeDate and time the order is placed by the investor or its agent.
PlcOfTradPlace Of Trade [0..1]PlaceOfTradeIdentification1Choice (choice)Market in which the advised trade transaction was executed.
CtryCountry [1..1]CountryCodeXchgExchange [1..1]MICIdentifierPtyParty [1..1]AnyBICIdentifierOverTheCntrOver The Counter [1..1]Max35Text
OrdrRefOrder Reference [1..1]Max35TextUnique and unambiguous identifier for the order, as assigned by the instructing party.
ClntRefClient Reference [0..1]Max35TextUnique and unambiguous investor's identification of the order.
InvstmtAcctDtlsInvestment Account Details [0..1]InvestmentAccount58Account impacted by the investment fund order.
AcctIdAccount Identification [1..1]Max35TextAcctNmAccount Name [0..1]Max35TextAcctDsgntAccount Designation [0..1]Max35TextOwnrIdOwner Identification [0..*]PartyIdentification113AcctSvcrAccount Servicer [0..1]PartyIdentification113OrdrOrgtrElgbltyOrder Originator Eligibility [0..1]OrderOriginatorEligibility1CodeSubAcctDtlsSub Account Details [0..1]SubAccount6
RltdPtyDtlsRelated Party Details [0..10]Intermediary40Party related to the transaction.
IdIdentification [1..1]PartyIdentification113AcctAccount [0..1]Account22OrdrOrgtrElgbltyOrder Originator Eligibility [0..1]OrderOriginatorEligibility1CodeRoleRole [0..1]InvestmentFundRole2Choice (choice)
ReqdFutrTradDtRequested Future Trade Date [0..1]ISODateFuture date at which the investor requests the order to be executed.
SttlmAmtSettlement Amount [0..1]ActiveCurrencyAndAmountTotal amount of money paid /to be paid or received in exchange for the financial instrument in the individual order.
CshSttlmDtCash Settlement Date [0..1]ISODateDate on which cash is available.
SttlmMtdSettlement Method [0..1]DeliveryReceiptType2CodeMethod by which the transaction is settled.
AddtlAmtAdditional Amount [0..1]AdditionalAmount1Choice (choice)Choice between additional cash in or resulting cash out.
AddtlCshInAdditional Cash In [1..1]ActiveOrHistoricCurrencyAndAmountRsltgCshOutResulting Cash Out [1..1]ActiveOrHistoricCurrencyAndAmount
XpryDtTmExpiry Date Time [0..1]DateAndDateTimeChoice (choice)Date on which the order expires.
DtDate [1..1]ISODateDtTmDate Time [1..1]ISODateTime
CxlRghtCancellation Right [0..1]CancellationRight1Choice (choice)Cancellation right of the investor with respect to the investment fund order.
CdCode [1..1]CancellationRight1CodePrtryProprietary [1..1]GenericIdentification47
RedLegDtlsRedemption Leg Details [1..*]SwitchRedemptionLegOrder6Part of the investment fund switch order that is a redemption.
LegIdLeg Identification [0..1]Max35TextFinInstrmDtlsFinancial Instrument Details [1..1]FinancialInstrument57FinInstrmQtyChcFinancial Instrument Quantity Choice [0..1]FinancialInstrumentQuantity29Choice (choice)InvstmtAcctDtlsInvestment Account Details [0..1]InvestmentAccount58IncmPrefIncome Preference [0..1]IncomePreference1CodeGrp1Or2UnitsGroup1 Or2 Units [0..1]UKTaxGroupUnit1CodeReqdSttlmCcyRequested Settlement Currency [0..1]ActiveCurrencyCodeReqdNAVCcyRequested NAV Currency [0..1]ActiveOrHistoricCurrencyCodeTxOvrhdTransaction Overhead [0..1]FeeAndTax1SttlmAndCtdyDtlsSettlement And Custody Details [0..1]FundSettlementParameters12PhysDlvryIndPhysical Delivery Indicator [1..1]YesNoIndicatorPhysDlvryDtlsPhysical Delivery Details [0..1]DeliveryParameters3NonStdSttlmInfNon Standard Settlement Information [0..1]Max350TextEqulstnEqualisation [0..1]Equalisation1
SbcptLegDtlsSubscription Leg Details [1..*]SwitchSubscriptionLegOrder6Part of the investment fund switch order that is a subscription.
LegIdLeg Identification [0..1]Max35TextFinInstrmDtlsFinancial Instrument Details [1..1]FinancialInstrument57FinInstrmQtyChcFinancial Instrument Quantity Choice [0..1]FinancialInstrumentQuantity26Choice (choice)InvstmtAcctDtlsInvestment Account Details [0..1]InvestmentAccount58IncmPrefIncome Preference [0..1]IncomePreference1CodeReqdSttlmCcyRequested Settlement Currency [0..1]ActiveCurrencyCodeReqdNAVCcyRequested NAV Currency [0..1]ActiveOrHistoricCurrencyCodeTxOvrhdTransaction Overhead [0..1]FeeAndTax1SttlmAndCtdyDtlsSettlement And Custody Details [0..1]FundSettlementParameters11PhysDlvryIndPhysical Delivery Indicator [1..1]YesNoIndicatorPhysDlvryDtlsPhysical Delivery Details [0..1]NameAndAddress4NonStdSttlmInfNon Standard Settlement Information [0..1]Max350TextEqulstnEqualisation [0..1]Equalisation1
CshSttlmDtlsCash Settlement Details [0..1]PaymentTransaction71Payment process for the transfer of cash from the debtor to the creditor.
CshInOrOutCash In Or Out [1..1]CashInOrOut7Choice (choice)
FXDtlsForeign Exchange Details [0..1]ForeignExchangeTerms32Information needed to process a currency exchange or conversion.
UnitCcyUnit Currency [1..1]ActiveCurrencyCodeQtdCcyQuoted Currency [1..1]ActiveCurrencyCodeXchgRateExchange Rate [1..1]BaseOneRateQtnDtQuotation Date [0..1]ISODateTimeQtgInstnQuoting Institution [0..1]PartyIdentification113
FinAdvcFinancial Advice [0..1]FinancialAdvice1CodeSpecifies if advice has been received from an independent financial advisor.
NgtdTradNegotiated Trade [0..1]NegotiatedTrade1CodeSpecifies whether the trade is negotiated.
CstmrCndctClssfctnCustomer Conduct Classification [0..1]CustomerConductClassification1Choice (choice)Assessment of the customer’s behaviour at the time of the account opening application.
CdCode [1..1]ConductClassification1CodePrtryProprietary [1..1]GenericIdentification47
TxChanlTpTransaction Channel Type [0..1]TransactionChannelType1Choice (choice)Means by which the investor or account owner submits the open account form.
CdCode [1..1]TransactionChannel2CodePrtryProprietary [1..1]GenericIdentification47
SgntrTpSignature Type [0..1]SignatureType1Choice (choice)Type of signature.
CdCode [1..1]SignatureType2CodePrtryProprietary [1..1]GenericIdentification47
OrdrWvrDtlsOrder Waiver Details [0..1]OrderWaiver1Information about a non-standard order.
OrdrWvrRsnOrder Waiver Reason [0..*]OrderWaiverReason3Choice (choice)InfValInformation Value [0..1]Max350Text
CpyDtlsCopy Details [0..1]CopyInformation4Information provided when the message is a copy of a previous message.
CpyIndCopy Indicator [1..1]YesNoIndicatorIndicates whether the message is a copy.
OrgnlRcvrOriginal Receiver [0..1]AnyBICIdentifierOriginal receiver of the message, if this message is a copy.
XtnsnExtension [0..*]Extension1Additional information that cannot be captured in the structured elements and/or any other specific block.
PlcAndNmPlace And Name [1..1]Max350TextName qualifying the information provided in the Text field, and place where this information should be inserted.
TxtText [1..1]Max350TextText 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.