BuyInConfirmationV03

secl.009.001.03

Scope The Buy In Confirmation message is sent by the central counterparty (CCP) to the clearing member to confirm the details of the transaction resulting from the buy in.

The message definition is intended for use with the ISO 20022 Business Application Header.

Usage The Buy In Confirmation message is sent by the central counterparty (CCP) to confirm the details of the buy in transaction.

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
%% BuyInConfirmationV03 recursion level 0 with max 0
class BuyInConfirmationV03{
    TransactionIdentification IsoMax35Text
}
BuyInConfirmationV03 *-- "1..1" IPartyIdentification35Choice : ClearingMember
BuyInConfirmationV03 *-- "1..1" BuyIn2 : BuyInDetails
BuyInConfirmationV03 *-- "0..1" SettlementObligation7 : OriginalSettlementObligation
BuyInConfirmationV03 *-- "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 known by the instructing party. Specifies a character string with a maximum length of 35 characters. For comparison, see the ISO20022 official specification This message is declared as Max35Text in the ISO specification. In our implementation, it is represented in source code as IsoMax35Text. Due to global using directives, it is treated as a System.String by the compiler and runtime.

ClearingMember building block

Provides the identification of the clearing member (individual clearing member or general clearing member). Choice of identification of a party. The party can be identified by giving a BIC or a proprietary code. For comparison, see the ISO20022 official specification

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

PartyIdentification35Choice members

BuyInDetails building block

Provides the buy-in details. Specifies elements related to the confirmation sent by the central counterparty to the clearing member in the context of the buy in process. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% BuyIn2 recursion level 0 with max 1
class BuyIn2{
    BuyInNotificationIdentification IsoMax35Text
    BuyInIdentification IsoMax35Text
    Date IsoISODate
}
BuyIn2 *-- "0..1" Price4 : Price
BuyIn2 *-- "0..1" SecuritiesCompensation1 : SecuritiesBuyIn
BuyIn2 *-- "0..1" CashCompensation1 : RequiredCashCompensation
%% Price4 recursion level 1 with max 1
class Price4{
    Type PriceValueType7Code
}
Price4 *-- "1..1" IPriceRateOrAmountChoice : Value
%% SecuritiesCompensation1 recursion level 1 with max 1
SecuritiesCompensation1 *-- "1..1" IPartyIdentification34Choice : Depository
SecuritiesCompensation1 *-- "1..1" AmountAndDirection20 : SettlementAmount
SecuritiesCompensation1 *-- "0..1" AmountAndDirection20 : Fees
%% CashCompensation1 recursion level 1 with max 1
class CashCompensation1{
    ValueDate IsoISODate
}
CashCompensation1 *-- "1..1" AmountAndDirection20 : SettlementAmount
CashCompensation1 *-- "0..1" AmountAndDirection20 : Fees
  

BuyIn2 members

OriginalSettlementObligation building block

Provides details about the original settlement obligation that did not settle and for which the buy in process will be launched. Provides details about the settlement obligation. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SettlementObligation7 recursion level 0 with max 1
class SettlementObligation7{
    CSDTransactionIdentification IsoMax35Text
    CentralCounterpartyTransactionIdentification IsoMax35Text
    PreviousBuyInIdentification IsoMax35Text
    IntendedSettlementDate IsoISODate
    TradeDate IsoISODate
}
SettlementObligation7 *-- "0..1" SecuritiesAccount19 : DeliveryAccount
SettlementObligation7 *-- "0..1" ISafekeepingPlaceFormat7Choice : SafekeepingPlace
SettlementObligation7 *-- "0..1" SecuritiesAccount19 : SafekeepingAccount
SettlementObligation7 *-- "0..1" IPartyIdentification35Choice : ClearingSegment
SettlementObligation7 *-- "0..1" PartyIdentificationAndAccount31 : NonClearingMember
SettlementObligation7 *-- "1..1" SecurityIdentification14 : FinancialInstrumentIdentification
SettlementObligation7 *-- "0..1" Price4 : DealPrice
SettlementObligation7 *-- "1..1" IFinancialInstrumentQuantity1Choice : Quantity
SettlementObligation7 *-- "0..1" IPartyIdentification34Choice : Depository
SettlementObligation7 *-- "0..1" IFinancialInstrumentQuantity1Choice : RemainingQuantityToBeSettled
SettlementObligation7 *-- "1..1" AmountAndDirection27 : SettlementAmount
SettlementObligation7 *-- "0..1" AmountAndDirection27 : RemainingAmountToBeSettled
%% SecuritiesAccount19 recursion level 1 with max 1
class SecuritiesAccount19{
    Identification IsoMax35Text
    Name IsoMax70Text
}
SecuritiesAccount19 *-- "0..1" GenericIdentification30 : Type
%% ISafekeepingPlaceFormat7Choice recursion level 1 with max 1
%% SecuritiesAccount19 recursion level 1 with max 1
class SecuritiesAccount19{
    Identification IsoMax35Text
    Name IsoMax70Text
}
SecuritiesAccount19 *-- "0..1" GenericIdentification30 : Type
%% IPartyIdentification35Choice recursion level 1 with max 1
%% PartyIdentificationAndAccount31 recursion level 1 with max 1
PartyIdentificationAndAccount31 *-- "1..1" IPartyIdentification33Choice : Identification
PartyIdentificationAndAccount31 *-- "0..1" AlternatePartyIdentification4 : AlternateIdentification
PartyIdentificationAndAccount31 *-- "0..1" PartyTextInformation1 : AdditionalInformation
PartyIdentificationAndAccount31 *-- "0..1" SecuritiesAccount18 : ClearingAccount
%% SecurityIdentification14 recursion level 1 with max 1
class SecurityIdentification14{
    ISIN IsoISINIdentifier
    Description IsoMax140Text
}
SecurityIdentification14 *-- "0..0" OtherIdentification1 : OtherIdentification
%% Price4 recursion level 1 with max 1
class Price4{
    Type PriceValueType7Code
}
Price4 *-- "1..1" IPriceRateOrAmountChoice : Value
%% IFinancialInstrumentQuantity1Choice recursion level 1 with max 1
%% IPartyIdentification34Choice recursion level 1 with max 1
%% IFinancialInstrumentQuantity1Choice recursion level 1 with max 1
%% AmountAndDirection27 recursion level 1 with max 1
class AmountAndDirection27{
    Amount IsoActiveCurrencyAndAmount
    CreditDebitIndicator CreditDebitCode
    OriginalCurrencyAndOrderedAmount IsoActiveOrHistoricCurrencyAndAmount
}
AmountAndDirection27 *-- "0..1" ForeignExchangeTerms17 : ForeignExchangeDetails
%% AmountAndDirection27 recursion level 1 with max 1
class AmountAndDirection27{
    Amount IsoActiveCurrencyAndAmount
    CreditDebitIndicator CreditDebitCode
    OriginalCurrencyAndOrderedAmount IsoActiveOrHistoricCurrencyAndAmount
}
AmountAndDirection27 *-- "0..1" ForeignExchangeTerms17 : ForeignExchangeDetails
  

SettlementObligation7 members

SupplementaryData building block

Additional information that can not be captured in the structured fields and/or any other specific block. Additional information that can not be captured in the structured fields and/or any other specific block. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SupplementaryData1 recursion level 0 with max 1
class SupplementaryData1{
    PlaceAndName IsoMax350Text
}
SupplementaryData1 *-- "1..1" IsoSupplementaryDataEnvelope1 : Envelope
%% IsoSupplementaryDataEnvelope1 recursion level 1 with max 1
  

SupplementaryData1 members

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    BuyInConfirmationV03 --|> IOuterRecord : Implements
    BuyInConfirmationV03Document --|> IOuterDocument~BuyInConfirmationV03~ : Implements
    class IOuterDocument~BuyInConfirmationV03~ {
        BuyInConfirmationV03 Message
     }
  

Document wrapper for serialization

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

classDiagram
    BuyInConfirmationV03Document *-- BuyInConfirmationV03 : 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:secl.009.001.03">
    <BuyInConf>
        <TxId>
            <!-- TransactionIdentification inner content -->
        </TxId>
        <ClrMmb>
            <!-- ClearingMember inner content -->
        </ClrMmb>
        <BuyInDtls>
            <!-- BuyInDetails inner content -->
        </BuyInDtls>
        <OrgnlSttlmOblgtn>
            <!-- OriginalSettlementObligation inner content -->
        </OrgnlSttlmOblgtn>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </BuyInConf>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_xpFSkS0lEeSRe9rElPHBfg"
  name="BuyInConfirmationV03"
  definition="Scope&#xD;&#xA;The Buy In Confirmation message is sent by the central counterparty (CCP) to the clearing member to confirm the details of the transaction resulting from the buy in.&#xD;&#xA;&#xD;&#xA;The message definition is intended for use with the ISO 20022 Business Application Header.&#xD;&#xA;&#xD;&#xA;Usage&#xD;&#xA;The Buy In Confirmation message is sent by the central counterparty (CCP) to confirm the details of the buy in transaction."
  registrationStatus="Registered"
  messageSet="_vZbScWwCEeSvG_1tXIrsqQ"
  xmlTag="BuyInConf"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_xpFSky0lEeSRe9rElPHBfg"
    name="TransactionIdentification"
    definition="Unambiguous identification of the transaction as known by the instructing party."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="TxId"
    simpleType="_YW1tKdp-Ed-ak6NoX_4Aeg_1913463446" />
  <messageBuildingBlock
    xmi:id="_xpFSlS0lEeSRe9rElPHBfg"
    name="ClearingMember"
    definition="Provides the identification of the clearing member (individual clearing member or general clearing member)."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="ClrMmb"
    complexType="_QPYd4dp-Ed-ak6NoX_4Aeg_-1523931735" />
  <messageBuildingBlock
    xmi:id="_xpFSly0lEeSRe9rElPHBfg"
    name="BuyInDetails"
    definition="Provides the buy-in details."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="BuyInDtls"
    complexType="_Uot1ldp-Ed-ak6NoX_4Aeg_1022669122" />
  <messageBuildingBlock
    xmi:id="_xpFSmS0lEeSRe9rElPHBfg"
    name="OriginalSettlementObligation"
    definition="Provides details about the original settlement obligation that did not settle and for which the buy in process will be launched."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="OrgnlSttlmOblgtn"
    complexType="_Bu5zUS9aEeS94oXWDaBauA" />
  <messageBuildingBlock
    xmi:id="_xpFSmy0lEeSRe9rElPHBfg"
    name="SupplementaryData"
    definition="Additional information that can not be captured in the structured fields and/or any other specific block."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="SplmtryData"
    complexType="_Qn0zC9p-Ed-ak6NoX_4Aeg_468227563" />
  <messageDefinitionIdentifier
    businessArea="secl"
    messageFunctionality="009"
    flavour="001"
    version="03" />
</messageDefinition>

ISO Building Blocks

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