SecuritiesBalanceCustodyReportV04

semt.002.001.04

Scope An account servicer sends a SecuritiesBalanceCustodyReport to an account owner to provide, at a moment in time, the quantity and identification of the financial instruments that the account servicer holds for the account owner The account servicer/owner relationship may be:

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
%% SecuritiesBalanceCustodyReportV04 recursion level 0 with max 0
SecuritiesBalanceCustodyReportV04 *-- "1..1" Pagination : Pagination
SecuritiesBalanceCustodyReportV04 *-- "1..1" Statement21 : StatementGeneralDetails
SecuritiesBalanceCustodyReportV04 *-- "0..1" IPartyIdentification36Choice : AccountOwner
SecuritiesBalanceCustodyReportV04 *-- "0..1" IPartyIdentification49Choice : AccountServicer
SecuritiesBalanceCustodyReportV04 *-- "1..1" SecuritiesAccount11 : SafekeepingAccount
SecuritiesBalanceCustodyReportV04 *-- "0..10" Intermediary21 : IntermediaryInformation
SecuritiesBalanceCustodyReportV04 *-- "0..1" AggregateBalanceInformation12 : BalanceForAccount
SecuritiesBalanceCustodyReportV04 *-- "0..1" SubAccountIdentification17 : SubAccountDetails
SecuritiesBalanceCustodyReportV04 *-- "0..1" TotalValueInPageAndStatement1 : AccountBaseCurrencyTotalAmounts
  

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 report. Characteristics of the statement. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Statement21 recursion level 0 with max 1
class Statement21{
    QueryReference IsoMax35Text
    StatementIdentification IsoMax35Text
    ActivityIndicator IsoYesNoIndicator
    SubAccountIndicator IsoYesNoIndicator
}
Statement21 *-- "0..1" INumber3Choice : ReportNumber
Statement21 *-- "1..1" IDateAndDateTimeChoice : StatementDateTime
Statement21 *-- "1..1" IFrequency4Choice : Frequency
Statement21 *-- "1..1" IUpdateType2Choice : UpdateType
Statement21 *-- "1..1" IStatementBasis3Choice : StatementBasis
%% INumber3Choice recursion level 1 with max 1
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% IFrequency4Choice recursion level 1 with max 1
%% IUpdateType2Choice recursion level 1 with max 1
%% IStatementBasis3Choice recursion level 1 with max 1
  

Statement21 members

Member name Description Data Type / Multiplicity
ReportNumber Sequential number of the report. INumber3Choice - Optional 0..1
QueryReference Identification of the SecuritiesStatementQuery message sent to request this statement. IsoMax35Text - 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
Frequency Frequency of the statement. IFrequency4Choice - Required 1..1
UpdateType Indicates whether the statement is complete or contains changes only. IUpdateType2Choice - Required 1..1
StatementBasis Type of balance on which the statement is prepared. IStatementBasis3Choice - Required 1..1
ActivityIndicator Indicates whether there is activity or information update reported in the statement. IsoYesNoIndicator - Required 1..1
SubAccountIndicator Indicates whether the statement reports holdings at subsafekeeping account level. IsoYesNoIndicator - Required 1..1

AccountOwner building block

Party that legally owns the account. Choice of identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification36Choice recursion level 0 with max 1
  

PartyIdentification36Choice members

Member name Description Data Type / Multiplicity

AccountServicer building block

Party that manages the account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account. . Choice of identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification49Choice recursion level 0 with max 1
  

PartyIdentification49Choice members

Member name Description Data Type / Multiplicity

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
%% SecuritiesAccount11 recursion level 0 with max 1
class SecuritiesAccount11{
    Identification IsoMax35Text
    Name IsoMax70Text
    Designation IsoMax35Text
}
SecuritiesAccount11 *-- "0..1" IPurposeCode1Choice : Type
%% IPurposeCode1Choice recursion level 1 with max 1
  

SecuritiesAccount11 members

Member name Description Data Type / Multiplicity
Identification Unique and unambiguous identification for the account between the account owner and the account servicer. IsoMax35Text - Required 1..1
Type Specifies the type of securities account. IPurposeCode1Choice - Optional 0..1
Name Name of the account. It provides an additional means of identification, and is designated by the account servicer in agreement with the account owner. IsoMax70Text - Optional 0..1
Designation Supplementary registration information applying to a specific block of units for dealing and reporting purposes. The supplementary registration information may be used when all the units are registered, for example, to a funds supermarket, but holdings for each investor have to reconciled individually. IsoMax35Text - Optional 0..1

IntermediaryInformation building block

Information about the party that provides services relating to financial products to investors, for example, advice on products and placement of orders for the investment fund. Party that provides services to investors relating to financial products (Investment Funds). For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Intermediary21 recursion level 0 with max 1
Intermediary21 *-- "1..1" IPartyIdentification49Choice : Identification
Intermediary21 *-- "0..1" IRole2Choice : Role
Intermediary21 *-- "0..1" Account11 : Account
%% IPartyIdentification49Choice recursion level 1 with max 1
%% IRole2Choice recursion level 1 with max 1
%% Account11 recursion level 1 with max 1
Account11 *-- "1..1" AccountIdentification1 : Identification
Account11 *-- "0..1" IPartyIdentification49Choice : AccountServicer
  

Intermediary21 members

Member name Description Data Type / Multiplicity
Identification Unique and unambiguous identifier of the intermediary. IPartyIdentification49Choice - Required 1..1
Role Function performed by the intermediary (investment funds). IRole2Choice - Optional 0..1
Account Business relationship between two entities; one entity is the account owner, the other entity is the account servicer. Account11 - Optional 0..1

BalanceForAccount building block

Net position of a segregated holding, in a single security, within the overall position held in a securities account. Overall position, in a single security, held in a securities account at a specified place of safekeeping. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AggregateBalanceInformation12 recursion level 0 with max 1
class AggregateBalanceInformation12{
    CorporateActionOptionType CorporateActionOption5Code
    DaysAccrued IsoNumber
    HoldingAdditionalDetails IsoMax350Text
}
AggregateBalanceInformation12 *-- "1..1" SecurityIdentification14 : FinancialInstrumentIdentification
AggregateBalanceInformation12 *-- "0..1" FinancialInstrumentAttributes20 : FinancialInstrumentAttributes
AggregateBalanceInformation12 *-- "0..1" FinancialInstrument21 : InvestmentFundsFinancialInstrumentAttributes
AggregateBalanceInformation12 *-- "0..1" BasicCollateralValuation1Details : ValuationHaircutDetails
AggregateBalanceInformation12 *-- "1..1" Balance1 : AggregateBalance
AggregateBalanceInformation12 *-- "0..1" IBalanceQuantity5Choice : AvailableBalance
AggregateBalanceInformation12 *-- "0..1" IBalanceQuantity5Choice : NotAvailableBalance
AggregateBalanceInformation12 *-- "0..1" ISafekeepingPlaceFormat3Choice : SafekeepingPlace
AggregateBalanceInformation12 *-- "0..0" PriceInformation5 : PriceDetails
AggregateBalanceInformation12 *-- "0..0" ForeignExchangeTerms14 : ForeignExchangeDetails
AggregateBalanceInformation12 *-- "0..1" BalanceAmounts3 : AccountBaseCurrencyAmounts
AggregateBalanceInformation12 *-- "0..1" BalanceAmounts3 : InstrumentCurrencyAmounts
AggregateBalanceInformation12 *-- "0..0" QuantityBreakdown3 : QuantityBreakdown
AggregateBalanceInformation12 *-- "0..0" SubBalanceInformation5 : BalanceBreakdown
AggregateBalanceInformation12 *-- "0..0" AdditionalBalanceInformation5 : AdditionalBalanceBreakdown
AggregateBalanceInformation12 *-- "0..0" AggregateBalancePerSafekeepingPlace11 : BalanceAtSafekeepingPlace
AggregateBalanceInformation12 *-- "0..0" SupplementaryData1 : SupplementaryData
%% SecurityIdentification14 recursion level 1 with max 1
class SecurityIdentification14{
    ISIN IsoISINIdentifier
    Description IsoMax140Text
}
SecurityIdentification14 *-- "0..0" OtherIdentification1 : OtherIdentification
%% FinancialInstrumentAttributes20 recursion level 1 with max 1
class FinancialInstrumentAttributes20{
    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
    NextInterestRate IsoPercentageRate
    IndexRateBasis IsoPercentageRate
    VariableRateIndicator IsoYesNoIndicator
    CallableIndicator IsoYesNoIndicator
    PutableIndicator IsoYesNoIndicator
    FinancialInstrumentAttributeAdditionalDetails IsoMax350Text
}
FinancialInstrumentAttributes20 *-- "0..1" MarketIdentification5 : PlaceOfListing
FinancialInstrumentAttributes20 *-- "0..1" IInterestComputationMethodFormat1Choice : DayCountBasis
FinancialInstrumentAttributes20 *-- "0..1" IFormOfSecurity2Choice : RegistrationForm
FinancialInstrumentAttributes20 *-- "0..1" IFrequency3Choice : PaymentFrequency
FinancialInstrumentAttributes20 *-- "0..1" ISecuritiesPaymentStatus2Choice : PaymentStatus
FinancialInstrumentAttributes20 *-- "0..1" IPaymentDirection2Choice : PaymentDirection
FinancialInstrumentAttributes20 *-- "0..1" IFrequency3Choice : VariableRateChangeFrequency
FinancialInstrumentAttributes20 *-- "0..1" IPreferenceToIncome2Choice : PreferenceToIncome
FinancialInstrumentAttributes20 *-- "0..1" IClassificationType2Choice : ClassificationType
FinancialInstrumentAttributes20 *-- "0..1" IOptionStyle4Choice : OptionStyle
FinancialInstrumentAttributes20 *-- "0..1" IOptionType2Choice : OptionType
FinancialInstrumentAttributes20 *-- "0..1" INumber2Choice : CouponAttachedNumber
FinancialInstrumentAttributes20 *-- "0..1" INumber2Choice : PoolNumber
FinancialInstrumentAttributes20 *-- "0..1" IPriceType1Choice : MarketOrIndicativePrice
FinancialInstrumentAttributes20 *-- "0..1" Price2 : ExercisePrice
FinancialInstrumentAttributes20 *-- "0..1" Price2 : SubscriptionPrice
FinancialInstrumentAttributes20 *-- "0..1" Price2 : ConversionPrice
FinancialInstrumentAttributes20 *-- "0..1" Price2 : StrikePrice
FinancialInstrumentAttributes20 *-- "0..1" IFinancialInstrumentQuantity1Choice : MinimumNominalQuantity
FinancialInstrumentAttributes20 *-- "0..1" IFinancialInstrumentQuantity1Choice : ContractSize
FinancialInstrumentAttributes20 *-- "0..0" SecurityIdentification14 : UnderlyingFinancialInstrumentIdentification
%% FinancialInstrument21 recursion level 1 with max 1
class FinancialInstrument21{
    ClassType IsoMax35Text
    SecuritiesForm FormOfSecurity1Code
    DistributionPolicy DistributionPolicy1Code
    ProductGroup IsoMax140Text
    UmbrellaName IsoMax35Text
    BaseCurrency ActiveCurrencyCode
    DenominationCurrency ActiveCurrencyCode
    RequestedNAVCurrency ActiveOrHistoricCurrencyCode
    DualFundIndicator IsoYesNoIndicator
    CountryOfDomicile CountryCode
    RegisteredDistributionCountry CountryCode
}
%% BasicCollateralValuation1Details recursion level 1 with max 1
class BasicCollateralValuation1Details{
    ValuationHaircut IsoPercentageRate
}
BasicCollateralValuation1Details *-- "0..1" PartyIdentification15 : HaircutSource
%% Balance1 recursion level 1 with max 1
class Balance1{
    ShortLongIndicator ShortLong1Code
}
Balance1 *-- "1..1" IBalanceQuantity4Choice : Quantity
%% IBalanceQuantity5Choice recursion level 1 with max 1
%% IBalanceQuantity5Choice recursion level 1 with max 1
%% ISafekeepingPlaceFormat3Choice recursion level 1 with max 1
%% PriceInformation5 recursion level 1 with max 1
PriceInformation5 *-- "1..1" ITypeOfPrice4Choice : Type
PriceInformation5 *-- "1..1" IPriceRateOrAmountOrUnknownChoice : Value
PriceInformation5 *-- "1..1" IYieldedOrValueType1Choice : ValueType
PriceInformation5 *-- "0..1" MarketIdentification6 : SourceOfPrice
PriceInformation5 *-- "0..1" IDateAndDateTimeChoice : QuotationDate
%% ForeignExchangeTerms14 recursion level 1 with max 1
class ForeignExchangeTerms14{
    UnitCurrency ActiveOrHistoricCurrencyCode
    QuotedCurrency ActiveOrHistoricCurrencyCode
    ExchangeRate IsoBaseOneRate
    QuotationDate IsoISODateTime
}
ForeignExchangeTerms14 *-- "0..1" IPartyIdentification49Choice : QuotingInstitution
%% BalanceAmounts3 recursion level 1 with max 1
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : HoldingValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : PreviousHoldingValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : BookValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : EligibleCollateralValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : AccruedInterestAmount
%% BalanceAmounts3 recursion level 1 with max 1
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : HoldingValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : PreviousHoldingValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : BookValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : EligibleCollateralValue
BalanceAmounts3 *-- "0..1" AmountAndDirection6 : AccruedInterestAmount
%% QuantityBreakdown3 recursion level 1 with max 1
QuantityBreakdown3 *-- "0..1" INumber2Choice : LotNumber
QuantityBreakdown3 *-- "0..1" IFinancialInstrumentQuantity1Choice : LotQuantity
QuantityBreakdown3 *-- "0..1" IDateAndDateTimeChoice : LotDateTime
QuantityBreakdown3 *-- "0..1" Price2 : LotPrice
QuantityBreakdown3 *-- "0..1" ITypeOfPrice3Choice : TypeOfPrice
%% SubBalanceInformation5 recursion level 1 with max 1
class SubBalanceInformation5{
    SubBalanceAdditionalDetails IsoMax140Text
}
SubBalanceInformation5 *-- "1..1" ISubBalanceType5Choice : SubBalanceType
SubBalanceInformation5 *-- "1..1" ISubBalanceQuantity3Choice : Quantity
SubBalanceInformation5 *-- "0..0" QuantityBreakdown3 : QuantityBreakdown
SubBalanceInformation5 *-- "0..0" AdditionalBalanceInformation5 : AdditionalBalanceBreakdownDetails
%% AdditionalBalanceInformation5 recursion level 1 with max 1
class AdditionalBalanceInformation5{
    SubBalanceAdditionalDetails IsoMax140Text
}
AdditionalBalanceInformation5 *-- "1..1" ISubBalanceType6Choice : SubBalanceType
AdditionalBalanceInformation5 *-- "1..1" ISubBalanceQuantity3Choice : Quantity
AdditionalBalanceInformation5 *-- "0..0" QuantityBreakdown3 : QuantityBreakdown
%% AggregateBalancePerSafekeepingPlace11 recursion level 1 with max 1
class AggregateBalancePerSafekeepingPlace11{
    DaysAccrued IsoNumber
    HoldingAdditionalDetails IsoMax350Text
}
AggregateBalancePerSafekeepingPlace11 *-- "1..1" ISafekeepingPlaceFormat3Choice : SafekeepingPlace
AggregateBalancePerSafekeepingPlace11 *-- "0..1" MarketIdentification5 : PlaceOfListing
AggregateBalancePerSafekeepingPlace11 *-- "1..1" Balance1 : AggregateBalance
AggregateBalancePerSafekeepingPlace11 *-- "0..1" IBalanceQuantity5Choice : AvailableBalance
AggregateBalancePerSafekeepingPlace11 *-- "0..1" IBalanceQuantity5Choice : NotAvailableBalance
AggregateBalancePerSafekeepingPlace11 *-- "0..0" PriceInformation5 : PriceDetails
AggregateBalancePerSafekeepingPlace11 *-- "0..0" ForeignExchangeTerms14 : ForeignExchangeDetails
AggregateBalancePerSafekeepingPlace11 *-- "0..1" BalanceAmounts3 : AccountBaseCurrencyAmounts
AggregateBalancePerSafekeepingPlace11 *-- "0..1" BalanceAmounts3 : InstrumentCurrencyAmounts
AggregateBalancePerSafekeepingPlace11 *-- "0..0" QuantityBreakdown3 : QuantityBreakdown
AggregateBalancePerSafekeepingPlace11 *-- "0..0" SubBalanceInformation5 : BalanceBreakdown
AggregateBalancePerSafekeepingPlace11 *-- "0..0" AdditionalBalanceInformation5 : AdditionalBalanceBreakdown
%% SupplementaryData1 recursion level 1 with max 1
class SupplementaryData1{
    PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
  

AggregateBalanceInformation12 members

Member name Description Data Type / Multiplicity
FinancialInstrumentIdentification Financial instruments representing a sum of rights of the investor vis-a-vis the issuer. SecurityIdentification14 - Required 1..1
FinancialInstrumentAttributes Elements characterising a financial instrument other than a investment funds. FinancialInstrumentAttributes20 - Optional 0..1
InvestmentFundsFinancialInstrumentAttributes Elements characterising an investment funds financial instrument. FinancialInstrument21 - Optional 0..1
ValuationHaircutDetails Elements used to calculate the valuation haircut. BasicCollateralValuation1Details - Optional 0..1
AggregateBalance Total quantity of financial instruments of the balance. Balance1 - Required 1..1
AvailableBalance Total quantity of financial instruments of the balance that is available. IBalanceQuantity5Choice - Optional 0..1
NotAvailableBalance Total quantity of financial instruments of the balance that is not available. IBalanceQuantity5Choice - Optional 0..1
SafekeepingPlace Place where the securities are safe-kept, physically or notionally. This place can be, for example, a local custodian, a Central Securities Depository (CSD) or an International Central Securities Depository (ICSD). ISafekeepingPlaceFormat3Choice - Optional 0..1
CorporateActionOptionType Specifies the corporate action options available to the account owner. CorporateActionOption5Code - Optional 0..1
PriceDetails Price of the financial instrument in one or more currencies. PriceInformation5 - Unknown 0..0
ForeignExchangeDetails Information needed to process a currency exchange or conversion. ForeignExchangeTerms14 - Unknown 0..0
DaysAccrued Specifies the number of days used for calculating the accrued interest amount. IsoNumber - Optional 0..1
AccountBaseCurrencyAmounts Valuation amounts provided in the base currency of the account. BalanceAmounts3 - Optional 0..1
InstrumentCurrencyAmounts Valuation amounts provided in the currency of the financial instrument. BalanceAmounts3 - Optional 0..1
QuantityBreakdown Breakdown of the aggregate quantity reported into significant lots, for example, tax lots. QuantityBreakdown3 - Unknown 0..0
BalanceBreakdown Breakdown of the aggregate balance per meaningful sub-balances and availability. SubBalanceInformation5 - Unknown 0..0
AdditionalBalanceBreakdown Provides additional instrument sub-balance information on all or parts of the reported financial instrument (unregistered, tax exempt, etc.). AdditionalBalanceInformation5 - Unknown 0..0
BalanceAtSafekeepingPlace Breakdown of positions per place of safekeeping (and optionally per place of listing). AggregateBalancePerSafekeepingPlace11 - Unknown 0..0
HoldingAdditionalDetails Provides additional information on the holding. IsoMax350Text - Optional 0..1
SupplementaryData Additional information that cannot be captured in the structured elements and/or any other specific block. SupplementaryData1 - Unknown 0..0

SubAccountDetails building block

Sub-account of the safekeeping or investment account. Account to or from which a securities entry is made. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SubAccountIdentification17 recursion level 0 with max 1
class SubAccountIdentification17{
    ActivityIndicator IsoYesNoIndicator
}
SubAccountIdentification17 *-- "0..1" IPartyIdentification36Choice : AccountOwner
SubAccountIdentification17 *-- "1..1" SecuritiesAccount14 : SafekeepingAccount
SubAccountIdentification17 *-- "0..0" AggregateBalanceInformation12 : BalanceForSubAccount
%% IPartyIdentification36Choice recursion level 1 with max 1
%% SecuritiesAccount14 recursion level 1 with max 1
class SecuritiesAccount14{
    Identification IsoMax35Text
    Name IsoMax70Text
}
SecuritiesAccount14 *-- "0..1" IPurposeCode2Choice : Type
%% AggregateBalanceInformation12 recursion level 1 with max 1
class AggregateBalanceInformation12{
    CorporateActionOptionType CorporateActionOption5Code
    DaysAccrued IsoNumber
    HoldingAdditionalDetails IsoMax350Text
}
AggregateBalanceInformation12 *-- "1..1" SecurityIdentification14 : FinancialInstrumentIdentification
AggregateBalanceInformation12 *-- "0..1" FinancialInstrumentAttributes20 : FinancialInstrumentAttributes
AggregateBalanceInformation12 *-- "0..1" FinancialInstrument21 : InvestmentFundsFinancialInstrumentAttributes
AggregateBalanceInformation12 *-- "0..1" BasicCollateralValuation1Details : ValuationHaircutDetails
AggregateBalanceInformation12 *-- "1..1" Balance1 : AggregateBalance
AggregateBalanceInformation12 *-- "0..1" IBalanceQuantity5Choice : AvailableBalance
AggregateBalanceInformation12 *-- "0..1" IBalanceQuantity5Choice : NotAvailableBalance
AggregateBalanceInformation12 *-- "0..1" ISafekeepingPlaceFormat3Choice : SafekeepingPlace
AggregateBalanceInformation12 *-- "0..0" PriceInformation5 : PriceDetails
AggregateBalanceInformation12 *-- "0..0" ForeignExchangeTerms14 : ForeignExchangeDetails
AggregateBalanceInformation12 *-- "0..1" BalanceAmounts3 : AccountBaseCurrencyAmounts
AggregateBalanceInformation12 *-- "0..1" BalanceAmounts3 : InstrumentCurrencyAmounts
AggregateBalanceInformation12 *-- "0..0" QuantityBreakdown3 : QuantityBreakdown
AggregateBalanceInformation12 *-- "0..0" SubBalanceInformation5 : BalanceBreakdown
AggregateBalanceInformation12 *-- "0..0" AdditionalBalanceInformation5 : AdditionalBalanceBreakdown
AggregateBalanceInformation12 *-- "0..0" AggregateBalancePerSafekeepingPlace11 : BalanceAtSafekeepingPlace
AggregateBalanceInformation12 *-- "0..0" SupplementaryData1 : SupplementaryData
  

SubAccountIdentification17 members

Member name Description Data Type / Multiplicity
AccountOwner Party that legally owns the account. IPartyIdentification36Choice - Optional 0..1
SafekeepingAccount Account to or from which a securities entry is made. SecuritiesAccount14 - Required 1..1
ActivityIndicator Indicates whether there is activity or information update reported in the statement. IsoYesNoIndicator - Required 1..1
BalanceForSubAccount Net position of a segregated holding, in a single security, within the overall position held in a securities subaccount. AggregateBalanceInformation12 - Unknown 0..0

AccountBaseCurrencyTotalAmounts building block

Total valuation amounts provided in the base currency of the account. Totals for the value of the holdings reported in the statement or page. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% TotalValueInPageAndStatement1 recursion level 0 with max 1
TotalValueInPageAndStatement1 *-- "0..1" AmountAndDirection6 : TotalHoldingsValueOfPage
TotalValueInPageAndStatement1 *-- "1..1" AmountAndDirection6 : TotalHoldingsValueOfStatement
TotalValueInPageAndStatement1 *-- "0..1" AmountAndDirection6 : TotalBookValueOfStatement
TotalValueInPageAndStatement1 *-- "0..1" AmountAndDirection6 : TotalEligibleCollateralValue
%% AmountAndDirection6 recursion level 1 with max 1
class AmountAndDirection6{
    Amount IsoActiveOrHistoricCurrencyAndAmount
    Sign IsoPlusOrMinusIndicator
}
%% AmountAndDirection6 recursion level 1 with max 1
class AmountAndDirection6{
    Amount IsoActiveOrHistoricCurrencyAndAmount
    Sign IsoPlusOrMinusIndicator
}
%% AmountAndDirection6 recursion level 1 with max 1
class AmountAndDirection6{
    Amount IsoActiveOrHistoricCurrencyAndAmount
    Sign IsoPlusOrMinusIndicator
}
%% AmountAndDirection6 recursion level 1 with max 1
class AmountAndDirection6{
    Amount IsoActiveOrHistoricCurrencyAndAmount
    Sign IsoPlusOrMinusIndicator
}
  

TotalValueInPageAndStatement1 members

Member name Description Data Type / Multiplicity
TotalHoldingsValueOfPage Total value of positions reported in this message. AmountAndDirection6 - Optional 0..1
TotalHoldingsValueOfStatement Total value of positions reported in this statement (a statement may comprise one or more messages). AmountAndDirection6 - Required 1..1
TotalBookValueOfStatement Total book value of positions reported in this statement (a statement may comprise one or more messages). AmountAndDirection6 - Optional 0..1
TotalEligibleCollateralValue Total value of the holdings eligible for collateral purposes reported in this statement (a statement may comprise one or more messages). AmountAndDirection6 - Optional 0..1

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    SecuritiesBalanceCustodyReportV04 --|> IOuterRecord : Implements
    SecuritiesBalanceCustodyReportV04Document --|> IOuterDocument~SecuritiesBalanceCustodyReportV04~ : Implements
    class IOuterDocument~SecuritiesBalanceCustodyReportV04~ {
        SecuritiesBalanceCustodyReportV04 Message
     }
  

Document wrapper for serialization

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

classDiagram
    SecuritiesBalanceCustodyReportV04Document *-- SecuritiesBalanceCustodyReportV04 : 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:semt.002.001.04">
    <SctiesBalCtdyRpt>
        <Pgntn>
            <!-- Pagination inner content -->
        </Pgntn>
        <StmtGnlDtls>
            <!-- StatementGeneralDetails inner content -->
        </StmtGnlDtls>
        <AcctOwnr>
            <!-- AccountOwner inner content -->
        </AcctOwnr>
        <AcctSvcr>
            <!-- AccountServicer inner content -->
        </AcctSvcr>
        <SfkpgAcct>
            <!-- SafekeepingAccount inner content -->
        </SfkpgAcct>
        <IntrmyInf>
            <!-- IntermediaryInformation inner content -->
        </IntrmyInf>
        <BalForAcct>
            <!-- BalanceForAccount inner content -->
        </BalForAcct>
        <SubAcctDtls>
            <!-- SubAccountDetails inner content -->
        </SubAcctDtls>
        <AcctBaseCcyTtlAmts>
            <!-- AccountBaseCurrencyTotalAmounts inner content -->
        </AcctBaseCcyTtlAmts>
    </SctiesBalCtdyRpt>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_HGMCodtYEd-RF5yaMAVhAw"
  nextVersions="_q5q4MfveEeCBQp5TnX1XKQ"
  previousVersion="_Mazc69FSEd-BzquC8wXy7w_-1520493983"
  name="SecuritiesBalanceCustodyReportV04"
  definition="Scope&#xD;&#xA;An account servicer sends a SecuritiesBalanceCustodyReport to an account owner to provide, at a moment in time, the quantity and identification of the financial instruments that the account servicer holds for the account owner&#xD;&#xA;The account servicer/owner relationship may be:&#xD;&#xA;- a central securities depository or another settlement market infrastructure acting on behalf of their participants, or&#xD;&#xA;- an agent (sub-custodian) acting on behalf of their global custodian customer, or&#xD;&#xA;- a custodian acting on behalf of an investment management institution or a broker/dealer, or&#xD;&#xA;- a transfer agent acting on behalf of a fund manager or an account owner's designated agent.&#xD;&#xA;Usage&#xD;&#xA;The message can also include availability and the location of holdings to facilitate trading and minimise settlement issues. The message reports all information per financial instrument, that is, when a financial instrument is held at multiple places of safekeeping, the total holdings for all locations can be provided.&#xD;&#xA;The message should be sent at a frequency agreed bi-laterally between the account servicer and the account owner. The message may be provided on a trade date, contractual or settlement date basis.&#xD;&#xA;There may be one or more intermediary parties, for example, an intermediary or a concentrator between the account owner and account servicer.&#xD;&#xA;The message may also be used to:&#xA;- re-send a message previously sent,&#xA;- provide a third party with a copy of a message for information,&#xA;- re-send to a third party a copy of a message for information.&#xA;using the relevant elements in the Business Application Header.&#xA;ISO 15022 - 20022 Coexistence&#xA;This ISO 20022 message is reversed engineered from ISO 15022. Both standards will coexist for a certain number of years. Until this coexistence period ends, the usage of certain data types is restricted to ensure interoperability between ISO 15022 and 20022 users. Compliance to these rules is mandatory in a coexistence environment. The coexistence restrictions are described in a Textual Rule linked to the Message Items they concern. These coexistence textual rules are clearly identified as follows: “CoexistenceXxxxRule”."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="SctiesBalCtdyRpt"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_HGMCu9tYEd-RF5yaMAVhAw"
    name="BalanceForAccountOrSubAccountDetailsRule"
    definition="If StatementGeneralDetails/ActivityIndicator is TRUE (Yes), then either BalanceForAccount or SubAccountDetails must be present. If StatementGeneralDetails/ActivityIndicator is FALSE (No), then BalanceForAccount and SubAccountDetails must be absent."
    registrationStatus="Provisionally Registered"
    expression="&lt;RuleDefinition&gt;&lt;ComplexRule xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:type=&quot;ComplexRule&quot;&gt;&lt;mustBe&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;Absence&quot;&gt;&lt;leftOperand&gt;/SubAccountDetails[*]&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;BooleanRule xsi:type=&quot;Absence&quot;&gt;&lt;leftOperand&gt;/BalanceForAccount[*]&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;/mustBe&gt;&lt;onCondition&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/StatementGeneralDetails/ActivityIndicator&lt;/leftOperand&gt;&lt;rightOperand&gt;false&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;/onCondition&gt;&lt;/ComplexRule&gt;&lt;/RuleDefinition&gt;" />
  <constraint
    xmi:id="_HGMCvdtYEd-RF5yaMAVhAw"
    name="SubAccountReportingRule"
    definition="If StatementGeneralDetails/ActivityIndicator is TRUE (Yes) and SubAccountIndicator is TRUE (YES), then SubAccountDetails must be present."
    registrationStatus="Provisionally Registered"
    expression="&lt;RuleDefinition&gt;&lt;ComplexRule xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:type=&quot;ComplexRule&quot;&gt;&lt;mustBe&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;Presence&quot;&gt;&lt;leftOperand&gt;/SubAccountDetails[*]&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;BooleanRule xsi:type=&quot;Absence&quot;&gt;&lt;leftOperand&gt;/BalanceForAccount[*]&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;/mustBe&gt;&lt;onCondition&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/StatementGeneralDetails/SubAccountIndicator&lt;/leftOperand&gt;&lt;rightOperand&gt;true&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/StatementGeneralDetails/ActivityIndicator&lt;/leftOperand&gt;&lt;rightOperand&gt;true&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;/onCondition&gt;&lt;/ComplexRule&gt;&lt;/RuleDefinition&gt;" />
  <constraint
    xmi:id="_HGMCv9tYEd-RF5yaMAVhAw"
    name="BalanceForAccountReportingRule"
    definition="If StatementGeneralDetails/ActivityIndicator is TRUE (Yes) and SubAccountIndicator is FALSE (NO), then BalanceForAccount must be present."
    registrationStatus="Provisionally Registered"
    expression="&lt;RuleDefinition&gt;&lt;ComplexRule xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:type=&quot;ComplexRule&quot;&gt;&lt;mustBe&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;Absence&quot;&gt;&lt;leftOperand&gt;/SubAccountDetails[*]&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;BooleanRule xsi:type=&quot;Presence&quot;&gt;&lt;leftOperand&gt;/BalanceForAccount[*]&lt;/leftOperand&gt;&lt;/BooleanRule&gt;&lt;/mustBe&gt;&lt;onCondition&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/StatementGeneralDetails/SubAccountIndicator&lt;/leftOperand&gt;&lt;rightOperand&gt;false&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/StatementGeneralDetails/ActivityIndicator&lt;/leftOperand&gt;&lt;rightOperand&gt;true&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;/onCondition&gt;&lt;/ComplexRule&gt;&lt;/RuleDefinition&gt;" />
  <constraint
    xmi:id="_HGMCwdtYEd-RF5yaMAVhAw"
    name="CoexistenceCharacterSetXRule"
    definition="During ISO 15022 – 20022 coexistence, characters used in all text fields must correspond to character set X, that is, a-z A-Z / - ? : ( ) . , ‘ + { } CR LF."
    registrationStatus="Provisionally Registered" />
  <constraint
    xmi:id="_HGMCw9tYEd-RF5yaMAVhAw"
    name="CoexistenceIdentificationRule"
    definition="During ISO 15022 – 20022 coexistence, all transaction and document identifications or references must be 16 characters or less. The field must not start or end with a slash ‘/’ or contain two consecutive slashes ‘//’."
    registrationStatus="Provisionally Registered" />
  <constraint
    xmi:id="_HGMCxdtYEd-RF5yaMAVhAw"
    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="_HGMCpdtYEd-RF5yaMAVhAw"
    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="_HGMCp9tYEd-RF5yaMAVhAw"
    name="StatementGeneralDetails"
    definition="Provides general information on the report."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="StmtGnlDtls"
    complexType="_QpwstNp-Ed-ak6NoX_4Aeg_1655325945" />
  <messageBuildingBlock
    xmi:id="_HGMCqdtYEd-RF5yaMAVhAw"
    name="AccountOwner"
    definition="Party that legally owns the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctOwnr"
    complexType="_qU9DBeaPEd-q8fx_Zl_34A" />
  <messageBuildingBlock
    xmi:id="_HGMCq9tYEd-RF5yaMAVhAw"
    name="AccountServicer"
    definition="Party that manages the account on behalf of the account owner, that is manages the registration and booking of entries on the account, calculates balances on the account and provides information about the account.&#xA;."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctSvcr"
    complexType="_K1u4YeaOEd-q8fx_Zl_34A" />
  <messageBuildingBlock
    xmi:id="_HGMCrdtYEd-RF5yaMAVhAw"
    name="SafekeepingAccount"
    definition="Account to or from which a securities entry is made."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="SfkpgAcct"
    complexType="_T_vKBdp-Ed-ak6NoX_4Aeg_1610207268" />
  <messageBuildingBlock
    xmi:id="_HGMCr9tYEd-RF5yaMAVhAw"
    name="IntermediaryInformation"
    definition="Information about the party that provides services relating to financial products to investors, for example, advice on products and placement of orders for the investment fund."
    registrationStatus="Provisionally Registered"
    maxOccurs="10"
    minOccurs="0"
    xmlTag="IntrmyInf"
    complexType="_K2B0CeaOEd-q8fx_Zl_34A" />
  <messageBuildingBlock
    xmi:id="_HGMCsdtYEd-RF5yaMAVhAw"
    name="BalanceForAccount"
    definition="Net position of a segregated holding, in a single security, within the overall position held in a securities account."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="BalForAcct"
    complexType="_K14CZeaOEd-q8fx_Zl_34A" />
  <messageBuildingBlock
    xmi:id="_HGMCs9tYEd-RF5yaMAVhAw"
    name="SubAccountDetails"
    definition="Sub-account of the safekeeping or investment account."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SubAcctDtls"
    complexType="_K2B0F-aOEd-q8fx_Zl_34A" />
  <messageBuildingBlock
    xmi:id="_HGMCtdtYEd-RF5yaMAVhAw"
    name="AccountBaseCurrencyTotalAmounts"
    definition="Total valuation amounts provided in the base currency of the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctBaseCcyTtlAmts"
    complexType="_ReNoe9p-Ed-ak6NoX_4Aeg_939590328" />
  <messageDefinitionIdentifier
    businessArea="semt"
    messageFunctionality="002"
    flavour="001"
    version="04" />
</messageDefinition>

ISO Building Blocks

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