Iso20022

PortfolioTransferNotification002V04

sese.037.002.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:

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
%% PortfolioTransferNotification002V04 recursion level 0 with max 0
PortfolioTransferNotification002V04 *-- "1..1" Pagination : Pagination
PortfolioTransferNotification002V04 *-- "1..1" Statement50 : StatementGeneralDetails
PortfolioTransferNotification002V04 *-- "0..1" PartyIdentification109 : AccountOwner
PortfolioTransferNotification002V04 *-- "1..1" SecuritiesAccount30 : SafekeepingAccount
PortfolioTransferNotification002V04 *-- "0..1" SecuritiesTradeDetails57 : 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
%% Statement50 recursion level 0 with max 1
class Statement50{
    CounterpartyPortfolioTransferNotificationReference IsoRestrictedFINXMax16Text
    StatementIdentification IsoRestrictedFINXMax16Text
    ActivityIndicator IsoYesNoIndicator
}
Statement50 *-- "0..1" INumber3Choice : ReportNumber
Statement50 *-- "1..1" IDateAndDateTimeChoice : StatementDateTime
Statement50 *-- "0..1" IUpdateType16Choice : UpdateType
%% INumber3Choice recursion level 1 with max 1
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% IUpdateType16Choice recursion level 1 with max 1

Statement50 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. IDateAndDateTimeChoice - 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
%% PartyIdentification109 recursion level 0 with max 1
class PartyIdentification109{
    LEI IsoLEIIdentifier
}
PartyIdentification109 *-- "1..1" IPartyIdentification114Choice : Identification
%% IPartyIdentification114Choice recursion level 1 with max 1

PartyIdentification109 members

Member name Description Data Type / Multiplicity
Identification Unique identification of the party. IPartyIdentification114Choice - 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
%% SecuritiesTradeDetails57 recursion level 0 with max 1
class SecuritiesTradeDetails57{
    NotificationSenderTransactionIdentification IsoRestrictedFINXMax16Text
    NotificationReceiverTransactionIdentification IsoRestrictedFINXMax16Text
    CommonIdentification IsoRestrictedFINXMax16Text
    SecuritiesMovementType ReceiveDelivery1Code
    Payment DeliveryReceiptType2Code
    NumberOfDaysAccrued IsoMax3Number
}
SecuritiesTradeDetails57 *-- "0..1" ITradeDate6Choice : TradeDate
SecuritiesTradeDetails57 *-- "1..1" ISettlementDate12Choice : SettlementDate
SecuritiesTradeDetails57 *-- "1..1" SecurityIdentification20 : FinancialInstrumentIdentification
SecuritiesTradeDetails57 *-- "0..1" FinancialInstrumentAttributes78 : FinancialInstrumentAttributes
SecuritiesTradeDetails57 *-- "0..0" IReporting8Choice : Reporting
SecuritiesTradeDetails57 *-- "1..1" Quantity12 : QuantityDetails
SecuritiesTradeDetails57 *-- "0..1" SettlementDetails103 : SettlementParameters
SecuritiesTradeDetails57 *-- "0..1" SettlementParties44 : DeliveringSettlementParties
SecuritiesTradeDetails57 *-- "0..1" SettlementParties44 : ReceivingSettlementParties
SecuritiesTradeDetails57 *-- "0..1" AmountAndDirection57 : SettlementAmount
SecuritiesTradeDetails57 *-- "0..1" OtherAmounts33 : OtherAmounts
SecuritiesTradeDetails57 *-- "0..1" OtherParties30 : OtherBusinessParties
SecuritiesTradeDetails57 *-- "0..0" SupplementaryData1 : SupplementaryData
%% ITradeDate6Choice recursion level 1 with max 1
%% ISettlementDate12Choice recursion level 1 with max 1
%% SecurityIdentification20 recursion level 1 with max 1
class SecurityIdentification20{
    ISIN IsoISINOct2015Identifier
    Description IsoRestrictedFINXMax140Text
}
SecurityIdentification20 *-- "0..0" OtherIdentification2 : OtherIdentification
%% FinancialInstrumentAttributes78 recursion level 1 with max 1
class FinancialInstrumentAttributes78{
    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
}
FinancialInstrumentAttributes78 *-- "0..1" IMarketIdentification4Choice : PlaceOfListing
FinancialInstrumentAttributes78 *-- "0..1" IInterestComputationMethodFormat5Choice : DayCountBasis
FinancialInstrumentAttributes78 *-- "0..1" IFormOfSecurity7Choice : RegistrationForm
FinancialInstrumentAttributes78 *-- "0..1" IFrequency27Choice : PaymentFrequency
FinancialInstrumentAttributes78 *-- "0..1" ISecuritiesPaymentStatus6Choice : PaymentStatus
FinancialInstrumentAttributes78 *-- "0..1" IFrequency27Choice : VariableRateChangeFrequency
FinancialInstrumentAttributes78 *-- "0..1" IClassificationType33Choice : ClassificationType
FinancialInstrumentAttributes78 *-- "0..1" IOptionStyle9Choice : OptionStyle
FinancialInstrumentAttributes78 *-- "0..1" IOptionType7Choice : OptionType
FinancialInstrumentAttributes78 *-- "0..1" INumber23Choice : CouponAttachedNumber
FinancialInstrumentAttributes78 *-- "0..1" GenericIdentification39 : PoolNumber
FinancialInstrumentAttributes78 *-- "0..1" IPriceType2Choice : MarketOrIndicativePrice
FinancialInstrumentAttributes78 *-- "0..1" Price3 : ExercisePrice
FinancialInstrumentAttributes78 *-- "0..1" Price3 : SubscriptionPrice
FinancialInstrumentAttributes78 *-- "0..1" Price3 : ConversionPrice
FinancialInstrumentAttributes78 *-- "0..1" Price3 : StrikePrice
FinancialInstrumentAttributes78 *-- "0..1" IFinancialInstrumentQuantity15Choice : MinimumNominalQuantity
FinancialInstrumentAttributes78 *-- "0..1" IFinancialInstrumentQuantity15Choice : ContractSize
FinancialInstrumentAttributes78 *-- "0..0" SecurityIdentification20 : UnderlyingFinancialInstrumentIdentification
%% IReporting8Choice recursion level 1 with max 1
%% Quantity12 recursion level 1 with max 1
class Quantity12{
    DenominationChoice IsoRestrictedFINXMax210Text
}
Quantity12 *-- "1..1" IFinancialInstrumentQuantity15Choice : SettlementQuantity
Quantity12 *-- "0..0" SecuritiesCertificate5 : CertificateNumber
Quantity12 *-- "0..0" QuantityBreakdown38 : 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
%% SettlementParties44 recursion level 1 with max 1
SettlementParties44 *-- "0..1" PartyIdentification103 : Depository
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party1
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party2
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party3
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party4
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party5
%% SettlementParties44 recursion level 1 with max 1
SettlementParties44 *-- "0..1" PartyIdentification103 : Depository
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party1
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party2
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party3
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : Party4
SettlementParties44 *-- "0..1" PartyIdentificationAndAccount131 : 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

SecuritiesTradeDetails57 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
TradeDate Specifies the date/time on which the trade was executed. ITradeDate6Choice - Optional 0..1
SettlementDate Date and time at which the securities are to be delivered or received. ISettlementDate12Choice - 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. FinancialInstrumentAttributes78 - 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. Quantity12 - 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. SettlementParties44 - Optional 0..1
ReceivingSettlementParties Identifies the chain of receiving settlement parties. SettlementParties44 - 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 PortfolioTransferNotification002V04 implementation follows a specific implementaiton pattern. First of all, PortfolioTransferNotification002V04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, PortfolioTransferNotification002V04Document implements IOuterDocument. Because PortfolioTransferNotification002V04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type PortfolioTransferNotification002V04.

classDiagram
    class IOuterRecord
    PortfolioTransferNotification002V04 --|> IOuterRecord : Implements
    PortfolioTransferNotification002V04Document --|> IOuterDocument~PortfolioTransferNotification002V04~ : Implements
    class IOuterDocument~PortfolioTransferNotification002V04~ {
        PortfolioTransferNotification002V04 Message
     }

Document wrapper for serialization

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

classDiagram
    PortfolioTransferNotification002V04Document *-- PortfolioTransferNotification002V04 : 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.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="_5TFsw5NLEeWGlc8L7oPDIg"
  nextVersions="_qImco83yEee5nJBZsW8MFQ"
  name="PortfolioTransferNotification002V04"
  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 (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.&#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="_5TFsxZNLEeWGlc8L7oPDIg"
    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="_5TFsx5NLEeWGlc8L7oPDIg"
    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="_5TFsyZNLEeWGlc8L7oPDIg"
    name="StatementGeneralDetails"
    definition="Provides general information on the notification."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="StmtGnlDtls"
    complexType="_5TFs1ZNLEeWGlc8L7oPDIg" />
  <messageBuildingBlock
    xmi:id="_5TFsy5NLEeWGlc8L7oPDIg"
    name="AccountOwner"
    definition="Party that legally owns the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctOwnr"
    complexType="_S1zDAZjTEeW1SPbGMCLIOQ" />
  <messageBuildingBlock
    xmi:id="_5TFszZNLEeWGlc8L7oPDIg"
    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="_5TFsz5NLEeWGlc8L7oPDIg"
    name="TransferNotificationDetails"
    definition="Details of transfer."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="TrfNtfctnDtls"
    complexType="_5TFtXZNLEeWGlc8L7oPDIg" />
  <messageDefinitionIdentifier
    businessArea="sese"
    messageFunctionality="037"
    flavour="002"
    version="04" />
</messageDefinition>

ISO Building Blocks

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