Iso20022

PortfolioTransferNotification002V05

sese.037.002.05

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 (such as trade date, settlement date, delivering settlement chain, quantities) 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:

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
%% PortfolioTransferNotification002V05 recursion level 0 with max 0
PortfolioTransferNotification002V05 *-- "1..1" Pagination1 : Pagination
PortfolioTransferNotification002V05 *-- "1..1" Statement68 : StatementGeneralDetails
PortfolioTransferNotification002V05 *-- "0..1" PartyIdentification119 : AccountOwner
PortfolioTransferNotification002V05 *-- "1..1" SecuritiesAccount30 : SafekeepingAccount
PortfolioTransferNotification002V05 *-- "0..1" SecuritiesTradeDetails81 : 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
%% Pagination1 recursion level 0 with max 1
class Pagination1{
    PageNumber IsoMax5NumericText
    LastPageIndicator IsoYesNoIndicator
}

Pagination1 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
%% Statement68 recursion level 0 with max 1
class Statement68{
    CounterpartyPortfolioTransferNotificationReference IsoRestrictedFINXMax16Text
    StatementIdentification IsoRestrictedFINXMax16Text
    ActivityIndicator IsoYesNoIndicator
}
Statement68 *-- "0..1" INumber3Choice : ReportNumber
Statement68 *-- "1..1" IDateAndDateTime2Choice : StatementDateTime
Statement68 *-- "0..1" IUpdateType16Choice : UpdateType
%% INumber3Choice recursion level 1 with max 1
%% IDateAndDateTime2Choice recursion level 1 with max 1
%% IUpdateType16Choice recursion level 1 with max 1

Statement68 members

Member name Description Data Type / Multiplicity
CounterpartyPortfolioTransferNotificationReference Identification assigned by the portfolio transfer counterpart to unambiguously identify a portfolio transfer notification. IsoRestrictedFINXMax16Text - Optional 0..1
ReportNumber Sequential number of the report. INumber3Choice - Optional 0..1
StatementIdentification Reference common to all pages of a statement. IsoRestrictedFINXMax16Text - Optional 0..1
StatementDateTime Date and time of the statement. IDateAndDateTime2Choice - Required 1..1
UpdateType Indicates whether the statement is complete or contains changes only. IUpdateType16Choice - 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
%% PartyIdentification119 recursion level 0 with max 1
class PartyIdentification119{
    LEI IsoLEIIdentifier
}
PartyIdentification119 *-- "1..1" IPartyIdentification103Choice : Identification
%% IPartyIdentification103Choice recursion level 1 with max 1

PartyIdentification119 members

Member name Description Data Type / Multiplicity
Identification Unique identification of the party. IPartyIdentification103Choice - 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
%% SecuritiesAccount30 recursion level 0 with max 1
class SecuritiesAccount30{
    Identification IsoRestrictedFINXMax35Text
    Name IsoMax70Text
}
SecuritiesAccount30 *-- "0..1" GenericIdentification47 : Type
%% GenericIdentification47 recursion level 1 with max 1
class GenericIdentification47{
    Identification IsoExact4AlphaNumericText
    Issuer IsoMax4AlphaNumericText
    SchemeName IsoMax4AlphaNumericText
}

SecuritiesAccount30 members

Member name Description Data Type / Multiplicity
Identification Unambiguous identification for the account between the account owner and the account servicer. IsoRestrictedFINXMax35Text - Required 1..1
Type Specifies the type of securities account. GenericIdentification47 - 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
%% SecuritiesTradeDetails81 recursion level 0 with max 1
class SecuritiesTradeDetails81{
    NotificationSenderTransactionIdentification IsoRestrictedFINXMax16Text
    NotificationReceiverTransactionIdentification IsoRestrictedFINXMax16Text
    CommonIdentification IsoRestrictedFINXMax16Text
    SecuritiesMovementType ReceiveDelivery1Code
    Payment DeliveryReceiptType2Code
    NumberOfDaysAccrued IsoMax3Number
}
SecuritiesTradeDetails81 *-- "0..1" IPortfolioTransferStatus1Choice : Status
SecuritiesTradeDetails81 *-- "0..1" ITradeDate9Choice : TradeDate
SecuritiesTradeDetails81 *-- "1..1" ISettlementDate20Choice : SettlementDate
SecuritiesTradeDetails81 *-- "1..1" SecurityIdentification20 : FinancialInstrumentIdentification
SecuritiesTradeDetails81 *-- "0..1" FinancialInstrumentAttributes97 : FinancialInstrumentAttributes
SecuritiesTradeDetails81 *-- "0..0" IReporting8Choice : Reporting
SecuritiesTradeDetails81 *-- "1..1" Quantity15 : QuantityDetails
SecuritiesTradeDetails81 *-- "0..1" SettlementDetails103 : SettlementParameters
SecuritiesTradeDetails81 *-- "0..1" SettlementParties64 : DeliveringSettlementParties
SecuritiesTradeDetails81 *-- "0..1" SettlementParties64 : ReceivingSettlementParties
SecuritiesTradeDetails81 *-- "0..1" AmountAndDirection57 : SettlementAmount
SecuritiesTradeDetails81 *-- "0..1" OtherAmounts33 : OtherAmounts
SecuritiesTradeDetails81 *-- "0..1" OtherParties30 : OtherBusinessParties
SecuritiesTradeDetails81 *-- "0..0" SupplementaryData1 : SupplementaryData
%% IPortfolioTransferStatus1Choice recursion level 1 with max 1
%% ITradeDate9Choice recursion level 1 with max 1
%% ISettlementDate20Choice recursion level 1 with max 1
%% SecurityIdentification20 recursion level 1 with max 1
class SecurityIdentification20{
    ISIN IsoISINOct2015Identifier
    Description IsoRestrictedFINXMax140Text
}
SecurityIdentification20 *-- "0..0" OtherIdentification2 : OtherIdentification
%% FinancialInstrumentAttributes97 recursion level 1 with max 1
class FinancialInstrumentAttributes97{
    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 IsoRestrictedFINXMax350Text
}
FinancialInstrumentAttributes97 *-- "0..1" IMarketIdentification4Choice : PlaceOfListing
FinancialInstrumentAttributes97 *-- "0..1" IInterestComputationMethodFormat5Choice : DayCountBasis
FinancialInstrumentAttributes97 *-- "0..1" IFormOfSecurity7Choice : RegistrationForm
FinancialInstrumentAttributes97 *-- "0..1" IFrequency27Choice : PaymentFrequency
FinancialInstrumentAttributes97 *-- "0..1" ISecuritiesPaymentStatus6Choice : PaymentStatus
FinancialInstrumentAttributes97 *-- "0..1" IFrequency27Choice : VariableRateChangeFrequency
FinancialInstrumentAttributes97 *-- "0..1" IClassificationType33Choice : ClassificationType
FinancialInstrumentAttributes97 *-- "0..1" IOptionStyle9Choice : OptionStyle
FinancialInstrumentAttributes97 *-- "0..1" IOptionType7Choice : OptionType
FinancialInstrumentAttributes97 *-- "0..1" INumber23Choice : CouponAttachedNumber
FinancialInstrumentAttributes97 *-- "0..1" GenericIdentification39 : PoolNumber
FinancialInstrumentAttributes97 *-- "0..1" IPriceType5Choice : MarketOrIndicativePrice
FinancialInstrumentAttributes97 *-- "0..1" Price3 : ExercisePrice
FinancialInstrumentAttributes97 *-- "0..1" Price3 : SubscriptionPrice
FinancialInstrumentAttributes97 *-- "0..1" Price3 : ConversionPrice
FinancialInstrumentAttributes97 *-- "0..1" Price3 : StrikePrice
FinancialInstrumentAttributes97 *-- "0..1" IFinancialInstrumentQuantity15Choice : MinimumNominalQuantity
FinancialInstrumentAttributes97 *-- "0..1" IFinancialInstrumentQuantity15Choice : ContractSize
FinancialInstrumentAttributes97 *-- "0..0" SecurityIdentification20 : UnderlyingFinancialInstrumentIdentification
%% IReporting8Choice recursion level 1 with max 1
%% Quantity15 recursion level 1 with max 1
class Quantity15{
    DenominationChoice IsoRestrictedFINXMax210Text
}
Quantity15 *-- "1..1" IFinancialInstrumentQuantity15Choice : SettlementQuantity
Quantity15 *-- "0..0" SecuritiesCertificate5 : CertificateNumber
Quantity15 *-- "0..0" QuantityBreakdown48 : QuantityBreakdown
%% SettlementDetails103 recursion level 1 with max 1
SettlementDetails103 *-- "0..0" ISettlementTransactionCondition21Choice : SettlementTransactionCondition
SettlementDetails103 *-- "0..1" IRegistration11Choice : Registration
SettlementDetails103 *-- "0..1" IRestriction6Choice : LegalRestrictions
SettlementDetails103 *-- "0..1" ISecuritiesRTGS5Choice : SecuritiesRTGS
SettlementDetails103 *-- "0..1" ISettlementSystemMethod5Choice : SettlementSystemMethod
SettlementDetails103 *-- "0..1" ITaxCapacityParty5Choice : TaxCapacity
SettlementDetails103 *-- "0..1" GenericIdentification47 : StampDutyTaxBasis
%% SettlementParties64 recursion level 1 with max 1
SettlementParties64 *-- "0..1" PartyIdentification128 : Depository
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party1
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party2
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party3
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party4
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party5
%% SettlementParties64 recursion level 1 with max 1
SettlementParties64 *-- "0..1" PartyIdentification128 : Depository
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party1
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party2
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party3
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party4
SettlementParties64 *-- "0..1" PartyIdentificationAndAccount160 : Party5
%% AmountAndDirection57 recursion level 1 with max 1
class AmountAndDirection57{
    Amount IsoRestrictedFINActiveCurrencyAndAmount
    CreditDebitIndicator CreditDebitCode
}
%% OtherAmounts33 recursion level 1 with max 1
OtherAmounts33 *-- "0..1" AmountAndDirection58 : AccruedInterestAmount
OtherAmounts33 *-- "0..1" AmountAndDirection58 : ChargesFees
OtherAmounts33 *-- "0..1" AmountAndDirection58 : CountryNationalFederalTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : PaymentLevyTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : LocalTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : Other
OtherAmounts33 *-- "0..1" AmountAndDirection58 : RegulatoryAmount
OtherAmounts33 *-- "0..1" AmountAndDirection58 : ShippingAmount
OtherAmounts33 *-- "0..1" AmountAndDirection58 : StampDuty
OtherAmounts33 *-- "0..1" AmountAndDirection58 : StockExchangeTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : TransferTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : TransactionTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : ValueAddedTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : WithholdingTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : ConsumptionTax
OtherAmounts33 *-- "0..1" AmountAndDirection58 : AccruedCapitalisationAmount
%% OtherParties30 recursion level 1 with max 1
OtherParties30 *-- "0..1" PartyIdentification110 : Investor
OtherParties30 *-- "0..1" PartyIdentification111 : StockExchange
OtherParties30 *-- "0..1" PartyIdentification111 : TradeRegulator
%% SupplementaryData1 recursion level 1 with max 1
class SupplementaryData1{
    PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope

SecuritiesTradeDetails81 members

Member name Description Data Type / Multiplicity
NotificationSenderTransactionIdentification Unambiguous identification of the transaction as known by the notification receiver. IsoRestrictedFINXMax16Text - Optional 0..1
NotificationReceiverTransactionIdentification Unambiguous identification of the transaction as known by the notification receiver. IsoRestrictedFINXMax16Text - Optional 0..1
CommonIdentification Unique reference agreed upon by the two trade counterparties to identify the trade. IsoRestrictedFINXMax16Text - 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
Status Status of the transfer. IPortfolioTransferStatus1Choice - Optional 0..1
TradeDate Specifies the date/time on which the trade was executed. ITradeDate9Choice - Optional 0..1
SettlementDate Date and time at which the securities are to be delivered or received. ISettlementDate20Choice - 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. SecurityIdentification20 - Required 1..1
FinancialInstrumentAttributes Elements characterising a financial instrument. FinancialInstrumentAttributes97 - Optional 0..1
Reporting Specifies that a trade is to be reported to a third party. IReporting8Choice - Unknown 0..0
QuantityDetails Details about the financial instrument quantity involved in the transfer. Quantity15 - Required 1..1
SettlementParameters Parameters applied to the settlement of a security transfer. SettlementDetails103 - Optional 0..1
DeliveringSettlementParties Identifies the chain of delivering settlement parties. SettlementParties64 - Optional 0..1
ReceivingSettlementParties Identifies the chain of receiving settlement parties. SettlementParties64 - Optional 0..1
SettlementAmount Total amount of money to be paid or received in exchange for the securities. AmountAndDirection57 - Optional 0..1
OtherAmounts Other amounts than the settlement amount. OtherAmounts33 - Optional 0..1
OtherBusinessParties Other business parties relevant to the transaction. OtherParties30 - 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 PortfolioTransferNotification002V05 implementation follows a specific implementaiton pattern. First of all, PortfolioTransferNotification002V05 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, PortfolioTransferNotification002V05Document implements IOuterDocument. Because PortfolioTransferNotification002V05 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type PortfolioTransferNotification002V05.

classDiagram
    class IOuterRecord
    PortfolioTransferNotification002V05 --|> IOuterRecord : Implements
    PortfolioTransferNotification002V05Document --|> IOuterDocument~PortfolioTransferNotification002V05~ : Implements
    class IOuterDocument~PortfolioTransferNotification002V05~ {
        PortfolioTransferNotification002V05 Message
     }

Document wrapper for serialization

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

classDiagram
    PortfolioTransferNotification002V05Document *-- PortfolioTransferNotification002V05 : 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.002.05">
    <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="_qImco83yEee5nJBZsW8MFQ"
  nextVersions="_IPiiUwn-Eeqvb4kQR8No8g"
  previousVersion="_5TFsw5NLEeWGlc8L7oPDIg"
  name="PortfolioTransferNotification002V05"
  definition="Scope&#xD;&#xA;An account servicer sends a PortfolioTransferNotification to another account servicer to exchange transfer settlement details information during a retail or institutional client portfolio transfer.&#xD;&#xA;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.&#xD;&#xA;&#xD;&#xA;Usage&#xD;&#xA;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 (such as trade date, settlement date, delivering settlement chain, quantities) 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.&#xD;&#xA;&#xD;&#xA;The message may also be used to:&#xD;&#xA;- re-send a message previously sent,&#xD;&#xA;- provide a third party with a copy of a message for information,&#xD;&#xA;- re-send to a third party a copy of a message for information&#xD;&#xA;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="_qImcpc3yEee5nJBZsW8MFQ"
    name="SecuritiesMarketPracticeGroupGuideline"
    definition="The Securities Market Practice Group (SMPG) has published market practice recommendations on the use of this message.&#xD;&#xA;These market practices are available on www.smpg.info."
    registrationStatus="Provisionally Registered" />
  <messageBuildingBlock
    xmi:id="_qImcp83yEee5nJBZsW8MFQ"
    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="_xhMHQa6XEees_ufOy2ci-g" />
  <messageBuildingBlock
    xmi:id="_qImcqc3yEee5nJBZsW8MFQ"
    name="StatementGeneralDetails"
    definition="Provides general information on the notification."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="StmtGnlDtls"
    complexType="_qImctc3yEee5nJBZsW8MFQ" />
  <messageBuildingBlock
    xmi:id="_qImcq83yEee5nJBZsW8MFQ"
    name="AccountOwner"
    definition="Party that legally owns the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctOwnr"
    complexType="_Vy5oUaWYEea1rLcUp8Fsgw" />
  <messageBuildingBlock
    xmi:id="_qImcrc3yEee5nJBZsW8MFQ"
    name="SafekeepingAccount"
    definition="Account to or from which a securities entry is made."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="SfkpgAcct"
    complexType="_5SG1s5NLEeWGlc8L7oPDIg" />
  <messageBuildingBlock
    xmi:id="_qImcr83yEee5nJBZsW8MFQ"
    name="TransferNotificationDetails"
    definition="Details of transfer."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="TrfNtfctnDtls"
    complexType="_qImdYc3yEee5nJBZsW8MFQ" />
  <messageDefinitionIdentifier
    businessArea="sese"
    messageFunctionality="037"
    flavour="002"
    version="05" />
</messageDefinition>

ISO Building Blocks

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