Iso20022

PortfolioTransferNotification002V06

sese.037.002.06

Scope The PortfolioTransferNotification is sent by an account servicer to another account servicer to exchange transfer settlement details information during a retail or institutional client portfolio transfer. The account servicer will typically be local agent or global custodian acting on behalf of an investment management institution, a broker/dealer or a retail client.

Usage The exchange of transfer settlement details is the provision, by the delivering account servicer to the receiving account servicer, of the settlement data (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
%% PortfolioTransferNotification002V06 recursion level 0 with max 0
PortfolioTransferNotification002V06 *-- "1..1" Pagination1 : Pagination
PortfolioTransferNotification002V06 *-- "1..1" Statement68 : StatementGeneralDetails
PortfolioTransferNotification002V06 *-- "0..1" PartyIdentification156 : AccountOwner
PortfolioTransferNotification002V06 *-- "1..1" SecuritiesAccount30 : SafekeepingAccount
PortfolioTransferNotification002V06 *-- "0..1" SecuritiesTradeDetails114 : 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 a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% PartyIdentification156 recursion level 0 with max 1
class PartyIdentification156{
    LEI IsoLEIIdentifier
}
PartyIdentification156 *-- "1..1" IPartyIdentification136Choice : Identification
%% IPartyIdentification136Choice recursion level 1 with max 1

PartyIdentification156 members

Member name Description Data Type / Multiplicity
Identification Unique identification of the party. IPartyIdentification136Choice - 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 the transfer. Details of the securities trade. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecuritiesTradeDetails114 recursion level 0 with max 1
class SecuritiesTradeDetails114{
    NotificationSenderTransactionIdentification IsoRestrictedFINXMax16Text
    NotificationReceiverTransactionIdentification IsoRestrictedFINXMax16Text
    CommonIdentification IsoRestrictedFINXMax16Text
    SecuritiesMovementType ReceiveDelivery1Code
    Payment DeliveryReceiptType2Code
    NumberOfDaysAccrued IsoMax3Number
}
SecuritiesTradeDetails114 *-- "0..1" IPortfolioTransferStatus2Choice : Status
SecuritiesTradeDetails114 *-- "0..1" ITradeDate9Choice : TradeDate
SecuritiesTradeDetails114 *-- "1..1" ISettlementDate20Choice : SettlementDate
SecuritiesTradeDetails114 *-- "1..1" SecurityIdentification20 : FinancialInstrumentIdentification
SecuritiesTradeDetails114 *-- "0..1" FinancialInstrumentAttributes97 : FinancialInstrumentAttributes
SecuritiesTradeDetails114 *-- "0..0" IReporting8Choice : Reporting
SecuritiesTradeDetails114 *-- "1..1" Quantity15 : QuantityDetails
SecuritiesTradeDetails114 *-- "0..1" SettlementDetails103 : SettlementParameters
SecuritiesTradeDetails114 *-- "0..1" SettlementParties96 : DeliveringSettlementParties
SecuritiesTradeDetails114 *-- "0..1" SettlementParties96 : ReceivingSettlementParties
SecuritiesTradeDetails114 *-- "0..1" AmountAndDirection57 : SettlementAmount
SecuritiesTradeDetails114 *-- "0..1" OtherAmounts33 : OtherAmounts
SecuritiesTradeDetails114 *-- "0..1" OtherParties42 : OtherBusinessParties
SecuritiesTradeDetails114 *-- "0..0" SupplementaryData1 : SupplementaryData
%% IPortfolioTransferStatus2Choice 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
%% SettlementParties96 recursion level 1 with max 1
SettlementParties96 *-- "0..1" PartyIdentification162 : Depository
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party1
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party2
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party3
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party4
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party5
%% SettlementParties96 recursion level 1 with max 1
SettlementParties96 *-- "0..1" PartyIdentification162 : Depository
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party1
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party2
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party3
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : Party4
SettlementParties96 *-- "0..1" PartyIdentificationAndAccount176 : 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
%% OtherParties42 recursion level 1 with max 1
OtherParties42 *-- "0..1" PartyIdentification170 : Investor
OtherParties42 *-- "0..1" PartyIdentification157 : StockExchange
OtherParties42 *-- "0..1" PartyIdentification157 : TradeRegulator
%% SupplementaryData1 recursion level 1 with max 1
class SupplementaryData1{
    PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope

SecuritiesTradeDetails114 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. IPortfolioTransferStatus2Choice - 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. SettlementParties96 - Optional 0..1
ReceivingSettlementParties Identifies the chain of receiving settlement parties. SettlementParties96 - 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. OtherParties42 - 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 PortfolioTransferNotification002V06 implementation follows a specific implementaiton pattern. First of all, PortfolioTransferNotification002V06 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, PortfolioTransferNotification002V06Document implements IOuterDocument. Because PortfolioTransferNotification002V06 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type PortfolioTransferNotification002V06.

classDiagram
    class IOuterRecord
    PortfolioTransferNotification002V06 --|> IOuterRecord : Implements
    PortfolioTransferNotification002V06Document --|> IOuterDocument~PortfolioTransferNotification002V06~ : Implements
    class IOuterDocument~PortfolioTransferNotification002V06~ {
        PortfolioTransferNotification002V06 Message
     }

Document wrapper for serialization

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

classDiagram
    PortfolioTransferNotification002V06Document *-- PortfolioTransferNotification002V06 : 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.06">
    <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="_IPiiUwn-Eeqvb4kQR8No8g"
  nextVersions="_cec-Mzi8Eeydid5dcNPKvg"
  previousVersion="_qImco83yEee5nJBZsW8MFQ"
  name="PortfolioTransferNotification002V06"
  definition="Scope&#xD;&#xA;The  PortfolioTransferNotification is sent by an account servicer to another account servicer to exchange transfer settlement details information during a retail or institutional client portfolio transfer.&#xD;&#xA;The account servicer will typically be local agent or global custodian acting on behalf of an investment management institution, a broker/dealer or a retail client.&#xD;&#xA;&#xD;&#xA;Usage&#xD;&#xA;The exchange of transfer settlement details is the provision, by the delivering account servicer to the receiving account servicer, of the settlement data (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="_gMCB9OSnEeauk5I89sEP4g"
  xmlTag="PrtflTrfNtfctn"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_IPiiVQn-Eeqvb4kQR8No8g"
    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="_IPiiWgn-Eeqvb4kQR8No8g"
    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="_IPiiXAn-Eeqvb4kQR8No8g"
    name="StatementGeneralDetails"
    definition="Provides general information on the notification."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="StmtGnlDtls"
    complexType="_qImctc3yEee5nJBZsW8MFQ" />
  <messageBuildingBlock
    xmi:id="_IPiiXgn-Eeqvb4kQR8No8g"
    name="AccountOwner"
    definition="Party that legally owns the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctOwnr"
    complexType="_Z0x6o_fVEeiNZp_PtLohLw" />
  <messageBuildingBlock
    xmi:id="_IPiiYAn-Eeqvb4kQR8No8g"
    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="_IPiiYgn-Eeqvb4kQR8No8g"
    name="TransferNotificationDetails"
    definition="Details of the transfer."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="TrfNtfctnDtls"
    complexType="_IPijEAn-Eeqvb4kQR8No8g" />
  <messageDefinitionIdentifier
    businessArea="sese"
    messageFunctionality="037"
    flavour="002"
    version="06" />
</messageDefinition>

ISO Building Blocks

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