sese.038.002.09
Scope The SecuritiesSettlementTransactionModificationRequest is sent by an account owner to an account servicer.
The account owner will generally be:
- a central securities depository participant which has an account with a central securities depository or a market infrastructure
- an investment manager which has an account with a custodian acting as accounting and/or settlement agent.
It is used to request the modification of non core business data (matching or non-matching) information in a pending or settled instruction. It can also be used for the enrichment of an incomplete transaction.
Usage The modification must only contain the data to be modified. The message may also be used to:
- re-send a message sent by the account owner to the account servicer,
- provide a third party with a copy of a message being sent by the account owner for information,
- re-send to a third party a copy of a message being sent by the account owner for information using the relevant elements in the Business Application Header.
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 %% SecuritiesSettlementTransactionModificationRequest002V09 recursion level 0 with max 0 SecuritiesSettlementTransactionModificationRequest002V09 *-- "1..1" TransactionDetails159 : ModifiedTransactionDetails SecuritiesSettlementTransactionModificationRequest002V09 *-- "1..3" IUpdateType38Choice : UpdateType
Now, we will zero-in one-by-one on each of these building blocks.
ModifiedTransactionDetails building block
Identifies the details of the transaction that is being modified. Identifies the details of the transaction. For comparison, see the ISO20022 official specification
classDiagram direction tb %% TransactionDetails159 recursion level 0 with max 1 class TransactionDetails159{ AccountServicerTransactionIdentification IsoRestrictedFINXMax16Text MarketInfrastructureTransactionIdentification IsoRestrictedFINXMax16Text ProcessorTransactionIdentification IsoRestrictedFINXMax16Text OtherTransactionIdentification IsoRestrictedFINXMax16Text } TransactionDetails159 *-- "1..1" SettlementTypeAndIdentification22 : AccountOwnerTransactionIdentification TransactionDetails159 *-- "0..1" PartyIdentification156 : AccountOwner TransactionDetails159 *-- "0..1" SecuritiesAccount30 : SafekeepingAccount TransactionDetails159 *-- "0..1" BlockChainAddressWallet7 : BlockChainAddressOrWallet TransactionDetails159 *-- "0..1" TransactionDetails160 : TransactionDetails %% SettlementTypeAndIdentification22 recursion level 1 with max 1 class SettlementTypeAndIdentification22{ TransactionIdentification IsoRestrictedFINXMax16Text SecuritiesMovementType ReceiveDelivery1Code Payment DeliveryReceiptType2Code } %% PartyIdentification156 recursion level 1 with max 1 class PartyIdentification156{ LEI IsoLEIIdentifier } PartyIdentification156 *-- "1..1" IPartyIdentification136Choice : Identification %% SecuritiesAccount30 recursion level 1 with max 1 class SecuritiesAccount30{ Identification IsoRestrictedFINXMax35Text Name IsoMax70Text } SecuritiesAccount30 *-- "0..1" GenericIdentification47 : Type %% BlockChainAddressWallet7 recursion level 1 with max 1 class BlockChainAddressWallet7{ Identification IsoRestrictedFINXMax140Text Name IsoRestrictedFINXMax70Text } BlockChainAddressWallet7 *-- "0..1" GenericIdentification47 : Type %% TransactionDetails160 recursion level 1 with max 1 TransactionDetails160 *-- "1..1" SecurityIdentification20 : FinancialInstrumentIdentification TransactionDetails160 *-- "0..1" ITradeDate9Choice : TradeDate TransactionDetails160 *-- "1..1" ISettlementDate20Choice : SettlementDate TransactionDetails160 *-- "1..1" IQuantity54Choice : SettlementQuantity TransactionDetails160 *-- "0..1" AmountAndDirection67 : SettlementAmount TransactionDetails160 *-- "0..1" SettlementParties109 : DeliveringSettlementParties TransactionDetails160 *-- "0..1" SettlementParties109 : ReceivingSettlementParties TransactionDetails160 *-- "0..1" PartyIdentification170 : Investor
TransactionDetails159 members
Member name | Description | Data Type / Multiplicity |
---|---|---|
AccountOwnerTransactionIdentification | Unambiguous identification of the transaction as known by the account owner (or the instructing party managing the account). | SettlementTypeAndIdentification22 - Required 1..1 |
AccountServicerTransactionIdentification | Unambiguous identification of the transaction as known by the account servicer. | IsoRestrictedFINXMax16Text - Optional 0..1 |
MarketInfrastructureTransactionIdentification | Identification of a transaction assigned by a market infrastructure other than a central securities depository, for example, Target2-Securities. | IsoRestrictedFINXMax16Text - Optional 0..1 |
ProcessorTransactionIdentification | Identification of the transaction assigned by the processor of the instruction other than the account owner, the account servicer and the market infrastructure. | IsoRestrictedFINXMax16Text - Optional 0..1 |
OtherTransactionIdentification | Identification of a transaction that cannot be identified using a standard reference element present in the message. | IsoRestrictedFINXMax16Text - Optional 0..1 |
AccountOwner | Party that legally owns the account. | PartyIdentification156 - Optional 0..1 |
SafekeepingAccount | Account to or from which a securities entry is made. | SecuritiesAccount30 - Optional 0..1 |
BlockChainAddressOrWallet | Blockchain address or wallet where digital assets are maintained. This is the equivalent of safekeeping account for digital assets. | BlockChainAddressWallet7 - Optional 0..1 |
TransactionDetails | Provides additional details on the transaction which can not be included within the structured fields of the message. | TransactionDetails160 - Optional 0..1 |
UpdateType building block
Specifies the type of update requested. Specifies the type of update requested. That is addition, deletion or modification. For comparison, see the ISO20022 official specification
classDiagram direction tb %% IUpdateType38Choice recursion level 0 with max 1
UpdateType38Choice members
Member name | Description | Data Type / Multiplicity |
---|
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the SecuritiesSettlementTransactionModificationRequest002V09 implementation follows a specific implementaiton pattern. First of all, SecuritiesSettlementTransactionModificationRequest002V09 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, SecuritiesSettlementTransactionModificationRequest002V09Document implements IOuterDocument. Because SecuritiesSettlementTransactionModificationRequest002V09 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type SecuritiesSettlementTransactionModificationRequest002V09.
classDiagram class IOuterRecord SecuritiesSettlementTransactionModificationRequest002V09 --|> IOuterRecord : Implements SecuritiesSettlementTransactionModificationRequest002V09Document --|> IOuterDocument~SecuritiesSettlementTransactionModificationRequest002V09~ : Implements class IOuterDocument~SecuritiesSettlementTransactionModificationRequest002V09~ { SecuritiesSettlementTransactionModificationRequest002V09 Message }
Document wrapper for serialization
The only real purpose SecuritiesSettlementTransactionModificationRequest002V09Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:sese.038.002.09’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using SecuritiesSettlementTransactionModificationRequest002V09.ToDocument() method. The returned SecuritiesSettlementTransactionModificationRequest002V09Document value will serialize correctly according to ISO 20022 standards.
classDiagram SecuritiesSettlementTransactionModificationRequest002V09Document *-- SecuritiesSettlementTransactionModificationRequest002V09 : Document
Sample of message format
This is an abbreviated version of what the message should look like.
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:sese.038.002.09">
<SctiesSttlmTxModReq>
<ModfdTxDtls>
<!-- ModifiedTransactionDetails inner content -->
</ModfdTxDtls>
<UpdTp>
<!-- UpdateType inner content -->
</UpdTp>
</SctiesSttlmTxModReq>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_eZPP4zi8Eeydid5dcNPKvg"
previousVersion="_a71xkyAdEeuyDZ-ukt4YRg"
name="SecuritiesSettlementTransactionModificationRequest002V09"
definition="Scope
The SecuritiesSettlementTransactionModificationRequest is sent by an account owner to an account servicer. 

The account owner will generally be:
- a central securities depository participant which has an account with a central securities depository or a market infrastructure
- an investment manager which has an account with a custodian acting as accounting and/or settlement agent.

It is used to request the modification of non core business data (matching or non-matching) information in a pending or settled instruction. It can also be used for the enrichment of an incomplete transaction.

Usage
The modification must only contain the data to be modified.
The message may also be used to:
- re-send a message sent by the account owner to the account servicer,
- provide a third party with a copy of a message being sent by the account owner for information,
- re-send to a third party a copy of a message being sent by the account owner for information using the relevant elements in the Business Application Header."
registrationStatus="Registered"
messageSet="_KoChkKS_EeWiN6v48CBCXg _26G2kVI3EeyUbfjRDFS84A"
xmlTag="SctiesSttlmTxModReq"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_eZPP5Ti8Eeydid5dcNPKvg"
name="PhysicalInstructionDetailsUsageRule"
definition="AdditionalPhysicalOrRegistrationDetails can only be used with free of payment instructions."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_eZPP5zi8Eeydid5dcNPKvg"
name="SecuritiesFinancingSettlementUsageRule"
definition="In the framework of Securities Financing (repo, reverse repo, securities lending, securities borrowing), the SettlementInstruction can only be used for the plain vanilla settlement of the opening leg and closing leg."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_eZPP6Ti8Eeydid5dcNPKvg"
name="LinkagesUsageRule"
definition="The linkages can only be used when modifying the Paired or Turned Quantity. For the changes of linking and unlinking messages this must be done with the SecuritiesSettlementConditionsModificationRequest."
registrationStatus="Provisionally Registered" />
<messageBuildingBlock
xmi:id="_eZPP7ji8Eeydid5dcNPKvg"
name="ModifiedTransactionDetails"
definition="Identifies the details of the transaction that is being modified."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="ModfdTxDtls"
complexType="_eZPP9Di8Eeydid5dcNPKvg" />
<messageBuildingBlock
xmi:id="_eZPP8Di8Eeydid5dcNPKvg"
name="UpdateType"
definition="Specifies the type of update requested."
registrationStatus="Provisionally Registered"
maxOccurs="3"
minOccurs="1"
xmlTag="UpdTp"
complexType="_eZThlTi8Eeydid5dcNPKvg" />
<messageDefinitionIdentifier
businessArea="sese"
messageFunctionality="038"
flavour="002"
version="09" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.