CorporateActionCancellationAdviceV12

seev.039.001.12

Scope The CorporateActionCancellationAdvice message is sent by an account servicer to an account owner or its designated agent to cancel a previously announced corporate action event in case of error from the account servicer or in case of withdrawal by the issuer. 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
%% CorporateActionCancellationAdviceV12 recursion level 0 with max 0
class CorporateActionCancellationAdviceV12{
    AdditionalText IsoMax8000Text
}
CorporateActionCancellationAdviceV12 *-- "1..1" CorporateActionCancellation3 : CancellationAdviceGeneralInformation
CorporateActionCancellationAdviceV12 *-- "1..1" CorporateActionGeneralInformation135 : CorporateActionGeneralInformation
CorporateActionCancellationAdviceV12 *-- "1..1" IAccountIdentification49Choice : AccountsDetails
CorporateActionCancellationAdviceV12 *-- "0..1" CorporateAction72 : CorporateActionDetails
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : IssuerAgent
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : PayingAgent
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : SubPayingAgent
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : Registrar
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : ResellingAgent
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : PhysicalSecuritiesAgent
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : DropAgent
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : SolicitationAgent
CorporateActionCancellationAdviceV12 *-- "0..1" IPartyIdentification120Choice : InformationAgent
CorporateActionCancellationAdviceV12 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

CancellationAdviceGeneralInformation building block

General information about the event cancellation status and cancellation reason. Corporate action event cancellation status and reason. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CorporateActionCancellation3 recursion level 0 with max 1
class CorporateActionCancellation3{
    CancellationReasonCode CorporateActionCancellationReason1Code
    CancellationReason IsoMax140Text
}
CorporateActionCancellation3 *-- "1..1" CorporateActionEventStatus1 : ProcessingStatus
%% CorporateActionEventStatus1 recursion level 1 with max 1
class CorporateActionEventStatus1{
    EventCompletenessStatus EventCompletenessStatus1Code
    EventConfirmationStatus EventConfirmationStatus1Code
}
  

CorporateActionCancellation3 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
%% CorporateActionGeneralInformation135 recursion level 0 with max 1
class CorporateActionGeneralInformation135{
    CorporateActionEventIdentification IsoMax35Text
    OfficialCorporateActionEventIdentification IsoMax35Text
    ClassActionNumber IsoMax35Text
}
CorporateActionGeneralInformation135 *-- "1..1" ICorporateActionEventType84Choice : EventType
CorporateActionGeneralInformation135 *-- "1..1" ICorporateActionMandatoryVoluntary3Choice : MandatoryVoluntaryEventType
CorporateActionGeneralInformation135 *-- "1..1" SecurityIdentification19 : FinancialInstrumentIdentification
%% ICorporateActionEventType84Choice recursion level 1 with max 1
%% ICorporateActionMandatoryVoluntary3Choice recursion level 1 with max 1
%% SecurityIdentification19 recursion level 1 with max 1
class SecurityIdentification19{
    ISIN IsoISINOct2015Identifier
    Description IsoMax140Text
}
SecurityIdentification19 *-- "0..0" OtherIdentification1 : OtherIdentification
  

CorporateActionGeneralInformation135 members

AccountsDetails building block

General information about the safekeeping account and the account owner. Choice between all accounts (GENR - General in ISO 15022) or one or more selected accounts. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IAccountIdentification49Choice recursion level 0 with max 1
  

AccountIdentification49Choice members

CorporateActionDetails building block

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

classDiagram
   direction tb
%% CorporateAction72 recursion level 0 with max 1
CorporateAction72 *-- "0..1" CorporateActionDate86 : DateDetails
CorporateAction72 *-- "0..1" ICorporateActionEventStageFormat14Choice : EventStage
CorporateAction72 *-- "0..0" IAdditionalBusinessProcessFormat15Choice : AdditionalBusinessProcessIndicator
CorporateAction72 *-- "0..1" ILotteryTypeFormat4Choice : LotteryType
%% CorporateActionDate86 recursion level 1 with max 1
CorporateActionDate86 *-- "0..1" IDateFormat30Choice : RecordDate
CorporateActionDate86 *-- "0..1" IDateFormat30Choice : ExDividendDate
%% ICorporateActionEventStageFormat14Choice recursion level 1 with max 1
%% IAdditionalBusinessProcessFormat15Choice recursion level 1 with max 1
%% ILotteryTypeFormat4Choice recursion level 1 with max 1
  

CorporateAction72 members

AdditionalText building block

Provides additional information or specifies in more detail the content of a message. This field may only be used when the information to be transmitted, cannot be coded. Specifies a character string with a maximum length of 8000 characters. For comparison, see the ISO20022 official specification This message is declared as Max8000Text in the ISO specification. In our implementation, it is represented in source code as IsoMax8000Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.

IssuerAgent building block

Party appointed to administer the event on behalf of the issuer company/offeror. The party may be contacted for more information about the event. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

PayingAgent building block

Agent (principal or fiscal paying agent) appointed to execute the payment for the corporate action event on behalf of the issuer company/offeror. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

SubPayingAgent building block

Sub-agent appointed to execute the payment for the corporate action event on behalf of the issuer company/offeror. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

Registrar building block

Party/agent responsible for maintaining the register of a security. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

ResellingAgent building block

Broker-dealer responsible for reselling to new investors securities (usually bonds) that have been tendered for purchase by their owner. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

PhysicalSecuritiesAgent building block

Trust company, bank or similar financial institution assigned by an issuer to accept presentations of instruments, usually bonds, for transfer and or exchange. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

DropAgent building block

Trust company, bank or similar financial institution that acts on behalf of an out-of-town agent or event agent where securities can be delivered in person. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

SolicitationAgent building block

Trust company, bank or similar financial institution assigned by an issuer to maintain records of investors and account balances and transactions for the consent of a material change. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice members

InformationAgent building block

Trust company, bank or similar financial institution assigned by an Issuer to provide information and copies of the offering documentation. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IPartyIdentification120Choice recursion level 0 with max 1
  

PartyIdentification120Choice 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 CorporateActionCancellationAdviceV12 implementation follows a specific implementaiton pattern. First of all, CorporateActionCancellationAdviceV12 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, CorporateActionCancellationAdviceV12Document implements IOuterDocument. Because CorporateActionCancellationAdviceV12 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type CorporateActionCancellationAdviceV12.

classDiagram
    class IOuterRecord
    CorporateActionCancellationAdviceV12 --|> IOuterRecord : Implements
    CorporateActionCancellationAdviceV12Document --|> IOuterDocument~CorporateActionCancellationAdviceV12~ : Implements
    class IOuterDocument~CorporateActionCancellationAdviceV12~ {
        CorporateActionCancellationAdviceV12 Message
     }
  

Document wrapper for serialization

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

classDiagram
    CorporateActionCancellationAdviceV12Document *-- CorporateActionCancellationAdviceV12 : 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.039.001.12">
    <CorpActnCxlAdvc>
        <CxlAdvcGnlInf>
            <!-- CancellationAdviceGeneralInformation inner content -->
        </CxlAdvcGnlInf>
        <CorpActnGnlInf>
            <!-- CorporateActionGeneralInformation inner content -->
        </CorpActnGnlInf>
        <AcctsDtls>
            <!-- AccountsDetails inner content -->
        </AcctsDtls>
        <CorpActnDtls>
            <!-- CorporateActionDetails inner content -->
        </CorpActnDtls>
        <AddtlTxt>
            <!-- AdditionalText inner content -->
        </AddtlTxt>
        <IssrAgt>
            <!-- IssuerAgent inner content -->
        </IssrAgt>
        <PngAgt>
            <!-- PayingAgent inner content -->
        </PngAgt>
        <SubPngAgt>
            <!-- SubPayingAgent inner content -->
        </SubPngAgt>
        <Regar>
            <!-- Registrar inner content -->
        </Regar>
        <RsellngAgt>
            <!-- ResellingAgent inner content -->
        </RsellngAgt>
        <PhysSctiesAgt>
            <!-- PhysicalSecuritiesAgent inner content -->
        </PhysSctiesAgt>
        <DrpAgt>
            <!-- DropAgent inner content -->
        </DrpAgt>
        <SlctnAgt>
            <!-- SolicitationAgent inner content -->
        </SlctnAgt>
        <InfAgt>
            <!-- InformationAgent inner content -->
        </InfAgt>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </CorpActnCxlAdvc>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_V4gsFTN3Ee2Amemf1A0gtA"
  previousVersion="_yg6_8RbHEeyroI8qKgB7Mg"
  name="CorporateActionCancellationAdviceV12"
  definition="Scope&#xD;&#xA;The CorporateActionCancellationAdvice message is sent by an account servicer to an account owner or its designated agent to cancel a previously announced corporate action event in case of error from the account servicer or in case of withdrawal by the issuer.&#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="_fFKlMXbrEeOVgavDmiBLPw"
  xmlTag="CorpActnCxlAdvc"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_V4gsGzN3Ee2Amemf1A0gtA"
    previousVersion="_yg6_9xbHEeyroI8qKgB7Mg"
    name="CancellationAdviceGeneralInformation"
    definition="General information about the event cancellation status and cancellation reason."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CxlAdvcGnlInf"
    complexType="_OgdE4SXaEeOFIcNWlDEvdQ" />
  <messageBuildingBlock
    xmi:id="_V4gsHTN3Ee2Amemf1A0gtA"
    previousVersion="_yg6_-RbHEeyroI8qKgB7Mg"
    name="CorporateActionGeneralInformation"
    definition="General information about the corporate action event."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CorpActnGnlInf"
    complexType="_cOw9geXmEemEj48jhmlA0Q" />
  <messageBuildingBlock
    xmi:id="_V4gsHzN3Ee2Amemf1A0gtA"
    previousVersion="_yg6_-xbHEeyroI8qKgB7Mg"
    name="AccountsDetails"
    definition="General information about the safekeeping account and the account owner."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AcctsDtls"
    complexType="_Uz7o4SLLEeyNSNrMl2zWxg" />
  <messageBuildingBlock
    xmi:id="_V4gsITN3Ee2Amemf1A0gtA"
    previousVersion="_yg6__RbHEeyroI8qKgB7Mg"
    name="CorporateActionDetails"
    definition="Information about the corporate action event."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CorpActnDtls"
    complexType="_EtsbbTQKEe2o-K1dwNg8Gg" />
  <messageBuildingBlock
    xmi:id="_V4gsIzN3Ee2Amemf1A0gtA"
    previousVersion="_yg6__xbHEeyroI8qKgB7Mg"
    name="AdditionalText"
    definition="Provides additional information or specifies in more detail the content of a message. This field may only be used when the information to be transmitted, cannot be coded."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="AddtlTxt"
    simpleType="_YWr8Jdp-Ed-ak6NoX_4Aeg_-1676525626" />
  <messageBuildingBlock
    xmi:id="_V4gsJTN3Ee2Amemf1A0gtA"
    previousVersion="_yg7AARbHEeyroI8qKgB7Mg"
    name="IssuerAgent"
    definition="Party appointed to administer the event on behalf of the issuer company/offeror. The party may be contacted for more information about the event."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="IssrAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsJzN3Ee2Amemf1A0gtA"
    previousVersion="_yg7AAxbHEeyroI8qKgB7Mg"
    name="PayingAgent"
    definition="Agent (principal or fiscal paying agent) appointed to execute the payment for the corporate action event on behalf of the issuer company/offeror."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="PngAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsKTN3Ee2Amemf1A0gtA"
    previousVersion="_yg7ABRbHEeyroI8qKgB7Mg"
    name="SubPayingAgent"
    definition="Sub-agent appointed to execute the payment for the corporate action event on behalf of the issuer company/offeror."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SubPngAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsKzN3Ee2Amemf1A0gtA"
    previousVersion="_yg7ABxbHEeyroI8qKgB7Mg"
    name="Registrar"
    definition="Party/agent responsible for maintaining the register of a security."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="Regar"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsLTN3Ee2Amemf1A0gtA"
    previousVersion="_yg7ACRbHEeyroI8qKgB7Mg"
    name="ResellingAgent"
    definition="Broker-dealer responsible for reselling to new investors securities (usually bonds) that have been tendered for purchase by their owner."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="RsellngAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsLzN3Ee2Amemf1A0gtA"
    previousVersion="_yg7ACxbHEeyroI8qKgB7Mg"
    name="PhysicalSecuritiesAgent"
    definition="Trust company, bank or similar financial institution assigned by an issuer to accept presentations of instruments, usually bonds, for transfer and or exchange."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="PhysSctiesAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsMTN3Ee2Amemf1A0gtA"
    previousVersion="_yg7ADRbHEeyroI8qKgB7Mg"
    name="DropAgent"
    definition="Trust company, bank or similar financial institution that acts on behalf of an out-of-town agent or event agent where securities can be delivered in person."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="DrpAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsMzN3Ee2Amemf1A0gtA"
    previousVersion="_yg7ADxbHEeyroI8qKgB7Mg"
    name="SolicitationAgent"
    definition="Trust company, bank or similar financial institution assigned by an issuer to maintain records of investors and account balances and transactions for the consent of a material change."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SlctnAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsNTN3Ee2Amemf1A0gtA"
    previousVersion="_yg7AERbHEeyroI8qKgB7Mg"
    name="InformationAgent"
    definition="Trust company, bank or similar financial institution assigned by an Issuer to provide information and copies of the offering documentation."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="InfAgt"
    complexType="_Vul5MbpYEeifFaUMRKyMMw" />
  <messageBuildingBlock
    xmi:id="_V4gsNzN3Ee2Amemf1A0gtA"
    previousVersion="_yg7AExbHEeyroI8qKgB7Mg"
    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="039"
    flavour="001"
    version="12" />
</messageDefinition>

ISO Building Blocks

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