CorporateActionInstructionCancellationRequest002V12

seev.040.002.12

Scope The CorporateActionInstructionCancellationRequest message is sent by an account owner to an account servicer to request cancellation of a previously sent corporate action election instruction. Usage The message may also be used to:

• re-send a message previously sent (the sub-function of the message is Duplicate),
• provide a third party with a copy of a message for information (the sub-function of the message is Copy),
• re-send to a third party a copy of a message for information (the sub-function of the message is Copy Duplicate), using the relevant elements in the business application header (BAH).

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
%% CorporateActionInstructionCancellationRequest002V12 recursion level 0 with max 0
class CorporateActionInstructionCancellationRequest002V12{
    ChangeInstructionIndicator IsoYesNoIndicator
}
CorporateActionInstructionCancellationRequest002V12 *-- "1..1" DocumentIdentification37 : InstructionIdentification
CorporateActionInstructionCancellationRequest002V12 *-- "1..1" CorporateActionGeneralInformation159 : CorporateActionGeneralInformation
CorporateActionInstructionCancellationRequest002V12 *-- "1..1" AccountIdentification62 : AccountDetails
CorporateActionInstructionCancellationRequest002V12 *-- "1..1" CorporateActionOption202 : CorporateActionInstruction
CorporateActionInstructionCancellationRequest002V12 *-- "0..1" ProtectInstruction7 : ProtectInstruction
CorporateActionInstructionCancellationRequest002V12 *-- "0..1" CorporateActionNarrative19 : AdditionalInformation
CorporateActionInstructionCancellationRequest002V12 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

ChangeInstructionIndicator building block

Indicates that cancelled instruction will be replaced by a new corporate action instruction to be sent later. Indicates a “Yes” or “No” type of answer for an element. For comparison, see the ISO20022 official specification This message is declared as YesNoIndicator in the ISO specification. In our implementation, it is represented in source code as IsoYesNoIndicator. Due to global using directives, it is treated as a System.String by the compiler and runtime.

InstructionIdentification building block

Identification of a previously sent instruction document. Identification of a document and type of link. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% DocumentIdentification37 recursion level 0 with max 1
class DocumentIdentification37{
    Identification IsoRestrictedFINXMax16Text
}
DocumentIdentification37 *-- "0..1" IProcessingPosition10Choice : LinkageType
%% IProcessingPosition10Choice recursion level 1 with max 1
  

DocumentIdentification37 members

CorporateActionGeneralInformation building block

General information about the corporate action event. General information about the corporate action event. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CorporateActionGeneralInformation159 recursion level 0 with max 1
class CorporateActionGeneralInformation159{
    CorporateActionEventIdentification IsoRestrictedFINXMax16Text
    OfficialCorporateActionEventIdentification IsoRestrictedFINXMax16Text
}
CorporateActionGeneralInformation159 *-- "1..1" ICorporateActionEventType103Choice : EventType
CorporateActionGeneralInformation159 *-- "0..1" SecurityIdentification21 : FinancialInstrumentIdentification
%% ICorporateActionEventType103Choice recursion level 1 with max 1
%% SecurityIdentification21 recursion level 1 with max 1
class SecurityIdentification21{
    ISIN IsoISINOct2015Identifier
    Description IsoRestrictedFINXMax140Text
}
SecurityIdentification21 *-- "0..0" OtherIdentification2 : OtherIdentification
  

CorporateActionGeneralInformation159 members

AccountDetails building block

General information about the safekeeping account and the account owner. Provides account identification information. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% AccountIdentification62 recursion level 0 with max 1
class AccountIdentification62{
    SafekeepingAccount IsoRestrictedFINXMax35Text
    BlockChainAddressOrWallet IsoMax140Text
}
AccountIdentification62 *-- "0..1" IPartyIdentification136Choice : AccountOwner
AccountIdentification62 *-- "0..1" ISafekeepingPlaceFormat34Choice : SafekeepingPlace
%% IPartyIdentification136Choice recursion level 1 with max 1
%% ISafekeepingPlaceFormat34Choice recursion level 1 with max 1
  

AccountIdentification62 members

CorporateActionInstruction building block

Information about the corporate action option. Provides information about the corporate action option. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CorporateActionOption202 recursion level 0 with max 1
CorporateActionOption202 *-- "1..1" IOptionNumber1Choice : OptionNumber
CorporateActionOption202 *-- "1..1" ICorporateActionOption43Choice : OptionType
CorporateActionOption202 *-- "1..1" IQuantity55Choice : InstructedQuantity
%% IOptionNumber1Choice recursion level 1 with max 1
%% ICorporateActionOption43Choice recursion level 1 with max 1
%% IQuantity55Choice recursion level 1 with max 1
  

CorporateActionOption202 members

ProtectInstruction building block

Provides detailed information on protect and cover protect instructions. Provides detailed information on protect and cover protect instructions. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% ProtectInstruction7 recursion level 0 with max 1
class ProtectInstruction7{
    TransactionType ProtectTransactionType3Code
    TransactionIdentification IsoRestrictedFINMax15Text
    ProtectDate IsoISODate
}
  

ProtectInstruction7 members

AdditionalInformation building block

Provides additional information. Provides additional information such as the information conditions. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CorporateActionNarrative19 recursion level 0 with max 1
class CorporateActionNarrative19{
    AdditionalText IsoRestrictedFINXMax350Text
    PartyContactNarrative IsoRestrictedFINXMax350Text
}
  

CorporateActionNarrative19 members

SupplementaryData building block

Additional information that can not be captured in the structured fields 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
%% SupplementaryData1 recursion level 0 with max 1
class SupplementaryData1{
    PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
%% IsoSupplementaryDataEnvelope1 recursion level 1 with max 1
  

SupplementaryData1 members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    CorporateActionInstructionCancellationRequest002V12 --|> IOuterRecord : Implements
    CorporateActionInstructionCancellationRequest002V12Document --|> IOuterDocument~CorporateActionInstructionCancellationRequest002V12~ : Implements
    class IOuterDocument~CorporateActionInstructionCancellationRequest002V12~ {
        CorporateActionInstructionCancellationRequest002V12 Message
     }
  

Document wrapper for serialization

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

classDiagram
    CorporateActionInstructionCancellationRequest002V12Document *-- CorporateActionInstructionCancellationRequest002V12 : 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:seev.040.002.12">
    <CorpActnInstrCxlReq>
        <ChngInstrInd>
            <!-- ChangeInstructionIndicator inner content -->
        </ChngInstrInd>
        <InstrId>
            <!-- InstructionIdentification inner content -->
        </InstrId>
        <CorpActnGnlInf>
            <!-- CorporateActionGeneralInformation inner content -->
        </CorpActnGnlInf>
        <AcctDtls>
            <!-- AccountDetails inner content -->
        </AcctDtls>
        <CorpActnInstr>
            <!-- CorporateActionInstruction inner content -->
        </CorpActnInstr>
        <PrtctInstr>
            <!-- ProtectInstruction inner content -->
        </PrtctInstr>
        <AddtlInf>
            <!-- AdditionalInformation inner content -->
        </AddtlInf>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </CorpActnInstrCxlReq>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_PGRLc199Ee262vCSVgjImg"
  previousVersion="_pfHNkzi7Eeydid5dcNPKvg"
  name="CorporateActionInstructionCancellationRequest002V12"
  definition="Scope&#xD;&#xA;The CorporateActionInstructionCancellationRequest message is sent by an account owner to an account servicer to request cancellation of a previously sent corporate action election instruction.&#xD;&#xA;Usage&#xD;&#xA;The message may also be used to:&#xD;&#xA;- re-send a message previously sent (the sub-function of the message is Duplicate),&#xD;&#xA;- provide a third party with a copy of a message for information (the sub-function of the message is Copy),&#xD;&#xA;- re-send to a third party a copy of a message for information (the sub-function of the message is Copy Duplicate), using the relevant elements in the business application header (BAH)."
  registrationStatus="Registered"
  messageSet="_kXAaIKS_EeWiN6v48CBCXg"
  xmlTag="CorpActnInstrCxlReq"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_PGRLdV99Ee262vCSVgjImg"
    name="ChangeInstructionIndicatorGuideline"
    definition="ChangeInstructionIndicator may only be used if CorporateActionOptionDetails/WithdrawalAllowedIndicator was set to 'false' or '0' (No) in the CorporateActionNotification message previously received and if CorporateActionOptionDetails/ChangeAllowedIndicator was set to 'true' or '1' (Yes) in the CorporateActionNotification message previously received."
    registrationStatus="Provisionally Registered" />
  <constraint
    xmi:id="_PGRLd199Ee262vCSVgjImg"
    name="CorporateActionEventIdentificationRule"
    definition="If the CorporateActionInstruction message was unsolicited (that is, this instruction has not been preceded by a CorporateActionNotification), then, CorporateActionGeneralInformation/CorporateActionEventIdentification must be NONREF."
    registrationStatus="Provisionally Registered" />
  <constraint
    xmi:id="_PGRLeV99Ee262vCSVgjImg"
    name="BeneficialOwnerBreakdownRequestRule "
    definition="If CorporateActionInstruction/OptionType/Code value is BOBD (BeneficialOwnerBreakdownRequest), then CorporateActionGeneralInformation/EventType/Code value must be WTRC (Withholding Tax Relief Certification).&#xD;&#xA;(MT565 NVR C8)"
    registrationStatus="Provisionally Registered"
    expression="&lt;RuleDefinition&gt;&lt;ComplexRule xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:type=&quot;ComplexRule&quot;&gt;&lt;mustBe&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/CorporateActionGeneralInformation/EventType/Code&lt;/leftOperand&gt;&lt;rightOperand&gt;WithholdingTaxReliefCertification&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;/mustBe&gt;&lt;onCondition&gt;&lt;connector&gt;AND&lt;/connector&gt;&lt;BooleanRule xsi:type=&quot;EqualToValue&quot;&gt;&lt;leftOperand&gt;/CorporateActionInstruction/OptionType/Code&lt;/leftOperand&gt;&lt;rightOperand&gt;BeneficialOwnerBreakdownRequest&lt;/rightOperand&gt;&lt;/BooleanRule&gt;&lt;/onCondition&gt;&lt;/ComplexRule&gt;&lt;/RuleDefinition&gt;" />
  <messageBuildingBlock
    xmi:id="_PGRLfl99Ee262vCSVgjImg"
    name="ChangeInstructionIndicator"
    definition="Indicates that cancelled instruction will be replaced by a new corporate action instruction to be sent later."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="ChngInstrInd"
    simpleType="_YXbjA9p-Ed-ak6NoX_4Aeg_-2040117978" />
  <messageBuildingBlock
    xmi:id="_PGRLgF99Ee262vCSVgjImg"
    name="InstructionIdentification"
    definition="Identification of a previously sent instruction document."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="InstrId"
    complexType="_chT0l5KQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_PGRLgl99Ee262vCSVgjImg"
    name="CorporateActionGeneralInformation"
    definition="General information about the corporate action event."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CorpActnGnlInf"
    complexType="_eTvQux9QEeuFz_FaCzCLgQ" />
  <messageBuildingBlock
    xmi:id="_PGRLhF99Ee262vCSVgjImg"
    name="AccountDetails"
    definition="General information about the safekeeping account and the account owner."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AcctDtls"
    complexType="_pfH1Ozi7Eeydid5dcNPKvg" />
  <messageBuildingBlock
    xmi:id="_PGRLhl99Ee262vCSVgjImg"
    name="CorporateActionInstruction"
    definition="Information about the corporate action option."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CorpActnInstr"
    complexType="_pfIcITi7Eeydid5dcNPKvg" />
  <messageBuildingBlock
    xmi:id="_PGRLiF99Ee262vCSVgjImg"
    name="ProtectInstruction"
    definition="Provides detailed information on protect and cover protect instructions."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PrtctInstr"
    complexType="_FLSgEf0hEeiKOe8GCUL1Lg" />
  <messageBuildingBlock
    xmi:id="_PGRLil99Ee262vCSVgjImg"
    name="AdditionalInformation"
    definition="Provides additional information."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AddtlInf"
    complexType="_WbKDmNp-Ed-ak6NoX_4Aeg_1685038746" />
  <messageBuildingBlock
    xmi:id="_PGRLjF99Ee262vCSVgjImg"
    name="SupplementaryData"
    definition="Additional information that can not be captured in the structured fields and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SplmtryData"
    complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
  <messageDefinitionIdentifier
    businessArea="seev"
    messageFunctionality="040"
    flavour="002"
    version="12" />
</messageDefinition>

ISO Building Blocks

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