AccountingStatementOfHoldingsCancellation

semt.005.001.01

Scope The AccountingStatementOfHoldingsCancellation 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 (sub-custodian) 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. This message is used to cancel a previously sent AccountingStatementOfHoldings message. Usage The AccountingStatementOfHoldingsCancellation message is sent by an account servicer to the account owner to cancel a previously sent AccountingStatementOfHoldings message. This message must contain the reference of the message to be cancelled. This message may also contain all the details of the message to be cancelled, but this is not recommended.

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
%% AccountingStatementOfHoldingsCancellation recursion level 0 with max 0
AccountingStatementOfHoldingsCancellation *-- "1..1" AdditionalReference2 : PreviousReference
AccountingStatementOfHoldingsCancellation *-- "0..1" AdditionalReference2 : RelatedReference
AccountingStatementOfHoldingsCancellation *-- "1..1" Pagination : MessagePagination
AccountingStatementOfHoldingsCancellation *-- "0..1" AccountingStatementOfHoldings1 : StatementToBeCancelled
  

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

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

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

StatementToBeCancelled building block

The Accounting Statement of Holdings message to cancel. Information about an accounting statement of holdings. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AccountingStatementOfHoldings1 recursion level 0 with max 1
AccountingStatementOfHoldings1 *-- "1..1" Pagination : MessagePagination
AccountingStatementOfHoldings1 *-- "0..1" Statement4 : StatementGeneralDetails
AccountingStatementOfHoldings1 *-- "0..1" SafekeepingAccount1 : AccountDetails
AccountingStatementOfHoldings1 *-- "0..0" AggregateBalanceInformation2 : BalanceForAccount
AccountingStatementOfHoldings1 *-- "0..0" SubAccountIdentification2 : SubAccountDetails
AccountingStatementOfHoldings1 *-- "0..1" TotalValueInPageAndStatement : TotalValues
AccountingStatementOfHoldings1 *-- "0..0" Extension1 : Extension
%% Pagination recursion level 1 with max 1
class Pagination{
    PageNumber IsoMax5NumericText
    LastPageIndicator IsoYesNoIndicator
}
%% Statement4 recursion level 1 with max 1
class Statement4{
    Reference IsoMax35Text
    ActivityIndicator IsoYesNoIndicator
    ReportNumber IsoMax5NumericText
    AuditedIndicator IsoYesNoIndicator
}
Statement4 *-- "1..1" IDateAndDateTimeChoice : StatementDateTime
Statement4 *-- "0..1" IDateAndDateTimeChoice : CreationDateTime
Statement4 *-- "0..1" IFrequencyCodeAndDSSCodeChoice : Frequency
Statement4 *-- "0..1" IStatementUpdateTypeCodeAndDSSCodeChoice : UpdateType
Statement4 *-- "0..1" IStatementBasisCodeAndDSSCodeChoice : StatementBasis
%% SafekeepingAccount1 recursion level 1 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
%% AggregateBalanceInformation2 recursion level 1 with max 1
class AggregateBalanceInformation2{
    DaysAccrued IsoNumber
    HoldingValue IsoActiveOrHistoricCurrencyAndAmount
    AccruedInterestAmount IsoActiveOrHistoricCurrencyAndAmount
    BookValue IsoActiveOrHistoricCurrencyAndAmount
}
AggregateBalanceInformation2 *-- "1..1" IBalanceQuantity1Choice : AggregateQuantity
AggregateBalanceInformation2 *-- "0..1" ISafekeepingPlaceFormatChoice : SafekeepingPlace
AggregateBalanceInformation2 *-- "1..1" FinancialInstrument4 : FinancialInstrumentDetails
AggregateBalanceInformation2 *-- "1..0" PriceInformation1 : PriceDetails
AggregateBalanceInformation2 *-- "0..1" ForeignExchangeTerms3 : ForeignExchangeDetails
AggregateBalanceInformation2 *-- "0..0" SubBalanceInformation1 : BalanceBreakdownDetails
AggregateBalanceInformation2 *-- "0..0" AdditionalBalanceInformation : AdditionalBalanceBreakdownDetails
AggregateBalanceInformation2 *-- "0..0" AggregateBalancePerSafekeepingPlace2 : BalanceAtSafekeepingPlace
%% SubAccountIdentification2 recursion level 1 with max 1
class SubAccountIdentification2{
    FungibleIndicator IsoYesNoIndicator
    ActivityIndicator IsoYesNoIndicator
}
SubAccountIdentification2 *-- "1..1" IAccountIdentificationFormatChoice : Identification
SubAccountIdentification2 *-- "0..0" AggregateBalanceInformation2 : BalanceForSubAccount
%% TotalValueInPageAndStatement recursion level 1 with max 1
class TotalValueInPageAndStatement{
    TotalHoldingsValueOfPage IsoActiveCurrencyAndAmount
    TotalHoldingsValueOfStatement IsoActiveCurrencyAndAmount
}
%% Extension1 recursion level 1 with max 1
class Extension1{
    PlaceAndName IsoMax350Text
    Text IsoMax350Text
}
  

AccountingStatementOfHoldings1 members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    AccountingStatementOfHoldingsCancellation --|> IOuterRecord : Implements
    AccountingStatementOfHoldingsCancellationDocument --|> IOuterDocument~AccountingStatementOfHoldingsCancellation~ : Implements
    class IOuterDocument~AccountingStatementOfHoldingsCancellation~ {
        AccountingStatementOfHoldingsCancellation Message
     }
  

Document wrapper for serialization

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

classDiagram
    AccountingStatementOfHoldingsCancellationDocument *-- AccountingStatementOfHoldingsCancellation : 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.005.001.01">
    <semt.005.001.01>
        <PrvsRef>
            <!-- PreviousReference inner content -->
        </PrvsRef>
        <RltdRef>
            <!-- RelatedReference inner content -->
        </RltdRef>
        <MsgPgntn>
            <!-- MessagePagination inner content -->
        </MsgPgntn>
        <StmtToBeCanc>
            <!-- StatementToBeCancelled inner content -->
        </StmtToBeCanc>
    </semt.005.001.01>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_MXhfatFSEd-BzquC8wXy7w_-1020688414"
  nextVersions="_McJgvtFSEd-BzquC8wXy7w_-1129601452"
  name="AccountingStatementOfHoldingsCancellation"
  definition="Scope&#xD;&#xA;The AccountingStatementOfHoldingsCancellation 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 (sub-custodian) 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.&#xD;&#xA;This message is used to cancel a previously sent AccountingStatementOfHoldings message.&#xD;&#xA;Usage&#xD;&#xA;The AccountingStatementOfHoldingsCancellation message is sent by an account servicer to the account owner to cancel a previously sent AccountingStatementOfHoldings message.&#xD;&#xA;This message must contain the reference of the message to be cancelled. This message may also contain all the details of the message to be cancelled, but this is not recommended."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlName="semt.005.001.01"
  xmlTag="semt.005.001.01"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_MXhfa9FSEd-BzquC8wXy7w_-932031360"
    name="PreviousReference"
    definition="Reference to a linked message that was previously sent."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="PrvsRef"
    complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
  <messageBuildingBlock
    xmi:id="_MXhfbNFSEd-BzquC8wXy7w_-930181927"
    name="RelatedReference"
    definition="Reference to a linked message that was previously received."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="RltdRef"
    complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
  <messageBuildingBlock
    xmi:id="_MXrQYNFSEd-BzquC8wXy7w_1185839408"
    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="_MXrQYdFSEd-BzquC8wXy7w_-814359740"
    name="StatementToBeCancelled"
    definition="The Accounting Statement of Holdings message to cancel."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="StmtToBeCanc"
    complexType="_UxD5R9p-Ed-ak6NoX_4Aeg_-1253958762" />
  <messageDefinitionIdentifier
    businessArea="semt"
    messageFunctionality="005"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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