SwitchOrderConfirmationV04

setr.015.001.04

Scope The SwitchOrderConfirmation message is sent by an executing party, for example, a transfer agent, to the instructing party, for example, an investment manager or its authorised representative, to confirm the details of the execution of a previously received SwitchOrder instruction. Usage The SwitchOrderConfirmation message is used to confirm that all the legs of the previously instructed switch order have been executed. The reference of the switch order confirmation is identified in DealReference. The reference of the original switch order is specified in OrderReference. The message identification of the SwitchOrder message in which the switch order was conveyed may also be quoted in RelatedReference but this is not recommended. When the message is used to convey a confirmation amendment/s, the AmendmentIndicator must be present with the value ‘true’ or ‘1’. When this is the case, the message must only contain a confirmation amendment/s and not contain both a confirmation amendment/s and a ‘new’ confirmation/s.

Message Construction

Every ISO20022 message has at the highest level what we call ‘building blocks’. Because the message is constructed as immutable records, the association is by composition. Below you can see the relationship between the message and its constituent building blocks: For comparison, see the ISO20022 official specification

classDiagram
     direction LR
%% SwitchOrderConfirmationV04 recursion level 0 with max 0
SwitchOrderConfirmationV04 *-- "1..1" MessageIdentification1 : MessageIdentification
SwitchOrderConfirmationV04 *-- "0..1" AdditionalReference9 : PoolReference
SwitchOrderConfirmationV04 *-- "0..1" AdditionalReference8 : PreviousReference
SwitchOrderConfirmationV04 *-- "0..1" AdditionalReference8 : RelatedReference
SwitchOrderConfirmationV04 *-- "1..1" SwitchExecution7 : SwitchExecutionDetails
SwitchOrderConfirmationV04 *-- "0..1" CopyInformation4 : CopyDetails
SwitchOrderConfirmationV04 *-- "0..1" Extension1 : Extension
  

Now, we will zero-in one-by-one on each of these building blocks.

MessageIdentification building block

Reference that uniquely identifies the message from a business application standpoint. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

MessageIdentification1 members

PoolReference building block

Collective reference identifying a set of messages. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalReference9 recursion level 0 with max 1
class AdditionalReference9{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference9 *-- "0..1" PartyIdentification113 : ReferenceIssuer
%% PartyIdentification113 recursion level 1 with max 1
class PartyIdentification113{
    LEI IsoLEIIdentifier
}
PartyIdentification113 *-- "1..1" IPartyIdentification90Choice : Party
  

AdditionalReference9 members

PreviousReference building block

Reference to a linked message that was previously sent. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalReference8 recursion level 0 with max 1
class AdditionalReference8{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference8 *-- "0..1" PartyIdentification113 : ReferenceIssuer
%% PartyIdentification113 recursion level 1 with max 1
class PartyIdentification113{
    LEI IsoLEIIdentifier
}
PartyIdentification113 *-- "1..1" IPartyIdentification90Choice : Party
  

AdditionalReference8 members

RelatedReference building block

Reference to a linked message that was previously received. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AdditionalReference8 recursion level 0 with max 1
class AdditionalReference8{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference8 *-- "0..1" PartyIdentification113 : ReferenceIssuer
%% PartyIdentification113 recursion level 1 with max 1
class PartyIdentification113{
    LEI IsoLEIIdentifier
}
PartyIdentification113 *-- "1..1" IPartyIdentification90Choice : Party
  

AdditionalReference8 members

SwitchExecutionDetails building block

Information related to a switch execution. Execution of a switch order. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SwitchExecution7 recursion level 0 with max 1
class SwitchExecution7{
    AmendmentIndicator IsoYesNoIndicator
    MasterReference IsoMax35Text
    OrderDateTime IsoISODateTime
    ReceivedDateTime IsoISODateTime
    DealReference IsoMax35Text
    OrderReference IsoMax35Text
    ClientReference IsoMax35Text
    RequestedFutureTradeDate IsoISODate
    SettlementAmount IsoActiveCurrencyAndAmount
    CashSettlementDate IsoISODate
    SettlementMethod DeliveryReceiptType2Code
    BestExecution BestExecution1Code
    FinancialAdvice FinancialAdvice1Code
    NegotiatedTrade NegotiatedTrade1Code
    LateReport LateReport1Code
}
SwitchExecution7 *-- "0..1" IPlaceOfTradeIdentification1Choice : PlaceOfTrade
SwitchExecution7 *-- "0..1" InvestmentAccount58 : InvestmentAccountDetails
SwitchExecution7 *-- "0..10" Intermediary39 : RelatedPartyDetails
SwitchExecution7 *-- "0..1" ICancellationRight1Choice : CancellationRight
SwitchExecution7 *-- "0..1" IAdditionalAmount1Choice : AdditionalAmount
SwitchExecution7 *-- "1..0" SwitchRedemptionLegExecution4 : RedemptionLegDetails
SwitchExecution7 *-- "1..0" SwitchSubscriptionLegExecution4 : SubscriptionLegDetails
SwitchExecution7 *-- "0..1" PaymentTransaction71 : CashSettlementDetails
SwitchExecution7 *-- "0..0" ForeignExchangeTerms33 : ForeignExchangeDetails
SwitchExecution7 *-- "0..1" ICustomerConductClassification1Choice : CustomerConductClassification
SwitchExecution7 *-- "0..1" ITransactionChannelType1Choice : TransactionChannelType
SwitchExecution7 *-- "0..1" ISignatureType1Choice : SignatureType
SwitchExecution7 *-- "0..1" OrderWaiver1 : OrderWaiverDetails
%% IPlaceOfTradeIdentification1Choice recursion level 1 with max 1
%% InvestmentAccount58 recursion level 1 with max 1
class InvestmentAccount58{
    AccountIdentification IsoMax35Text
    AccountName IsoMax35Text
    AccountDesignation IsoMax35Text
    OrderOriginatorEligibility OrderOriginatorEligibility1Code
}
InvestmentAccount58 *-- "0..0" PartyIdentification113 : OwnerIdentification
InvestmentAccount58 *-- "0..1" PartyIdentification113 : AccountServicer
InvestmentAccount58 *-- "0..1" SubAccount6 : SubAccountDetails
%% Intermediary39 recursion level 1 with max 1
class Intermediary39{
    OrderOriginatorEligibility OrderOriginatorEligibility1Code
    TradingPartyCapacity TradingCapacity8Code
}
Intermediary39 *-- "1..1" PartyIdentification113 : Identification
Intermediary39 *-- "0..1" Account22 : Account
Intermediary39 *-- "0..1" IInvestmentFundRole2Choice : Role
%% ICancellationRight1Choice recursion level 1 with max 1
%% IAdditionalAmount1Choice recursion level 1 with max 1
%% SwitchRedemptionLegExecution4 recursion level 1 with max 1
class SwitchRedemptionLegExecution4{
    LegIdentification IsoMax35Text
    LegExecutionIdentification IsoMax35Text
    UnitsNumber IsoDecimalNumber
    HoldingsRedemptionRate IsoPercentageRate
    NetAmount IsoActiveCurrencyAndAmount
    GrossAmount IsoActiveCurrencyAndAmount
    CumDividendIndicator IsoYesNoIndicator
    IncomePreference IncomePreference1Code
    Group1Or2Units UKTaxGroupUnit1Code
    RequestedSettlementCurrency ActiveCurrencyCode
    RequestedNAVCurrency ActiveOrHistoricCurrencyCode
    PhysicalDeliveryIndicator IsoYesNoIndicator
    NonStandardSettlementInformation IsoMax350Text
}
SwitchRedemptionLegExecution4 *-- "1..1" FinancialInstrument57 : FinancialInstrumentDetails
SwitchRedemptionLegExecution4 *-- "0..1" InvestmentAccount58 : InvestmentAccountDetails
SwitchRedemptionLegExecution4 *-- "1..1" IDateAndDateTimeChoice : TradeDateTime
SwitchRedemptionLegExecution4 *-- "1..1" UnitPrice22 : PriceDetails
SwitchRedemptionLegExecution4 *-- "0..2" UnitPrice22 : InformativePriceDetails
SwitchRedemptionLegExecution4 *-- "0..1" IProfitAndLoss2Choice : InterimProfitAmount
SwitchRedemptionLegExecution4 *-- "0..1" TotalFeesAndTaxes40 : TransactionOverhead
SwitchRedemptionLegExecution4 *-- "0..1" InformativeTax1 : InformativeTaxDetails
SwitchRedemptionLegExecution4 *-- "0..1" FundSettlementParameters11 : SettlementAndCustodyDetails
SwitchRedemptionLegExecution4 *-- "0..1" DeliveryParameters3 : PhysicalDeliveryDetails
SwitchRedemptionLegExecution4 *-- "0..1" Equalisation1 : Equalisation
SwitchRedemptionLegExecution4 *-- "0..1" HoldBackInformation2 : GatingOrHoldBackDetails
%% SwitchSubscriptionLegExecution4 recursion level 1 with max 1
class SwitchSubscriptionLegExecution4{
    LegIdentification IsoMax35Text
    LegExecutionIdentification IsoMax35Text
    UnitsNumber IsoDecimalNumber
    NetAmount IsoActiveCurrencyAndAmount
    GrossAmount IsoActiveCurrencyAndAmount
    CumDividendIndicator IsoYesNoIndicator
    IncomePreference IncomePreference1Code
    RequestedSettlementCurrency ActiveCurrencyCode
    RequestedNAVCurrency ActiveOrHistoricCurrencyCode
    PhysicalDeliveryIndicator IsoYesNoIndicator
    NonStandardSettlementInformation IsoMax350Text
}
SwitchSubscriptionLegExecution4 *-- "1..1" FinancialInstrument57 : FinancialInstrumentDetails
SwitchSubscriptionLegExecution4 *-- "0..1" InvestmentAccount58 : InvestmentAccountDetails
SwitchSubscriptionLegExecution4 *-- "1..1" IDateAndDateTimeChoice : TradeDateTime
SwitchSubscriptionLegExecution4 *-- "1..1" UnitPrice22 : PriceDetails
SwitchSubscriptionLegExecution4 *-- "0..2" UnitPrice22 : InformativePriceDetails
SwitchSubscriptionLegExecution4 *-- "0..1" IProfitAndLoss2Choice : InterimProfitAmount
SwitchSubscriptionLegExecution4 *-- "0..1" TotalFeesAndTaxes40 : TransactionOverhead
SwitchSubscriptionLegExecution4 *-- "0..1" InformativeTax1 : InformativeTaxDetails
SwitchSubscriptionLegExecution4 *-- "0..1" FundSettlementParameters12 : SettlementAndCustodyDetails
SwitchSubscriptionLegExecution4 *-- "0..1" DeliveryParameters3 : PhysicalDeliveryDetails
SwitchSubscriptionLegExecution4 *-- "0..1" Equalisation1 : Equalisation
%% PaymentTransaction71 recursion level 1 with max 1
PaymentTransaction71 *-- "1..1" ICashInOrOut7Choice : CashInOrOut
%% ForeignExchangeTerms33 recursion level 1 with max 1
class ForeignExchangeTerms33{
    ToAmount IsoActiveCurrencyAndAmount
    FromAmount IsoActiveCurrencyAndAmount
    UnitCurrency ActiveCurrencyCode
    QuotedCurrency ActiveCurrencyCode
    ExchangeRate IsoBaseOneRate
    QuotationDate IsoISODateTime
}
ForeignExchangeTerms33 *-- "0..1" PartyIdentification113 : QuotingInstitution
%% ICustomerConductClassification1Choice recursion level 1 with max 1
%% ITransactionChannelType1Choice recursion level 1 with max 1
%% ISignatureType1Choice recursion level 1 with max 1
%% OrderWaiver1 recursion level 1 with max 1
class OrderWaiver1{
    InformationValue IsoMax350Text
}
OrderWaiver1 *-- "0..0" IOrderWaiverReason3Choice : OrderWaiverReason
  

SwitchExecution7 members

CopyDetails building block

Information provided when the message is a copy of a previous message. Information provided when the message is a copy of a previous message. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CopyInformation4 recursion level 0 with max 1
class CopyInformation4{
    CopyIndicator IsoYesNoIndicator
    OriginalReceiver IsoAnyBICIdentifier
}
  

CopyInformation4 members

Extension building block

Additional information that cannot be captured in the structured elements and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Extension1 recursion level 0 with max 1
class Extension1{
    PlaceAndName IsoMax350Text
    Text IsoMax350Text
}
  

Extension1 members

Extensibility and generalization considerations

To facilitate generalized design patterns in the system, the SwitchOrderConfirmationV04 implementation follows a specific implementaiton pattern. First of all, SwitchOrderConfirmationV04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, SwitchOrderConfirmationV04Document implements IOuterDocument. Because SwitchOrderConfirmationV04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type SwitchOrderConfirmationV04.

classDiagram
    class IOuterRecord
    SwitchOrderConfirmationV04 --|> IOuterRecord : Implements
    SwitchOrderConfirmationV04Document --|> IOuterDocument~SwitchOrderConfirmationV04~ : Implements
    class IOuterDocument~SwitchOrderConfirmationV04~ {
        SwitchOrderConfirmationV04 Message
     }
  

Document wrapper for serialization

The only real purpose SwitchOrderConfirmationV04Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:setr.015.001.04’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using SwitchOrderConfirmationV04.ToDocument() method. The returned SwitchOrderConfirmationV04Document value will serialize correctly according to ISO 20022 standards.

classDiagram
    SwitchOrderConfirmationV04Document *-- SwitchOrderConfirmationV04 : Document
  

Sample of message format

This is an abbreviated version of what the message should look like.

<Document xmlns="urn:iso:std:iso:20022:tech:xsd:setr.015.001.04">
    <SwtchOrdrConf>
        <MsgId>
            <!-- MessageIdentification inner content -->
        </MsgId>
        <PoolRef>
            <!-- PoolReference inner content -->
        </PoolRef>
        <PrvsRef>
            <!-- PreviousReference inner content -->
        </PrvsRef>
        <RltdRef>
            <!-- RelatedReference inner content -->
        </RltdRef>
        <SwtchExctnDtls>
            <!-- SwitchExecutionDetails inner content -->
        </SwtchExctnDtls>
        <CpyDtls>
            <!-- CopyDetails inner content -->
        </CpyDtls>
        <Xtnsn>
            <!-- Extension inner content -->
        </Xtnsn>
    </SwtchOrdrConf>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_Aab7DTbLEead9bDRE_1DAQ"
  previousVersion="_7t2ZYNE7Ed-BzquC8wXy7w_190731874"
  name="SwitchOrderConfirmationV04"
  definition="Scope&#xD;&#xA;The SwitchOrderConfirmation message is sent by an executing party, for example, a transfer agent, to the instructing party, for example, an investment manager or its authorised representative, to confirm the details of the execution of a previously received SwitchOrder instruction.&#xD;&#xA;Usage&#xD;&#xA;The SwitchOrderConfirmation message is used to confirm that all the legs of the previously instructed switch order have been executed. The reference of the switch order confirmation is identified in DealReference.&#xD;&#xA;The reference of the original switch order is specified in OrderReference. The message identification of the SwitchOrder message in which the switch order was conveyed may also be quoted in RelatedReference but this is not recommended.&#xD;&#xA;When the message is used to convey a confirmation amendment/s, the AmendmentIndicator must be present with the value ‘true’ or ‘1’. When this is the case, the message must only contain a confirmation amendment/s and not contain both a confirmation amendment/s and a ‘new’ confirmation/s."
  registrationStatus="Registered"
  messageSet="_hijK0WiLEeOuqdLlpUIWBw _qCumkAFwEeu2__1EbNXzuA"
  xmlTag="SwtchOrdrConf"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_Aab7EzbLEead9bDRE_1DAQ"
    previousVersion="_7uAKaNE7Ed-BzquC8wXy7w_1012754356"
    name="MultipleSwitchExecutionRule"
    definition="If SwitchExecutionDetails is present more than once, then SwitchExecutionDetails/RedemptionLegDetails and SwitchExecutionDetails/SubscriptionLegDetails must only be present once."
    registrationStatus="Provisionally Registered" />
  <messageBuildingBlock
    xmi:id="_Aab7FzbLEead9bDRE_1DAQ"
    previousVersion="_7t2ZYdE7Ed-BzquC8wXy7w_602996789"
    name="MessageIdentification"
    definition="Reference that uniquely identifies the message from a business application standpoint."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="MsgId"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_Aab7GTbLEead9bDRE_1DAQ"
    previousVersion="_7t2ZYtE7Ed-BzquC8wXy7w_1151194773"
    name="PoolReference"
    definition="Collective reference identifying a set of messages."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PoolRef"
    complexType="_N4g3EXETEea2e4bzJ8TyEw" />
  <messageBuildingBlock
    xmi:id="_Aab7GzbLEead9bDRE_1DAQ"
    previousVersion="_7t2ZY9E7Ed-BzquC8wXy7w_1364526959"
    name="PreviousReference"
    definition="Reference to a linked message that was previously sent."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="PrvsRef"
    complexType="_udnPoTbsEead9bDRE_1DAQ" />
  <messageBuildingBlock
    xmi:id="_Aab7HTbLEead9bDRE_1DAQ"
    previousVersion="_7t2ZZNE7Ed-BzquC8wXy7w_1366376495"
    name="RelatedReference"
    definition="Reference to a linked message that was previously received."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="RltdRef"
    complexType="_udnPoTbsEead9bDRE_1DAQ" />
  <messageBuildingBlock
    xmi:id="_Aab7HzbLEead9bDRE_1DAQ"
    previousVersion="_7t2ZZdE7Ed-BzquC8wXy7w_-1882952026"
    name="SwitchExecutionDetails"
    definition="Information related to a switch execution."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="SwtchExctnDtls"
    complexType="_8EacxzbsEead9bDRE_1DAQ" />
  <messageBuildingBlock
    xmi:id="_Aab7ITbLEead9bDRE_1DAQ"
    previousVersion="_7uAKYNE7Ed-BzquC8wXy7w_738593095"
    name="CopyDetails"
    definition="Information provided when the message is a copy of a previous message."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CpyDtls"
    complexType="_7VUJ8degEeSA_uUacqhl1Q" />
  <messageBuildingBlock
    xmi:id="_Aab7IzbLEead9bDRE_1DAQ"
    previousVersion="_7uAKYdE7Ed-BzquC8wXy7w_746903959"
    name="Extension"
    definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="Xtnsn"
    complexType="_Q6vvCNp-Ed-ak6NoX_4Aeg_1503007069" />
  <messageDefinitionIdentifier
    businessArea="setr"
    messageFunctionality="015"
    flavour="001"
    version="04" />
</messageDefinition>

ISO Building Blocks

The following items are used as building blocks to construct this message.