ShareholdersIdentificationDisclosureRequestCancellationAdviceV01

seev.046.001.01

The ShareholdersIdentificationDisclosureCancellationAdvice message is sent by an issuer or by a third party nominated by the issuer (such as an issuer’s agent) to the first intermediaries in a custody chain or is sent by any intermediaries in a custody chain to the next intermediary down the chain of intermediaries (towards the investor side of the chain) in order to withdraw/cancel the disclosure request of shareholders identity previously sent.

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
%% ShareholdersIdentificationDisclosureRequestCancellationAdviceV01 recursion level 0 with max 0
class ShareholdersIdentificationDisclosureRequestCancellationAdviceV01{
    CancellationReason DisclosureRequestCancellationReason1Code
}
ShareholdersIdentificationDisclosureRequestCancellationAdviceV01 *-- "1..1" DisclosureRequestIdentification1 : IssuerDisclosureRequestReference
ShareholdersIdentificationDisclosureRequestCancellationAdviceV01 *-- "0..1" IPartyIdentification129Choice : Issuer
ShareholdersIdentificationDisclosureRequestCancellationAdviceV01 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

IssuerDisclosureRequestReference building block

Official and unique identification assigned to a shareholders identification disclosure request process by the issuer or third party nominated by it and for which a response is sent. Information identifying the disclosure request for shareholders identification published by the issuer or third party nominated by the issuer in order to receive the disclosure responses from intermediaries in the custody chain. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% DisclosureRequestIdentification1 recursion level 0 with max 1
class DisclosureRequestIdentification1{
    IssuerDisclosureRequestIdentification IsoMax35Text
}
DisclosureRequestIdentification1 *-- "1..1" SecurityIdentification19 : FinancialInstrumentIdentification
DisclosureRequestIdentification1 *-- "1..1" IDateFormat46Choice : ShareholdersDisclosureRecordDate
%% SecurityIdentification19 recursion level 1 with max 1
class SecurityIdentification19{
    ISIN IsoISINOct2015Identifier
    Description IsoMax140Text
}
SecurityIdentification19 *-- "0..0" OtherIdentification1 : OtherIdentification
%% IDateFormat46Choice recursion level 1 with max 1
  

DisclosureRequestIdentification1 members

CancellationReason building block

Provides the reason for cancelling the request for shareholders identification disclosure. Specifies the reason for the cancellation of the disclosure request. For comparison, see the ISO20022 official specification This message is declared as DisclosureRequestCancellationReason1Code in the ISO specification. In our implementation, it is represented in source code as DisclosureRequestCancellationReason1Code. Due to global using directives, it is treated as a System.String by the compiler and runtime.

Issuer building block

Issuer of the financial instrument. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification

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

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

classDiagram
    class IOuterRecord
    ShareholdersIdentificationDisclosureRequestCancellationAdviceV01 --|> IOuterRecord : Implements
    ShareholdersIdentificationDisclosureRequestCancellationAdviceV01Document --|> IOuterDocument~ShareholdersIdentificationDisclosureRequestCancellationAdviceV01~ : Implements
    class IOuterDocument~ShareholdersIdentificationDisclosureRequestCancellationAdviceV01~ {
        ShareholdersIdentificationDisclosureRequestCancellationAdviceV01 Message
     }
  

Document wrapper for serialization

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

classDiagram
    ShareholdersIdentificationDisclosureRequestCancellationAdviceV01Document *-- ShareholdersIdentificationDisclosureRequestCancellationAdviceV01 : 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.046.001.01">
    <ShrhldrsIdDsclsrReqCxlAdvc>
        <IssrDsclsrReqRef>
            <!-- IssuerDisclosureRequestReference inner content -->
        </IssrDsclsrReqRef>
        <CxlRsn>
            <!-- CancellationReason inner content -->
        </CxlRsn>
        <Issr>
            <!-- Issuer inner content -->
        </Issr>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </ShrhldrsIdDsclsrReqCxlAdvc>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_mKzuYDnYEemL_ewJY9QP1g"
  name="ShareholdersIdentificationDisclosureRequestCancellationAdviceV01"
  definition="The ShareholdersIdentificationDisclosureCancellationAdvice message is sent by an issuer or by a third party nominated by the issuer (such as an issuer's agent) to the first intermediaries in a custody chain or is sent by any intermediaries in  a custody chain to the next intermediary down the chain of intermediaries (towards the investor side of the chain) in order to withdraw/cancel the disclosure request of shareholders identity previously sent."
  registrationStatus="Registered"
  messageSet="_zEyuADnXEemL_ewJY9QP1g _PQfi4TktEeqRy8MTwqUMxA"
  xmlTag="ShrhldrsIdDsclsrReqCxlAdvc"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_Yk74gbRAEem2T48lBgJbww"
    name="IssuerDisclosureRequestReference"
    definition="Official and unique identification assigned to a shareholders identification disclosure request process by the issuer or third party nominated by it and for which a response is sent."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="IssrDsclsrReqRef"
    complexType="_im8pMDqgEemL_ewJY9QP1g" />
  <messageBuildingBlock
    xmi:id="_L7L5YDqUEemL_ewJY9QP1g"
    name="CancellationReason"
    definition="Provides the reason for cancelling the request for shareholders identification disclosure."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CxlRsn"
    simpleType="_MbblYEV5EemRx7jyevcLwg" />
  <messageBuildingBlock
    xmi:id="_OBOqxzqSEemL_ewJY9QP1g"
    name="Issuer"
    definition="Issuer of the financial instrument."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="Issr"
    complexType="_CIhQ4bXLEeiTob_PrFFUxA" />
  <messageBuildingBlock
    xmi:id="_FGPFkT6LEemPvNTzinB5Vw"
    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="046"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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