semt.002.001.01
Scope The CustodyStatementOfHoldings message is sent by an account servicer to the account owner or the account owner’s designated agent. The account servicer may be a local agent acting on behalf of its global custodian customer, a custodian acting on behalf of an investment management institution or a broker/dealer, a fund administrator or fund intermediary, trustee or registrar, etc. This message reports, at a specified moment in time, the quantity and identification of financial instruments that an account servicer holds for the account owner. This message is used to reconcile the books of the account owner and the account servicer for the specified account or sub-account. This message can also report availability and/or the location of security holdings to facilitate trading and minimise settlement issues. The reporting is per financial instrument, ie, when a financial instrument is held at multiple places of safekeeping, the total holding for all locations can be provided. Usage The CustodyStatementOfHoldings message can be sent:
- At a frequency agreed bi-laterally between the Sender and the Receiver
- As a response to a request for statement sent by the account owner. This message can reflect all outstanding holding information or may only contain changes since the previously sent statement. The CustodyStatementOfHoldings message can only be used to list the holdings of a single (master) account. However, it is possible to break down these holdings into one or several sub-accounts. Therefore, this message can be used to either specify holdings at
- the main account level, or
- the sub-account level. This message can be also be used to report where the securities are safe-kept, physically or notionally. If a security is held in more than one safekeeping place, this can also be indicated. This message must not be used to report audited positions. Audited positions are reported using the AccountingStatementOfHoldings message. Since a SWIFT message as sent is restricted to the maximum input message length, several messages may be needed to accommodate all the information.
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
%% CustodyStatementOfHoldings recursion level 0 with max 0
CustodyStatementOfHoldings *-- "0..1" AdditionalReference2 : PreviousReference
CustodyStatementOfHoldings *-- "0..1" AdditionalReference2 : RelatedReference
CustodyStatementOfHoldings *-- "1..1" Pagination : MessagePagination
CustodyStatementOfHoldings *-- "1..1" Statement3 : StatementGeneralDetails
CustodyStatementOfHoldings *-- "1..1" SafekeepingAccount1 : AccountDetails
CustodyStatementOfHoldings *-- "0..1" AggregateBalanceInformation1 : BalanceForAccount
CustodyStatementOfHoldings *-- "0..1" SubAccountIdentification1 : SubAccountDetails
CustodyStatementOfHoldings *-- "0..1" TotalValueInPageAndStatement : TotalValues
CustodyStatementOfHoldings *-- "0..1" Extension1 : Extension
Now, we will zero-in one-by-one on each of these building blocks.
PreviousReference building block
Reference to a linked message that was previously sent. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% AdditionalReference2 recursion level 0 with max 1
class AdditionalReference2{
Reference IsoMax35Text
MessageName IsoMax35Text
}
AdditionalReference2 *-- "0..1" IPartyIdentification1Choice : ReferenceIssuer
%% IPartyIdentification1Choice recursion level 1 with max 1
AdditionalReference2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Reference | Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party. | IsoMax35Text - Required 1..1 |
| ReferenceIssuer | Issuer of the reference. | IPartyIdentification1Choice - Optional 0..1 |
| MessageName | Name of a message. | IsoMax35Text - Optional 0..1 |
RelatedReference building block
Reference to a linked message that was previously received. References a related message or provides another reference, such as a pool reference, linking a set of messages. The party which issued the related reference may be the Sender of the referenced message or a party other than the Sender. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% AdditionalReference2 recursion level 0 with max 1
class AdditionalReference2{
Reference IsoMax35Text
MessageName IsoMax35Text
}
AdditionalReference2 *-- "0..1" IPartyIdentification1Choice : ReferenceIssuer
%% IPartyIdentification1Choice recursion level 1 with max 1
AdditionalReference2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Reference | Business reference of a message assigned by the party issuing the message. This reference must be unique amongst all messages of the same name sent by the same party. | IsoMax35Text - Required 1..1 |
| ReferenceIssuer | Issuer of the reference. | IPartyIdentification1Choice - Optional 0..1 |
| MessageName | Name of a message. | IsoMax35Text - Optional 0..1 |
MessagePagination building block
Pagination of the message. 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
General information related to the custody statement of holdings. General characteristics related to a statement which reports information for a precise date. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% Statement3 recursion level 0 with max 1
class Statement3{
Reference IsoMax35Text
ActivityIndicator IsoYesNoIndicator
ReportNumber IsoMax5NumericText
}
Statement3 *-- "1..1" IDateAndDateTimeChoice : StatementDateTime
Statement3 *-- "0..1" IDateAndDateTimeChoice : CreationDateTime
Statement3 *-- "0..1" IFrequencyCodeAndDSSCodeChoice : Frequency
Statement3 *-- "0..1" IStatementUpdateTypeCodeAndDSSCodeChoice : UpdateType
Statement3 *-- "0..1" IStatementBasisCodeAndDSSCodeChoice : StatementBasis
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% IFrequencyCodeAndDSSCodeChoice recursion level 1 with max 1
%% IStatementUpdateTypeCodeAndDSSCodeChoice recursion level 1 with max 1
%% IStatementBasisCodeAndDSSCodeChoice recursion level 1 with max 1
Statement3 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Reference | Reference of the statement. | IsoMax35Text - Required 1..1 |
| StatementDateTime | Date of the statement. | IDateAndDateTimeChoice - Required 1..1 |
| CreationDateTime | Preparation date of the statement. | IDateAndDateTimeChoice - Optional 0..1 |
| Frequency | Frequency of the statement. | IFrequencyCodeAndDSSCodeChoice - Optional 0..1 |
| UpdateType | Indicates whether the report is complete or contains changes only. | IStatementUpdateTypeCodeAndDSSCodeChoice - Optional 0..1 |
| ActivityIndicator | Indicates whether there is activity reported in the statement. | IsoYesNoIndicator - Required 1..1 |
| StatementBasis | Type of balance on which the statement is prepared. | IStatementBasisCodeAndDSSCodeChoice - Optional 0..1 |
| ReportNumber | Sequential number of the statement. | IsoMax5NumericText - Optional 0..1 |
AccountDetails building block
The safekeeping or investment account. Safekeeping or investment account. A safekeeping account is an account on which a securities entry is made. An investment account is an account between an investor(s) and a fund manager or a fund. The account can contain holdings in any investment fund or investment fund class managed (or distributed) by the fund manager, within the same fund family. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% SafekeepingAccount1 recursion level 0 with max 1
class SafekeepingAccount1{
FungibleIndicator IsoYesNoIndicator
Name IsoMax35Text
Designation IsoMax35Text
}
SafekeepingAccount1 *-- "1..1" IAccountIdentificationFormatChoice : Identification
SafekeepingAccount1 *-- "0..10" Intermediary1 : IntermediaryInformation
SafekeepingAccount1 *-- "0..1" IPartyIdentification1Choice : AccountOwner
SafekeepingAccount1 *-- "0..1" IPartyIdentification1Choice : AccountServicer
%% IAccountIdentificationFormatChoice recursion level 1 with max 1
%% Intermediary1 recursion level 1 with max 1
class Intermediary1{
Role IsoMax35Text
}
Intermediary1 *-- "1..1" IPartyIdentification1Choice : Identification
Intermediary1 *-- "0..1" Account1 : Account
%% IPartyIdentification1Choice recursion level 1 with max 1
%% IPartyIdentification1Choice recursion level 1 with max 1
SafekeepingAccount1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique and unambiguous identification for the account between the account owner and the account servicer. | IAccountIdentificationFormatChoice - Required 1..1 |
| FungibleIndicator | Indicates whether the securities in the account are fungible, ie, interchangeable. | IsoYesNoIndicator - Required 1..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. | IsoMax35Text - 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 | Party that provides services relating to financial products to investors, eg, advice on products and placement of orders for the investment fund. | Intermediary1 - Collection 0..10 |
| AccountOwner | Party that legally owns the account. | IPartyIdentification1Choice - Optional 0..1 |
| AccountServicer | 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. | IPartyIdentification1Choice - 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. Net position of a segregated holding, in a single security, within the overall position held in a securities account. A securities balance is calculated from the sum of securities’ receipts minus the sum of securities’ deliveries. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% AggregateBalanceInformation1 recursion level 0 with max 1
class AggregateBalanceInformation1{
DaysAccrued IsoNumber
HoldingValue IsoActiveOrHistoricCurrencyAndAmount
AccruedInterestAmount IsoActiveOrHistoricCurrencyAndAmount
BookValue IsoActiveOrHistoricCurrencyAndAmount
}
AggregateBalanceInformation1 *-- "1..1" IBalanceQuantity1Choice : AggregateQuantity
AggregateBalanceInformation1 *-- "0..1" IBalanceQuantity1Choice : AvailableQuantity
AggregateBalanceInformation1 *-- "0..1" IBalanceQuantity1Choice : NotAvailableQuantity
AggregateBalanceInformation1 *-- "0..1" ISafekeepingPlaceFormatChoice : SafekeepingPlace
AggregateBalanceInformation1 *-- "1..1" FinancialInstrument4 : FinancialInstrumentDetails
AggregateBalanceInformation1 *-- "0..0" PriceInformation1 : PriceDetails
AggregateBalanceInformation1 *-- "0..1" ForeignExchangeTerms3 : ForeignExchangeDetails
AggregateBalanceInformation1 *-- "0..0" SubBalanceInformation1 : BalanceBreakdownDetails
AggregateBalanceInformation1 *-- "0..0" AdditionalBalanceInformation : AdditionalBalanceBreakdownDetails
AggregateBalanceInformation1 *-- "0..0" AggregateBalancePerSafekeepingPlace1 : BalanceAtSafekeepingPlace
%% IBalanceQuantity1Choice recursion level 1 with max 1
%% IBalanceQuantity1Choice recursion level 1 with max 1
%% IBalanceQuantity1Choice recursion level 1 with max 1
%% ISafekeepingPlaceFormatChoice recursion level 1 with max 1
%% FinancialInstrument4 recursion level 1 with max 1
class FinancialInstrument4{
Name IsoMax350Text
SupplementaryIdentification IsoMax35Text
SecuritiesForm FormOfSecurity1Code
ClassType IsoMax35Text
DistributionPolicy DistributionPolicy1Code
}
FinancialInstrument4 *-- "1..1" ISecurityIdentification1Choice : Identification
%% PriceInformation1 recursion level 1 with max 1
class PriceInformation1{
ValueType PriceValueType2Code
Type TypeOfPrice5Code
Yielded IsoYesNoIndicator
}
PriceInformation1 *-- "1..1" IPriceRateOrAmountOrUnknownChoice : Value
PriceInformation1 *-- "0..1" IPriceSourceFormatChoice : SourceOfPrice
PriceInformation1 *-- "0..1" IDateAndDateTimeChoice : QuotationDate
%% ForeignExchangeTerms3 recursion level 1 with max 1
class ForeignExchangeTerms3{
UnitCurrency CurrencyCode
QuotedCurrency CurrencyCode
ExchangeRate IsoBaseOneRate
QuotationDate IsoISODateTime
}
ForeignExchangeTerms3 *-- "0..1" IPartyIdentification1Choice : QuotingInstitution
%% SubBalanceInformation1 recursion level 1 with max 1
SubBalanceInformation1 *-- "1..1" ISubBalanceQuantity1Choice : Quantity
SubBalanceInformation1 *-- "1..1" ISecuritiesBalanceType1Choice : SubBalanceType
SubBalanceInformation1 *-- "0..0" AdditionalBalanceInformation : AdditionalBalanceBreakdownDetails
%% AdditionalBalanceInformation recursion level 1 with max 1
class AdditionalBalanceInformation{
SubBalanceType SecuritiesBalanceType2Code
}
AdditionalBalanceInformation *-- "1..1" ISubBalanceQuantity1Choice : Quantity
%% AggregateBalancePerSafekeepingPlace1 recursion level 1 with max 1
class AggregateBalancePerSafekeepingPlace1{
DaysAccrued IsoNumber
HoldingValue IsoActiveOrHistoricCurrencyAndAmount
AccruedInterestAmount IsoActiveOrHistoricCurrencyAndAmount
BookValue IsoActiveOrHistoricCurrencyAndAmount
}
AggregateBalancePerSafekeepingPlace1 *-- "1..1" IBalanceQuantity1Choice : AggregateQuantity
AggregateBalancePerSafekeepingPlace1 *-- "0..1" IBalanceQuantity1Choice : AvailableQuantity
AggregateBalancePerSafekeepingPlace1 *-- "0..1" IBalanceQuantity1Choice : NotAvailableQuantity
AggregateBalancePerSafekeepingPlace1 *-- "1..1" ISafekeepingPlaceFormatChoice : SafekeepingPlace
AggregateBalancePerSafekeepingPlace1 *-- "0..0" PriceInformation1 : PriceDetails
AggregateBalancePerSafekeepingPlace1 *-- "0..1" ForeignExchangeTerms3 : ForeignExchangeDetails
AggregateBalancePerSafekeepingPlace1 *-- "0..0" SubBalanceInformation1 : BalanceBreakdownDetails
AggregateBalancePerSafekeepingPlace1 *-- "0..0" AdditionalBalanceInformation : AdditionalBalanceBreakdownDetails
AggregateBalanceInformation1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| AggregateQuantity | Total quantity of financial instrument for the referenced holding. | IBalanceQuantity1Choice - Required 1..1 |
| AvailableQuantity | Total quantity of financial instrument for the referenced holding that is available. | IBalanceQuantity1Choice - Optional 0..1 |
| NotAvailableQuantity | Total quantity of financial instrument for the referenced holding that is not available. | IBalanceQuantity1Choice - Optional 0..1 |
| DaysAccrued | Specifies the number of days used for calculating the accrued interest amount. | IsoNumber - Optional 0..1 |
| HoldingValue | Total value of a balance of the securities account for a specific financial instrument, expressed in one or more currencies. | IsoActiveOrHistoricCurrencyAndAmount - Unknown 0..0 |
| AccruedInterestAmount | Interest amount that has accrued in between coupon payment periods. | IsoActiveOrHistoricCurrencyAndAmount - Optional 0..1 |
| BookValue | Value of a security, as booked in an account. Book value is often different from the current market value of the security. | IsoActiveOrHistoricCurrencyAndAmount - 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). | ISafekeepingPlaceFormatChoice - Optional 0..1 |
| FinancialInstrumentDetails | Security held on the account for which the balance is calculated. | FinancialInstrument4 - Required 1..1 |
| PriceDetails | Price of the financial instrument in one or more currencies. | PriceInformation1 - Unknown 0..0 |
| ForeignExchangeDetails | Currency exchange related to a securities order. | ForeignExchangeTerms3 - Optional 0..1 |
| BalanceBreakdownDetails | Net position of a segregated holding of a single security within the overall position held in a securities account, eg, sub-balance per status. | SubBalanceInformation1 - Unknown 0..0 |
| AdditionalBalanceBreakdownDetails | Net position of a segregated holding of a single security within the overall position held in a securities account, eg, sub-balance per status. | AdditionalBalanceInformation - Unknown 0..0 |
| BalanceAtSafekeepingPlace | Net position of a segregated holding, in a single security, within the overall position held in a securities account at a specified place of safekeeping. | AggregateBalancePerSafekeepingPlace1 - Unknown 0..0 |
SubAccountDetails building block
The 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
%% SubAccountIdentification1 recursion level 0 with max 1
class SubAccountIdentification1{
FungibleIndicator IsoYesNoIndicator
ActivityIndicator IsoYesNoIndicator
}
SubAccountIdentification1 *-- "1..1" IAccountIdentificationFormatChoice : Identification
SubAccountIdentification1 *-- "0..0" AggregateBalanceInformation1 : BalanceForSubAccount
%% IAccountIdentificationFormatChoice recursion level 1 with max 1
%% AggregateBalanceInformation1 recursion level 1 with max 1
class AggregateBalanceInformation1{
DaysAccrued IsoNumber
HoldingValue IsoActiveOrHistoricCurrencyAndAmount
AccruedInterestAmount IsoActiveOrHistoricCurrencyAndAmount
BookValue IsoActiveOrHistoricCurrencyAndAmount
}
AggregateBalanceInformation1 *-- "1..1" IBalanceQuantity1Choice : AggregateQuantity
AggregateBalanceInformation1 *-- "0..1" IBalanceQuantity1Choice : AvailableQuantity
AggregateBalanceInformation1 *-- "0..1" IBalanceQuantity1Choice : NotAvailableQuantity
AggregateBalanceInformation1 *-- "0..1" ISafekeepingPlaceFormatChoice : SafekeepingPlace
AggregateBalanceInformation1 *-- "1..1" FinancialInstrument4 : FinancialInstrumentDetails
AggregateBalanceInformation1 *-- "0..0" PriceInformation1 : PriceDetails
AggregateBalanceInformation1 *-- "0..1" ForeignExchangeTerms3 : ForeignExchangeDetails
AggregateBalanceInformation1 *-- "0..0" SubBalanceInformation1 : BalanceBreakdownDetails
AggregateBalanceInformation1 *-- "0..0" AdditionalBalanceInformation : AdditionalBalanceBreakdownDetails
AggregateBalanceInformation1 *-- "0..0" AggregateBalancePerSafekeepingPlace1 : BalanceAtSafekeepingPlace
SubAccountIdentification1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique and unambiguous identification for the account between the account owner and the account servicer. | IAccountIdentificationFormatChoice - Required 1..1 |
| FungibleIndicator | Indicates whether the securities in the account are fungible, ie, interchangeable. | IsoYesNoIndicator - Required 1..1 |
| ActivityIndicator | Indicates whether there is activity 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 account. | AggregateBalanceInformation1 - Unknown 0..0 |
TotalValues building block
Value of total holdings reported. Value of total holdings reported. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% TotalValueInPageAndStatement recursion level 0 with max 1
class TotalValueInPageAndStatement{
TotalHoldingsValueOfPage IsoActiveCurrencyAndAmount
TotalHoldingsValueOfStatement IsoActiveCurrencyAndAmount
}
TotalValueInPageAndStatement members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| TotalHoldingsValueOfPage | Total value of positions reported in this message. | IsoActiveCurrencyAndAmount - Optional 0..1 |
| TotalHoldingsValueOfStatement | Total value of positions reported in this statement (a statement may comprise one or more messages). | IsoActiveCurrencyAndAmount - Required 1..1 |
Extension building block
Additional information that cannot be captured in the structured elements and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% Extension1 recursion level 0 with max 1
class Extension1{
PlaceAndName IsoMax350Text
Text IsoMax350Text
}
Extension1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PlaceAndName | Name qualifying the information provided in the Text field, and place where this information should be inserted. | IsoMax350Text - Required 1..1 |
| Text | Text of the extension. | IsoMax350Text - Required 1..1 |
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the CustodyStatementOfHoldings implementation follows a specific implementaiton pattern. First of all, CustodyStatementOfHoldings impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, CustodyStatementOfHoldingsDocument implements IOuterDocument. Because CustodyStatementOfHoldings implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type CustodyStatementOfHoldings.
classDiagram
class IOuterRecord
CustodyStatementOfHoldings --|> IOuterRecord : Implements
CustodyStatementOfHoldingsDocument --|> IOuterDocument~CustodyStatementOfHoldings~ : Implements
class IOuterDocument~CustodyStatementOfHoldings~ {
CustodyStatementOfHoldings Message
}
Document wrapper for serialization
The only real purpose CustodyStatementOfHoldingsDocument serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:semt.002.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using CustodyStatementOfHoldings.ToDocument() method. The returned CustodyStatementOfHoldingsDocument value will serialize correctly according to ISO 20022 standards.
classDiagram
CustodyStatementOfHoldingsDocument *-- CustodyStatementOfHoldings : 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.01">
<semt.002.001.01>
<PrvsRef>
<!-- PreviousReference inner content -->
</PrvsRef>
<RltdRef>
<!-- RelatedReference inner content -->
</RltdRef>
<MsgPgntn>
<!-- MessagePagination inner content -->
</MsgPgntn>
<StmtGnlDtls>
<!-- StatementGeneralDetails inner content -->
</StmtGnlDtls>
<AcctDtls>
<!-- AccountDetails inner content -->
</AcctDtls>
<BalForAcct>
<!-- BalanceForAccount inner content -->
</BalForAcct>
<SubAcctDtls>
<!-- SubAccountDetails inner content -->
</SubAcctDtls>
<TtlVals>
<!-- TotalValues inner content -->
</TtlVals>
<Xtnsn>
<!-- Extension inner content -->
</Xtnsn>
</semt.002.001.01>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_MWx4gNFSEd-BzquC8wXy7w_650597621"
nextVersions="_Magh_dFSEd-BzquC8wXy7w_1153922186"
name="CustodyStatementOfHoldings"
definition="Scope
The CustodyStatementOfHoldings message is sent by an account servicer to the account owner or the account owner's designated agent. The account servicer may be a local agent acting on behalf of its global custodian customer, a custodian acting on behalf of an investment management institution or a broker/dealer, a fund administrator or fund intermediary, trustee or registrar, etc.
This message reports, at a specified moment in time, the quantity and identification of financial instruments that an account servicer holds for the account owner.
This message is used to reconcile the books of the account owner and the account servicer for the specified account or sub-account.
This message can also report availability and/or the location of security holdings to facilitate trading and minimise settlement issues. The reporting is per financial instrument, ie, when a financial instrument is held at multiple places of safekeeping, the total holding for all locations can be provided.
Usage
The CustodyStatementOfHoldings message can be sent:
- At a frequency agreed bi-laterally between the Sender and the Receiver
- As a response to a request for statement sent by the account owner.
This message can reflect all outstanding holding information or may only contain changes since the previously sent statement.
The CustodyStatementOfHoldings message can only be used to list the holdings of a single (master) account. However, it is possible to break down these holdings into one or several sub-accounts. Therefore, this message can be used to either specify holdings at
- the main account level, or
- the sub-account level.
This message can be also be used to report where the securities are safe-kept, physically or notionally. If a security is held in more than one safekeeping place, this can also be indicated.
This message must not be used to report audited positions. Audited positions are reported using the AccountingStatementOfHoldings message.
Since a SWIFT message as sent is restricted to the maximum input message length, several messages may be needed to accommodate all the information."
registrationStatus="Registered"
messageSet="_urpIICeJEeOCeO5e7islRQ"
xmlName="semt.002.001.01"
xmlTag="semt.002.001.01"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_MXEzcdFSEd-BzquC8wXy7w_-1055044854"
name="BalanceForAccountOrSubAccountDetailsRule"
definition="If StatementGeneralDetails/ActivityIndicator is "true" or "1" (Yes), then either BalanceForAccount or SubAccountDetails is mandatory. If StatementGeneralDetails/ActivityIndicator is "false" or "0" (No), then BalanceForAccount and SubAccountDetails are not allowed."
registrationStatus="Provisionally Registered" />
<messageBuildingBlock
xmi:id="_MW7pgNFSEd-BzquC8wXy7w_1818905401"
name="PreviousReference"
definition="Reference to a linked message that was previously sent."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="PrvsRef"
complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
<messageBuildingBlock
xmi:id="_MW7pgdFSEd-BzquC8wXy7w_1810591867"
name="RelatedReference"
definition="Reference to a linked message that was previously received."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="RltdRef"
complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
<messageBuildingBlock
xmi:id="_MW7pgtFSEd-BzquC8wXy7w_-1884866352"
name="MessagePagination"
definition="Pagination of the message."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="MsgPgntn"
complexType="_Q65gBdp-Ed-ak6NoX_4Aeg_-21330104" />
<messageBuildingBlock
xmi:id="_MW7pg9FSEd-BzquC8wXy7w_500773271"
name="StatementGeneralDetails"
definition="General information related to the custody statement of holdings."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="StmtGnlDtls"
complexType="_U1-1h9p-Ed-ak6NoX_4Aeg_418582784" />
<messageBuildingBlock
xmi:id="_MW7phNFSEd-BzquC8wXy7w_-1316963479"
name="AccountDetails"
definition="The safekeeping or investment account."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AcctDtls"
complexType="_VafQyNp-Ed-ak6NoX_4Aeg_-1628848569" />
<messageBuildingBlock
xmi:id="_MW7phdFSEd-BzquC8wXy7w_-2003208951"
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="_VK_cO9p-Ed-ak6NoX_4Aeg_1813959824" />
<messageBuildingBlock
xmi:id="_MW7phtFSEd-BzquC8wXy7w_1776832052"
name="SubAccountDetails"
definition="The sub-account of the safekeeping or investment account."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="SubAcctDtls"
complexType="_VbFGp9p-Ed-ak6NoX_4Aeg_1318763778" />
<messageBuildingBlock
xmi:id="_MW7ph9FSEd-BzquC8wXy7w_1111399368"
name="TotalValues"
definition="Value of total holdings reported."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="TtlVals"
complexType="_Q7Cp9tp-Ed-ak6NoX_4Aeg_-277574684" />
<messageBuildingBlock
xmi:id="_MXEzcNFSEd-BzquC8wXy7w_-143061138"
name="Extension"
definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="Xtnsn"
complexType="_Q6vvCNp-Ed-ak6NoX_4Aeg_1503007069" />
<messageDefinitionIdentifier
businessArea="semt"
messageFunctionality="002"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.