seev.035.002.13
Scope The CorporateActionMovementPreliminaryAdvice message is sent by an account servicer to an account owner or its designated agent to pre-advise an upcoming posting or reversal of securities and/or cash postings. 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
%% CorporateActionMovementPreliminaryAdvice002V13 recursion level 0 with max 0
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" Pagination1 : Pagination
CorporateActionMovementPreliminaryAdvice002V13 *-- "1..1" CorporateActionPreliminaryAdviceType2 : MovementPreliminaryAdviceGeneralInformation
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" DocumentIdentification37 : PreviousMovementPreliminaryAdviceIdentification
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" DocumentIdentification37 : NotificationIdentification
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" DocumentIdentification37 : MovementConfirmationIdentification
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" DocumentIdentification17 : InstructionIdentification
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" DocumentIdentification38 : OtherDocumentIdentification
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" CorporateActionEventReference4 : EventsLinkage
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" CorporateActionReversalReason4 : ReversalReason
CorporateActionMovementPreliminaryAdvice002V13 *-- "1..1" CorporateActionGeneralInformation168 : CorporateActionGeneralInformation
CorporateActionMovementPreliminaryAdvice002V13 *-- "1..1" IAccountIdentification52Choice : AccountDetails
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" CorporateAction65 : CorporateActionDetails
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" CorporateActionOption206 : CorporateActionMovementDetails
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" CorporateActionNarrative53 : AdditionalInformation
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification151Choice : IssuerAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : PayingAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : SubPayingAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : Registrar
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : ResellingAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : PhysicalSecuritiesAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : DropAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : SolicitationAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification137Choice : InformationAgent
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" SupplementaryData1 : SupplementaryData
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification151Choice : Issuer
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification151Choice : Offeror
CorporateActionMovementPreliminaryAdvice002V13 *-- "0..1" IPartyIdentification151Choice : TransferAgent
Now, we will zero-in one-by-one on each of these building blocks.
Pagination building block
Page number of the message and continuation indicator to indicate that the multi-part preliminary advice is to continue or that the message is the last page of the multi-part preliminary advice. Number used to sequence pages when it is not possible for data to be conveyed in a single message and the data has to be split across several pages (messages). For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% Pagination1 recursion level 0 with max 1
class Pagination1{
PageNumber IsoMax5NumericText
LastPageIndicator IsoYesNoIndicator
}
Pagination1 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PageNumber | Page number. | IsoMax5NumericText - Required 1..1 |
| LastPageIndicator | Indicates the last page. | IsoYesNoIndicator - Required 1..1 |
MovementPreliminaryAdviceGeneralInformation building block
General information about the movement preliminary advice document. Type of movement preliminary advice document. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionPreliminaryAdviceType2 recursion level 0 with max 1
class CorporateActionPreliminaryAdviceType2{
Type CorporateActionPreliminaryAdviceType1Code
EligibilityIndicator IsoYesNoIndicator
}
CorporateActionPreliminaryAdviceType2 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Type | Type of movement preliminary advice, for example. new or replacement. | CorporateActionPreliminaryAdviceType1Code - Required 1..1 |
| EligibilityIndicator | Indicates whether the movement preliminary advice is sent after entitlement date. Value is Yes (true) if sent after entitlement date and No (false) if sent before entitlement date. | IsoYesNoIndicator - Optional 0..1 |
PreviousMovementPreliminaryAdviceIdentification building block
Identification of the previously sent movement preliminary advice document. Identification of a document and type of link. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DocumentIdentification37 recursion level 0 with max 1
class DocumentIdentification37{
Identification IsoRestrictedFINXMax16Text
}
DocumentIdentification37 *-- "0..1" IProcessingPosition10Choice : LinkageType
%% IProcessingPosition10Choice recursion level 1 with max 1
DocumentIdentification37 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identifies the document. | IsoRestrictedFINXMax16Text - Required 1..1 |
| LinkageType | Specifies when this document is to be processed relative to another referred document. | IProcessingPosition10Choice - Optional 0..1 |
NotificationIdentification building block
Identification of a previously sent notification document. Identification of a document and type of link. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DocumentIdentification37 recursion level 0 with max 1
class DocumentIdentification37{
Identification IsoRestrictedFINXMax16Text
}
DocumentIdentification37 *-- "0..1" IProcessingPosition10Choice : LinkageType
%% IProcessingPosition10Choice recursion level 1 with max 1
DocumentIdentification37 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identifies the document. | IsoRestrictedFINXMax16Text - Required 1..1 |
| LinkageType | Specifies when this document is to be processed relative to another referred document. | IProcessingPosition10Choice - Optional 0..1 |
MovementConfirmationIdentification building block
Identification of a previously sent movement confirmation document. Identification of a document and type of link. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DocumentIdentification37 recursion level 0 with max 1
class DocumentIdentification37{
Identification IsoRestrictedFINXMax16Text
}
DocumentIdentification37 *-- "0..1" IProcessingPosition10Choice : LinkageType
%% IProcessingPosition10Choice recursion level 1 with max 1
DocumentIdentification37 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identifies the document. | IsoRestrictedFINXMax16Text - Required 1..1 |
| LinkageType | Specifies when this document is to be processed relative to another referred document. | IProcessingPosition10Choice - Optional 0..1 |
InstructionIdentification building block
Identification of a related instruction document. Identifies a document by a unique identification. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% DocumentIdentification17 recursion level 0 with max 1
class DocumentIdentification17{
Identification IsoRestrictedFINXMax16Text
}
DocumentIdentification17 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Identifies the document. | IsoRestrictedFINXMax16Text - Required 1..1 |
OtherDocumentIdentification building block
Identification of other documents as well as the document number. Identification of a document as well as the document number and type of link. For comparison, see the ISO20022 official specification
classDiagram direction tb %% DocumentIdentification38 recursion level 0 with max 1 DocumentIdentification38 *-- "1..1" IDocumentIdentification4Choice : Identification DocumentIdentification38 *-- "0..1" IDocumentNumber6Choice : DocumentNumber DocumentIdentification38 *-- "0..1" IProcessingPosition10Choice : LinkageType %% IDocumentIdentification4Choice recursion level 1 with max 1 %% IDocumentNumber6Choice recursion level 1 with max 1 %% IProcessingPosition10Choice recursion level 1 with max 1
DocumentIdentification38 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Identification | Unique identifier of the document (message) assigned either by the account servicer or the account owner. | IDocumentIdentification4Choice - Required 1..1 |
| DocumentNumber | Identification of the type of document. | IDocumentNumber6Choice - Optional 0..1 |
| LinkageType | Specifies when this document is to be processed relative to another referred document. | IProcessingPosition10Choice - Optional 0..1 |
EventsLinkage building block
Identification of another corporate action event that needs to be closely linked to the processing of the event notified in this document. Identification of a linked corporate action event. For comparison, see the ISO20022 official specification
classDiagram direction tb %% CorporateActionEventReference4 recursion level 0 with max 1 CorporateActionEventReference4 *-- "1..1" ICorporateActionEventReference4Choice : EventIdentification CorporateActionEventReference4 *-- "0..1" IProcessingPosition10Choice : LinkageType %% ICorporateActionEventReference4Choice recursion level 1 with max 1 %% IProcessingPosition10Choice recursion level 1 with max 1
CorporateActionEventReference4 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| EventIdentification | Identification of the linked corporate action event. | ICorporateActionEventReference4Choice - Required 1..1 |
| LinkageType | Specifies when this corporate action event is to be processed relative to a linked corporate action event. | IProcessingPosition10Choice - Optional 0..1 |
ReversalReason building block
Reason for the reversal. Specifies the reason why the corporate action reversal occurs. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionReversalReason4 recursion level 0 with max 1
class CorporateActionReversalReason4{
AdditionalReasonInformation IsoRestrictedFINXMax256Text
}
CorporateActionReversalReason4 *-- "1..1" ICorporateActionReversalReason4Choice : Reason
%% ICorporateActionReversalReason4Choice recursion level 1 with max 1
CorporateActionReversalReason4 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| Reason | Specifies the reason for the reversal. | ICorporateActionReversalReason4Choice - Required 1..1 |
| AdditionalReasonInformation | Provides additional information about the processed instruction. | IsoRestrictedFINXMax256Text - Optional 0..1 |
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
%% CorporateActionGeneralInformation168 recursion level 0 with max 1
class CorporateActionGeneralInformation168{
CorporateActionEventIdentification IsoRestrictedFINXMax16Text
OfficialCorporateActionEventIdentification IsoRestrictedFINXMax16Text
ClassActionNumber IsoRestrictedFINXMax16Text
}
CorporateActionGeneralInformation168 *-- "0..1" ICorporateActionEventProcessingType3Choice : EventProcessingType
CorporateActionGeneralInformation168 *-- "1..1" ICorporateActionEventType97Choice : EventType
CorporateActionGeneralInformation168 *-- "1..1" ICorporateActionMandatoryVoluntary4Choice : MandatoryVoluntaryEventType
CorporateActionGeneralInformation168 *-- "1..1" FinancialInstrumentAttributes114 : UnderlyingSecurity
%% ICorporateActionEventProcessingType3Choice recursion level 1 with max 1
%% ICorporateActionEventType97Choice recursion level 1 with max 1
%% ICorporateActionMandatoryVoluntary4Choice recursion level 1 with max 1
%% FinancialInstrumentAttributes114 recursion level 1 with max 1
class FinancialInstrumentAttributes114{
DenominationCurrency ActiveOrHistoricCurrencyCode
NextCouponDate IsoISODate
ExpiryDate IsoISODate
FloatingRateFixingDate IsoISODate
MaturityDate IsoISODate
IssueDate IsoISODate
NextCallableDate IsoISODate
PutableDate IsoISODate
DatedDate IsoISODate
ConversionDate IsoISODate
}
FinancialInstrumentAttributes114 *-- "1..1" SecurityIdentification20 : FinancialInstrumentIdentification
FinancialInstrumentAttributes114 *-- "0..1" IMarketIdentification4Choice : PlaceOfListing
FinancialInstrumentAttributes114 *-- "0..1" IInterestComputationMethodFormat5Choice : DayCountBasis
FinancialInstrumentAttributes114 *-- "0..1" IClassificationType33Choice : ClassificationType
FinancialInstrumentAttributes114 *-- "0..1" IOptionStyle9Choice : OptionStyle
FinancialInstrumentAttributes114 *-- "0..1" IRateFormat3Choice : InterestRate
FinancialInstrumentAttributes114 *-- "0..1" IRateFormat3Choice : NextInterestRate
FinancialInstrumentAttributes114 *-- "0..1" IRateFormat3Choice : PercentageOfDebtClaim
FinancialInstrumentAttributes114 *-- "0..1" IRateFormat12Choice : PreviousFactor
FinancialInstrumentAttributes114 *-- "0..1" IRateFormat12Choice : NextFactor
FinancialInstrumentAttributes114 *-- "0..1" QuantityToQuantityRatio2 : WarrantParity
FinancialInstrumentAttributes114 *-- "0..1" IFinancialInstrumentQuantity36Choice : MinimumNominalQuantity
FinancialInstrumentAttributes114 *-- "0..1" IFinancialInstrumentQuantity36Choice : ContractSize
CorporateActionGeneralInformation168 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| CorporateActionEventIdentification | Reference assigned by the account servicer to unambiguously identify a corporate action event. | IsoRestrictedFINXMax16Text - Required 1..1 |
| OfficialCorporateActionEventIdentification | Official and unique reference assigned by the official central body/entity within each market at the beginning of a corporate action event. | IsoRestrictedFINXMax16Text - Optional 0..1 |
| ClassActionNumber | Reference assigned by a court to a class action. | IsoRestrictedFINXMax16Text - Optional 0..1 |
| EventProcessingType | Type of processing involved by a corporate action. | ICorporateActionEventProcessingType3Choice - Optional 0..1 |
| EventType | Type of corporate action event. | ICorporateActionEventType97Choice - Required 1..1 |
| MandatoryVoluntaryEventType | Specifies whether the event is mandatory, mandatory with options or voluntary. | ICorporateActionMandatoryVoluntary4Choice - Required 1..1 |
| UnderlyingSecurity | Security concerned by the corporate action. | FinancialInstrumentAttributes114 - Required 1..1 |
AccountDetails building block
General information about the safekeeping account, owner and account balance. 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 %% IAccountIdentification52Choice recursion level 0 with max 1
AccountIdentification52Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% CorporateAction65 recursion level 0 with max 1 CorporateAction65 *-- "0..1" CorporateActionDate70 : DateDetails CorporateAction65 *-- "0..1" CorporateActionQuantity13 : SecuritiesQuantity CorporateAction65 *-- "0..1" ICorporateActionEventStageFormat15Choice : EventStage CorporateAction65 *-- "0..0" IAdditionalBusinessProcessFormat21Choice : AdditionalBusinessProcessIndicator CorporateAction65 *-- "0..1" IIntermediateSecuritiesDistributionTypeFormat18Choice : IntermediateSecuritiesDistributionType CorporateAction65 *-- "0..1" ILotteryTypeFormat5Choice : LotteryType %% CorporateActionDate70 recursion level 1 with max 1 CorporateActionDate70 *-- "0..1" IDateFormat49Choice : RecordDate CorporateActionDate70 *-- "0..1" IDateFormat49Choice : ExDividendDate CorporateActionDate70 *-- "0..1" IDateFormat49Choice : LotteryDate %% CorporateActionQuantity13 recursion level 1 with max 1 CorporateActionQuantity13 *-- "0..1" IFinancialInstrumentQuantity43Choice : BaseDenomination CorporateActionQuantity13 *-- "0..1" IFinancialInstrumentQuantity43Choice : IncrementalDenomination %% ICorporateActionEventStageFormat15Choice recursion level 1 with max 1 %% IAdditionalBusinessProcessFormat21Choice recursion level 1 with max 1 %% IIntermediateSecuritiesDistributionTypeFormat18Choice recursion level 1 with max 1 %% ILotteryTypeFormat5Choice recursion level 1 with max 1
CorporateAction65 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| DateDetails | Provides information about the dates related to a corporate action event. | CorporateActionDate70 - Optional 0..1 |
| SecuritiesQuantity | Provides information about securities quantity linked to a corporate action. | CorporateActionQuantity13 - Optional 0..1 |
| EventStage | Stage in the corporate action event life cycle. | ICorporateActionEventStageFormat15Choice - Optional 0..1 |
| AdditionalBusinessProcessIndicator | Indicates whether the message is related to a claim on the associated corporate action event. | IAdditionalBusinessProcessFormat21Choice - Unknown 0..0 |
| IntermediateSecuritiesDistributionType | Specifies the type of intermediates securities distribution. | IIntermediateSecuritiesDistributionTypeFormat18Choice - Optional 0..1 |
| LotteryType | Specifies the type of lottery announced. | ILotteryTypeFormat5Choice - Optional 0..1 |
CorporateActionMovementDetails building block
Information about the corporate action option. Provides information about the corporate action option. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionOption206 recursion level 0 with max 1
class CorporateActionOption206{
OptionNumber IsoExact3NumericText
NonDomicileCountry CountryCode
ValidDomicileCountry CountryCode
CurrencyOption ActiveCurrencyCode
ChargesAppliedIndicator IsoYesNoIndicator
CertificationBreakdownIndicator IsoYesNoIndicator
WithdrawalAllowedIndicator IsoYesNoIndicator
ChangeAllowedIndicator IsoYesNoIndicator
AppliedOptionIndicator IsoYesNoIndicator
}
CorporateActionOption206 *-- "1..1" ICorporateActionOption46Choice : OptionType
CorporateActionOption206 *-- "0..1" IFractionDispositionType31Choice : FractionDisposition
CorporateActionOption206 *-- "0..0" IOfferTypeFormat13Choice : OfferType
CorporateActionOption206 *-- "0..0" IOptionFeaturesFormat26Choice : OptionFeatures
CorporateActionOption206 *-- "0..1" IOptionAvailabilityStatus4Choice : OptionAvailabilityStatus
CorporateActionOption206 *-- "0..0" IBeneficiaryCertificationType12Choice : CertificationBreakdownType
CorporateActionOption206 *-- "1..1" IDefaultProcessingOrStandingInstruction1Choice : DefaultProcessingOrStandingInstruction
CorporateActionOption206 *-- "0..1" SecurityIdentification20 : SecurityIdentification
CorporateActionOption206 *-- "0..1" CorporateActionDate81 : DateDetails
CorporateActionOption206 *-- "0..1" CorporateActionPeriod12 : PeriodDetails
CorporateActionOption206 *-- "0..1" CorporateActionRate109 : RateAndAmountDetails
CorporateActionOption206 *-- "0..1" CorporateActionPrice69 : PriceDetails
CorporateActionOption206 *-- "0..1" SecuritiesOption84 : SecuritiesQuantity
CorporateActionOption206 *-- "0..0" SecuritiesOption85 : SecuritiesMovementDetails
CorporateActionOption206 *-- "0..0" CashOption81 : CashMovementDetails
CorporateActionOption206 *-- "0..1" CorporateActionNarrative36 : AdditionalInformation
%% ICorporateActionOption46Choice recursion level 1 with max 1
%% IFractionDispositionType31Choice recursion level 1 with max 1
%% IOfferTypeFormat13Choice recursion level 1 with max 1
%% IOptionFeaturesFormat26Choice recursion level 1 with max 1
%% IOptionAvailabilityStatus4Choice recursion level 1 with max 1
%% IBeneficiaryCertificationType12Choice recursion level 1 with max 1
%% IDefaultProcessingOrStandingInstruction1Choice recursion level 1 with max 1
%% SecurityIdentification20 recursion level 1 with max 1
class SecurityIdentification20{
ISIN IsoISINOct2015Identifier
Description IsoRestrictedFINXMax140Text
}
SecurityIdentification20 *-- "0..0" OtherIdentification2 : OtherIdentification
%% CorporateActionDate81 recursion level 1 with max 1
CorporateActionDate81 *-- "0..1" IDateFormat49Choice : EarlyResponseDeadline
CorporateActionDate81 *-- "0..1" IDateFormat43Choice : CoverExpirationDeadline
CorporateActionDate81 *-- "0..1" IDateFormat43Choice : ProtectDeadline
CorporateActionDate81 *-- "0..1" IDateFormat49Choice : MarketDeadline
CorporateActionDate81 *-- "0..1" IDateFormat54Choice : ResponseDeadline
CorporateActionDate81 *-- "0..1" IDateFormat49Choice : ExpiryDate
CorporateActionDate81 *-- "0..1" IDateFormat49Choice : SubscriptionCostDebitDate
CorporateActionDate81 *-- "0..1" IDateFormat49Choice : DepositoryCoverExpirationDate
CorporateActionDate81 *-- "0..1" IDateFormat49Choice : StockLendingDeadline
CorporateActionDate81 *-- "0..0" BorrowerLendingDeadline6 : BorrowerStockLendingDeadline
%% CorporateActionPeriod12 recursion level 1 with max 1
CorporateActionPeriod12 *-- "0..1" IPeriod6Choice : PriceCalculationPeriod
CorporateActionPeriod12 *-- "0..1" IPeriod6Choice : ParallelTradingPeriod
CorporateActionPeriod12 *-- "0..1" IPeriod6Choice : ActionPeriod
CorporateActionPeriod12 *-- "0..1" IPeriod6Choice : RevocabilityPeriod
CorporateActionPeriod12 *-- "0..1" IPeriod6Choice : PrivilegeSuspensionPeriod
CorporateActionPeriod12 *-- "0..1" IPeriod6Choice : AccountServicerRevocabilityPeriod
CorporateActionPeriod12 *-- "0..1" IPeriod6Choice : DepositorySuspensionPeriodForWithdrawal
%% CorporateActionRate109 recursion level 1 with max 1
CorporateActionRate109 *-- "0..1" IRateAndAmountFormat46Choice : AdditionalTax
CorporateActionRate109 *-- "0..0" IGrossDividendRateFormat41Choice : GrossDividendRate
CorporateActionRate109 *-- "0..0" INetDividendRateFormat43Choice : NetDividendRate
CorporateActionRate109 *-- "0..0" IInterestRateUsedForPaymentFormat10Choice : InterestRateUsedForPayment
CorporateActionRate109 *-- "0..1" IRateFormat3Choice : MaximumAllowedOversubscriptionRate
CorporateActionRate109 *-- "0..1" IRateFormat3Choice : ProrationRate
CorporateActionRate109 *-- "0..0" IRateAndAmountFormat47Choice : WithholdingTaxRate
CorporateActionRate109 *-- "0..0" IRateAndAmountFormat47Choice : SecondLevelTax
CorporateActionRate109 *-- "0..0" RateTypeAndAmountAndStatus33 : TaxableIncomePerDividendShare
CorporateActionRate109 *-- "0..1" IRateAndAmountFormat46Choice : TaxOnIncome
%% CorporateActionPrice69 recursion level 1 with max 1
CorporateActionPrice69 *-- "0..1" IPriceFormat57Choice : CashInLieuOfSharePrice
CorporateActionPrice69 *-- "0..1" IPriceFormat57Choice : OverSubscriptionDepositPrice
CorporateActionPrice69 *-- "0..1" IPriceFormat62Choice : MaximumCashToInstruct
CorporateActionPrice69 *-- "0..1" IPriceFormat62Choice : MinimumCashToInstruct
CorporateActionPrice69 *-- "0..1" IPriceFormat62Choice : MinimumMultipleCashToInstruct
%% SecuritiesOption84 recursion level 1 with max 1
SecuritiesOption84 *-- "0..1" IFinancialInstrumentQuantity44Choice : MaximumQuantityToInstruct
SecuritiesOption84 *-- "0..1" IFinancialInstrumentQuantity44Choice : MinimumQuantityToInstruct
SecuritiesOption84 *-- "0..1" IFinancialInstrumentQuantity43Choice : MinimumMultipleQuantityToInstruct
SecuritiesOption84 *-- "0..1" IFinancialInstrumentQuantity43Choice : NewBoardLotQuantity
SecuritiesOption84 *-- "0..1" IFinancialInstrumentQuantity43Choice : NewDenominationQuantity
SecuritiesOption84 *-- "0..1" IFinancialInstrumentQuantity43Choice : FrontEndOddLotQuantity
SecuritiesOption84 *-- "0..1" IFinancialInstrumentQuantity43Choice : BackEndOddLotQuantity
%% SecuritiesOption85 recursion level 1 with max 1
class SecuritiesOption85{
CreditDebitIndicator CreditDebitCode
NewSecuritiesIssuanceIndicator NewSecuritiesIssuanceType5Code
CountryOfIncomeSource CountryCode
CurrencyOption ActiveCurrencyCode
}
SecuritiesOption85 *-- "1..1" FinancialInstrumentAttributes115 : SecurityDetails
SecuritiesOption85 *-- "0..1" ITemporaryFinancialInstrumentIndicator4Choice : TemporaryFinancialInstrumentIndicator
SecuritiesOption85 *-- "0..1" INonEligibleProceedsIndicator4Choice : NonEligibleProceedsIndicator
SecuritiesOption85 *-- "0..1" IIssuerOfferorTaxabilityIndicator1Choice : IssuerOfferorTaxabilityIndicator
SecuritiesOption85 *-- "0..1" GenericIdentification47 : IncomeType
SecuritiesOption85 *-- "0..0" GenericIdentification47 : OtherIncomeType
SecuritiesOption85 *-- "0..0" GenericIdentification47 : ExemptionType
SecuritiesOption85 *-- "0..1" IQuantity54Choice : EntitledQuantity
SecuritiesOption85 *-- "0..1" ISafekeepingPlaceFormat39Choice : SafekeepingPlace
SecuritiesOption85 *-- "0..1" IFractionDispositionType31Choice : FractionDisposition
SecuritiesOption85 *-- "0..1" IPeriod6Choice : TradingPeriod
SecuritiesOption85 *-- "1..1" SecurityDate18 : DateDetails
SecuritiesOption85 *-- "0..1" CorporateActionRate95 : RateDetails
SecuritiesOption85 *-- "0..1" CorporateActionPrice79 : PriceDetails
%% CashOption81 recursion level 1 with max 1
class CashOption81{
CreditDebitIndicator CreditDebitCode
ContractualPaymentIndicator Payment1Code
CountryOfIncomeSource CountryCode
}
CashOption81 *-- "0..1" INonEligibleProceedsIndicator4Choice : NonEligibleProceedsIndicator
CashOption81 *-- "0..1" IIssuerOfferorTaxabilityIndicator1Choice : IssuerOfferorTaxabilityIndicator
CashOption81 *-- "0..1" GenericIdentification47 : IncomeType
CashOption81 *-- "0..0" GenericIdentification47 : OtherIncomeType
CashOption81 *-- "0..0" GenericIdentification47 : ExemptionType
CashOption81 *-- "0..1" ICashAccountIdentification6Choice : CashAccountIdentification
CashOption81 *-- "0..1" CorporateActionAmounts58 : AmountDetails
CashOption81 *-- "1..1" CorporateActionDate72 : DateDetails
CashOption81 *-- "0..1" ForeignExchangeTerms28 : ForeignExchangeDetails
CashOption81 *-- "0..1" Rate38 : RateAndAmountDetails
CashOption81 *-- "0..1" PriceDetails29 : PriceDetails
%% CorporateActionNarrative36 recursion level 1 with max 1
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation6 : AdditionalText
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation6 : NarrativeVersion
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation5 : InformationConditions
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation5 : InformationToComplyWith
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation5 : SecurityRestriction
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation5 : TaxationConditions
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation5 : Disclaimer
CorporateActionNarrative36 *-- "0..1" UpdatedAdditionalInformation5 : CertificationBreakdown
CorporateActionOption206 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| OptionNumber | Number identifying the available corporate action options. | IsoExact3NumericText - Required 1..1 |
| OptionType | Specifies the corporate action options available to the account owner. | ICorporateActionOption46Choice - Required 1..1 |
| FractionDisposition | Specifies how fractions resulting from derived securities will be processed or how prorated decisions will be rounding, if provided with a pro ration rate. | IFractionDispositionType31Choice - Optional 0..1 |
| OfferType | Specifies the conditions that apply to the offer. | IOfferTypeFormat13Choice - Unknown 0..0 |
| OptionFeatures | Specifies the features that may apply to a corporate action option. | IOptionFeaturesFormat26Choice - Unknown 0..0 |
| OptionAvailabilityStatus | Specifies the status of the option. | IOptionAvailabilityStatus4Choice - Optional 0..1 |
| CertificationBreakdownType | Type of certification/breakdown. | IBeneficiaryCertificationType12Choice - Unknown 0..0 |
| NonDomicileCountry | Holder of the security has to certify, in line with the terms of the corporate action, that it is not domiciled in the country indicated. | CountryCode - Unknown 0..0 |
| ValidDomicileCountry | Country of domicile in which the Corporate Action option is valid. The holder of the security has to certify that it is domiciled in the country indicated. | CountryCode - Unknown 0..0 |
| CurrencyOption | Currency in which the cash disbursed from an interest or dividend payment is offered. | ActiveCurrencyCode - Optional 0..1 |
| DefaultProcessingOrStandingInstruction | Indicates whether the corporate action movement is a default processing or a standing instruction. | IDefaultProcessingOrStandingInstruction1Choice - Required 1..1 |
| ChargesAppliedIndicator | Indicates whether redemption charges apply. | IsoYesNoIndicator - Optional 0..1 |
| CertificationBreakdownIndicator | Indicates whether certification/breakdown is required from the account owner. Yes: certification required No: no certification required. | IsoYesNoIndicator - Optional 0..1 |
| WithdrawalAllowedIndicator | Indicates whether withdrawal of instruction is allowed. | IsoYesNoIndicator - Optional 0..1 |
| ChangeAllowedIndicator | Indicates whether change of instruction is allowed. | IsoYesNoIndicator - Optional 0..1 |
| AppliedOptionIndicator | Indicates whether the option, different from the default one, shall be applied by the account owner. | IsoYesNoIndicator - Optional 0..1 |
| SecurityIdentification | Identifies the financial instrument. | SecurityIdentification20 - Optional 0..1 |
| DateDetails | Provides information about the dates related to a corporate action option. | CorporateActionDate81 - Optional 0..1 |
| PeriodDetails | Provides information about the periods related to a corporate action option. | CorporateActionPeriod12 - Optional 0..1 |
| RateAndAmountDetails | Provides information about rates and amounts related to a corporate action option. | CorporateActionRate109 - Optional 0..1 |
| PriceDetails | Provides information about the prices related to a corporate action option. | CorporateActionPrice69 - Optional 0..1 |
| SecuritiesQuantity | Provides information about securities quantity related to a corporate action option. | SecuritiesOption84 - Optional 0..1 |
| SecuritiesMovementDetails | Provides information about securities movement related to a corporate action option. | SecuritiesOption85 - Unknown 0..0 |
| CashMovementDetails | Provides information about the cash movement linked to the corporate action option. | CashOption81 - Unknown 0..0 |
| AdditionalInformation | Provides additional information about the corporate action movement. | CorporateActionNarrative36 - Optional 0..1 |
AdditionalInformation building block
Provides additional information. Provides additional information such as the taxation conditions. For comparison, see the ISO20022 official specification
classDiagram
direction tb
%% CorporateActionNarrative53 recursion level 0 with max 1
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : AdditionalText
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : NarrativeVersion
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : InformationConditions
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : InformationToComplyWith
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : TaxationConditions
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : Disclaimer
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : PartyContactNarrative
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : RegistrationDetails
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : BasketOrIndexInformation
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation5 : CertificationBreakdown
CorporateActionNarrative53 *-- "0..1" UpdatedAdditionalInformation1 : ProcessingTextForNextIntermediary
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation5 recursion level 1 with max 1
class UpdatedAdditionalInformation5{
UpdateDescription IsoRestrictedFINXMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoRestrictedFINXMax350Text
}
%% UpdatedAdditionalInformation1 recursion level 1 with max 1
class UpdatedAdditionalInformation1{
UpdateDescription IsoMax140Text
UpdateDate IsoISODate
AdditionalInformation IsoMax350Text
}
CorporateActionNarrative53 members
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| AdditionalText | 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. | UpdatedAdditionalInformation5 - Optional 0..1 |
| NarrativeVersion | Provides information that can be ignored for automated processing; - reiteration of information that has been included within structured fields of this message, - or narrative information not needed for automatic processing. | UpdatedAdditionalInformation5 - Optional 0..1 |
| InformationConditions | Provides conditional information related to the event, for example, an offer is subject to 50 percent acceptance, the offeror allows the securities holder to set some conditions. | UpdatedAdditionalInformation5 - Optional 0..1 |
| InformationToComplyWith | Provides information conditions to the account owner that are to be complied with, for example, not open to US/Canadian residents, Qualified Institutional Buyers (QIB) or SIL (Sophisticated Investor Letter) to be provided. | UpdatedAdditionalInformation5 - Optional 0..1 |
| TaxationConditions | Provides taxation conditions that cannot be included within the structured fields of this message and has not been mentioned in the Service Level Agreement (SLA). | UpdatedAdditionalInformation5 - Optional 0..1 |
| Disclaimer | Provides a disclaimer relative to the information provided in the message. It may be ignored for automated processing. | UpdatedAdditionalInformation5 - Optional 0..1 |
| PartyContactNarrative | Provides additional information regarding the party, for example, the contact unit or person responsible for the transaction identified in the message. | UpdatedAdditionalInformation5 - Optional 0..1 |
| RegistrationDetails | Provides information required for the registration. | UpdatedAdditionalInformation5 - Optional 0..1 |
| BasketOrIndexInformation | Provides additional information on the basket or index underlying a security, for example a warrant. | UpdatedAdditionalInformation5 - Optional 0..1 |
| CertificationBreakdown | Provides additional information about the type of certification/breakdown required. | UpdatedAdditionalInformation5 - Optional 0..1 |
| ProcessingTextForNextIntermediary | Provides additional information from the account servicer or a service provider solely intended for the next immediate account holder to enable or facilitate event processing between parties. | UpdatedAdditionalInformation1 - Optional 0..1 |
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 %% IPartyIdentification151Choice recursion level 0 with max 1
PartyIdentification151Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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 %% IPartyIdentification137Choice recursion level 0 with max 1
PartyIdentification137Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
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
| Member name | Description | Data Type / Multiplicity |
|---|---|---|
| PlaceAndName | Unambiguous reference to the location where the supplementary data must be inserted in the message instance. In the case of XML, this is expressed by a valid XPath. | IsoMax350Text - Optional 0..1 |
| Envelope | Technical element wrapping the supplementary data. | IsoSupplementaryDataEnvelope1 - Required 1..1 |
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 %% IPartyIdentification151Choice recursion level 0 with max 1
PartyIdentification151Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
Offeror building block
Party making the offer and which is different from the issuing company. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification
classDiagram direction tb %% IPartyIdentification151Choice recursion level 0 with max 1
PartyIdentification151Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
TransferAgent building block
Trust company, bank or similar financial institution appointed by a fund management company to maintain records of investors and account balances. The transfer agent records transactions, including subscriptions, redemptions, switches, transfers, and re-registrations. Choice between different formats for the identification of a party. For comparison, see the ISO20022 official specification
classDiagram direction tb %% IPartyIdentification151Choice recursion level 0 with max 1
PartyIdentification151Choice members
| Member name | Description | Data Type / Multiplicity |
|---|
Extensibility and generalization considerations
To facilitate generalized design patterns in the system, the CorporateActionMovementPreliminaryAdvice002V13 implementation follows a specific implementaiton pattern. First of all, CorporateActionMovementPreliminaryAdvice002V13 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, CorporateActionMovementPreliminaryAdvice002V13Document implements IOuterDocument. Because CorporateActionMovementPreliminaryAdvice002V13 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type CorporateActionMovementPreliminaryAdvice002V13.
classDiagram
class IOuterRecord
CorporateActionMovementPreliminaryAdvice002V13 --|> IOuterRecord : Implements
CorporateActionMovementPreliminaryAdvice002V13Document --|> IOuterDocument~CorporateActionMovementPreliminaryAdvice002V13~ : Implements
class IOuterDocument~CorporateActionMovementPreliminaryAdvice002V13~ {
CorporateActionMovementPreliminaryAdvice002V13 Message
}
Document wrapper for serialization
The only real purpose CorporateActionMovementPreliminaryAdvice002V13Document serves is to cause the document to be serialized into the ‘urn:iso:std:iso:20022:tech:xsd:seev.035.002.13’ namespace. Therefore, it will probably be the usual practice to build the message and construct this wrapper at the last minute using CorporateActionMovementPreliminaryAdvice002V13.ToDocument() method. The returned CorporateActionMovementPreliminaryAdvice002V13Document value will serialize correctly according to ISO 20022 standards.
classDiagram
CorporateActionMovementPreliminaryAdvice002V13Document *-- CorporateActionMovementPreliminaryAdvice002V13 : 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.035.002.13">
<CorpActnMvmntPrlimryAdvc>
<Pgntn>
<!-- Pagination inner content -->
</Pgntn>
<MvmntPrlimryAdvcGnlInf>
<!-- MovementPreliminaryAdviceGeneralInformation inner content -->
</MvmntPrlimryAdvcGnlInf>
<PrvsMvmntPrlimryAdvcId>
<!-- PreviousMovementPreliminaryAdviceIdentification inner content -->
</PrvsMvmntPrlimryAdvcId>
<NtfctnId>
<!-- NotificationIdentification inner content -->
</NtfctnId>
<MvmntConfId>
<!-- MovementConfirmationIdentification inner content -->
</MvmntConfId>
<InstrId>
<!-- InstructionIdentification inner content -->
</InstrId>
<OthrDocId>
<!-- OtherDocumentIdentification inner content -->
</OthrDocId>
<EvtsLkg>
<!-- EventsLinkage inner content -->
</EvtsLkg>
<RvslRsn>
<!-- ReversalReason inner content -->
</RvslRsn>
<CorpActnGnlInf>
<!-- CorporateActionGeneralInformation inner content -->
</CorpActnGnlInf>
<AcctDtls>
<!-- AccountDetails inner content -->
</AcctDtls>
<CorpActnDtls>
<!-- CorporateActionDetails inner content -->
</CorpActnDtls>
<CorpActnMvmntDtls>
<!-- CorporateActionMovementDetails inner content -->
</CorpActnMvmntDtls>
<AddtlInf>
<!-- AdditionalInformation inner content -->
</AddtlInf>
<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>
<Issr>
<!-- Issuer inner content -->
</Issr>
<Offerr>
<!-- Offeror inner content -->
</Offerr>
<TrfAgt>
<!-- TransferAgent inner content -->
</TrfAgt>
</CorpActnMvmntPrlimryAdvc>
</Document>
Data from ISO specification
This is the technical data from the specification document.
<messageDefinition
xmi:id="_ps9cUzi7Eeydid5dcNPKvg"
nextVersions="_TsuZM199Ee262vCSVgjImg"
previousVersion="_ZHTykx9REeuFz_FaCzCLgQ"
name="CorporateActionMovementPreliminaryAdvice002V13"
definition="Scope
The CorporateActionMovementPreliminaryAdvice message is sent by an account servicer to an account owner or its designated agent to pre-advise an upcoming posting or reversal of securities and/or cash postings.
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)."
registrationStatus="Registered"
messageSet="_3gH3tOSgEeadBPHxVHI4mw"
xmlTag="CorpActnMvmntPrlimryAdvc"
rootElement="Document"
xmlns:xmi="http://www.omg.org/XMI">
<constraint
xmi:id="_ps9cVTi7Eeydid5dcNPKvg"
name="RateAndCorporateActionEventRule"
definition="If CorporateActionMovementDetails/RateAndAmountDetails/GrossDividendRate/NotSpecifiedRate Code value or CorporateActionMovementDetails/RateAndAmountDetails/InterestRateUsedForPayment/NotSpecifiedRate Code value is NILP (Nil Payment), then CorporateActionGeneralInformation/EventType/Code must be either DVCA (CashDividend) or INTR (InterestPayment).
If CorporateActionMovementDetails/CashMovementDetails/RateAndAmountDetails/GrossDividendRate/NotSpecifiedRate Code value or CorporateActionMovementDetails/CashMovementDetails/RateAndAmountDetails/InterestRateUsedForPayment/NotSpecifiedRate Code value is NILP (Nil Payment), then CorporateActionGeneralInformation/EventType/Code must be either DVCA (CashDividend) or INTR (InterestPayment)."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_ps9cVzi7Eeydid5dcNPKvg"
name="SafekeepingAccount1Rule"
definition="If AccountDetails/ForAllAccounts/IdentificationCode value is GENR (General), then any element in the list (MinimumNominalQuantity, MinimumExercisableQuantity,MinimumExercisableMultipleQuantity, ContractSize) must not be present in any occurrences of CorporateActionMovementDetails/SecuritiesMovementDetails/SecurityDetails;
(MT564 Rule C2 - part 1)."
registrationStatus="Provisionally Registered"
expression="<RuleDefinition><ComplexRule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ComplexRule"><mustBe><connector>AND</connector><BooleanRule xsi:type="Absence"><leftOperand>/CorporateActionMovementDetails[*]/SecuritiesMovementDetails[*]/SecurityDetails/MinimumNominalQuantity</leftOperand></BooleanRule><BooleanRule xsi:type="Absence"><leftOperand>/CorporateActionMovementDetails[*]/SecuritiesMovementDetails[*]/SecurityDetails/MinimumQuantityToInstruct</leftOperand></BooleanRule><BooleanRule xsi:type="Absence"><leftOperand>/CorporateActionMovementDetails[*]/SecuritiesMovementDetails[*]/SecurityDetails/MinimumMultipleQuantityToInstruct</leftOperand></BooleanRule><BooleanRule xsi:type="Absence"><leftOperand>/CorporateActionMovementDetails[*]/SecuritiesMovementDetails[*]/SecurityDetails/ContractSize</leftOperand></BooleanRule></mustBe><onCondition><connector>AND</connector><BooleanRule xsi:type="Presence"><leftOperand>/AccountDetails/ForAllAccounts</leftOperand></BooleanRule><BooleanRule xsi:type="EqualToValue"><leftOperand>/AccountDetails/ForAllAccounts/IdentificationCode</leftOperand><rightOperand>General</rightOperand></BooleanRule></onCondition></ComplexRule></RuleDefinition>" />
<constraint
xmi:id="_ps9cWTi7Eeydid5dcNPKvg"
name="SafekeepingAccount2Rule"
definition="If AccountDetails/ForAllAccounts/IdentificationCode value is GENR (General), then AmountDetails must not be present in any occurrences of CorporateActionMovementDetails/CashMovementDetails.
(MT564 Rule C2 - part 2)."
registrationStatus="Provisionally Registered"
expression="<RuleDefinition><ComplexRule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ComplexRule"><mustBe><connector>AND</connector><BooleanRule xsi:type="Absence"><leftOperand>/CorporateActionMovementDetails[*]/CashMovementDetails[*]/AmountDetails</leftOperand></BooleanRule></mustBe><onCondition><connector>AND</connector><BooleanRule xsi:type="Presence"><leftOperand>/AccountDetails/ForAllAccounts</leftOperand></BooleanRule><BooleanRule xsi:type="EqualToValue"><leftOperand>/AccountDetails/ForAllAccounts/IdentificationCode</leftOperand><rightOperand>General</rightOperand></BooleanRule></onCondition></ComplexRule></RuleDefinition>" />
<constraint
xmi:id="_ps9cWzi7Eeydid5dcNPKvg"
name="OtherEventRule"
definition="If CorporateActionGeneralInformation/EventType/Code is OTHR (Other), then at least one occurrence of AdditionalInformation/AdditionalText/AdditionalInformation must be present.
(MT564 NVR C4)."
registrationStatus="Provisionally Registered"
expression="<RuleDefinition><ComplexRule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ComplexRule"><mustBe><connector>AND</connector><BooleanRule xsi:type="Presence"><leftOperand>/AdditionalInformation</leftOperand></BooleanRule><BooleanRule xsi:type="Presence"><leftOperand>/AdditionalInformation/AdditionalText</leftOperand></BooleanRule><BooleanRule xsi:type="Presence"><leftOperand>/AdditionalInformation/AdditionalText/AdditionalInformation[1]</leftOperand></BooleanRule></mustBe><onCondition><connector>AND</connector><BooleanRule xsi:type="Presence"><leftOperand>/CorporateActionGeneralInformation/EventType/Code</leftOperand></BooleanRule><BooleanRule xsi:type="EqualToValue"><leftOperand>/CorporateActionGeneralInformation/EventType/Code</leftOperand><rightOperand>OtherEvent</rightOperand></BooleanRule></onCondition></ComplexRule></RuleDefinition>" />
<constraint
xmi:id="_ps9cXTi7Eeydid5dcNPKvg"
name="IntermediateSecuritiesDistributionRule"
definition="If CorporateActionGeneralInformation/EventType/Code is RHDI (IntermediateSecuritiesDistribution), then CorporateActionDetails/IntermediateSecuritiesDistributionType must be present.
(MT 564 NVR C11)."
registrationStatus="Provisionally Registered"
expression="<RuleDefinition><ComplexRule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ComplexRule"><mustBe><connector>AND</connector><BooleanRule xsi:type="Presence"><leftOperand>/CorporateActionDetails</leftOperand></BooleanRule><BooleanRule xsi:type="Presence"><leftOperand>/CorporateActionDetails/IntermediateSecuritiesDistributionType</leftOperand></BooleanRule></mustBe><onCondition><connector>AND</connector><BooleanRule xsi:type="EqualToValue"><leftOperand>/CorporateActionGeneralInformation/EventType/Code</leftOperand><rightOperand>IntermediateSecuritiesDistribution</rightOperand></BooleanRule></onCondition></ComplexRule></RuleDefinition>" />
<constraint
xmi:id="_ps9cXzi7Eeydid5dcNPKvg"
name="AppliedOptionRule"
definition="If CorporateActionMovementDetails/AppliedOptionIndicator value is 'true' or '1' (Yes) in one or more occurrences of CorporateActionMovementDetails, then CorporateActionGeneralInformation/MandatoryVoluntaryEventType/Code value must be CHOS (MandatoryWithOptions) and at least one of the CorporateActionDetails/AdditionalBusinessProcessIndicator/Code values must be REAC (RequiredAction)."
registrationStatus="Provisionally Registered" />
<constraint
xmi:id="_ps9cYTi7Eeydid5dcNPKvg"
name="BeneficialOwnerBreakdownRequestRule"
definition="If in at least one occurrence of CorporateActionMovementDetails, OptionType/Code value is BOBD (BeneficialOwnerBreakdownRequest), then CorporateActionGeneralInformation/EventType/Code value must be WTRC (Withholding Tax Relief Certification).
(MT 564 NVR C23)."
registrationStatus="Provisionally Registered"
expression="<RuleDefinition><ComplexRule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ComplexRule"><mustBe><connector>AND</connector><BooleanRule xsi:type="EqualToValue"><leftOperand>/CorporateActionGeneralInformation/EventType/Code</leftOperand><rightOperand>WithholdingTaxReliefCertification</rightOperand></BooleanRule></mustBe><onCondition><connector>AND</connector><BooleanRule xsi:type="EqualToValue"><leftOperand>/CorporateActionMovementDetails[*]/OptionType/Code</leftOperand><rightOperand>BeneficialOwnerBreakdownRequest</rightOperand></BooleanRule></onCondition></ComplexRule></RuleDefinition>" />
<constraint
xmi:id="_ps9cYzi7Eeydid5dcNPKvg"
name="IncentivePremiumEventType1Rule"
definition="If Code value is equal to INCP (IncentivePremiumPayment) in CorporateActionDetails/AdditionalBusinessProcessIndicator, then CorporateActionGeneralInformation/EventType/Code value must be equal to CONS (Consent).
(MT 564 NVR C26)"
registrationStatus="Provisionally Registered"
expression="<RuleDefinition><ComplexRule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ComplexRule"><mustBe><connector>AND</connector><BooleanRule xsi:type="EqualToValue"><leftOperand>/CorporateActionGeneralInformation/EventType/Code</leftOperand><rightOperand>Consent</rightOperand></BooleanRule></mustBe><onCondition><connector>AND</connector><BooleanRule xsi:type="EqualToValue"><leftOperand>/CorporateActionDetails/AdditionalBusinessProcessIndicator[*]/Code</leftOperand><rightOperand>IncentivePremiumPayment</rightOperand></BooleanRule></onCondition></ComplexRule></RuleDefinition>" />
<messageBuildingBlock
xmi:id="_ps9caDi7Eeydid5dcNPKvg"
name="Pagination"
definition="Page number of the message and continuation indicator to indicate that the multi-part preliminary advice is to continue or that the message is the last page of the multi-part preliminary advice."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="Pgntn"
complexType="_xhMHQa6XEees_ufOy2ci-g" />
<messageBuildingBlock
xmi:id="_ps9caji7Eeydid5dcNPKvg"
name="MovementPreliminaryAdviceGeneralInformation"
definition="General information about the movement preliminary advice document."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="MvmntPrlimryAdvcGnlInf"
complexType="_hX_uQSqeEeObprHJy8Zrxg" />
<messageBuildingBlock
xmi:id="_ps9cbDi7Eeydid5dcNPKvg"
name="PreviousMovementPreliminaryAdviceIdentification"
definition="Identification of the previously sent movement preliminary advice document."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="PrvsMvmntPrlimryAdvcId"
complexType="_chT0l5KQEeWHWpTQn1FFVg" />
<messageBuildingBlock
xmi:id="_ps9cbji7Eeydid5dcNPKvg"
name="NotificationIdentification"
definition="Identification of a previously sent notification document."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="NtfctnId"
complexType="_chT0l5KQEeWHWpTQn1FFVg" />
<messageBuildingBlock
xmi:id="_ps9ccDi7Eeydid5dcNPKvg"
name="MovementConfirmationIdentification"
definition="Identification of a previously sent movement confirmation document."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="MvmntConfId"
complexType="_chT0l5KQEeWHWpTQn1FFVg" />
<messageBuildingBlock
xmi:id="_ps9ccji7Eeydid5dcNPKvg"
name="InstructionIdentification"
definition="Identification of a related instruction document."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="InstrId"
complexType="_XWm_Otp-Ed-ak6NoX_4Aeg_-1145599038" />
<messageBuildingBlock
xmi:id="_ps9cdDi7Eeydid5dcNPKvg"
name="OtherDocumentIdentification"
definition="Identification of other documents as well as the document number."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="OthrDocId"
complexType="_chUbxZKQEeWHWpTQn1FFVg" />
<messageBuildingBlock
xmi:id="_ps9cdji7Eeydid5dcNPKvg"
name="EventsLinkage"
definition="Identification of another corporate action event that needs to be closely linked to the processing of the event notified in this document."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="EvtsLkg"
complexType="_chUcRZKQEeWHWpTQn1FFVg" />
<messageBuildingBlock
xmi:id="_ps9ceDi7Eeydid5dcNPKvg"
name="ReversalReason"
definition="Reason for the reversal."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="RvslRsn"
complexType="_ctOKKZKQEeWHWpTQn1FFVg" />
<messageBuildingBlock
xmi:id="_ps9ceji7Eeydid5dcNPKvg"
name="CorporateActionGeneralInformation"
definition="General information about the corporate action event."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="CorpActnGnlInf"
complexType="_ps-EkTi7Eeydid5dcNPKvg" />
<messageBuildingBlock
xmi:id="_ps9cfDi7Eeydid5dcNPKvg"
name="AccountDetails"
definition="General information about the safekeeping account, owner and account balance."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="1"
xmlTag="AcctDtls"
complexType="_ps_Rqzi7Eeydid5dcNPKvg" />
<messageBuildingBlock
xmi:id="_ps9cfji7Eeydid5dcNPKvg"
name="CorporateActionDetails"
definition="Information about the corporate action event."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="CorpActnDtls"
complexType="_ptF_bzi7Eeydid5dcNPKvg" />
<messageBuildingBlock
xmi:id="_ps9cgDi7Eeydid5dcNPKvg"
name="CorporateActionMovementDetails"
definition="Information about the corporate action option."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="CorpActnMvmntDtls"
complexType="_ptGm1Ti7Eeydid5dcNPKvg" />
<messageBuildingBlock
xmi:id="_ps9cgji7Eeydid5dcNPKvg"
name="AdditionalInformation"
definition="Provides additional information."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="AddtlInf"
complexType="_ptSzgzi7Eeydid5dcNPKvg" />
<messageBuildingBlock
xmi:id="_ps9chDi7Eeydid5dcNPKvg"
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="_ctD2W_fSEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9chji7Eeydid5dcNPKvg"
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="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9ciDi7Eeydid5dcNPKvg"
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="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9ciji7Eeydid5dcNPKvg"
name="Registrar"
definition="Party/agent responsible for maintaining the register of a security."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="Regar"
complexType="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9cjDi7Eeydid5dcNPKvg"
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="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9cjji7Eeydid5dcNPKvg"
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="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9ckDi7Eeydid5dcNPKvg"
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="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9ckji7Eeydid5dcNPKvg"
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="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9clDi7Eeydid5dcNPKvg"
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="__2ajK_fDEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9clji7Eeydid5dcNPKvg"
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" />
<messageBuildingBlock
xmi:id="_ps9cmDi7Eeydid5dcNPKvg"
name="Issuer"
definition="Issuer of the financial instrument."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="Issr"
complexType="_ctD2W_fSEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9cmji7Eeydid5dcNPKvg"
name="Offeror"
definition="Party making the offer and which is different from the issuing company."
registrationStatus="Provisionally Registered"
minOccurs="0"
xmlTag="Offerr"
complexType="_ctD2W_fSEeiNZp_PtLohLw" />
<messageBuildingBlock
xmi:id="_ps9cnDi7Eeydid5dcNPKvg"
name="TransferAgent"
definition="Trust company, bank or similar financial institution appointed by a fund management company to maintain records of investors and account balances. The transfer agent records transactions, including subscriptions, redemptions, switches, transfers, and re-registrations."
registrationStatus="Provisionally Registered"
maxOccurs="1"
minOccurs="0"
xmlTag="TrfAgt"
complexType="_ctD2W_fSEeiNZp_PtLohLw" />
<messageDefinitionIdentifier
businessArea="seev"
messageFunctionality="035"
flavour="002"
version="13" />
</messageDefinition>
ISO Building Blocks
The following items are used as building blocks to construct this message.