seev.024.001.01
Scope This message is sent by an issuer (or its agent) to a CSD to report the status, or change in status, of an information advice. Usage This message must be used in response to an Agent Corporate Action Information Advice in the case of a rejection. However, it may also be used to report other statuses. The information advice identification must be present to link this message to the information advice for which the status is provided.
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
%% AgentCAInformationStatusAdviceV01 recursion level 0 with max 0
AgentCAInformationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : Identification
AgentCAInformationStatusAdviceV01 *-- "1..1" DocumentIdentification8 : AgentCAInformationAdviceIdentification
AgentCAInformationStatusAdviceV01 *-- "0..1" CorporateActionAdditionalInformation1 : CorporateActionAdditionalInformation
AgentCAInformationStatusAdviceV01 *-- "1..1" ICorporateActionInformationStatus1Choice : InformationStatusDetails
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
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique identification of the document. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date/time of the creation of the document. | IsoISODateTime - Optional 0..1 |
AgentCAInformationAdviceIdentification building block
Identification of the linked Agent CA Information Advice 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
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique identification of the document. | IsoMax35Text - Required 1..1 |
| CreationDateTime | Date/time of the creation of the document. | IsoISODateTime - Optional 0..1 |
CorporateActionAdditionalInformation building block
Additional information about the corporate action such as the delivery details. Provides additional information about the delivery details, beneficial owner details, etc. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionAdditionalInformation1 recursion level 0 with max 1
class CorporateActionAdditionalInformation1{
RegistrationDetails IsoMax350Text
CertificationIndicator IsoYesNoIndicator
AdditionalInstruction IsoMax350Text
}
CorporateActionAdditionalInformation1 *-- "0..0" BeneficialOwner1 : BeneficialOwnerDetails
CorporateActionAdditionalInformation1 *-- "0..1" IPartyIdentification2Choice : ReceiverIdentification
CorporateActionAdditionalInformation1 *-- "0..1" IBeneficiaryCertificationType1FormatChoice : CertificationType
CorporateActionAdditionalInformation1 *-- "0..0" ProceedsDelivery1 : DeliveryDetails
%% BeneficialOwner1 recursion level 1 with max 1
class BeneficialOwner1{
Nationality CountryCode
DomicileCountry CountryCode
NonDomicileCountry CountryCode
CertificationIndicator IsoYesNoIndicator
DeclarationDetails IsoMax350Text
}
BeneficialOwner1 *-- "1..1" IPartyIdentification2Choice : BeneficialOwnerIdentification
BeneficialOwner1 *-- "0..1" GenericIdentification16 : AdditionalIdentification
BeneficialOwner1 *-- "0..1" IBeneficiaryCertificationType1FormatChoice : CertificationType
BeneficialOwner1 *-- "0..1" SecurityIdentification7 : SecurityIdentification
BeneficialOwner1 *-- "1..1" IUnitOrFaceAmount1Choice : ElectedSecuritiesQuantity
%% IPartyIdentification2Choice recursion level 1 with max 1
%% IBeneficiaryCertificationType1FormatChoice recursion level 1 with max 1
%% ProceedsDelivery1 recursion level 1 with max 1
class ProceedsDelivery1{
SecuritiesAccountIdentification IsoMax35Text
}
ProceedsDelivery1 *-- "1..1" ICashAccountIdentification1Choice : CashAccountIdentification
ProceedsDelivery1 *-- "0..1" IPartyIdentification2Choice : AccountOwnerIdentification
ProceedsDelivery1 *-- "0..1" IPartyIdentification2Choice : AccountServicerIdentification
CorporateActionAdditionalInformation1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| BeneficialOwnerDetails | Provides information about the beneficial owner of the securities. | BeneficialOwner1 - Unknown 0..0 |
| RegistrationDetails | Provides information required for the registration. | IsoMax350Text - Optional 0..1 |
| ReceiverIdentification | Identification of the receiver of outturned resources (cash/securities) in case the resources need to be delivered outside the CSD. | IPartyIdentification2Choice - Optional 0..1 |
| CertificationIndicator | Whether or not certification is required from the account owner. | Y: certification required |
| CertificationType | Type of certification which is required. | IBeneficiaryCertificationType1FormatChoice - Optional 0..1 |
| DeliveryDetails | Provides information about the delivery details of proceeds. | ProceedsDelivery1 - Unknown 0..0 |
| AdditionalInstruction | Provides additional details pertaining to the corporate action instruction. | IsoMax350Text - Optional 0..1 |
InformationStatusDetails building block
Status of the information advice sent by the CSD. Choice between the different statuses of a corporate action information advice. For comparison, see the ISO20022 official specification
classDiagram direction tb %% ICorporateActionInformationStatus1Choice recursion level 0 with max 1
CorporateActionInformationStatus1Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the AgentCAInformationStatusAdviceV01 implementation follows a specific implementaiton pattern. First of all, AgentCAInformationStatusAdviceV01 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, AgentCAInformationStatusAdviceV01Document implements IOuterDocument. Because AgentCAInformationStatusAdviceV01 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type AgentCAInformationStatusAdviceV01.
classDiagram
class IOuterRecord
AgentCAInformationStatusAdviceV01 --|> IOuterRecord : Implements
AgentCAInformationStatusAdviceV01Document --|> IOuterDocument~AgentCAInformationStatusAdviceV01~ : Implements
class IOuterDocument~AgentCAInformationStatusAdviceV01~ {
AgentCAInformationStatusAdviceV01 Message
}
Document wrapper for serialization
The only real purpose AgentCAInformationStatusAdviceV01Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.024.001.01’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using AgentCAInformationStatusAdviceV01.ToDocument() method. The returned AgentCAInformationStatusAdviceV01Document value will serialize correctly according to ISO 20022 standards.
classDiagram
AgentCAInformationStatusAdviceV01Document *-- AgentCAInformationStatusAdviceV01 : 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.024.001.01">
<AgtCAInfStsAdvc>
<Id>
<!-- Identification inner content -->
</Id>
<AgtCAInfAdvcId>
<!-- AgentCAInformationAdviceIdentification inner content -->
</AgtCAInfAdvcId>
<CorpActnAddtlInf>
<!-- CorporateActionAdditionalInformation inner content -->
</CorpActnAddtlInf>
<InfStsDtls>
<!-- InformationStatusDetails inner content -->
</InfStsDtls>
</AgtCAInfStsAdvc>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_TOM7y9EwEd-BzquC8wXy7w_11240695"
name="AgentCAInformationStatusAdviceV01"
definition="Scope
This message is sent by an issuer (or its agent) to a CSD to report the status, or change in status, of an information advice.
Usage
This message must be used in response to an Agent Corporate Action Information Advice in the case of a rejection. However, it may also be used to report other statuses.
The information advice identification must be present to link this message to the information advice for which the status is provided."
registrationStatus="Registered"
messageSet="_wRe70k2rEeG_I4xRYCA_7g"
xmlTag="AgtCAInfStsAdvc"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<messageBuildingBlock
xmi:id="_TOM7zNEwEd-BzquC8wXy7w_1654735985"
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="_TOWFsNEwEd-BzquC8wXy7w_1665816866"
name="AgentCAInformationAdviceIdentification"
definition="Identification of the linked Agent CA Information Advice for which a status is given."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AgtCAInfAdvcId"
complexType="_RXNBiNp-Ed-ak6NoX_4Aeg_-320016249" />
<messageBuildingBlock
xmi:id="_TOWFsdEwEd-BzquC8wXy7w_693722719"
name="CorporateActionAdditionalInformation"
definition="Additional information about the corporate action such as the delivery details."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="CorpActnAddtlInf"
complexType="_UMZtCNp-Ed-ak6NoX_4Aeg_302800554" />
<messageBuildingBlock
xmi:id="_TOWFstEwEd-BzquC8wXy7w_-904563755"
name="InformationStatusDetails"
definition="Status of the information advice sent by the CSD."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="InfStsDtls"
complexType="_RiPM0tp-Ed-ak6NoX_4Aeg_-923033281" />
<messageDefinitionIdentifier
businessArea="seev"
messageFunctionality="024"
flavour="001"
version="01" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.