CorporateActionCancellationAdvice002V06

seev.039.002.06

Scope An account servicer sends the CorporateActionCancellationAdvice message 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
%% CorporateActionCancellationAdvice002V06 recursion level 0 with max 0
CorporateActionCancellationAdvice002V06 *-- "1..1" CorporateActionCancellation4 : CancellationAdviceGeneralInformation
CorporateActionCancellationAdvice002V06 *-- "1..1" CorporateActionGeneralInformation93 : CorporateActionGeneralInformation
CorporateActionCancellationAdvice002V06 *-- "1..1" IAccountIdentification34Choice : AccountsDetails
CorporateActionCancellationAdvice002V06 *-- "0..1" CorporateAction35 : CorporateActionDetails
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : IssuerAgent
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : PayingAgent
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : SubPayingAgent
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : Registrar
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : ResellingAgent
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : PhysicalSecuritiesAgent
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : DropAgent
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : SolicitationAgent
CorporateActionCancellationAdvice002V06 *-- "0..1" IPartyIdentification104Choice : InformationAgent
CorporateActionCancellationAdvice002V06 *-- "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
%% CorporateActionCancellation4 recursion level 0 with max 1
class CorporateActionCancellation4{
    CancellationReasonCode CorporateActionCancellationReason1Code
    CancellationReason IsoRestrictedFINXMax140Text
}
CorporateActionCancellation4 *-- "1..1" CorporateActionEventStatus1 : ProcessingStatus
%% CorporateActionEventStatus1 recursion level 1 with max 1
class CorporateActionEventStatus1{
    EventCompletenessStatus EventCompletenessStatus1Code
    EventConfirmationStatus EventConfirmationStatus1Code
}
  

CorporateActionCancellation4 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
%% CorporateActionGeneralInformation93 recursion level 0 with max 1
class CorporateActionGeneralInformation93{
    CorporateActionEventIdentification IsoRestrictedFINXMax16Text
    OfficialCorporateActionEventIdentification IsoRestrictedFINXMax16Text
    ClassActionNumber IsoRestrictedFINXMax16Text
}
CorporateActionGeneralInformation93 *-- "1..1" ICorporateActionEventType35Choice : EventType
CorporateActionGeneralInformation93 *-- "1..1" ICorporateActionMandatoryVoluntary4Choice : MandatoryVoluntaryEventType
CorporateActionGeneralInformation93 *-- "1..1" SecurityIdentification20 : FinancialInstrumentIdentification
%% ICorporateActionEventType35Choice recursion level 1 with max 1
%% ICorporateActionMandatoryVoluntary4Choice recursion level 1 with max 1
%% SecurityIdentification20 recursion level 1 with max 1
class SecurityIdentification20{
    ISIN IsoISINOct2015Identifier
    Description IsoRestrictedFINXMax140Text
}
SecurityIdentification20 *-- "0..0" OtherIdentification2 : OtherIdentification
  

CorporateActionGeneralInformation93 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
%% IAccountIdentification34Choice recursion level 0 with max 1
  

AccountIdentification34Choice 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
%% CorporateAction35 recursion level 0 with max 1
CorporateAction35 *-- "0..1" CorporateActionDate50 : DateDetails
CorporateAction35 *-- "0..1" ICorporateActionEventStageFormat15Choice : EventStage
CorporateAction35 *-- "0..1" ILotteryTypeFormat5Choice : LotteryType
%% CorporateActionDate50 recursion level 1 with max 1
CorporateActionDate50 *-- "0..1" IDateFormat34Choice : RecordDate
CorporateActionDate50 *-- "0..1" IDateFormat34Choice : ExDividendDate
%% ICorporateActionEventStageFormat15Choice recursion level 1 with max 1
%% ILotteryTypeFormat5Choice recursion level 1 with max 1
  

CorporateAction35 members

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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice members

ResellingAgent building block

A 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice members

PhysicalSecuritiesAgent building block

A 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice members

DropAgent building block

A trust company, bank or similar financial institution who 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice members

SolicitationAgent building block

A 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

PartyIdentification104Choice members

InformationAgent building block

A 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
%% IPartyIdentification104Choice recursion level 0 with max 1
  

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

classDiagram
    class IOuterRecord
    CorporateActionCancellationAdvice002V06 --|> IOuterRecord : Implements
    CorporateActionCancellationAdvice002V06Document --|> IOuterDocument~CorporateActionCancellationAdvice002V06~ : Implements
    class IOuterDocument~CorporateActionCancellationAdvice002V06~ {
        CorporateActionCancellationAdvice002V06 Message
     }
  

Document wrapper for serialization

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

classDiagram
    CorporateActionCancellationAdvice002V06Document *-- CorporateActionCancellationAdvice002V06 : 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.002.06">
    <CorpActnCxlAdvc>
        <CxlAdvcGnlInf>
            <!-- CancellationAdviceGeneralInformation inner content -->
        </CxlAdvcGnlInf>
        <CorpActnGnlInf>
            <!-- CorporateActionGeneralInformation inner content -->
        </CorpActnGnlInf>
        <AcctsDtls>
            <!-- AccountsDetails inner content -->
        </AcctsDtls>
        <CorpActnDtls>
            <!-- CorporateActionDetails inner content -->
        </CorpActnDtls>
        <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="_cdPz05KQEeWHWpTQn1FFVg"
  nextVersions="_lA9KG5wtEeazcsnODTksnQ"
  name="CorporateActionCancellationAdvice002V06"
  definition="Scope&#xD;&#xA;An account servicer sends the CorporateActionCancellationAdvice message 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),&#xD;&#xA;using the relevant elements in the business application header (BAH)."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="CorpActnCxlAdvc"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_cdPz1ZKQEeWHWpTQn1FFVg"
    name="CancellationAdviceGeneralInformation"
    definition="General information about the event cancellation status and cancellation reason."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CxlAdvcGnlInf"
    complexType="_TdbKmVAeEeO1M--XQMqOtA" />
  <messageBuildingBlock
    xmi:id="_cdPz15KQEeWHWpTQn1FFVg"
    name="CorporateActionGeneralInformation"
    definition="General information about the corporate action event."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CorpActnGnlInf"
    complexType="_cdQbAZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz2ZKQEeWHWpTQn1FFVg"
    name="AccountsDetails"
    definition="General information about the safekeeping account and the account owner."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AcctsDtls"
    complexType="_cdRpC5KQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz25KQEeWHWpTQn1FFVg"
    name="CorporateActionDetails"
    definition="Information about the corporate action event."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CorpActnDtls"
    complexType="_cdSQPZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz3ZKQEeWHWpTQn1FFVg"
    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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz35KQEeWHWpTQn1FFVg"
    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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz4ZKQEeWHWpTQn1FFVg"
    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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz45KQEeWHWpTQn1FFVg"
    name="Registrar"
    definition="Party/agent responsible for maintaining the register of a security."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="Regar"
    complexType="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz5ZKQEeWHWpTQn1FFVg"
    name="ResellingAgent"
    definition="A 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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz55KQEeWHWpTQn1FFVg"
    name="PhysicalSecuritiesAgent"
    definition="A 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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz6ZKQEeWHWpTQn1FFVg"
    name="DropAgent"
    definition="A trust company, bank or similar financial institution who 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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz65KQEeWHWpTQn1FFVg"
    name="SolicitationAgent"
    definition="A 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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz7ZKQEeWHWpTQn1FFVg"
    name="InformationAgent"
    definition="A 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="_cdS3mZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_cdPz75KQEeWHWpTQn1FFVg"
    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="002"
    version="06" />
</messageDefinition>

ISO Building Blocks

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