TransferOutInstruction

sese.001.001.01

Scope The TransferOutInstruction message is sent by an instructing party, or an instructing party’s designated agent, to the executing party. This message is used to instruct the delivery of a financial instrument, free of payment, at a given date, to a specified party. This message can be used to instruct the transfer of a financial instrument to an own account or to a third party. Usage The TransferOutInstruction message is used by an instructing party to instruct the executing party to withdraw a financial instrument from one account and deliver it to either another account or to a third party.

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
%% TransferOutInstruction recursion level 0 with max 0
TransferOutInstruction *-- "0..1" AdditionalReference2 : PoolReference
TransferOutInstruction *-- "0..1" AdditionalReference2 : PreviousReference
TransferOutInstruction *-- "0..1" AdditionalReference2 : RelatedReference
TransferOutInstruction *-- "1..1" Transfer1 : TransferDetails
TransferOutInstruction *-- "1..1" FinancialInstrument3 : FinancialInstrumentDetails
TransferOutInstruction *-- "1..1" InvestmentAccount10 : AccountDetails
TransferOutInstruction *-- "1..1" ReceiveInformation1 : SettlementDetails
TransferOutInstruction *-- "0..1" Extension1 : Extension

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

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
%% AdditionalReference2 recursion level 0 with max 1
class AdditionalReference2{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference2 *-- "0..1" IPartyIdentification1Choice : ReferenceIssuer
%% IPartyIdentification1Choice recursion level 1 with max 1

AdditionalReference2 members

Member name	Description	Data Type / Multiplicity
Reference	Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party.	IsoMax35Text - Required 1..1
ReferenceIssuer	Issuer of the reference.	IPartyIdentification1Choice - Optional 0..1
MessageName	Name of a message.	IsoMax35Text - Optional 0..1

PreviousReference building block

Reference of the 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
%% AdditionalReference2 recursion level 0 with max 1
class AdditionalReference2{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference2 *-- "0..1" IPartyIdentification1Choice : ReferenceIssuer
%% IPartyIdentification1Choice recursion level 1 with max 1

AdditionalReference2 members

Member name	Description	Data Type / Multiplicity
Reference	Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party.	IsoMax35Text - Required 1..1
ReferenceIssuer	Issuer of the reference.	IPartyIdentification1Choice - Optional 0..1
MessageName	Name of a message.	IsoMax35Text - Optional 0..1

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
%% AdditionalReference2 recursion level 0 with max 1
class AdditionalReference2{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference2 *-- "0..1" IPartyIdentification1Choice : ReferenceIssuer
%% IPartyIdentification1Choice recursion level 1 with max 1

AdditionalReference2 members

Member name	Description	Data Type / Multiplicity
Reference	Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party.	IsoMax35Text - Required 1..1
ReferenceIssuer	Issuer of the reference.	IPartyIdentification1Choice - Optional 0..1
MessageName	Name of a message.	IsoMax35Text - Optional 0..1

TransferDetails building block

General information related to the transfer of a financial instrument. Parameters applied to the settlement of a security transfer. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Transfer1 recursion level 0 with max 1
class Transfer1{
    TransferReference IsoMax35Text
    PortfolioTransferOutRate IsoPercentageRate
    OwnAccountTransferIndicator IsoYesNoIndicator
    AveragePrice IsoActiveOrHistoricCurrencyAnd13DecimalAmount
}
Transfer1 *-- "1..1" IDateFormat1Choice : RequestedTransferDate
Transfer1 *-- "1..1" FinancialInstrumentQuantity1 : TotalUnitsNumber
Transfer1 *-- "0..0" Unit1 : UnitsDetails
%% IDateFormat1Choice recursion level 1 with max 1
%% FinancialInstrumentQuantity1 recursion level 1 with max 1
class FinancialInstrumentQuantity1{
    Unit IsoDecimalNumber
}
%% Unit1 recursion level 1 with max 1
class Unit1{
    AcquisitionDate IsoISODate
    CertificateNumber IsoMax35Text
    Group1Or2Units UKTaxGroupUnitCode
}
Unit1 *-- "1..1" FinancialInstrumentQuantity1 : UnitsNumber
Unit1 *-- "0..1" UnitPrice3 : PriceDetails

Transfer1 members

Member name	Description	Data Type / Multiplicity
TransferReference	Unique and unambiguous identifier for a transfer instruction, as assigned by the instructing party.	IsoMax35Text - Required 1..1
RequestedTransferDate	Date and time at which the securities are to be delivered or received.	IDateFormat1Choice - Required 1..1
TotalUnitsNumber	Total quantity of securities to be settled.	FinancialInstrumentQuantity1 - Required 1..1
PortfolioTransferOutRate	Total quantity of securities to be settled.	IsoPercentageRate - Required 1..1
UnitsDetails	Information about the units to be transferred.	Unit1 - Unknown 0..0
OwnAccountTransferIndicator	Indicates whether the transfer results in a change of beneficial owner.	IsoYesNoIndicator - Required 1..1
AveragePrice	Value of a security, as booked in an account. Book value is often different from the current market value of the security.	IsoActiveOrHistoricCurrencyAnd13DecimalAmount - Optional 0..1

FinancialInstrumentDetails building block

Information related to the financial instrument to be withdrawn. Security that is a sub-set of an investment fund, and is governed by the same investment fund policy, eg, dividend option or valuation currency. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% FinancialInstrument3 recursion level 0 with max 1
class FinancialInstrument3{
    Name IsoMax350Text
    SupplementaryIdentification IsoMax35Text
    RequestedNAVCurrency ActiveOrHistoricCurrencyCode
    ClassType IsoMax35Text
    SecuritiesForm FormOfSecurity1Code
    DistributionPolicy DistributionPolicy1Code
}
FinancialInstrument3 *-- "1..1" ISecurityIdentification1Choice : Identification
%% ISecurityIdentification1Choice recursion level 1 with max 1

FinancialInstrument3 members

Member name	Description	Data Type / Multiplicity
Identification	Identification of a security by an ISIN.	ISecurityIdentification1Choice - Required 1..1
Name	Name of the financial instrument in free format text.	IsoMax350Text - Optional 0..1
SupplementaryIdentification	Additional information about a financial instrument to help identify the instrument.	IsoMax35Text - Optional 0..1
RequestedNAVCurrency	Currency to be used for pricing the fund. This currency must be among the set of currencies in which the price may be expressed, as stated in the prospectus.	ActiveOrHistoricCurrencyCode - Optional 0..1
ClassType	Features of units offered by a fund. For example, a unit may have a specific load structure, eg, front end or back end, an income policy, eg, pay out or accumulate, or a trailer policy, eg, with or without. Fund classes are typically denoted by a single character, eg, ‘Class A’, ‘Class 2’.	IsoMax35Text - Optional 0..1
SecuritiesForm	Form, ie, ownership, of the security, eg, registered or bearer.	FormOfSecurity1Code - Optional 0..1
DistributionPolicy	Income policy relating to a class type, ie, if income is paid out or retained in the fund.	DistributionPolicy1Code - Optional 0..1

AccountDetails building block

Information related to the account from which the financial instrument is to be withdrawn. Account between an investor(s) and a fund manager or a fund. The account can contain holdings in any investment fund or investment fund class managed (or distributed) by the fund manager, within the same fund family. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% InvestmentAccount10 recursion level 0 with max 1
class InvestmentAccount10{
    AccountName IsoMax35Text
    AccountDesignation IsoMax35Text
    SecuritiesForm FormOfSecurity1Code
    DematerialisedIndicator IsoYesNoIndicator
    IncomePreference IncomePreference1Code
    BeneficiaryCertificationIndicator IsoYesNoIndicator
}
InvestmentAccount10 *-- "0..0" IPartyIdentification1Choice : OwnerIdentification
InvestmentAccount10 *-- "1..1" AccountIdentification1 : AccountIdentification
InvestmentAccount10 *-- "0..0" Intermediary1 : IntermediaryInformation
InvestmentAccount10 *-- "0..1" IPartyIdentification1Choice : SafekeepingPlace
InvestmentAccount10 *-- "0..1" IPartyIdentification1Choice : AccountServicer
%% IPartyIdentification1Choice recursion level 1 with max 1
%% AccountIdentification1 recursion level 1 with max 1
AccountIdentification1 *-- "1..1" SimpleIdentificationInformation : Proprietary
%% Intermediary1 recursion level 1 with max 1
class Intermediary1{
    Role IsoMax35Text
}
Intermediary1 *-- "1..1" IPartyIdentification1Choice : Identification
Intermediary1 *-- "0..1" Account1 : Account
%% IPartyIdentification1Choice recursion level 1 with max 1
%% IPartyIdentification1Choice recursion level 1 with max 1

InvestmentAccount10 members

Member name	Description	Data Type / Multiplicity
OwnerIdentification	Party that legally owns the account.	IPartyIdentification1Choice - Unknown 0..0
AccountIdentification	Unique and unambiguous identification for the account between the account owner and the account servicer.	AccountIdentification1 - Required 1..1
AccountName	Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner.	IsoMax35Text - Optional 0..1
AccountDesignation	Supplementary registration information applying to a specific block of units for dealing and reporting purposes. The supplementary registration information may be used when all the units are registered, for example, to a funds supermarket, but holdings for each investor have to reconciled individually.	IsoMax35Text - Optional 0..1
IntermediaryInformation	Party that provides services relating to financial products to investors, eg, advice on products and placement of orders for the investment fund.	Intermediary1 - Unknown 0..0
SecuritiesForm	Form, ie, ownership, of the security, eg, registered or bearer.	FormOfSecurity1Code - Optional 0..1
DematerialisedIndicator	Indicates whether a security exists only as an electronic record, ie, there is no physical document representing the security.	IsoYesNoIndicator - Optional 0..1
IncomePreference	Dividend option chosen by the account owner based on the options offered in the prospectus.	IncomePreference1Code - Optional 0..1
BeneficiaryCertificationIndicator	Indicates whether the beneficial ownership certification has been sent, certifying that the beneficial owner is eligible to own a specific investment fund or investment fund class.	IsoYesNoIndicator - Optional 0..1
SafekeepingPlace	Place requested as the place of safekeeping.	IPartyIdentification1Choice - Optional 0..1
AccountServicer	Party related to an account that is not the legal account owner, eg, the power of attorney.	IPartyIdentification1Choice - Optional 0..1

SettlementDetails building block

Information related to the receiving side of the transfer. Parameters applied to the settlement of a security transfer. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ReceiveInformation1 recursion level 0 with max 1
class ReceiveInformation1{
    PhysicalTransferIndicator IsoYesNoIndicator
}
ReceiveInformation1 *-- "1..1" ReceivingPartiesAndAccount1 : SettlementPartiesDetails
ReceiveInformation1 *-- "0..1" DeliveryParameters2 : PhysicalTransferDetails
%% ReceivingPartiesAndAccount1 recursion level 1 with max 1
class ReceivingPartiesAndAccount1{
    SecuritiesSettlementSystem IsoMax35Text
}
ReceivingPartiesAndAccount1 *-- "1..1" InvestmentAccount11 : ReceiverDetails
ReceivingPartiesAndAccount1 *-- "0..1" PartyIdentificationAndAccount2 : ReceiversCustodianDetails
ReceivingPartiesAndAccount1 *-- "0..1" PartyIdentificationAndAccount2 : ReceiversIntermediaryDetails
ReceivingPartiesAndAccount1 *-- "1..1" PartyIdentificationAndAccount2 : ReceivingAgentDetails
ReceivingPartiesAndAccount1 *-- "1..1" PartyIdentificationAndAccount2 : PlaceOfSettlementDetails
%% DeliveryParameters2 recursion level 1 with max 1
class DeliveryParameters2{
    RegisteredAddressIndicator IsoYesNoIndicator
}
DeliveryParameters2 *-- "0..1" NameAndAddress1 : NameAndAddress

ReceiveInformation1 members

Member name	Description	Data Type / Multiplicity
SettlementPartiesDetails	Chain of parties involved in the settlement of a transaction.	ReceivingPartiesAndAccount1 - Required 1..1
PhysicalTransferIndicator	Indicates whether the financial instrument is to be physically delivered.	IsoYesNoIndicator - Required 1..1
PhysicalTransferDetails	Parameters of a physical delivery.	DeliveryParameters2 - Optional 0..1

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

Member name	Description	Data Type / Multiplicity
PlaceAndName	Name qualifying the information provided in the Text field, and place where this information should be inserted.	IsoMax350Text - Required 1..1
Text	Text of the extension.	IsoMax350Text - Required 1..1

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    TransferOutInstruction --|> IOuterRecord : Implements
    TransferOutInstructionDocument --|> IOuterDocument~TransferOutInstruction~ : Implements
    class IOuterDocument~TransferOutInstruction~ {
        TransferOutInstruction Message
     }

Document wrapper for serialization

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

classDiagram
    TransferOutInstructionDocument *-- TransferOutInstruction : 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:sese.001.001.01">
    <sese.001.001.01>
        <PoolRef>
            <!-- PoolReference inner content -->
        </PoolRef>
        <PrvsRef>
            <!-- PreviousReference inner content -->
        </PrvsRef>
        <RltdRef>
            <!-- RelatedReference inner content -->
        </RltdRef>
        <TrfDtls>
            <!-- TransferDetails inner content -->
        </TrfDtls>
        <FinInstrmDtls>
            <!-- FinancialInstrumentDetails inner content -->
        </FinInstrmDtls>
        <AcctDtls>
            <!-- AccountDetails inner content -->
        </AcctDtls>
        <SttlmDtls>
            <!-- SettlementDetails inner content -->
        </SttlmDtls>
        <Xtnsn>
            <!-- Extension inner content -->
        </Xtnsn>
    </sese.001.001.01>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_K2NxmNE6Ed-BzquC8wXy7w_-47353492"
  nextVersions="_K2gsgNE6Ed-BzquC8wXy7w_-1277759641"
  name="TransferOutInstruction"
  definition="Scope&#xD;&#xA;The TransferOutInstruction message is sent by an instructing party, or an instructing party's designated agent, to the executing party.&#xD;&#xA;This message is used to instruct the delivery of a financial instrument, free of payment, at a given date, to a specified party. This message can be used to instruct the transfer of a financial instrument to an own account or to a third party.&#xD;&#xA;Usage&#xD;&#xA;The TransferOutInstruction message is used by an instructing party to instruct the executing party to withdraw a financial instrument from one account and deliver it to either another account or to a third party."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlName="sese.001.001.01"
  xmlTag="sese.001.001.01"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_K2NxmdE6Ed-BzquC8wXy7w_-1535314618"
    name="PoolReference"
    definition="Collective reference identifying a set of messages."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PoolRef"
    complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
  <messageBuildingBlock
    xmi:id="_K2NxmtE6Ed-BzquC8wXy7w_1182915315"
    name="PreviousReference"
    definition="Reference of the linked message that was previously sent."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PrvsRef"
    complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
  <messageBuildingBlock
    xmi:id="_K2Nxm9E6Ed-BzquC8wXy7w_-1011295011"
    name="RelatedReference"
    definition="Reference to a linked message that was previously received."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="RltdRef"
    complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
  <messageBuildingBlock
    xmi:id="_K2NxnNE6Ed-BzquC8wXy7w_-1636080860"
    name="TransferDetails"
    definition="General information related to the transfer of a financial instrument."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TrfDtls"
    complexType="_VORZs9p-Ed-ak6NoX_4Aeg_-1697955805" />
  <messageBuildingBlock
    xmi:id="_K2NxndE6Ed-BzquC8wXy7w_1556003366"
    name="FinancialInstrumentDetails"
    definition="Information related to the financial instrument to be withdrawn."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="FinInstrmDtls"
    complexType="_VG0G0tp-Ed-ak6NoX_4Aeg_-2041666443" />
  <messageBuildingBlock
    xmi:id="_K2XikNE6Ed-BzquC8wXy7w_1846996382"
    name="AccountDetails"
    definition="Information related to the account from which the financial instrument is to be withdrawn."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AcctDtls"
    complexType="_U8-1ZNp-Ed-ak6NoX_4Aeg_1336807406" />
  <messageBuildingBlock
    xmi:id="_K2XikdE6Ed-BzquC8wXy7w_1723243531"
    name="SettlementDetails"
    definition="Information related to the receiving side of the transfer."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="SttlmDtls"
    complexType="_VOajqtp-Ed-ak6NoX_4Aeg_299421149" />
  <messageBuildingBlock
    xmi:id="_K2XiktE6Ed-BzquC8wXy7w_-406991476"
    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="sese"
    messageFunctionality="001"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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