AgentCADeactivationStatusAdviceV01

seev.030.001.01

Scope This message is sent by a CSD to an issuer (or its agent) to report the status, or a change in status, of a corporate action deactivation instruction or the status of a deactivation cancellation request. Usage This message is used to provide a status on the deactivation instruction, especially to confirm the deactivation of a Corporate Action event or option.

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
%% AgentCADeactivationStatusAdviceV01 recursion level 0 with max 0
AgentCADeactivationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : Identification
AgentCADeactivationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : AgentCADeactivationInstructionIdentification
AgentCADeactivationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : AgentCADeactivationCancellationRequestIdentification
AgentCADeactivationStatusAdviceV01 *-- "1..1" CorporateActionInformation1 : CorporateActionGeneralInformation
AgentCADeactivationStatusAdviceV01 *-- "1..1" CorporateActionDeactivationInstructionStatus1 : DeactivationInstructionStatus
AgentCADeactivationStatusAdviceV01 *-- "1..1" ICorporateActionDeactivationCancellationStatus1Choice : DeactivationCancellationRequestStatus
  

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

Identification building block

Identification assigned by the Sender to unambiguously identify the status advice. Identifies the document by providing a unique identification and optionally the date/time of the creation of the document. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% DocumentIdentification8 recursion level 0 with max 1
class DocumentIdentification8{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

DocumentIdentification8 members

AgentCADeactivationInstructionIdentification building block

Identification of the linked Agent CA Deactivation Instruction for which a status is given. Identifies the document by providing a unique identification and optionally the date/time of the creation of the document. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% DocumentIdentification8 recursion level 0 with max 1
class DocumentIdentification8{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

DocumentIdentification8 members

AgentCADeactivationCancellationRequestIdentification building block

Identification of the linked Agent CA Deactivation Cancellation Request for which a status is given. Identifies the document by providing a unique identification and optionally the date/time of the creation of the document. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% DocumentIdentification8 recursion level 0 with max 1
class DocumentIdentification8{
    Identification IsoMax35Text
    CreationDateTime IsoISODateTime
}
  

DocumentIdentification8 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
%% CorporateActionInformation1 recursion level 0 with max 1
class CorporateActionInformation1{
    IssuerCorporateActionIdentification IsoMax35Text
    CorporateActionProcessingIdentification IsoMax35Text
}
CorporateActionInformation1 *-- "1..1" IPartyIdentification2Choice : AgentIdentification
CorporateActionInformation1 *-- "1..1" ICorporateActionEventType2FormatChoice : EventType
CorporateActionInformation1 *-- "1..1" ICorporateActionMandatoryVoluntary1FormatChoice : MandatoryVoluntaryEventType
CorporateActionInformation1 *-- "0..1" ICorporateActionEventProcessingType1FormatChoice : EventProcessingType
CorporateActionInformation1 *-- "1..1" FinancialInstrumentDescription3 : UnderlyingSecurity
%% IPartyIdentification2Choice recursion level 1 with max 1
%% ICorporateActionEventType2FormatChoice recursion level 1 with max 1
%% ICorporateActionMandatoryVoluntary1FormatChoice recursion level 1 with max 1
%% ICorporateActionEventProcessingType1FormatChoice recursion level 1 with max 1
%% FinancialInstrumentDescription3 recursion level 1 with max 1
class FinancialInstrumentDescription3{
    PlaceOfListing IsoMICIdentifier
}
FinancialInstrumentDescription3 *-- "1..1" SecurityIdentification7 : SecurityIdentification
FinancialInstrumentDescription3 *-- "0..1" IPartyIdentification2Choice : SafekeepingPlace
  

CorporateActionInformation1 members

DeactivationInstructionStatus building block

Status of the deactivation instruction sent by the issuer (agent). Provides status of the deactivation instruction. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% CorporateActionDeactivationInstructionStatus1 recursion level 0 with max 1
class CorporateActionDeactivationInstructionStatus1{
    OptionNumber IsoExact3NumericText
}
CorporateActionDeactivationInstructionStatus1 *-- "0..1" ICorporateActionOption1FormatChoice : OptionType
CorporateActionDeactivationInstructionStatus1 *-- "1..1" CorporateActionDeactivationInstructionProcessingStatus1 : ProcessedStatus
CorporateActionDeactivationInstructionStatus1 *-- "1..1" CorporateActionDeactivationInstructionRejectionStatus1 : RejectedStatus
%% ICorporateActionOption1FormatChoice recursion level 1 with max 1
%% CorporateActionDeactivationInstructionProcessingStatus1 recursion level 1 with max 1
class CorporateActionDeactivationInstructionProcessingStatus1{
    AdditionalInformation IsoMax350Text
}
CorporateActionDeactivationInstructionProcessingStatus1 *-- "1..1" IProcessedStatus6FormatChoice : Status
%% CorporateActionDeactivationInstructionRejectionStatus1 recursion level 1 with max 1
class CorporateActionDeactivationInstructionRejectionStatus1{
    AdditionalInformation IsoMax350Text
}
CorporateActionDeactivationInstructionRejectionStatus1 *-- "1..0" IRejectionReason12FormatChoice : Reason
  

CorporateActionDeactivationInstructionStatus1 members

DeactivationCancellationRequestStatus building block

Status of the deactivation cancellation request sent by the issuer (agent). Choice between the different statuses of a deactivation cancellation request. For comparison, see the ISO20022 official specification

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

CorporateActionDeactivationCancellationStatus1Choice members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    AgentCADeactivationStatusAdviceV01 --|> IOuterRecord : Implements
    AgentCADeactivationStatusAdviceV01Document --|> IOuterDocument~AgentCADeactivationStatusAdviceV01~ : Implements
    class IOuterDocument~AgentCADeactivationStatusAdviceV01~ {
        AgentCADeactivationStatusAdviceV01 Message
     }
  

Document wrapper for serialization

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

classDiagram
    AgentCADeactivationStatusAdviceV01Document *-- AgentCADeactivationStatusAdviceV01 : 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.030.001.01">
    <AgtCADeactvtnStsAdvc>
        <Id>
            <!-- Identification inner content -->
        </Id>
        <AgtCADeactvtnInstrId>
            <!-- AgentCADeactivationInstructionIdentification inner content -->
        </AgtCADeactvtnInstrId>
        <AgtCADeactvtnCxlReqId>
            <!-- AgentCADeactivationCancellationRequestIdentification inner content -->
        </AgtCADeactvtnCxlReqId>
        <CorpActnGnlInf>
            <!-- CorporateActionGeneralInformation inner content -->
        </CorpActnGnlInf>
        <DeactvtnInstrSts>
            <!-- DeactivationInstructionStatus inner content -->
        </DeactvtnInstrSts>
        <DeactvtnCxlReqSts>
            <!-- DeactivationCancellationRequestStatus inner content -->
        </DeactvtnCxlReqSts>
    </AgtCADeactvtnStsAdvc>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_TMQbDNEwEd-BzquC8wXy7w_622567227"
  name="AgentCADeactivationStatusAdviceV01"
  definition="Scope&#xD;&#xA;This message is sent by a CSD to an issuer (or its agent) to report the status, or a change in status, of a corporate action deactivation instruction or the status of a deactivation cancellation request.&#xD;&#xA;Usage&#xD;&#xA;This message is used to provide a status on the deactivation instruction, especially to confirm the deactivation of a Corporate Action event or option."
  registrationStatus="Registered"
  messageSet="_wRe70k2rEeG_I4xRYCA_7g"
  xmlTag="AgtCADeactvtnStsAdvc"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <constraint
    xmi:id="_TMaMC9EwEd-BzquC8wXy7w_1282795821"
    name="DeactivationInstructionStatusRule"
    definition="If AgentCADeactivationInstructionIdentification is present, then at least one occurrence of DeactivationInstructionStatus must be present."
    registrationStatus="Provisionally Registered" />
  <constraint
    xmi:id="_TMj9AtEwEd-BzquC8wXy7w_1681754170"
    name="DeactivationCancellationRequestStatusRule"
    definition="If AgentCADeactivationCancellationRequestIdentification is present, then DeactivationCancellationRequestStatus must be present."
    registrationStatus="Provisionally Registered" />
  <xors
    xmi:id="_TMaMBdEwEd-BzquC8wXy7w_-1041642643"
    name="DeactivationInstructionIDOrDeactivationCancellationRequestIDRule"
    definition="Either AgentCADeactivationInstructionIdentification or AgentCADeactivationCancellationRequestIdentification must be present."
    registrationStatus="Provisionally Registered"
    impactedMessageBuildingBlocks="_TMaMANEwEd-BzquC8wXy7w_-214470974 _TMaMAdEwEd-BzquC8wXy7w_965193756" />
  <xors
    xmi:id="_TMaMCNEwEd-BzquC8wXy7w_905075265"
    name="DeactivationInstructionStatusOrDeactivationCancellationRequestStatusRule"
    definition="Either DeactivationInstructionStatus or DeactivationCancellationRequestStatus must be present."
    registrationStatus="Provisionally Registered"
    impactedMessageBuildingBlocks="_TMaMA9EwEd-BzquC8wXy7w_861232790 _TMaMBNEwEd-BzquC8wXy7w_1319300008" />
  <messageBuildingBlock
    xmi:id="_TMQbDdEwEd-BzquC8wXy7w_-540475327"
    name="Identification"
    definition="Identification assigned by the Sender to unambiguously identify the status advice."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="Id"
    complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
  <messageBuildingBlock
    xmi:id="_TMaMANEwEd-BzquC8wXy7w_-214470974"
    name="AgentCADeactivationInstructionIdentification"
    definition="Identification of the linked Agent CA Deactivation Instruction for which a status is given."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AgtCADeactvtnInstrId"
    complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
  <messageBuildingBlock
    xmi:id="_TMaMAdEwEd-BzquC8wXy7w_965193756"
    name="AgentCADeactivationCancellationRequestIdentification"
    definition="Identification of the linked Agent CA Deactivation Cancellation Request for which a status is given."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AgtCADeactvtnCxlReqId"
    complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
  <messageBuildingBlock
    xmi:id="_TMaMAtEwEd-BzquC8wXy7w_-1294066154"
    name="CorporateActionGeneralInformation"
    definition="General information about the corporate action event."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="CorpActnGnlInf"
    complexType="_TdxFY9p-Ed-ak6NoX_4Aeg_1155832018" />
  <messageBuildingBlock
    xmi:id="_TMaMA9EwEd-BzquC8wXy7w_861232790"
    name="DeactivationInstructionStatus"
    definition="Status of the deactivation instruction sent by the issuer (agent)."
    registrationStatus="Provisionally Registered"
    minOccurs="1"
    xmlTag="DeactvtnInstrSts"
    complexType="_RjRuptp-Ed-ak6NoX_4Aeg_491823442" />
  <messageBuildingBlock
    xmi:id="_TMaMBNEwEd-BzquC8wXy7w_1319300008"
    name="DeactivationCancellationRequestStatus"
    definition="Status of the deactivation cancellation request sent by the issuer (agent)."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="DeactvtnCxlReqSts"
    complexType="_RiYWwNp-Ed-ak6NoX_4Aeg_1248187111" />
  <messageDefinitionIdentifier
    businessArea="seev"
    messageFunctionality="030"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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