sese.037.001.04
Scope An account servicer sends a PortfolioTransferNotification to another account servicer to exchange transfer settlement details information during a retail or institutional client portfolio transfer. The account servicers will typically be local agents or global custodians acting on behalf of an investment management institution, a broker/dealer or a retail client.
Usage By exchange of transfer settlement details, it is understood the providing, by the delivering account servicer to the receiving account servicer, of the settlement details (trade date, settlement date, delivering settlement chain, quantities, etc.) of the individual transfers that will take place during a full or partial portfolio transfer. This delivering account servicer message may also include, for validation, the receiving settlement chain as provided by the client. In case the receiving settlement chain is not available to the delivering account servicer, the receiving account servicer may in return provide to the delivering account servicer the receiving settlement chain using the same message.
The message may also be used to:
- re-send a message previously sent,
- provide a third party with a copy of a message for information,
- re-send to a third party a copy of a message for information using the relevant elements in the Business Application Header.
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 %% PortfolioTransferNotificationV04 recursion level 0 with max 0 PortfolioTransferNotificationV04 *-- "1..1" Pagination : Pagination PortfolioTransferNotificationV04 *-- "1..1" Statement46 : StatementGeneralDetails PortfolioTransferNotificationV04 *-- "0..1" PartyIdentification98 : AccountOwner PortfolioTransferNotificationV04 *-- "1..1" SecuritiesAccount19 : SafekeepingAccount PortfolioTransferNotificationV04 *-- "0..1" SecuritiesTradeDetails48 : TransferNotificationDetails
Now, we will zero-in one-by-one on each of these building blocks.
Pagination building block
Page number of the message (within a statement) and continuation indicator to indicate that the statement is to continue or that the message is the last page of the statement. Number used to sequence pages when it is not possible for data to be conveyed in a single message and the data has to be split across several pages (messages). For comparison, see the ISO20022 official specification
classDiagram direction tb %% Pagination recursion level 0 with max 1 class Pagination{ PageNumber IsoMax5NumericText LastPageIndicator IsoYesNoIndicator }
Pagination members
Member name | Description | Data Type / Multiplicity |
---|---|---|
PageNumber | Page number. | IsoMax5NumericText - Required 1..1 |
LastPageIndicator | Indicates the last page. | IsoYesNoIndicator - Required 1..1 |
StatementGeneralDetails building block
Provides general information on the notification. Characteristics of the statement. For comparison, see the ISO20022 official specification
classDiagram direction tb %% Statement46 recursion level 0 with max 1 class Statement46{ CounterpartyPortfolioTransferNotificationReference IsoMax35Text StatementIdentification IsoMax35Text ActivityIndicator IsoYesNoIndicator } Statement46 *-- "0..1" INumber3Choice : ReportNumber Statement46 *-- "1..1" IDateAndDateTimeChoice : StatementDateTime Statement46 *-- "0..1" IUpdateType15Choice : UpdateType %% INumber3Choice recursion level 1 with max 1 %% IDateAndDateTimeChoice recursion level 1 with max 1 %% IUpdateType15Choice recursion level 1 with max 1
Statement46 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
CounterpartyPortfolioTransferNotificationReference | Identification assigned by the portfolio transfer counterpart to unambiguously identify a portfolio transfer notification. | IsoMax35Text - Optional 0..1 |
ReportNumber | Sequential number of the report. | INumber3Choice - Optional 0..1 |
StatementIdentification | Reference common to all pages of a statement. | IsoMax35Text - Optional 0..1 |
StatementDateTime | Date and time of the statement. | IDateAndDateTimeChoice - Required 1..1 |
UpdateType | Indicates whether the statement is complete or contains changes only. | IUpdateType15Choice - Optional 0..1 |
ActivityIndicator | Indicates whether there is activity or information update reported in the statement. | IsoYesNoIndicator - Required 1..1 |
AccountOwner building block
Party that legally owns the account. Identification of the party. For comparison, see the ISO20022 official specification
classDiagram direction tb %% PartyIdentification98 recursion level 0 with max 1 class PartyIdentification98{ LEI IsoLEIIdentifier } PartyIdentification98 *-- "1..1" IPartyIdentification92Choice : Identification %% IPartyIdentification92Choice recursion level 1 with max 1
PartyIdentification98 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
Identification | Unique identification of the party. | IPartyIdentification92Choice - Required 1..1 |
LEI | Legal entity identification as an alternate identification for a party. | IsoLEIIdentifier - Optional 0..1 |
SafekeepingAccount building block
Account to or from which a securities entry is made. Account to or from which a securities entry is made. For comparison, see the ISO20022 official specification
classDiagram direction tb %% SecuritiesAccount19 recursion level 0 with max 1 class SecuritiesAccount19{ Identification IsoMax35Text Name IsoMax70Text } SecuritiesAccount19 *-- "0..1" GenericIdentification30 : Type %% GenericIdentification30 recursion level 1 with max 1 class GenericIdentification30{ Identification IsoExact4AlphaNumericText Issuer IsoMax35Text SchemeName IsoMax35Text }
SecuritiesAccount19 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
Identification | Unambiguous identification for the account between the account owner and the account servicer. | IsoMax35Text - Required 1..1 |
Type | Specifies the type of securities account. | GenericIdentification30 - Optional 0..1 |
Name | Description of the account. | IsoMax70Text - Optional 0..1 |
TransferNotificationDetails building block
Details of transfer. Details of the securities trade. For comparison, see the ISO20022 official specification
classDiagram direction tb %% SecuritiesTradeDetails48 recursion level 0 with max 1 class SecuritiesTradeDetails48{ NotificationSenderTransactionIdentification IsoMax35Text NotificationReceiverTransactionIdentification IsoMax35Text CommonIdentification IsoMax35Text SecuritiesMovementType ReceiveDelivery1Code Payment DeliveryReceiptType2Code NumberOfDaysAccrued IsoMax3Number } SecuritiesTradeDetails48 *-- "0..1" ITradeDate5Choice : TradeDate SecuritiesTradeDetails48 *-- "1..1" ISettlementDate9Choice : SettlementDate SecuritiesTradeDetails48 *-- "1..1" SecurityIdentification19 : FinancialInstrumentIdentification SecuritiesTradeDetails48 *-- "0..1" FinancialInstrumentAttributes64 : FinancialInstrumentAttributes SecuritiesTradeDetails48 *-- "0..0" IReporting7Choice : Reporting SecuritiesTradeDetails48 *-- "1..1" Quantity11 : QuantityDetails SecuritiesTradeDetails48 *-- "0..1" SettlementDetails100 : SettlementParameters SecuritiesTradeDetails48 *-- "0..1" SettlementParties36 : DeliveringSettlementParties SecuritiesTradeDetails48 *-- "0..1" SettlementParties36 : ReceivingSettlementParties SecuritiesTradeDetails48 *-- "0..1" AmountAndDirection52 : SettlementAmount SecuritiesTradeDetails48 *-- "0..1" OtherAmounts29 : OtherAmounts SecuritiesTradeDetails48 *-- "0..1" OtherParties26 : OtherBusinessParties SecuritiesTradeDetails48 *-- "0..0" SupplementaryData1 : SupplementaryData %% ITradeDate5Choice recursion level 1 with max 1 %% ISettlementDate9Choice recursion level 1 with max 1 %% SecurityIdentification19 recursion level 1 with max 1 class SecurityIdentification19{ ISIN IsoISINOct2015Identifier Description IsoMax140Text } SecurityIdentification19 *-- "0..0" OtherIdentification1 : OtherIdentification %% FinancialInstrumentAttributes64 recursion level 1 with max 1 class FinancialInstrumentAttributes64{ DenominationCurrency ActiveOrHistoricCurrencyCode CouponDate IsoISODate ExpiryDate IsoISODate FloatingRateFixingDate IsoISODate MaturityDate IsoISODate IssueDate IsoISODate NextCallableDate IsoISODate PutableDate IsoISODate DatedDate IsoISODate FirstPaymentDate IsoISODate PreviousFactor IsoBaseOneRate CurrentFactor IsoBaseOneRate NextFactor IsoBaseOneRate InterestRate IsoPercentageRate YieldToMaturityRate IsoPercentageRate NextInterestRate IsoPercentageRate IndexRateBasis IsoPercentageRate VariableRateIndicator IsoYesNoIndicator CallableIndicator IsoYesNoIndicator PutableIndicator IsoYesNoIndicator FinancialInstrumentAttributeAdditionalDetails IsoMax350Text } FinancialInstrumentAttributes64 *-- "0..1" IMarketIdentification3Choice : PlaceOfListing FinancialInstrumentAttributes64 *-- "0..1" IInterestComputationMethodFormat4Choice : DayCountBasis FinancialInstrumentAttributes64 *-- "0..1" IFormOfSecurity6Choice : RegistrationForm FinancialInstrumentAttributes64 *-- "0..1" IFrequency23Choice : PaymentFrequency FinancialInstrumentAttributes64 *-- "0..1" ISecuritiesPaymentStatus5Choice : PaymentStatus FinancialInstrumentAttributes64 *-- "0..1" IFrequency23Choice : VariableRateChangeFrequency FinancialInstrumentAttributes64 *-- "0..1" IClassificationType32Choice : ClassificationType FinancialInstrumentAttributes64 *-- "0..1" IOptionStyle8Choice : OptionStyle FinancialInstrumentAttributes64 *-- "0..1" IOptionType6Choice : OptionType FinancialInstrumentAttributes64 *-- "0..1" INumber22Choice : CouponAttachedNumber FinancialInstrumentAttributes64 *-- "0..1" GenericIdentification37 : PoolNumber FinancialInstrumentAttributes64 *-- "0..1" IPriceType1Choice : MarketOrIndicativePrice FinancialInstrumentAttributes64 *-- "0..1" Price2 : ExercisePrice FinancialInstrumentAttributes64 *-- "0..1" Price2 : SubscriptionPrice FinancialInstrumentAttributes64 *-- "0..1" Price2 : ConversionPrice FinancialInstrumentAttributes64 *-- "0..1" Price2 : StrikePrice FinancialInstrumentAttributes64 *-- "0..1" IFinancialInstrumentQuantity1Choice : MinimumNominalQuantity FinancialInstrumentAttributes64 *-- "0..1" IFinancialInstrumentQuantity1Choice : ContractSize FinancialInstrumentAttributes64 *-- "0..0" SecurityIdentification19 : UnderlyingFinancialInstrumentIdentification %% IReporting7Choice recursion level 1 with max 1 %% Quantity11 recursion level 1 with max 1 class Quantity11{ DenominationChoice IsoMax210Text } Quantity11 *-- "1..1" IFinancialInstrumentQuantity1Choice : SettlementQuantity Quantity11 *-- "0..0" SecuritiesCertificate4 : CertificateNumber Quantity11 *-- "0..0" QuantityBreakdown30 : QuantityBreakdown %% SettlementDetails100 recursion level 1 with max 1 SettlementDetails100 *-- "0..0" ISettlementTransactionCondition19Choice : SettlementTransactionCondition SettlementDetails100 *-- "0..1" IRegistration9Choice : Registration SettlementDetails100 *-- "0..1" IRestriction5Choice : LegalRestrictions SettlementDetails100 *-- "0..1" ISecuritiesRTGS4Choice : SecuritiesRTGS SettlementDetails100 *-- "0..1" ISettlementSystemMethod4Choice : SettlementSystemMethod SettlementDetails100 *-- "0..1" ITaxCapacityParty4Choice : TaxCapacity SettlementDetails100 *-- "0..1" GenericIdentification30 : StampDutyTaxBasis %% SettlementParties36 recursion level 1 with max 1 SettlementParties36 *-- "0..1" PartyIdentification75 : Depository SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party1 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party2 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party3 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party4 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party5 %% SettlementParties36 recursion level 1 with max 1 SettlementParties36 *-- "0..1" PartyIdentification75 : Depository SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party1 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party2 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party3 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party4 SettlementParties36 *-- "0..1" PartyIdentificationAndAccount106 : Party5 %% AmountAndDirection52 recursion level 1 with max 1 class AmountAndDirection52{ Amount IsoActiveCurrencyAndAmount CreditDebitIndicator CreditDebitCode } %% OtherAmounts29 recursion level 1 with max 1 OtherAmounts29 *-- "0..1" AmountAndDirection44 : AccruedInterestAmount OtherAmounts29 *-- "0..1" AmountAndDirection44 : ChargesFees OtherAmounts29 *-- "0..1" AmountAndDirection44 : CountryNationalFederalTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : PaymentLevyTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : LocalTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : Other OtherAmounts29 *-- "0..1" AmountAndDirection44 : RegulatoryAmount OtherAmounts29 *-- "0..1" AmountAndDirection44 : ShippingAmount OtherAmounts29 *-- "0..1" AmountAndDirection44 : StampDuty OtherAmounts29 *-- "0..1" AmountAndDirection44 : StockExchangeTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : TransferTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : TransactionTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : ValueAddedTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : WithholdingTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : ConsumptionTax OtherAmounts29 *-- "0..1" AmountAndDirection44 : AccruedCapitalisationAmount %% OtherParties26 recursion level 1 with max 1 OtherParties26 *-- "0..1" PartyIdentification99 : Investor OtherParties26 *-- "0..1" PartyIdentification100 : StockExchange OtherParties26 *-- "0..1" PartyIdentification100 : TradeRegulator %% SupplementaryData1 recursion level 1 with max 1 class SupplementaryData1{ PlaceAndName IsoMax350Text } SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
SecuritiesTradeDetails48 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
NotificationSenderTransactionIdentification | Unambiguous identification of the transaction as known by the notification receiver. | IsoMax35Text - Optional 0..1 |
NotificationReceiverTransactionIdentification | Unambiguous identification of the transaction as known by the notification receiver. | IsoMax35Text - Optional 0..1 |
CommonIdentification | Unique reference agreed upon by the two trade counterparties to identify the trade. | IsoMax35Text - Optional 0..1 |
SecuritiesMovementType | Specifies if the movement on a securities account results from a deliver or a receive instruction. | ReceiveDelivery1Code - Required 1..1 |
Payment | Specifies how the transaction is to be settled, for example, against payment. | DeliveryReceiptType2Code - Required 1..1 |
TradeDate | Specifies the date/time on which the trade was executed. | ITradeDate5Choice - Optional 0..1 |
SettlementDate | Date and time at which the securities are to be delivered or received. | ISettlementDate9Choice - Required 1..1 |
NumberOfDaysAccrued | Number of days on which the interest rate accrues (daily accrual note). | IsoMax3Number - Optional 0..1 |
FinancialInstrumentIdentification | Financial instruments representing a sum of rights of the investor vis-a-vis the issuer. | SecurityIdentification19 - Required 1..1 |
FinancialInstrumentAttributes | Elements characterising a financial instrument. | FinancialInstrumentAttributes64 - Optional 0..1 |
Reporting | Specifies that a trade is to be reported to a third party. | IReporting7Choice - Unknown 0..0 |
QuantityDetails | Details about the financial instrument quantity involved in the transfer. | Quantity11 - Required 1..1 |
SettlementParameters | Parameters applied to the settlement of a security transfer. | SettlementDetails100 - Optional 0..1 |
DeliveringSettlementParties | Identifies the chain of delivering settlement parties. | SettlementParties36 - Optional 0..1 |
ReceivingSettlementParties | Identifies the chain of receiving settlement parties. | SettlementParties36 - Optional 0..1 |
SettlementAmount | Total amount of money to be paid or received in exchange for the securities. | AmountAndDirection52 - Optional 0..1 |
OtherAmounts | Other amounts than the settlement amount. | OtherAmounts29 - Optional 0..1 |
OtherBusinessParties | Other business parties relevant to the transaction. | OtherParties26 - Optional 0..1 |
SupplementaryData | Additional information that cannot be captured in the structured elements and/or any other specific block. | SupplementaryData1 - Unknown 0..0 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the PortfolioTransferNotificationV04 implementation follows a specific implementaiton pattern. First of all, PortfolioTransferNotificationV04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, PortfolioTransferNotificationV04Document implements IOuterDocument. Because PortfolioTransferNotificationV04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type PortfolioTransferNotificationV04.
classDiagram class IOuterRecord PortfolioTransferNotificationV04 --|> IOuterRecord : Implements PortfolioTransferNotificationV04Document --|> IOuterDocument~PortfolioTransferNotificationV04~ : Implements class IOuterDocument~PortfolioTransferNotificationV04~ { PortfolioTransferNotificationV04 Message }
Document wrapper for serialization
The only real purpose PortfolioTransferNotificationV04Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:sese.037.001.04’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using PortfolioTransferNotificationV04.ToDocument() method. The returned PortfolioTransferNotificationV04Document value will serialize correctly according to ISO 20022 standards.
classDiagram PortfolioTransferNotificationV04Document *-- PortfolioTransferNotificationV04 : 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.037.001.04">
<PrtflTrfNtfctn>
<Pgntn>
<!-- Pagination inner content -->
</Pgntn>
<StmtGnlDtls>
<!-- StatementGeneralDetails inner content -->
</StmtGnlDtls>
<AcctOwnr>
<!-- AccountOwner inner content -->
</AcctOwnr>
<SfkpgAcct>
<!-- SafekeepingAccount inner content -->
</SfkpgAcct>
<TrfNtfctnDtls>
<!-- TransferNotificationDetails inner content -->
</TrfNtfctnDtls>
</PrtflTrfNtfctn>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_YSMWEQCTEeW_3KiG8SEjHA"
nextVersions="_ViILkaz7EeeBVbuVcoH9Nw"
previousVersion="_hyT1ofvfEeCBQp5TnX1XKQ"
name="PortfolioTransferNotificationV04"
definition="Scope
An account servicer sends a PortfolioTransferNotification to another account servicer to exchange transfer settlement details information during a retail or institutional client portfolio transfer.
The account servicers will typically be local agents or global custodians acting on behalf of an investment management institution, a broker/dealer or a retail client.

Usage
By exchange of transfer settlement details, it is understood the providing, by the delivering account servicer to the receiving account servicer, of the settlement details (trade date, settlement date, delivering settlement chain, quantities, etc.) of the individual transfers that will take place during a full or partial portfolio transfer. This delivering account servicer message may also include, for validation, the receiving settlement chain as provided by the client. In case the receiving settlement chain is not available to the delivering account servicer, the receiving account servicer may in return provide to the delivering account servicer the receiving settlement chain using the same message.

The message may also be used to:
- re-send a message previously sent,
- provide a third party with a copy of a message for information,
- re-send to a third party a copy of a message for information
using the relevant elements in the Business Application Header."
registrationStatus="Registered"
messageSet="_urpIICeJEeOCeO5e7islRQ"
xmlTag="PrtflTrfNtfctn"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_YSMWFwCTEeW_3KiG8SEjHA"
nextVersions="_ViILk6z7EeeBVbuVcoH9Nw"
previousVersion="_hyT1rfvfEeCBQp5TnX1XKQ"
name="SecuritiesMarketPracticeGroupGuideline"
definition="The Securities Market Practice Group (SMPG) has published market practice recommendations on the use of this message.
These market practices are available on www.smpg.info."
registrationStatus="Provisionally Registered" />
<messageBuildingBlock
xmi:id="_YSMWGQCTEeW_3KiG8SEjHA"
nextVersions="_ViILlaz7EeeBVbuVcoH9Nw"
previousVersion="_hyT1sfvfEeCBQp5TnX1XKQ"
name="Pagination"
definition="Page number of the message (within a statement) and continuation indicator to indicate that the statement is to continue or that the message is the last page of the statement."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="Pgntn"
complexType="_Q65gBdp-Ed-ak6NoX_4Aeg_-21330104" />
<messageBuildingBlock
xmi:id="_YSMWGwCTEeW_3KiG8SEjHA"
nextVersions="_ViILl6z7EeeBVbuVcoH9Nw"
previousVersion="_hyT1tfvfEeCBQp5TnX1XKQ"
name="StatementGeneralDetails"
definition="Provides general information on the notification."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="StmtGnlDtls"
complexType="_YOYdpTeQEeWm5uvLSn0jEw" />
<messageBuildingBlock
xmi:id="_YSMWHQCTEeW_3KiG8SEjHA"
nextVersions="_ViILmaz7EeeBVbuVcoH9Nw"
previousVersion="_hyT1ufvfEeCBQp5TnX1XKQ"
name="AccountOwner"
definition="Party that legally owns the account."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="AcctOwnr"
complexType="_lwSA1GwBEeWLq_lbZ2Mhyw" />
<messageBuildingBlock
xmi:id="_YSMWHwCTEeW_3KiG8SEjHA"
nextVersions="_ViILm6z7EeeBVbuVcoH9Nw"
previousVersion="_hyT1vfvfEeCBQp5TnX1XKQ"
name="SafekeepingAccount"
definition="Account to or from which a securities entry is made."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="SfkpgAcct"
complexType="_T_JUKtp-Ed-ak6NoX_4Aeg_1976638301" />
<messageBuildingBlock
xmi:id="_YSMWIQCTEeW_3KiG8SEjHA"
nextVersions="_ViILnaz7EeeBVbuVcoH9Nw"
previousVersion="_hyT1wfvfEeCBQp5TnX1XKQ"
name="TransferNotificationDetails"
definition="Details of transfer."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="TrfNtfctnDtls"
complexType="_JASVVR5dEeWE3PufGMdJ3w" />
<messageDefinitionIdentifier
businessArea="sese"
messageFunctionality="037"
flavour="001"
version="04" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.