AccountingStatementOfHoldingsCancellationV02

semt.005.001.02

Scope An account servicer, for example, a transfer agent, sends the AccountingStatementofHoldingsCancellation message to the account owner, for example, a fund manager or an account owner’s designated agent, to notify the cancellation of a previously sent AccountingStatementOfHoldings message. Usage The AccountingStatementOfHoldingsCancellation message is used 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
%% AccountingStatementOfHoldingsCancellationV02 recursion level 0 with max 0
AccountingStatementOfHoldingsCancellationV02 *-- "1..1" MessageIdentification1 : MessageIdentification
AccountingStatementOfHoldingsCancellationV02 *-- "0..1" AdditionalReference2 : PreviousReference
AccountingStatementOfHoldingsCancellationV02 *-- "0..1" AdditionalReference2 : RelatedReference
AccountingStatementOfHoldingsCancellationV02 *-- "1..1" Pagination : MessagePagination
AccountingStatementOfHoldingsCancellationV02 *-- "0..1" AccountingStatementOfHoldings2 : StatementToBeCancelled
  

Now, we will zero-in one-by-one on each of these building blocks.

MessageIdentification building block

Reference that uniquely identifies a message from a business application standpoint. Identifies a message by a unique identifier and the date and time when the message was created by the sender. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% MessageIdentification1 recursion level 0 with max 1
class MessageIdentification1{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

MessageIdentification1 members

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
%% AccountingStatementOfHoldings2 recursion level 0 with max 1
AccountingStatementOfHoldings2 *-- "0..1" Statement6 : StatementGeneralDetails
AccountingStatementOfHoldings2 *-- "0..1" SafekeepingAccount2 : AccountDetails
AccountingStatementOfHoldings2 *-- "0..0" AggregateBalanceInformation3 : BalanceForAccount
AccountingStatementOfHoldings2 *-- "0..0" SubAccountIdentification3 : SubAccountDetails
AccountingStatementOfHoldings2 *-- "0..1" TotalValueInPageAndStatement : TotalValues
AccountingStatementOfHoldings2 *-- "0..0" Extension1 : Extension
%% Statement6 recursion level 1 with max 1
class Statement6{
    Reference IsoMax35Text
    ActivityIndicator IsoYesNoIndicator
    ReportNumber IsoMax5NumericText
    AuditedIndicator IsoYesNoIndicator
}
Statement6 *-- "1..1" IDateAndDateTimeChoice : StatementDateTime
Statement6 *-- "0..1" IDateAndDateTimeChoice : CreationDateTime
Statement6 *-- "1..1" IFrequencyCodeAndDSSCode1Choice : Frequency
Statement6 *-- "1..1" IStatementUpdateTypeCodeAndDSSCodeChoice : UpdateType
Statement6 *-- "1..1" IStatementBasisCodeAndDSSCodeChoice : StatementBasis
%% SafekeepingAccount2 recursion level 1 with max 1
class SafekeepingAccount2{
    FungibleIndicator IsoYesNoIndicator
    Name IsoMax35Text
    Designation IsoMax35Text
}
SafekeepingAccount2 *-- "1..1" IAccountIdentificationFormatChoice : Identification
SafekeepingAccount2 *-- "0..10" Intermediary11 : IntermediaryInformation
SafekeepingAccount2 *-- "0..1" IPartyIdentification2Choice : AccountOwner
SafekeepingAccount2 *-- "0..1" IPartyIdentification2Choice : AccountServicer
%% AggregateBalanceInformation3 recursion level 1 with max 1
class AggregateBalanceInformation3{
    DaysAccrued IsoNumber
    HoldingValue IsoActiveOrHistoricCurrencyAndAmount
    PreviousHoldingValue IsoActiveOrHistoricCurrencyAndAmount
    AccruedInterestAmount IsoActiveOrHistoricCurrencyAndAmount
    AccruedInterestAmountSign IsoPlusOrMinusIndicator
    BookValue IsoActiveOrHistoricCurrencyAndAmount
}
AggregateBalanceInformation3 *-- "1..1" IBalanceQuantity1Choice : AggregateQuantity
AggregateBalanceInformation3 *-- "0..1" ISafekeepingPlaceFormatChoice : SafekeepingPlace
AggregateBalanceInformation3 *-- "1..1" FinancialInstrument13 : FinancialInstrumentDetails
AggregateBalanceInformation3 *-- "1..0" PriceInformation2 : PriceDetails
AggregateBalanceInformation3 *-- "0..1" ForeignExchangeTerms6 : ForeignExchangeDetails
AggregateBalanceInformation3 *-- "0..0" SubBalanceInformation2 : BalanceBreakdownDetails
AggregateBalanceInformation3 *-- "0..0" AdditionalBalanceInformation2 : AdditionalBalanceBreakdownDetails
AggregateBalanceInformation3 *-- "0..0" AggregateBalancePerSafekeepingPlace4 : BalanceAtSafekeepingPlace
%% SubAccountIdentification3 recursion level 1 with max 1
class SubAccountIdentification3{
    FungibleIndicator IsoYesNoIndicator
    ActivityIndicator IsoYesNoIndicator
}
SubAccountIdentification3 *-- "1..1" IAccountIdentificationFormatChoice : Identification
SubAccountIdentification3 *-- "0..0" AggregateBalanceInformation3 : 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
}
  

AccountingStatementOfHoldings2 members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    AccountingStatementOfHoldingsCancellationV02 --|> IOuterRecord : Implements
    AccountingStatementOfHoldingsCancellationV02Document --|> IOuterDocument~AccountingStatementOfHoldingsCancellationV02~ : Implements
    class IOuterDocument~AccountingStatementOfHoldingsCancellationV02~ {
        AccountingStatementOfHoldingsCancellationV02 Message
     }
  

Document wrapper for serialization

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

classDiagram
    AccountingStatementOfHoldingsCancellationV02Document *-- AccountingStatementOfHoldingsCancellationV02 : 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.02">
    <AcctgStmtOfHldgsCxlV02>
        <MsgId>
            <!-- MessageIdentification inner content -->
        </MsgId>
        <PrvsRef>
            <!-- PreviousReference inner content -->
        </PrvsRef>
        <RltdRef>
            <!-- RelatedReference inner content -->
        </RltdRef>
        <MsgPgntn>
            <!-- MessagePagination inner content -->
        </MsgPgntn>
        <StmtToBeCanc>
            <!-- StatementToBeCancelled inner content -->
        </StmtToBeCanc>
    </AcctgStmtOfHldgsCxlV02>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_McJgvtFSEd-BzquC8wXy7w_-1129601452"
  previousVersion="_MXhfatFSEd-BzquC8wXy7w_-1020688414"
  name="AccountingStatementOfHoldingsCancellationV02"
  definition="Scope&#xD;&#xA;An account servicer, for example, a transfer agent, sends the AccountingStatementofHoldingsCancellation message to the account owner, for example, a fund manager or an account owner's designated agent, to notify the cancellation of a previously sent AccountingStatementOfHoldings message.&#xD;&#xA;Usage&#xD;&#xA;The AccountingStatementOfHoldingsCancellation message is used to cancel a previously sent AccountingStatementOfHoldings message. This message must contain the reference of the message to be cancelled.&#xD;&#xA;This message may also contain all the details of the message to be cancelled, but this is not recommended."
  registrationStatus="Registered"
  messageSet="_wFQdsE2rEeG_I4xRYCA_7g _hijK0WiLEeOuqdLlpUIWBw _qCumkAFwEeu2__1EbNXzuA"
  xmlTag="AcctgStmtOfHldgsCxlV02"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_McSqoNFSEd-BzquC8wXy7w_-312284977"
    name="MessageIdentification"
    definition="Reference that uniquely identifies a message from a business application standpoint."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="MsgId"
    complexType="_Q7pG5Np-Ed-ak6NoX_4Aeg_-967008570" />
  <messageBuildingBlock
    xmi:id="_McSqodFSEd-BzquC8wXy7w_-1129601449"
    name="PreviousReference"
    definition="Reference to a linked message that was previously sent."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PrvsRef"
    complexType="_RNE1Kdp-Ed-ak6NoX_4Aeg_-577369889" />
  <messageBuildingBlock
    xmi:id="_McSqotFSEd-BzquC8wXy7w_-1129601408"
    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="_McSqo9FSEd-BzquC8wXy7w_-1129601090"
    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="_McSqpNFSEd-BzquC8wXy7w_-1129601373"
    name="StatementToBeCancelled"
    definition="The Accounting Statement of Holdings message to cancel."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="StmtToBeCanc"
    complexType="_RPdawtp-Ed-ak6NoX_4Aeg_986842434" />
  <messageDefinitionIdentifier
    businessArea="semt"
    messageFunctionality="005"
    flavour="001"
    version="02" />
</messageDefinition>

ISO Building Blocks

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