ZagTrader

setr: Securities Trade

setr.027 Securities Trade Confirmation

Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked

setr.027 is the ISO 20022 SecuritiesTradeConfirmation message in the Securities Trade business area (setr). The latest version is setr.027.001.05, and 5 versions are in the repository.

Message
SecuritiesTradeConfirmation
Latest version
setr.027.001.05
Submitting organisation
Not read from the catalogue
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What setr.027 is for

Sent by an executing party to an instructing party directly or through Central Matching Utility (CMU) to provide trade confirmation on a per-account basis based on instructions provided by the instructing party in the SecuritiesAllocationInstruction message.

It may also be used to provide trade confirmation on the trade level from an executing party or an instructing party to the custodian or an affirming party directly or through CMU.

The instructing party is typically the investment manager or an intermediary system/vendor communicating on behalf of the investment manager or of other categories of investors.

The executing party is typically the broker/dealer or an intermediary system/vendor communicating on behalf of the broker/dealer.

The custodian or the affirming party is typically the custodian, trustee, financial institution, intermediary system/vendor communicating on behalf of them, or their agent.

Initiator: In local matching, the initiator of this message is always the executing party. In central matching the initiator may be either the executing party or instructing party.

Respondent: instructing party, a custodian or an affirming party responds with SecuritiesTradeConfirmationResponse (accept or reject) message.

Definition from the ISO 20022 e-Repository, release of 24 April 2025.

setr.027 versions

Every version published in the e-Repository, newest first. A message keeps its business purpose across versions; each new version is a separate schema with its own namespace.

VersionRegistration statusPublished in
setr.027.001.05latestRegisteredLatest version set
setr.027.001.04RegisteredPrevious version set
setr.027.001.03RegisteredArchive
setr.027.001.02RegisteredArchive
setr.027.001.01RegisteredArchive

setr.027 message structure

The building blocks of setr.027.001.05 and the elements directly under them, with multiplicity ([0..1] optional, [1..1] mandatory, * any number) and the data type or component. Element names and definitions are from the ISO 20022 repository; usage guidelines such as CBPR+ or a market infrastructure's rules can restrict them further.

  • Document [1..1]
    • SctiesTradConf SecuritiesTradeConfirmation [1..1]
      • Id Identification [1..1]TransactiontIdentification4

        Information that unambiguously identifies an SecuritiesTradeConfirmation message as known by the account owner (or the instructing party acting on its behalf).

        • TxId Transaction Identification [1..1]Max35Text

          Unambiguous identification of the transaction as known by the instructing party.

      • NbCnt Number Count [0..1]NumberCount1Choice (choice)

        Count of the number of transactions linked.

        • CurInstrNb Current Instruction Number [1..1]Exact3NumericText

          Sequential number of the instruction in a range of linked settlement instructions.

        • TtlNb Total Number [1..1]TotalNumber1

          Total numbers of settlement transactions, receipts and deliveries, and the concerned settlement transaction number.

      • Refs References [0..*]Linkages76

        Reference to the transaction identifier issued by a business party and/or market infrastructure.

        • MsgNb Message Number [0..1]DocumentNumber17Choice (choice)

          Message type number/message identifier of the message referenced in the linkage sequence.

        • Ref Reference [1..1]IdentificationReference15Choice (choice)

          Reference to the linked transaction.

      • TradDtls Trade Details [1..1]Order24

        Details of the trade.

        • BizPrcTp Business Process Type [0..1]BusinessProcessType2Choice (choice)

          Specifies the type of business process.

        • OrdrId Order Identification [0..*]Max35Text

          Unique identifier for Order as assigned by sell-side.

        • ClntOrdrId Client Order Identification [0..*]Max35Text

          Unique identifier for the order as assigned by the buy-side.

        • ScndryClntOrdrId Secondary Client Order Identification [0..*]Max35Text

          Assigned by the party that originates the order.

        • ListId List Identification [0..*]Max35Text

          Unique identifier for a list, as assigned by the trading party.

        • Sd Side [1..1]Side3Code

          Coded list to specify the side of the order.

        • Pmt Payment [0..1]DeliveryReceiptType2Code

          Specifies how the transaction is to be settled, for example, against payment.

        • TradTxTp Trade Transaction Type [0..1]TradeType4Choice (choice)

          Specifies the type of transaction of which the order is a component.

        • 35 more elements not shown
      • FinInstrmId Financial Instrument Identification [1..1]SecurityIdentification19

        Unique and unambiguous identifier of a financial instrument, assigned under a formal or proprietary identification scheme.

        • ISIN ISIN [0..1]ISINOct2015Identifier

          International Securities Identification Number (ISIN).

        • OthrId Other Identification [0..*]OtherIdentification1

          Identification of a security by proprietary or domestic identification scheme.

        • Desc Description [0..1]Max140Text

          Textual description of a security instrument.

      • FinInstrmAttrbts Financial Instrument Attributes [0..1]FinancialInstrumentAttributes124

        Elements characterising a financial instrument.

        • PlcOfListg Place Of Listing [0..1]MarketIdentification3Choice (choice)

          Market(s) on which the security is listed.

        • Ratg Rating [0..1]Rating1

          Assessment of securities credit and investment risk.

        • CertNb Certificate Number [0..1]Max35Text

          Unique and unambiguous identifier of a certificate assigned by the issuer.

        • DayCntBsis Day Count Basis [0..1]InterestComputationMethodFormat4Choice (choice)

          Specifies the computation method of (accrued) interest of the security.

        • RegnForm Registration Form [0..1]FormOfSecurity6Choice (choice)

          Specifies the form, ie, ownership, of the security.

        • PmtFrqcy Payment Frequency [0..1]Frequency23Choice (choice)

          Specifies the frequency of an interest payment.

        • VarblRateChngFrqcy Variable Rate Change Frequency [0..1]Frequency23Choice (choice)

          Specifies the frequency of change to the variable rate of an interest bearing instrument.

        • ClssfctnTp Classification Type [0..1]ClassificationType32Choice (choice)

          Classification type of the financial instrument, as per the ISO Classification of Financial Instrument (CFI) codification, for example, common share...

        • 44 more elements not shown
      • UndrlygFinInstrm Underlying Financial Instrument [0..*]UnderlyingFinancialInstrument7

        Underlying financial instrument to which an trade confirmation is related.

        • Id Identification [1..1]SecurityIdentification19

          Identification of the underlying security by an ISIN.

        • Attrbts Attributes [0..1]FinancialInstrumentAttributes124

          Underlying financial instrument attributes to which an trade confirmation is related.

      • Stiptns Stipulations [0..1]FinancialInstrumentStipulations4

        Additional restrictions on the financial instrument, related to the stipulation.

        • Geogcs Geographics [0..1]Max35Text

          Type of stipulation expressing geographical constraints on a fixed income instrument.

        • YldRg Yield Range [0..1]AmountOrPercentageRange1

          Range of allowed yield.

        • Ratg Rating [0..1]Rating1

          Range of assessment of securities credit and investment risk.

        • CpnRg Coupon Range [0..1]AmountOrPercentageRange1

          Identification of a range of coupon numbers attached to its related financial instrument.

        • AmtsblInd Amortisable Indicator [0..1]YesNoIndicator

          Indicates whether the financial instrument repays the principal amount in parts during the life cycle of the security.

        • Purp Purpose [0..1]Max256Text

          Reason for which money is raised through the issuance of a security.

        • AltrntvMinTaxInd Alternative Minimum Tax Indicator [0..1]YesNoIndicator

          Identifies whether the issue is subject to alternative minimum taxation (used for municipal bonds).

        • AutoRinvstmt Auto Reinvestment [0..1]PercentageRate

          Indicates an instruction to reinvest dividends in the underlying security (or proceeds at maturity in a similar instrument) if the current rate is...

        • 33 more elements not shown
      • ConfPties Confirmation Parties [1..*]ConfirmationParties6

        Parties involved in the confirmation of the details of a trade.

        • Buyr Buyer [0..1]ConfirmationPartyDetails7

          Party that buys goods or services, or a financial instrument.

        • Brrwr Borrower [0..1]ConfirmationPartyDetails7

          Party that has applied, met specific requirements, and received a monetary or securities loan from a lender.

        • Sellr Seller [0..1]ConfirmationPartyDetails7

          Party that sells goods or services, or a financial instrument.

        • Lndr Lender [0..1]ConfirmationPartyDetails7

          A private, public or institutional entity which makes funds available to others to borrow.

        • BrkrOfCdt Broker Of Credit [0..1]ConfirmationPartyDetails8

          Brokerage firm which is the commissioned broker in a multi-broker trade.

        • IntrdcgFirm Introducing Firm [0..1]ConfirmationPartyDetails8

          Broker or other intermediary with the closest association with the investor.

        • StepInFirm Step In Firm [0..1]ConfirmationPartyDetails8

          Brokerage firm assigned to take credit on the trade from the step-out brokerage firm.

        • StepOutFirm Step Out Firm [0..1]ConfirmationPartyDetails8

          Brokerage firm that executes an order, but gives other firms credit and some of the commission for the trade.

        • 6 more elements not shown
      • SttlmParams Settlement Parameters [0..1]SettlementDetails213

        Parameters which explicitly state the conditions that must be fulfilled before a particular transaction of a financial instrument can be settled.

        • SttlmTxTp Settlement Transaction Type [1..1]SettlementTransactionType3Choice (choice)

          Indicates whether the trade is to be settled as principal or netted off against another trade.

        • HldInd Hold Indicator [0..1]YesNoIndicator

          Specifies whether the transaction is on hold/blocked/frozen.

        • Prty Priority [0..1]PriorityNumeric4Choice (choice)

          Specifies whether the transaction is to be executed with a high priority.

        • SttlmInstrGnrtn Settlement Instruction Generation [0..1]SettlementInstructionGeneration2Choice (choice)

          Specifies if the Electronic Trade Confirmation (ETC) service provider is to generate or not a settlement instruction.

        • SttlmTxCond Settlement Transaction Condition [0..*]SettlementTransactionCondition31Choice (choice)

          Conditions under which the order/trade is to be settled.

        • PrtlSttlmInd Partial Settlement Indicator [0..1]YesNoIndicator

          Specifies whether partial settlement is allowed.

        • BnfclOwnrsh Beneficial Ownership [0..1]BeneficialOwnership4Choice (choice)

          Specifies whether there is change of beneficial ownership.

        • BlckTrad Block Trade [0..1]BlockTrade4Choice (choice)

          Specifies whether the settlement instruction is a block parent or child.

        • 22 more elements not shown
      • StgSttlmInstr Standing Settlement Instruction [0..1]StandingSettlementInstruction13

        Specifies what settlement standing instruction database is to be used to derive the settlement parties involved in the transaction.

        • SttlmStgInstrDB Settlement Standing Instruction Database [1..1]SettlementStandingInstructionDatabase4Choice (choice)

          Specifies what settlement standing instruction database is to be used to derive the settlement parties involved in the transaction.

        • Vndr Vendor [0..1]PartyIdentification117Choice (choice)

          Vendor of the Settlement Standing Instruction database requested to be consulted.

        • OthrDlvrgSttlmPties Other Delivering Settlement Parties [0..1]SettlementParties59

          Delivering parties, other than the seller, needed for deriving the standing settlement instruction (for example, depository) or provided for...

        • OthrRcvgSttlmPties Other Receiving Settlement Parties [0..1]SettlementParties59

          Receiving parties, other than the buyer, needed for deriving the standing settlement instruction (for example, depository) or provided for...

      • DlvrgSttlmPties Delivering Settlement Parties [0..1]SettlementParties59

        Specifies the chain of delivering settlement parties.

        • Dpstry Depository [0..1]PartyIdentification118

          First party in the settlement chain.

        • Pty1 Party1 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the depository.

        • Pty2 Party2 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 1.

        • Pty3 Party3 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 2.

        • Pty4 Party4 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 3.

        • Pty5 Party5 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 4.

      • RcvgSttlmPties Receiving Settlement Parties [0..1]SettlementParties59

        Specifies the chain of receiving settlement parties.

        • Dpstry Depository [0..1]PartyIdentification118

          First party in the settlement chain.

        • Pty1 Party1 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the depository.

        • Pty2 Party2 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 1.

        • Pty3 Party3 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 2.

        • Pty4 Party4 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 3.

        • Pty5 Party5 [0..1]PartyIdentificationAndAccount155

          Party that, in a settlement chain interacts with the party 4.

      • CshPties Cash Parties [0..1]CashParties33

        Cash parties involved in the specific transaction.

        • Dbtr Debtor [0..1]PartyIdentificationAndAccount148

          Party that owes an amount of money to the (ultimate) creditor.

        • DbtrAgt Debtor Agent [0..1]PartyIdentificationAndAccount148

          Financial institution servicing an account for the debtor.

        • Cdtr Creditor [0..1]PartyIdentificationAndAccount148

          Party to which an amount of money is due.

        • CdtrAgt Creditor Agent [0..1]PartyIdentificationAndAccount148

          Financial institution servicing an account for the creditor.

        • Intrmy Intermediary [0..1]PartyIdentificationAndAccount148

          Financial institution through which the transaction must pass to reach the account with institution.

      • ClrDtls Clearing Details [0..1]Clearing5

        Provides clearing member information.

        • ClrMmb Clearing Member [1..*]PartyIdentificationAndAccount149

          Provides details about the clearing member identification and account.

        • ClrSgmt Clearing Segment [0..1]PartyIdentification127Choice (choice)

          Clearing organisation that will clear the trade.

      • SttlmAmt Settlement Amount [0..1]AmountAndDirection28

        Total amount of money to be paid or received in exchange for the securities.

        • AcrdIntrstInd Accrued Interest Indicator [0..1]YesNoIndicator

          Indicates whether the net proceeds include interest accrued on the financial instrument.

        • StmpDtyInd Stamp Duty Indicator [0..1]YesNoIndicator

          Indicates whether the settlement amount includes the stamp duty amount.

        • Amt Amount [1..1]ActiveCurrencyAndAmount

          Amount of money in the cash entry.

        • CdtDbtInd Credit Debit Indicator [0..1]CreditDebitCode

          Indicates whether an entry is a credit or a debit.

        • OrgnlCcyAndOrdrdAmt Original Currency And Ordered Amount [0..1]ActiveOrHistoricCurrencyAndAmount

          Posting/settlement amount in its original currency when conversion from/into another currency has occurred.

        • FXDtls Foreign Exchange Details [0..1]ForeignExchangeTerms18

          Information needed to process a currency exchange or conversion.

        • ValDt Value Date [0..1]DateAndDateTime1Choice (choice)

          Date and time at which the cash is at the disposal of the credit account owner, or ceases to be at the disposal of the debit account owner.

      • OthrAmts Other Amounts [0..*]OtherAmounts16

        Other amounts than the settlement amount.

        • ChrgsFees Charges Fees [0..1]AmountAndDirection29

          Amount of money paid for the provision of financial services that cannot be categorised by another qualifier.

        • CtryNtlFdrlTax Country National Federal Tax [0..1]AmountAndDirection29

          Amount of country, national or federal tax charged by the jurisdiction in which the account servicer is located.

        • ExctgBrkrAmt Executing Broker Amount [0..1]AmountAndDirection29

          Amount of money paid to an executing broker as a commission.

        • IsseDscntAllwnc Issue Discount Allowance [0..1]AmountAndDirection29

          Amount of money defined as a discount on a new issue or on a tranche of an existing issue.

        • PmtLevyTax Payment Levy Tax [0..1]AmountAndDirection29

          Amount of payment levy tax.

        • LclTax Local Tax [0..1]AmountAndDirection29

          Tax charged by the jurisdiction in which the financial instrument settles.

        • LclBrkrComssn Local Broker Commission [0..1]AmountAndDirection29

          Amount of commission paid to a local broker.

        • Mrgn Margin [0..1]AmountAndDirection29

          Amount of money deposited by the trading party in a margin account.

        • 32 more elements not shown
      • OthrPrics Other Prices [0..*]OtherPrices5

        Other prices than the deal price.

        • Max Maximum [0..1]Price14

          Specifies the maximum price.

        • Tx Transaction [0..1]Price14

          Specifies the transaction price.

        • MktBrkrComssn Market Broker Commission [0..1]Price14

          Market price including or excluding the broker's commission.

        • MrkdUp Marked Up [0..1]Price14

          In case of an order to buy, the price that the broker paid on the market plus the broker's commission.

        • MrkdDwn Marked Down [0..1]Price14

          In case of an order to sell, the price the broker receives in the market minus the broker's commission.

        • NetDscld Net Disclosed [0..1]Price14

          Price is net to the disclosed client.

        • NetUdscld Net Undisclosed [0..1]Price14

          Price is net to the client undisclosed (used in the UK market).

        • NtnlGrss Notional Gross [0..1]Price14

          Price is notional gross (used in the UK market).

        • 7 more elements not shown
      • OthrBizPties Other Business Parties [0..1]OtherParties32

        Other business parties relevant to the transaction.

        • Invstr Investor [0..*]PartyIdentificationAndAccount150

          Party that identifies the underlying investor.

        • StockXchg Stock Exchange [0..1]PartyIdentificationAndAccount152

          Party that identifies the stock exchange.

        • TradRgltr Trade Regulator [0..1]PartyIdentificationAndAccount152

          Party that identifies the trade regulator.

        • TrptyAgt Triparty Agent [0..1]PartyIdentificationAndAccount154

          Party that handles tri-party transactions.

        • QlfdFrgnIntrmy Qualified Foreign Intermediary [0..1]PartyIdentificationAndAccount151

          Foreign Financial Institution which has been authorised by local authorities to act as account management institution in the country.

      • TwoLegTxDtls Two Leg Transaction Details [0..1]TwoLegTransactionDetails5

        Specifies a transaction that the trading parties are agreeing to repurchase, sell back or return the same or similar securities at a later time.

        • TradDt Trade Date [0..1]TradeDate8Choice (choice)

          Specifies the date/time on which the trade was executed.

        • OpngLegId Opening Leg Identification [0..1]Max35Text

          Unambiguous identification of the reference assigned in the first leg of the transaction.

        • ClsgLegId Closing Leg Identification [0..1]Max35Text

          Unambiguous identification of the second leg of the transaction as known by the account owner (or the instructing party acting on its behalf).

        • GrssTradAmt Gross Trade Amount [0..1]AmountAndDirection29

          Principal amount of a trade (price multiplied by quantity).

        • OthrAmts Other Amounts [0..*]OtherAmounts16

          Identifies other amounts pertaining to the transaction.

        • ScndLegNrrtv Second Leg Narrative [0..1]Max140Text

          Provides additional information about the second leg in narrative form.

        • EndPric End Price [0..1]Price14

          Negotiated fixed price of the security to buy it back.

        • ClsgDt Closing Date [0..1]ClosingDate4Choice (choice)

          Closing date/time or maturity date/time of the transaction.

        • 3 more elements not shown
      • RgltryStiptns Regulatory Stipulations [0..1]RegulatoryStipulations1

        Specifies regulatory stipulations that financial institutions must be compliant with in the country, region, and/or area they conduct business.

        • Ctry Country [1..1]CountryCode

          Nation with its own government, occupying a particular territory.

        • Stiptns Stipulations [1..*]Max350Text

          Specifies regulatory stipulations that financial institutions must be compliant with in the country, region, and/or where they conduct business.

      • SplmtryData Supplementary Data [0..*]SupplementaryData1

        Additional information that cannot be captured in the structured elements and/or any other specific block.

        • PlcAndNm Place And Name [0..1]Max350Text

          Unambiguous reference to the location where the supplementary data must be inserted in the message instance.

        • Envlp Envelope [1..1]SupplementaryDataEnvelope1

          Technical element wrapping the supplementary data.

Have a setr.027 message? Paste it into the parser to see every element with its name and definition, and format checks on BICs, IBANs, dates and amounts.

External code sets used in setr.027

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

setr.027 questions

What is the latest version of setr.027?
The latest version in the ISO 20022 e-Repository release of 24 April 2025 is setr.027.001.05.
What is the root element of setr.027?
The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:setr.027.001.05, and its message element is SctiesTradConf (SecuritiesTradeConfirmation).
Is there an MT equivalent of setr.027?
No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

All ISO 20022 messages · ISO 20022 code sets · MT messages

The ISO 20022 message definitions, element names and definitions on this page are reproduced from material published at iso20022.org under the ISO 20022 Intellectual Property Rights policy. This is not the official source: the up-to-date ISO 20022 standards and repository material are published only at iso20022.org. Explanations in our own words are by ZagTrader. ZagTrader is not affiliated with or endorsed by ISO or Swift.