BuyInRegulatoryAdviceResponseV01

sese.042.001.01

Scope

An account servicer sends a BuyInRegulatoryAdviceResponse to an account owner to advise the status of a buy-in report previously instructed by the account owner.

The account servicer/owner relationship may be:

a central securities depository or another settlement market infrastructure acting on behalf of their participants
an agent (sub-custodian) acting on behalf of their global custodian customer, or
a custodian acting on behalf of an investment management institution or a broker/dealer.

Usage

A BuyInRegulatpryReport may contain reports on multiple transactions. However, one BuyInRegulatoryReportStatusAdvice must be sent per transaction reported unless the BuyInRegulatoryReport is rejected as a whole.

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
%% BuyInRegulatoryAdviceResponseV01 recursion level 0 with max 0
BuyInRegulatoryAdviceResponseV01 *-- "1..1" Identification14 : AdviceReference
BuyInRegulatoryAdviceResponseV01 *-- "0..1" PartyIdentification144 : AccountOwner
BuyInRegulatoryAdviceResponseV01 *-- "0..1" SecuritiesAccount19 : SafekeepingAccount
BuyInRegulatoryAdviceResponseV01 *-- "0..1" BuyInAdviceDetails1 : BuyInAttributes
BuyInRegulatoryAdviceResponseV01 *-- "1..1" IProcessingStatus79Choice : ProcessingStatus
BuyInRegulatoryAdviceResponseV01 *-- "0..1" SupplementaryData1 : SupplementaryData

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

AdviceReference building block

Identification of the BuyInRegulatoryAdvice message for which the response is provided. Unique identifier of a document, message or transaction. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% Identification14 recursion level 0 with max 1
class Identification14{
    Identification IsoMax35Text
}

Identification14 members

Member name	Description	Data Type / Multiplicity
Identification	Unique identifier of a document, message or transaction.	IsoMax35Text - Required 1..1

AccountOwner building block

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

classDiagram
   direction tb
%% PartyIdentification144 recursion level 0 with max 1
class PartyIdentification144{
    LEI IsoLEIIdentifier
}
PartyIdentification144 *-- "1..1" IPartyIdentification127Choice : Identification
%% IPartyIdentification127Choice recursion level 1 with max 1

PartyIdentification144 members

Member name	Description	Data Type / Multiplicity
Identification	Unique identification of the party.	IPartyIdentification127Choice - Required 1..1
LEI	Legal entity identification as an alternate identification for a party.	IsoLEIIdentifier - Optional 0..1

SafekeepingAccount building block

Account used in the original failing transaction. Account to or from which a securities entry is made. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% SecuritiesAccount19 recursion level 0 with max 1
class SecuritiesAccount19{
    Identification IsoMax35Text
    Name IsoMax70Text
}
SecuritiesAccount19 *-- "0..1" GenericIdentification30 : Type
%% GenericIdentification30 recursion level 1 with max 1
class GenericIdentification30{
    Identification IsoExact4AlphaNumericText
    Issuer IsoMax35Text
    SchemeName IsoMax35Text
}

SecuritiesAccount19 members

Member name	Description	Data Type / Multiplicity
Identification	Unambiguous identification for the account between the account owner and the account servicer.	IsoMax35Text - Required 1..1
Type	Specifies the type of securities account.	GenericIdentification30 - Optional 0..1
Name	Description of the account.	IsoMax70Text - Optional 0..1

BuyInAttributes building block

Details of the buy-in. Details of a buy-in. For comparison, see the ISO20022 official specification

classDiagram
   direction tb
%% BuyInAdviceDetails1 recursion level 0 with max 1
class BuyInAdviceDetails1{
    BuyInState BuyInState1Code
    BuyInDeferral BuyInDeferral1Code
}
BuyInAdviceDetails1 *-- "1..1" References23 : Reference
BuyInAdviceDetails1 *-- "0..1" SecurityIdentification19 : FinancialInstrumentIdentification
BuyInAdviceDetails1 *-- "0..1" IFinancialInstrumentQuantity1Choice : Quantity
BuyInAdviceDetails1 *-- "0..1" IRateAndAmountFormat39Choice : BuyInPrice
BuyInAdviceDetails1 *-- "0..1" AmountAndDirection102 : CashCompensationAmount
BuyInAdviceDetails1 *-- "0..1" IDateAndDateTime2Choice : BuyInSettlementDate
%% References23 recursion level 1 with max 1
class References23{
    AccountOwnerTransactionIdentification IsoMax35Text
    AccountServicerTransactionIdentification IsoMax35Text
    MarketInfrastructureTransactionIdentification IsoMax35Text
    ProcessorTransactionIdentification IsoMax35Text
    PoolIdentification IsoMax35Text
    CommonIdentification IsoMax35Text
    TradeIdentification IsoMax52Text
}
%% SecurityIdentification19 recursion level 1 with max 1
class SecurityIdentification19{
    ISIN IsoISINOct2015Identifier
    Description IsoMax140Text
}
SecurityIdentification19 *-- "0..0" OtherIdentification1 : OtherIdentification
%% IFinancialInstrumentQuantity1Choice recursion level 1 with max 1
%% IRateAndAmountFormat39Choice recursion level 1 with max 1
%% AmountAndDirection102 recursion level 1 with max 1
class AmountAndDirection102{
    Amount IsoActiveCurrencyAndAmount
    Sign IsoPlusOrMinusIndicator
}
%% IDateAndDateTime2Choice recursion level 1 with max 1

BuyInAdviceDetails1 members

Member name	Description	Data Type / Multiplicity
Reference	References of the failing transaction.	References23 - Required 1..1
BuyInState	Status of the buy-in transaction.	BuyInState1Code - Required 1..1
BuyInDeferral	Specifies if the buy-in transaction was deferred or not.	BuyInDeferral1Code - Required 1..1
FinancialInstrumentIdentification	Identification of the financial instrument of the buy-in instruction.	SecurityIdentification19 - Optional 0..1
Quantity	Quantity of financial instrument concerned by the buy-in transaction.	IFinancialInstrumentQuantity1Choice - Optional 0..1
BuyInPrice	Price of the traded financial instrument in the buy-in transaction.	IRateAndAmountFormat39Choice - Optional 0..1
CashCompensationAmount	Amount of money that has to be paid by the failing trading party in case of an unsuccessful or partially successful buy-in transaction.	AmountAndDirection102 - Optional 0..1
BuyInSettlementDate	Settlement date of the buy-in.	IDateAndDateTime2Choice - Optional 0..1

ProcessingStatus building block

Provides details on the processing status of the advice. Choice of format for a processing status. For comparison, see the ISO20022 official specification

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

ProcessingStatus79Choice members

Member name	Description	Data Type / Multiplicity

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

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

Extensibility and generalization considerations

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

classDiagram
    class IOuterRecord
    BuyInRegulatoryAdviceResponseV01 --|> IOuterRecord : Implements
    BuyInRegulatoryAdviceResponseV01Document --|> IOuterDocument~BuyInRegulatoryAdviceResponseV01~ : Implements
    class IOuterDocument~BuyInRegulatoryAdviceResponseV01~ {
        BuyInRegulatoryAdviceResponseV01 Message
     }

Document wrapper for serialization

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

classDiagram
    BuyInRegulatoryAdviceResponseV01Document *-- BuyInRegulatoryAdviceResponseV01 : 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:sese.042.001.01">
    <BuyInRgltryAdvcRspn>
        <AdvcRef>
            <!-- AdviceReference inner content -->
        </AdvcRef>
        <AcctOwnr>
            <!-- AccountOwner inner content -->
        </AcctOwnr>
        <SfkpgAcct>
            <!-- SafekeepingAccount inner content -->
        </SfkpgAcct>
        <BuyInAttrbts>
            <!-- BuyInAttributes inner content -->
        </BuyInAttrbts>
        <PrcgSts>
            <!-- ProcessingStatus inner content -->
        </PrcgSts>
        <SplmtryData>
            <!-- SupplementaryData inner content -->
        </SplmtryData>
    </BuyInRgltryAdvcRspn>
</Document>

Data from ISO specification

This is the technical data from the specification document.

<messageDefinition
  xmi:id="_DFqK8ZwYEeqtp-LOti013g"
  name="BuyInRegulatoryAdviceResponseV01"
  definition="Scope&#xD;&#xA;&#xA;An account servicer sends a BuyInRegulatoryAdviceResponse to an account owner to advise the status of a buy-in report previously instructed by the account owner.&#xD;&#xA;&#xA;The account servicer/owner relationship may be:&#xA;&#xD;&#xA;- a central securities depository or another settlement market infrastructure acting on behalf of their participants&#xA;&#xD;&#xA;- an agent (sub-custodian) acting on behalf of their global custodian customer, or&#xA;&#xD;&#xA;- a custodian acting on behalf of an investment management institution or a broker/dealer.&#xA;&#xA;&#xD;&#xA;&#xD;&#xA;Usage&#xD;&#xA;&#xA;A BuyInRegulatpryReport may contain reports on multiple transactions. However, one BuyInRegulatoryReportStatusAdvice must be sent per transaction reported  unless the BuyInRegulatoryReport is rejected as a whole.&#xA;&#xA;&#xD;&#xA;The message may also be used to:&#xA;- re-send a message previously sent,&#xD;&#xA;&#xA;- provide a third party with a copy of a message for information,&#xA;&#xD;&#xA;- re-send to a third party a copy of a message for information using the relevant elements in the Business Application Header."
  registrationStatus="Registered"
  messageSet="_jMnLMJwWEeqtp-LOti013g"
  xmlTag="BuyInRgltryAdvcRspn"
  rootElement="Document"
  xmlns:xmi="http://www.omg.org/XMI">
  <messageBuildingBlock
    xmi:id="_DFqK-ZwYEeqtp-LOti013g"
    previousVersion="_19xJ49BmEeihG9bKfarOOA"
    name="AdviceReference"
    definition="Identification of the BuyInRegulatoryAdvice message for which the response is provided."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="AdvcRef"
    complexType="_jXzlYu5NEeCisYr99QEiWA_-2122254183" />
  <messageBuildingBlock
    xmi:id="_DFqK-5wYEeqtp-LOti013g"
    previousVersion="_19xJ5dBmEeihG9bKfarOOA"
    name="AccountOwner"
    definition="Party that legally owns the account."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="AcctOwnr"
    complexType="_XnxoYdLCEeiN28wlpBQScw" />
  <messageBuildingBlock
    xmi:id="_DFqK_ZwYEeqtp-LOti013g"
    previousVersion="_19xJ59BmEeihG9bKfarOOA"
    name="SafekeepingAccount"
    definition="Account used in the original failing transaction."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="0"
    xmlTag="SfkpgAcct"
    complexType="_T_JUKtp-Ed-ak6NoX_4Aeg_1976638301" />
  <messageBuildingBlock
    xmi:id="_4Pp1QZwYEeqtp-LOti013g"
    name="BuyInAttributes"
    definition="Details of the buy-in."
    registrationStatus="Provisionally Registered"
    minOccurs="0"
    xmlTag="BuyInAttrbts"
    complexType="_fGNv0ZwREeqtp-LOti013g" />
  <messageBuildingBlock
    xmi:id="_DFqLAZwYEeqtp-LOti013g"
    previousVersion="_19xJ69BmEeihG9bKfarOOA"
    name="ProcessingStatus"
    definition="Provides details on the processing status of the advice."
    registrationStatus="Provisionally Registered"
    maxOccurs="1"
    minOccurs="1"
    xmlTag="PrcgSts"
    complexType="_Hk0BYZwZEeqtp-LOti013g" />
  <messageBuildingBlock
    xmi:id="_DFqLA5wYEeqtp-LOti013g"
    previousVersion="_19xJ7dBmEeihG9bKfarOOA"
    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="sese"
    messageFunctionality="042"
    flavour="001"
    version="01" />
</messageDefinition>

ISO Building Blocks

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