RedemptionBulkOrderConfirmationCancellationInstructionV01

setr.053.001.01

Scope An executing party, for example, a transfer agent sends the RedemptionBulkOrderConfirmationCancellationInstruction message to the instructing party, for example, an investment manager or its authorised representative to cancel a previously sent RedemptionBulkOrderConfirmation. Usage The RedemptionBulkOrderConfirmationCancellationInstruction message is used to cancel one or more previously sent subscription order confirmations. The amendment indicator element is used to specify whether the subscription order confirmation cancellation is to be followed by a RedemptionBulkOrderConfirmationAmendment. The RedemptionBulkOrderConfirmationCancellationInstruction message is used to either:

• cancel an entire RedemptionBulkOrderConfirmation message, that is, all the individual order confirmations that it contained, or,
• request the cancellation of one or more individual confirmations. There are two ways to use the message. (1) When the RedemptionBulkOrderConfirmationCancellationInstruction message is used to cancel an entire message, this can be done by either:
• quoting the business references, for example, OrderReference, Deal Reference, of all the individual order confirmations listed in the SubscriptionOrderConfirmation message, or,
• quoting the details of all the individual order confirmations (this includes the OrderReference and DealReference) listed in SubscriptionOrderConfirmation message but this is not recommended. The message identification of the RedemptionBulkOrderConfirmation message may also be quoted in PreviousReference. It is also possible to instruct the cancellation of an entire confirmation message by quoting its message identification in PreviousReference, but this is not recommended. (2) When the RedemptionBulkOrderConfirmationCancellationInstruction message is used to cancel one or more individual order confirmations, this can be done by either:
• quoting the business references, for example, OrderReference, Deal Reference, of each individual order confirmation listed in the RedemptionBulkOrderConfirmation message, or,
• quoting the details of each individual order execution (this includes the OrderReference and DealReference) listed in RedemptionBulkOrderConfirmation message but this is not recommended. The message identification of the RedemptionBulkOrderConfirmation message in which the individual order confirmation was conveyed may also be quoted in PreviousReference.

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
%% RedemptionBulkOrderConfirmationCancellationInstructionV01 recursion level 0 with max 0
RedemptionBulkOrderConfirmationCancellationInstructionV01 *-- "1..1" MessageIdentification1 : MessageIdentification
RedemptionBulkOrderConfirmationCancellationInstructionV01 *-- "0..1" AdditionalReference3 : PoolReference
RedemptionBulkOrderConfirmationCancellationInstructionV01 *-- "0..1" AdditionalReference3 : PreviousReference
RedemptionBulkOrderConfirmationCancellationInstructionV01 *-- "0..1" AdditionalReference3 : RelatedReference
RedemptionBulkOrderConfirmationCancellationInstructionV01 *-- "0..1" InvestmentFundOrderExecution1 : CancellationByReference
RedemptionBulkOrderConfirmationCancellationInstructionV01 *-- "0..1" OrderConfirmationDetails1 : CancellationByOrderConfirmationDetails
RedemptionBulkOrderConfirmationCancellationInstructionV01 *-- "0..1" CopyInformation2 : CopyDetails
  

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

PoolReference building block

Collective reference identifying a set of messages. 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
%% AdditionalReference3 recursion level 0 with max 1
class AdditionalReference3{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference3 *-- "0..1" IPartyIdentification2Choice : ReferenceIssuer
%% IPartyIdentification2Choice recursion level 1 with max 1
  

AdditionalReference3 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
%% AdditionalReference3 recursion level 0 with max 1
class AdditionalReference3{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference3 *-- "0..1" IPartyIdentification2Choice : ReferenceIssuer
%% IPartyIdentification2Choice recursion level 1 with max 1
  

AdditionalReference3 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
%% AdditionalReference3 recursion level 0 with max 1
class AdditionalReference3{
    Reference IsoMax35Text
    MessageName IsoMax35Text
}
AdditionalReference3 *-- "0..1" IPartyIdentification2Choice : ReferenceIssuer
%% IPartyIdentification2Choice recursion level 1 with max 1
  

AdditionalReference3 members

CancellationByReference building block

References of the orders to be cancelled. Reference of an order, deal reference, client reference and master reference. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% InvestmentFundOrderExecution1 recursion level 0 with max 1
class InvestmentFundOrderExecution1{
    MasterReference IsoMax35Text
    AmendmentIndicator IsoYesNoIndicator
}
InvestmentFundOrderExecution1 *-- "1..0" InvestmentFundOrderExecution2 : OrderReferences
%% InvestmentFundOrderExecution2 recursion level 1 with max 1
class InvestmentFundOrderExecution2{
    OrderReference IsoMax35Text
    ClientReference IsoMax35Text
    DealReference IsoMax35Text
}
  

InvestmentFundOrderExecution1 members

CancellationByOrderConfirmationDetails building block

Common information related to all the orders to be cancelled. Order confirmation details. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% OrderConfirmationDetails1 recursion level 0 with max 1
class OrderConfirmationDetails1{
    AmendmentIndicator IsoYesNoIndicator
}
OrderConfirmationDetails1 *-- "1..1" RedemptionBulkExecution3 : BulkExecutionDetails
OrderConfirmationDetails1 *-- "0..10" Intermediary9 : RelatedPartyDetails
OrderConfirmationDetails1 *-- "0..0" Extension1 : Extension
%% RedemptionBulkExecution3 recursion level 1 with max 1
class RedemptionBulkExecution3{
    MasterReference IsoMax35Text
    OrderDateTime IsoISODateTime
    RequestedFutureTradeDate IsoISODate
    CancellationRight CancellationRight1Code
    ExtendedCancellationRight IsoExtended350Code
    RequestedSettlementCurrency ActiveCurrencyCode
    RequestedNAVCurrency ActiveOrHistoricCurrencyCode
    TotalSettlementAmount IsoActiveCurrencyAndAmount
    CashSettlementDate IsoISODate
}
RedemptionBulkExecution3 *-- "0..1" IPlaceOfTradeIdentification1Choice : PlaceOfTrade
RedemptionBulkExecution3 *-- "1..1" FinancialInstrument10 : FinancialInstrumentDetails
RedemptionBulkExecution3 *-- "1..0" RedemptionExecution5 : IndividualExecutionDetails
RedemptionBulkExecution3 *-- "0..1" PaymentTransaction22 : BulkCashSettlementDetails
%% Intermediary9 recursion level 1 with max 1
class Intermediary9{
    OrderOriginatorEligibility OrderOriginatorEligibility1Code
    TradingPartyCapacity TradingCapacity2Code
    Role InvestmentFundRole2Code
    ExtendedRole IsoExtended350Code
}
Intermediary9 *-- "1..1" IPartyIdentification2Choice : Identification
Intermediary9 *-- "0..1" Account7 : Account
%% Extension1 recursion level 1 with max 1
class Extension1{
    PlaceAndName IsoMax350Text
    Text IsoMax350Text
}
  

OrderConfirmationDetails1 members

CopyDetails building block

Information provided when the message is a copy of a previous message. Information provided when the message is a copy of a previous message. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CopyInformation2 recursion level 0 with max 1
class CopyInformation2{
    CopyIndicator IsoYesNoIndicator
}
CopyInformation2 *-- "0..1" BICIdentification1 : OriginalReceiver
%% BICIdentification1 recursion level 1 with max 1
class BICIdentification1{
    BIC IsoBICIdentifier
}
  

CopyInformation2 members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    RedemptionBulkOrderConfirmationCancellationInstructionV01 --|> IOuterRecord : Implements
    RedemptionBulkOrderConfirmationCancellationInstructionV01Document --|> IOuterDocument~RedemptionBulkOrderConfirmationCancellationInstructionV01~ : Implements
    class IOuterDocument~RedemptionBulkOrderConfirmationCancellationInstructionV01~ {
        RedemptionBulkOrderConfirmationCancellationInstructionV01 Message
     }
  

Document wrapper for serialization

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

classDiagram
    RedemptionBulkOrderConfirmationCancellationInstructionV01Document *-- RedemptionBulkOrderConfirmationCancellationInstructionV01 : 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:setr.053.001.01">
    <RedBlkOrdrConfCxlInstrV01>
        <MsgId>
            <!-- MessageIdentification inner content -->
        </MsgId>
        <PoolRef>
            <!-- PoolReference inner content -->
        </PoolRef>
        <PrvsRef>
            <!-- PreviousReference inner content -->
        </PrvsRef>
        <RltdRef>
            <!-- RelatedReference inner content -->
        </RltdRef>
        <CxlByRef>
            <!-- CancellationByReference inner content -->
        </CxlByRef>
        <CxlByOrdrConfDtls>
            <!-- CancellationByOrderConfirmationDetails inner content -->
        </CxlByOrdrConfDtls>
        <CpyDtls>
            <!-- CopyDetails inner content -->
        </CpyDtls>
    </RedBlkOrdrConfCxlInstrV01>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_olRmCNE7Ed-BzquC8wXy7w_-462737877"
  nextVersions="_Aab73zbLEead9bDRE_1DAQ"
  name="RedemptionBulkOrderConfirmationCancellationInstructionV01"
  definition="Scope&#xD;&#xA;An executing party, for example, a transfer agent sends the RedemptionBulkOrderConfirmationCancellationInstruction message to the instructing party, for example, an investment manager or its authorised representative to cancel a previously sent RedemptionBulkOrderConfirmation.&#xD;&#xA;Usage&#xD;&#xA;The RedemptionBulkOrderConfirmationCancellationInstruction message is used to cancel one or more previously sent subscription order confirmations. The amendment indicator element is used to specify whether the subscription order confirmation cancellation is to be followed by a RedemptionBulkOrderConfirmationAmendment.&#xD;&#xA;The RedemptionBulkOrderConfirmationCancellationInstruction message is used to either:&#xD;&#xA;- cancel an entire RedemptionBulkOrderConfirmation message, that is, all the individual order confirmations that it contained, or,&#xD;&#xA;- request the cancellation of one or more individual confirmations.&#xD;&#xA;There are two ways to use the message.&#xD;&#xA;(1) When the RedemptionBulkOrderConfirmationCancellationInstruction message is used to cancel an entire message, this can be done by either:&#xD;&#xA;- quoting the business references, for example, OrderReference, Deal Reference, of all the individual order confirmations listed in the SubscriptionOrderConfirmation message, or,&#xD;&#xA;- quoting the details of all the individual order confirmations (this includes the OrderReference and DealReference) listed in SubscriptionOrderConfirmation message but this is not recommended.&#xD;&#xA;The message identification of the RedemptionBulkOrderConfirmation message may also be quoted in PreviousReference.&#xD;&#xA;It is also possible to instruct the cancellation of an entire confirmation message by quoting its message identification in PreviousReference, but this is not recommended.&#xD;&#xA;(2) When the RedemptionBulkOrderConfirmationCancellationInstruction message is used to cancel one or more individual order confirmations, this can be done by either:&#xD;&#xA;- quoting the business references, for example, OrderReference, Deal Reference, of each individual order confirmation listed in the RedemptionBulkOrderConfirmation message, or,&#xD;&#xA;- quoting the details of each individual order execution (this includes the OrderReference and DealReference) listed in RedemptionBulkOrderConfirmation message but this is not recommended.&#xD;&#xA;The message identification of the RedemptionBulkOrderConfirmation message in which the individual order confirmation was conveyed may also be quoted in PreviousReference."
  registrationStatus="Registered"
  messageSet="_wFQdsE2rEeG_I4xRYCA_7g"
  xmlTag="RedBlkOrdrConfCxlInstrV01"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_olbXB9E7Ed-BzquC8wXy7w_-86118132"
    name="AccountIdentificationRule"
    definition="If the confirmation message was linked to an account opening request and the account identification is not yet known then the value of the AccountIdentification element in CancellationByOrderConfirmationDetails/MultipleExecutionDetails/InvestmentAccountDetails must be UNKNOWN if present."
    registrationStatus="Provisionally Registered" />
  <xors
    xmi:id="_olkg8tE7Ed-BzquC8wXy7w_-86118097"
    name="CancellationByReferenceOrByOrderConfirmationDetailsRule"
    definition="Either CancellationByOrderConfirmationDetails or CancellationByReference may be present, but not both."
    registrationStatus="Provisionally Registered"
    impactedMessageBuildingBlocks="_olbXBNE7Ed-BzquC8wXy7w_-1901759113 _olbXBdE7Ed-BzquC8wXy7w_-1902682541" />
  <messageBuildingBlock
    xmi:id="_olbXANE7Ed-BzquC8wXy7w_2135542440"
    nextVersions="_Aab75TbLEead9bDRE_1DAQ"
    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="_olbXAdE7Ed-BzquC8wXy7w_2133696982"
    nextVersions="_Aab75zbLEead9bDRE_1DAQ"
    name="PoolReference"
    definition="Collective reference identifying a set of messages."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PoolRef"
    complexType="_Q6vvAdp-Ed-ak6NoX_4Aeg_2101402955" />
  <messageBuildingBlock
    xmi:id="_olbXAtE7Ed-BzquC8wXy7w_2133698531"
    nextVersions="_Aab76TbLEead9bDRE_1DAQ"
    name="PreviousReference"
    definition="Reference to a linked message that was previously sent."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="PrvsRef"
    complexType="_Q6vvAdp-Ed-ak6NoX_4Aeg_2101402955" />
  <messageBuildingBlock
    xmi:id="_olbXA9E7Ed-BzquC8wXy7w_2133697852"
    nextVersions="_Aab76zbLEead9bDRE_1DAQ"
    name="RelatedReference"
    definition="Reference to a linked message that was previously received."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="RltdRef"
    complexType="_Q6vvAdp-Ed-ak6NoX_4Aeg_2101402955" />
  <messageBuildingBlock
    xmi:id="_olbXBNE7Ed-BzquC8wXy7w_-1901759113"
    name="CancellationByReference"
    definition="References of the orders to be cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CxlByRef"
    complexType="_R60r-dp-Ed-ak6NoX_4Aeg_-571676430" />
  <messageBuildingBlock
    xmi:id="_olbXBdE7Ed-BzquC8wXy7w_-1902682541"
    name="CancellationByOrderConfirmationDetails"
    definition="Common information related to all the orders to be cancelled."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CxlByOrdrConfDtls"
    complexType="_RPAu1Np-Ed-ak6NoX_4Aeg_2133695541" />
  <messageBuildingBlock
    xmi:id="_olbXBtE7Ed-BzquC8wXy7w_2134620072"
    nextVersions="_Aab78TbLEead9bDRE_1DAQ"
    name="CopyDetails"
    definition="Information provided when the message is a copy of a previous message."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CpyDtls"
    complexType="_Q7Vk4tp-Ed-ak6NoX_4Aeg_-1918092012" />
  <messageDefinitionIdentifier
    businessArea="setr"
    messageFunctionality="053"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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