IntraPositionMovementInstruction002V04

semt.013.002.04

Scope An account owner sends a IntraPositionMovementInstruction to an account servicer to instruct the movement of securities within its holding from one sub-balance to another, for example, blocking of securities. The account owner/servicer relationship may be:

• a global custodian which has an account with its local agent (sub-custodian), or
• an investment management institution which manage a fund account opened at a custodian, or
• a broker which has an account with a custodian, or
• a central securities depository participant which has an account with a central securities depository, or
• a central securities depository which has an account with a custodian, another central securities depository or another settlement market infrastructure. Usage The message may also be used to:
• re-send a message previously sent,
• provide a third party with a copy of a message for information,
• re-send to a third party a copy of a message for information. using the relevant elements in the Business Application Header.

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
%% IntraPositionMovementInstruction002V04 recursion level 0 with max 0
class IntraPositionMovementInstruction002V04{
    TransactionIdentification IsoRestrictedFINXMax16Text
}
IntraPositionMovementInstruction002V04 *-- "0..1" Identification16 : CorporateActionEventIdentification
IntraPositionMovementInstruction002V04 *-- "0..1" INumberCount1Choice : NumberCounts
IntraPositionMovementInstruction002V04 *-- "0..1" Linkages42 : Linkages
IntraPositionMovementInstruction002V04 *-- "0..1" IPartyIdentification103Choice : AccountOwner
IntraPositionMovementInstruction002V04 *-- "1..1" SecuritiesAccount27 : SafekeepingAccount
IntraPositionMovementInstruction002V04 *-- "0..1" ISafekeepingPlaceFormat17Choice : SafekeepingPlace
IntraPositionMovementInstruction002V04 *-- "1..1" SecurityIdentification20 : FinancialInstrumentIdentification
IntraPositionMovementInstruction002V04 *-- "0..1" FinancialInstrumentAttributes75 : FinancialInstrumentAttributes
IntraPositionMovementInstruction002V04 *-- "1..1" IntraPositionDetails36 : IntraPositionDetails
IntraPositionMovementInstruction002V04 *-- "0..1" SupplementaryData1 : SupplementaryData
  

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

TransactionIdentification building block

Unambiguous identification of the transaction as know by the instructing party. Specifies a character string with a maximum length of 16 characters. It has a pattern that disables the use of characters that is not part of the character set X, that is, that is not a-z A-Z / - ? : ( ) . , ‘ + , and disable the use of slash “/” at the beginning and end of line and double slash “//” within the line. For comparison, see the ISO20022 official specification This message is declared as RestrictedFINXMax16Text in the ISO specification. In our implementation, it is represented in source code as IsoRestrictedFINXMax16Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.

CorporateActionEventIdentification building block

Identification assigned by the account servicer to unambiguously identify a corporate action event. Unique identifier of a document, message or transaction. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Identification16 recursion level 0 with max 1
class Identification16{
    Identification IsoRestrictedFINXMax16Text
}
  

Identification16 members

NumberCounts building block

Count of the number of transactions linked. Choice of number count type. For comparison, see the ISO20022 official specification

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

NumberCount1Choice members

Linkages building block

Link to another transaction that must be processed after, before or at the same time. Information related to a linked transaction. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Linkages42 recursion level 0 with max 1
Linkages42 *-- "0..1" IProcessingPosition10Choice : ProcessingPosition
Linkages42 *-- "0..1" IDocumentNumber6Choice : MessageNumber
Linkages42 *-- "1..1" IReferences50Choice : Reference
Linkages42 *-- "0..1" IPartyIdentification103Choice : ReferenceOwner
%% IProcessingPosition10Choice recursion level 1 with max 1
%% IDocumentNumber6Choice recursion level 1 with max 1
%% IReferences50Choice recursion level 1 with max 1
%% IPartyIdentification103Choice recursion level 1 with max 1
  

Linkages42 members

AccountOwner building block

Party that legally owns the account. Choice of identification of a party. For comparison, see the ISO20022 official specification

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

PartyIdentification103Choice members

SafekeepingAccount building block

Account to or from which a securities entry is made. Account to or from which a securities entry is made. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecuritiesAccount27 recursion level 0 with max 1
class SecuritiesAccount27{
    Identification IsoRestrictedFINXMax35Text
    Name IsoMax70Text
}
SecuritiesAccount27 *-- "0..1" GenericIdentification47 : Type
%% GenericIdentification47 recursion level 1 with max 1
class GenericIdentification47{
    Identification IsoExact4AlphaNumericText
    Issuer IsoMax4AlphaNumericText
    SchemeName IsoMax4AlphaNumericText
}
  

SecuritiesAccount27 members

SafekeepingPlace building block

Place where the securities are safe-kept, physically or notionally. This place can be, for example, a local custodian, a Central Securities Depository (CSD) or an International Central Securities Depository (ICSD). Choice between formats for the place of safekeeping. For comparison, see the ISO20022 official specification

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

SafekeepingPlaceFormat17Choice members

FinancialInstrumentIdentification building block

Financial instrument representing a sum of rights of the investor vis-a-vis the issuer. Identification of a security. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecurityIdentification20 recursion level 0 with max 1
class SecurityIdentification20{
    ISIN IsoISINOct2015Identifier
    Description IsoRestrictedFINXMax140Text
}
SecurityIdentification20 *-- "0..0" OtherIdentification2 : OtherIdentification
%% OtherIdentification2 recursion level 1 with max 1
class OtherIdentification2{
    Identification IsoRestrictedFINXMax31Text
    Suffix IsoMax16Text
}
OtherIdentification2 *-- "1..1" IIdentificationSource4Choice : Type
  

SecurityIdentification20 members

FinancialInstrumentAttributes building block

Elements characterising a financial instrument. Elements characterising a financial instrument. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% FinancialInstrumentAttributes75 recursion level 0 with max 1
class FinancialInstrumentAttributes75{
    DenominationCurrency ActiveOrHistoricCurrencyCode
    CouponDate IsoISODate
    ExpiryDate IsoISODate
    FloatingRateFixingDate IsoISODate
    MaturityDate IsoISODate
    IssueDate IsoISODate
    NextCallableDate IsoISODate
    PutableDate IsoISODate
    DatedDate IsoISODate
    FirstPaymentDate IsoISODate
    PreviousFactor IsoBaseOneRate
    CurrentFactor IsoBaseOneRate
    NextFactor IsoBaseOneRate
    InterestRate IsoPercentageRate
    YieldToMaturityRate IsoPercentageRate
    NextInterestRate IsoPercentageRate
    IndexRateBasis IsoPercentageRate
    VariableRateIndicator IsoYesNoIndicator
    CallableIndicator IsoYesNoIndicator
    PutableIndicator IsoYesNoIndicator
    FinancialInstrumentAttributeAdditionalDetails IsoRestrictedFINXMax350Text
}
FinancialInstrumentAttributes75 *-- "0..1" IMarketIdentification4Choice : PlaceOfListing
FinancialInstrumentAttributes75 *-- "0..1" IInterestComputationMethodFormat5Choice : DayCountBasis
FinancialInstrumentAttributes75 *-- "0..1" IFormOfSecurity7Choice : RegistrationForm
FinancialInstrumentAttributes75 *-- "0..1" IFrequency27Choice : PaymentFrequency
FinancialInstrumentAttributes75 *-- "0..1" ISecuritiesPaymentStatus6Choice : PaymentStatus
FinancialInstrumentAttributes75 *-- "0..1" IFrequency27Choice : VariableRateChangeFrequency
FinancialInstrumentAttributes75 *-- "0..1" IClassificationType33Choice : ClassificationType
FinancialInstrumentAttributes75 *-- "0..1" IOptionStyle9Choice : OptionStyle
FinancialInstrumentAttributes75 *-- "0..1" IOptionType7Choice : OptionType
FinancialInstrumentAttributes75 *-- "0..1" INumber23Choice : CouponAttachedNumber
FinancialInstrumentAttributes75 *-- "0..1" GenericIdentification39 : PoolNumber
FinancialInstrumentAttributes75 *-- "0..0" QuantityBreakdown33 : QuantityBreakdown
FinancialInstrumentAttributes75 *-- "0..1" IPriceType2Choice : MarketOrIndicativePrice
FinancialInstrumentAttributes75 *-- "0..1" Price3 : ExercisePrice
FinancialInstrumentAttributes75 *-- "0..1" Price3 : SubscriptionPrice
FinancialInstrumentAttributes75 *-- "0..1" Price3 : ConversionPrice
FinancialInstrumentAttributes75 *-- "0..1" Price3 : StrikePrice
FinancialInstrumentAttributes75 *-- "0..1" IFinancialInstrumentQuantity15Choice : MinimumNominalQuantity
FinancialInstrumentAttributes75 *-- "0..1" IFinancialInstrumentQuantity15Choice : ContractSize
FinancialInstrumentAttributes75 *-- "0..0" SecurityIdentification32 : UnderlyingFinancialInstrumentIdentification
%% IMarketIdentification4Choice recursion level 1 with max 1
%% IInterestComputationMethodFormat5Choice recursion level 1 with max 1
%% IFormOfSecurity7Choice recursion level 1 with max 1
%% IFrequency27Choice recursion level 1 with max 1
%% ISecuritiesPaymentStatus6Choice recursion level 1 with max 1
%% IFrequency27Choice recursion level 1 with max 1
%% IClassificationType33Choice recursion level 1 with max 1
%% IOptionStyle9Choice recursion level 1 with max 1
%% IOptionType7Choice recursion level 1 with max 1
%% INumber23Choice recursion level 1 with max 1
%% GenericIdentification39 recursion level 1 with max 1
class GenericIdentification39{
    Identification IsoRestrictedFINMax30Text
    Issuer IsoRestrictedFINMax8Text
}
%% QuantityBreakdown33 recursion level 1 with max 1
QuantityBreakdown33 *-- "1..1" GenericIdentification39 : LotNumber
QuantityBreakdown33 *-- "0..1" IFinancialInstrumentQuantity15Choice : LotQuantity
%% IPriceType2Choice recursion level 1 with max 1
%% Price3 recursion level 1 with max 1
Price3 *-- "1..1" IYieldedOrValueType1Choice : Type
Price3 *-- "1..1" IPriceRateOrAmount1Choice : Value
%% Price3 recursion level 1 with max 1
Price3 *-- "1..1" IYieldedOrValueType1Choice : Type
Price3 *-- "1..1" IPriceRateOrAmount1Choice : Value
%% Price3 recursion level 1 with max 1
Price3 *-- "1..1" IYieldedOrValueType1Choice : Type
Price3 *-- "1..1" IPriceRateOrAmount1Choice : Value
%% Price3 recursion level 1 with max 1
Price3 *-- "1..1" IYieldedOrValueType1Choice : Type
Price3 *-- "1..1" IPriceRateOrAmount1Choice : Value
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1
%% SecurityIdentification32 recursion level 1 with max 1
class SecurityIdentification32{
    ISIN IsoISINOct2015Identifier
    Description IsoRestrictedFINXMax140Text
}
SecurityIdentification32 *-- "0..0" OtherIdentification3 : OtherIdentification
  

FinancialInstrumentAttributes75 members

IntraPositionDetails building block

Intra-position movement transaction details. Details of the intra-position movement. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% IntraPositionDetails36 recursion level 0 with max 1
class IntraPositionDetails36{
    InstructionProcessingAdditionalDetails IsoRestrictedFINXMax350Text
}
IntraPositionDetails36 *-- "0..1" IPriorityNumeric5Choice : Priority
IntraPositionDetails36 *-- "1..1" IFinancialInstrumentQuantity15Choice : SettlementQuantity
IntraPositionDetails36 *-- "0..1" GenericIdentification39 : SecuritiesSubBalanceIdentification
IntraPositionDetails36 *-- "1..1" IDateAndDateTimeChoice : SettlementDate
IntraPositionDetails36 *-- "1..1" SecuritiesSubBalanceTypeAndQuantityBreakdown4 : BalanceFrom
IntraPositionDetails36 *-- "1..1" SecuritiesSubBalanceTypeAndQuantityBreakdown4 : BalanceTo
%% IPriorityNumeric5Choice recursion level 1 with max 1
%% IFinancialInstrumentQuantity15Choice recursion level 1 with max 1
%% GenericIdentification39 recursion level 1 with max 1
class GenericIdentification39{
    Identification IsoRestrictedFINMax30Text
    Issuer IsoRestrictedFINMax8Text
}
%% IDateAndDateTimeChoice recursion level 1 with max 1
%% SecuritiesSubBalanceTypeAndQuantityBreakdown4 recursion level 1 with max 1
SecuritiesSubBalanceTypeAndQuantityBreakdown4 *-- "1..1" ISecuritiesBalanceType8Choice : Type
SecuritiesSubBalanceTypeAndQuantityBreakdown4 *-- "0..0" QuantityBreakdown34 : QuantityBreakdown
%% SecuritiesSubBalanceTypeAndQuantityBreakdown4 recursion level 1 with max 1
SecuritiesSubBalanceTypeAndQuantityBreakdown4 *-- "1..1" ISecuritiesBalanceType8Choice : Type
SecuritiesSubBalanceTypeAndQuantityBreakdown4 *-- "0..0" QuantityBreakdown34 : QuantityBreakdown
  

IntraPositionDetails36 members

SupplementaryData building block

Additional information that cannot be captured in the structured elements 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 IntraPositionMovementInstruction002V04 implementation follows a specific implementaiton pattern. First of all, IntraPositionMovementInstruction002V04 impleemnts IOuterRecord indicating it is the outermost logical part of the message definition. Like all message wrappers, IntraPositionMovementInstruction002V04Document implements IOuterDocument. Because IntraPositionMovementInstruction002V04 implements IOuterDocument, it is a suitable template parameter for IOuterDocument, and causes the internal ‘Message’ to be of type IntraPositionMovementInstruction002V04.

classDiagram
    class IOuterRecord
    IntraPositionMovementInstruction002V04 --|> IOuterRecord : Implements
    IntraPositionMovementInstruction002V04Document --|> IOuterDocument~IntraPositionMovementInstruction002V04~ : Implements
    class IOuterDocument~IntraPositionMovementInstruction002V04~ {
        IntraPositionMovementInstruction002V04 Message
     }
  

Document wrapper for serialization

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

classDiagram
    IntraPositionMovementInstruction002V04Document *-- IntraPositionMovementInstruction002V04 : 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:semt.013.002.04">
    <IntraPosMvmntInstr>
        <TxId>
            <!-- TransactionIdentification inner content -->
        </TxId>
        <CorpActnEvtId>
            <!-- CorporateActionEventIdentification inner content -->
        </CorpActnEvtId>
        <NbCounts>
            <!-- NumberCounts inner content -->
        </NbCounts>
        <Lnkgs>
            <!-- Linkages inner content -->
        </Lnkgs>
        <AcctOwnr>
            <!-- AccountOwner inner content -->
        </AcctOwnr>
        <SfkpgAcct>
            <!-- SafekeepingAccount inner content -->
        </SfkpgAcct>
        <SfkpgPlc>
            <!-- SafekeepingPlace inner content -->
        </SfkpgPlc>
        <FinInstrmId>
            <!-- FinancialInstrumentIdentification inner content -->
        </FinInstrmId>
        <FinInstrmAttrbts>
            <!-- FinancialInstrumentAttributes inner content -->
        </FinInstrmAttrbts>
        <IntraPosDtls>
            <!-- IntraPositionDetails inner content -->
        </IntraPosDtls>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </IntraPosMvmntInstr>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_5PaGo5NLEeWGlc8L7oPDIg"
  nextVersions="_jJPNoyAZEeu4a6pNulzZ4Q"
  name="IntraPositionMovementInstruction002V04"
  definition="Scope&#xD;&#xA;An account owner sends a IntraPositionMovementInstruction to an account servicer to instruct the movement of securities within its holding from one sub-balance to another, for example, blocking of securities.&#xD;&#xA;The account owner/servicer relationship may be:&#xD;&#xA;- a global custodian which has an account with its local agent (sub-custodian), or&#xD;&#xA;- an investment management institution which manage a fund account opened at a custodian, or&#xD;&#xA;- a broker which has an account with a custodian, or&#xD;&#xA;- a central securities depository participant which has an account with a central securities depository, or&#xD;&#xA;- a central securities depository which has an account with a custodian, another central securities depository or another settlement market infrastructure.&#xD;&#xA;Usage&#xD;&#xA;The message may also be used to:&#xD;&#xA;- re-send a message previously sent,&#xD;&#xA;- provide a third party with a copy of a message for information,&#xD;&#xA;- re-send to a third party a copy of a message for information.&#xD;&#xA;using the relevant elements in the Business Application Header."
  registrationStatus="Registered"
  messageSet="_urpIICeJEeOCeO5e7islRQ"
  xmlTag="IntraPosMvmntInstr"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_5PaGpZNLEeWGlc8L7oPDIg"
    name="TransactionIdentification"
    definition="Unambiguous identification of the transaction as know by the instructing party."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="TxId"
    simpleType="_XZJV2Np-Ed-ak6NoX_4Aeg_-1555155859" />
  <messageBuildingBlock
    xmi:id="_5PaGp5NLEeWGlc8L7oPDIg"
    name="CorporateActionEventIdentification"
    definition="Identification assigned by the account servicer to unambiguously identify a corporate action event."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="CorpActnEvtId"
    complexType="_5PaGvZNLEeWGlc8L7oPDIg" />
  <messageBuildingBlock
    xmi:id="_5PaGqZNLEeWGlc8L7oPDIg"
    name="NumberCounts"
    definition="Count of the number of transactions linked."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="NbCounts"
    complexType="_QrsmZ9p-Ed-ak6NoX_4Aeg_994582654" />
  <messageBuildingBlock
    xmi:id="_5PaGq5NLEeWGlc8L7oPDIg"
    name="Linkages"
    definition="Link to another transaction that must be processed after, before or at the same time."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="Lnkgs"
    complexType="_5PaGy5NLEeWGlc8L7oPDIg" />
  <messageBuildingBlock
    xmi:id="_5PaGrZNLEeWGlc8L7oPDIg"
    name="AccountOwner"
    definition="Party that legally owns the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctOwnr"
    complexType="_cdRpP5KQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_5PaGr5NLEeWGlc8L7oPDIg"
    name="SafekeepingAccount"
    definition="Account to or from which a securities entry is made."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="SfkpgAcct"
    complexType="_5NXfXZNLEeWGlc8L7oPDIg" />
  <messageBuildingBlock
    xmi:id="_5PaGsZNLEeWGlc8L7oPDIg"
    name="SafekeepingPlace"
    definition="Place where the securities are safe-kept, physically or notionally. This place can be, for example, a local custodian, a Central Securities Depository (CSD) or an International Central Securities Depository (ICSD)."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="SfkpgPlc"
    complexType="_cj_8gZKQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_5PaGs5NLEeWGlc8L7oPDIg"
    name="FinancialInstrumentIdentification"
    definition="Financial instrument representing a sum of rights of the investor vis-a-vis the issuer."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="FinInstrmId"
    complexType="_cdRCO5KQEeWHWpTQn1FFVg" />
  <messageBuildingBlock
    xmi:id="_5PaGtZNLEeWGlc8L7oPDIg"
    name="FinancialInstrumentAttributes"
    definition="Elements characterising a financial instrument."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="FinInstrmAttrbts"
    complexType="_5NYtZZNLEeWGlc8L7oPDIg" />
  <messageBuildingBlock
    xmi:id="_5PaGt5NLEeWGlc8L7oPDIg"
    name="IntraPositionDetails"
    definition="Intra-position movement transaction details."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="IntraPosDtls"
    complexType="_5PgNg5NLEeWGlc8L7oPDIg" />
  <messageBuildingBlock
    xmi:id="_5PaGuZNLEeWGlc8L7oPDIg"
    name="SupplementaryData"
    definition="Additional information that cannot be captured in the structured elements and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SplmtryData"
    complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
  <messageDefinitionIdentifier
    businessArea="semt"
    messageFunctionality="013"
    flavour="002"
    version="04" />
</messageDefinition>

ISO Building Blocks

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