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.
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.
| Version | Registration status | Published in |
|---|---|---|
| setr.027.001.05latest | Registered | Latest version set |
| setr.027.001.04 | Registered | Previous version set |
| setr.027.001.03 | Registered | Archive |
| setr.027.001.02 | Registered | Archive |
| setr.027.001.01 | Registered | Archive |
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]SctiesTradConfSecuritiesTradeConfirmation [1..1]IdIdentification [1..1]TransactiontIdentification4Information that unambiguously identifies an SecuritiesTradeConfirmation message as known by the account owner (or the instructing party acting on its behalf).
TxIdTransaction Identification [1..1]Max35TextUnambiguous identification of the transaction as known by the instructing party.
NbCntNumber Count [0..1]NumberCount1Choice (choice)Count of the number of transactions linked.
CurInstrNbCurrent Instruction Number [1..1]Exact3NumericTextSequential number of the instruction in a range of linked settlement instructions.
TtlNbTotal Number [1..1]TotalNumber1Total numbers of settlement transactions, receipts and deliveries, and the concerned settlement transaction number.
RefsReferences [0..*]Linkages76Reference to the transaction identifier issued by a business party and/or market infrastructure.
MsgNbMessage Number [0..1]DocumentNumber17Choice (choice)Message type number/message identifier of the message referenced in the linkage sequence.
RefReference [1..1]IdentificationReference15Choice (choice)Reference to the linked transaction.
TradDtlsTrade Details [1..1]Order24Details of the trade.
BizPrcTpBusiness Process Type [0..1]BusinessProcessType2Choice (choice)Specifies the type of business process.
OrdrIdOrder Identification [0..*]Max35TextUnique identifier for Order as assigned by sell-side.
ClntOrdrIdClient Order Identification [0..*]Max35TextUnique identifier for the order as assigned by the buy-side.
ScndryClntOrdrIdSecondary Client Order Identification [0..*]Max35TextAssigned by the party that originates the order.
ListIdList Identification [0..*]Max35TextUnique identifier for a list, as assigned by the trading party.
SdSide [1..1]Side3CodeCoded list to specify the side of the order.
PmtPayment [0..1]DeliveryReceiptType2CodeSpecifies how the transaction is to be settled, for example, against payment.
TradTxTpTrade Transaction Type [0..1]TradeType4Choice (choice)Specifies the type of transaction of which the order is a component.
- 35 more elements not shown
FinInstrmIdFinancial Instrument Identification [1..1]SecurityIdentification19Unique and unambiguous identifier of a financial instrument, assigned under a formal or proprietary identification scheme.
ISINISIN [0..1]ISINOct2015IdentifierInternational Securities Identification Number (ISIN).
OthrIdOther Identification [0..*]OtherIdentification1Identification of a security by proprietary or domestic identification scheme.
DescDescription [0..1]Max140TextTextual description of a security instrument.
FinInstrmAttrbtsFinancial Instrument Attributes [0..1]FinancialInstrumentAttributes124Elements characterising a financial instrument.
PlcOfListgPlace Of Listing [0..1]MarketIdentification3Choice (choice)Market(s) on which the security is listed.
RatgRating [0..1]Rating1Assessment of securities credit and investment risk.
CertNbCertificate Number [0..1]Max35TextUnique and unambiguous identifier of a certificate assigned by the issuer.
DayCntBsisDay Count Basis [0..1]InterestComputationMethodFormat4Choice (choice)Specifies the computation method of (accrued) interest of the security.
RegnFormRegistration Form [0..1]FormOfSecurity6Choice (choice)Specifies the form, ie, ownership, of the security.
PmtFrqcyPayment Frequency [0..1]Frequency23Choice (choice)Specifies the frequency of an interest payment.
VarblRateChngFrqcyVariable Rate Change Frequency [0..1]Frequency23Choice (choice)Specifies the frequency of change to the variable rate of an interest bearing instrument.
ClssfctnTpClassification 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
UndrlygFinInstrmUnderlying Financial Instrument [0..*]UnderlyingFinancialInstrument7Underlying financial instrument to which an trade confirmation is related.
IdIdentification [1..1]SecurityIdentification19Identification of the underlying security by an ISIN.
AttrbtsAttributes [0..1]FinancialInstrumentAttributes124Underlying financial instrument attributes to which an trade confirmation is related.
StiptnsStipulations [0..1]FinancialInstrumentStipulations4Additional restrictions on the financial instrument, related to the stipulation.
GeogcsGeographics [0..1]Max35TextType of stipulation expressing geographical constraints on a fixed income instrument.
YldRgYield Range [0..1]AmountOrPercentageRange1Range of allowed yield.
RatgRating [0..1]Rating1Range of assessment of securities credit and investment risk.
CpnRgCoupon Range [0..1]AmountOrPercentageRange1Identification of a range of coupon numbers attached to its related financial instrument.
AmtsblIndAmortisable Indicator [0..1]YesNoIndicatorIndicates whether the financial instrument repays the principal amount in parts during the life cycle of the security.
PurpPurpose [0..1]Max256TextReason for which money is raised through the issuance of a security.
AltrntvMinTaxIndAlternative Minimum Tax Indicator [0..1]YesNoIndicatorIdentifies whether the issue is subject to alternative minimum taxation (used for municipal bonds).
AutoRinvstmtAuto Reinvestment [0..1]PercentageRateIndicates 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
ConfPtiesConfirmation Parties [1..*]ConfirmationParties6Parties involved in the confirmation of the details of a trade.
BuyrBuyer [0..1]ConfirmationPartyDetails7Party that buys goods or services, or a financial instrument.
BrrwrBorrower [0..1]ConfirmationPartyDetails7Party that has applied, met specific requirements, and received a monetary or securities loan from a lender.
SellrSeller [0..1]ConfirmationPartyDetails7Party that sells goods or services, or a financial instrument.
LndrLender [0..1]ConfirmationPartyDetails7A private, public or institutional entity which makes funds available to others to borrow.
BrkrOfCdtBroker Of Credit [0..1]ConfirmationPartyDetails8Brokerage firm which is the commissioned broker in a multi-broker trade.
IntrdcgFirmIntroducing Firm [0..1]ConfirmationPartyDetails8Broker or other intermediary with the closest association with the investor.
StepInFirmStep In Firm [0..1]ConfirmationPartyDetails8Brokerage firm assigned to take credit on the trade from the step-out brokerage firm.
StepOutFirmStep Out Firm [0..1]ConfirmationPartyDetails8Brokerage firm that executes an order, but gives other firms credit and some of the commission for the trade.
- 6 more elements not shown
SttlmParamsSettlement Parameters [0..1]SettlementDetails213Parameters which explicitly state the conditions that must be fulfilled before a particular transaction of a financial instrument can be settled.
SttlmTxTpSettlement Transaction Type [1..1]SettlementTransactionType3Choice (choice)Indicates whether the trade is to be settled as principal or netted off against another trade.
HldIndHold Indicator [0..1]YesNoIndicatorSpecifies whether the transaction is on hold/blocked/frozen.
PrtyPriority [0..1]PriorityNumeric4Choice (choice)Specifies whether the transaction is to be executed with a high priority.
SttlmInstrGnrtnSettlement Instruction Generation [0..1]SettlementInstructionGeneration2Choice (choice)Specifies if the Electronic Trade Confirmation (ETC) service provider is to generate or not a settlement instruction.
SttlmTxCondSettlement Transaction Condition [0..*]SettlementTransactionCondition31Choice (choice)Conditions under which the order/trade is to be settled.
PrtlSttlmIndPartial Settlement Indicator [0..1]YesNoIndicatorSpecifies whether partial settlement is allowed.
BnfclOwnrshBeneficial Ownership [0..1]BeneficialOwnership4Choice (choice)Specifies whether there is change of beneficial ownership.
BlckTradBlock Trade [0..1]BlockTrade4Choice (choice)Specifies whether the settlement instruction is a block parent or child.
- 22 more elements not shown
StgSttlmInstrStanding Settlement Instruction [0..1]StandingSettlementInstruction13Specifies what settlement standing instruction database is to be used to derive the settlement parties involved in the transaction.
SttlmStgInstrDBSettlement 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.
VndrVendor [0..1]PartyIdentification117Choice (choice)Vendor of the Settlement Standing Instruction database requested to be consulted.
OthrDlvrgSttlmPtiesOther Delivering Settlement Parties [0..1]SettlementParties59Delivering parties, other than the seller, needed for deriving the standing settlement instruction (for example, depository) or provided for...
OthrRcvgSttlmPtiesOther Receiving Settlement Parties [0..1]SettlementParties59Receiving parties, other than the buyer, needed for deriving the standing settlement instruction (for example, depository) or provided for...
DlvrgSttlmPtiesDelivering Settlement Parties [0..1]SettlementParties59Specifies the chain of delivering settlement parties.
DpstryDepository [0..1]PartyIdentification118First party in the settlement chain.
Pty1Party1 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the depository.
Pty2Party2 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 1.
Pty3Party3 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 2.
Pty4Party4 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 3.
Pty5Party5 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 4.
RcvgSttlmPtiesReceiving Settlement Parties [0..1]SettlementParties59Specifies the chain of receiving settlement parties.
DpstryDepository [0..1]PartyIdentification118First party in the settlement chain.
Pty1Party1 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the depository.
Pty2Party2 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 1.
Pty3Party3 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 2.
Pty4Party4 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 3.
Pty5Party5 [0..1]PartyIdentificationAndAccount155Party that, in a settlement chain interacts with the party 4.
CshPtiesCash Parties [0..1]CashParties33Cash parties involved in the specific transaction.
DbtrDebtor [0..1]PartyIdentificationAndAccount148Party that owes an amount of money to the (ultimate) creditor.
DbtrAgtDebtor Agent [0..1]PartyIdentificationAndAccount148Financial institution servicing an account for the debtor.
CdtrCreditor [0..1]PartyIdentificationAndAccount148Party to which an amount of money is due.
CdtrAgtCreditor Agent [0..1]PartyIdentificationAndAccount148Financial institution servicing an account for the creditor.
IntrmyIntermediary [0..1]PartyIdentificationAndAccount148Financial institution through which the transaction must pass to reach the account with institution.
ClrDtlsClearing Details [0..1]Clearing5Provides clearing member information.
ClrMmbClearing Member [1..*]PartyIdentificationAndAccount149Provides details about the clearing member identification and account.
ClrSgmtClearing Segment [0..1]PartyIdentification127Choice (choice)Clearing organisation that will clear the trade.
SttlmAmtSettlement Amount [0..1]AmountAndDirection28Total amount of money to be paid or received in exchange for the securities.
AcrdIntrstIndAccrued Interest Indicator [0..1]YesNoIndicatorIndicates whether the net proceeds include interest accrued on the financial instrument.
StmpDtyIndStamp Duty Indicator [0..1]YesNoIndicatorIndicates whether the settlement amount includes the stamp duty amount.
AmtAmount [1..1]ActiveCurrencyAndAmountAmount of money in the cash entry.
CdtDbtIndCredit Debit Indicator [0..1]CreditDebitCodeIndicates whether an entry is a credit or a debit.
OrgnlCcyAndOrdrdAmtOriginal Currency And Ordered Amount [0..1]ActiveOrHistoricCurrencyAndAmountPosting/settlement amount in its original currency when conversion from/into another currency has occurred.
FXDtlsForeign Exchange Details [0..1]ForeignExchangeTerms18Information needed to process a currency exchange or conversion.
ValDtValue 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.
OthrAmtsOther Amounts [0..*]OtherAmounts16Other amounts than the settlement amount.
ChrgsFeesCharges Fees [0..1]AmountAndDirection29Amount of money paid for the provision of financial services that cannot be categorised by another qualifier.
CtryNtlFdrlTaxCountry National Federal Tax [0..1]AmountAndDirection29Amount of country, national or federal tax charged by the jurisdiction in which the account servicer is located.
ExctgBrkrAmtExecuting Broker Amount [0..1]AmountAndDirection29Amount of money paid to an executing broker as a commission.
IsseDscntAllwncIssue Discount Allowance [0..1]AmountAndDirection29Amount of money defined as a discount on a new issue or on a tranche of an existing issue.
PmtLevyTaxPayment Levy Tax [0..1]AmountAndDirection29Amount of payment levy tax.
LclTaxLocal Tax [0..1]AmountAndDirection29Tax charged by the jurisdiction in which the financial instrument settles.
LclBrkrComssnLocal Broker Commission [0..1]AmountAndDirection29Amount of commission paid to a local broker.
MrgnMargin [0..1]AmountAndDirection29Amount of money deposited by the trading party in a margin account.
- 32 more elements not shown
OthrPricsOther Prices [0..*]OtherPrices5Other prices than the deal price.
MaxMaximum [0..1]Price14Specifies the maximum price.
TxTransaction [0..1]Price14Specifies the transaction price.
MktBrkrComssnMarket Broker Commission [0..1]Price14Market price including or excluding the broker's commission.
MrkdUpMarked Up [0..1]Price14In case of an order to buy, the price that the broker paid on the market plus the broker's commission.
MrkdDwnMarked Down [0..1]Price14In case of an order to sell, the price the broker receives in the market minus the broker's commission.
NetDscldNet Disclosed [0..1]Price14Price is net to the disclosed client.
NetUdscldNet Undisclosed [0..1]Price14Price is net to the client undisclosed (used in the UK market).
NtnlGrssNotional Gross [0..1]Price14Price is notional gross (used in the UK market).
- 7 more elements not shown
OthrBizPtiesOther Business Parties [0..1]OtherParties32Other business parties relevant to the transaction.
InvstrInvestor [0..*]PartyIdentificationAndAccount150Party that identifies the underlying investor.
StockXchgStock Exchange [0..1]PartyIdentificationAndAccount152Party that identifies the stock exchange.
TradRgltrTrade Regulator [0..1]PartyIdentificationAndAccount152Party that identifies the trade regulator.
TrptyAgtTriparty Agent [0..1]PartyIdentificationAndAccount154Party that handles tri-party transactions.
QlfdFrgnIntrmyQualified Foreign Intermediary [0..1]PartyIdentificationAndAccount151Foreign Financial Institution which has been authorised by local authorities to act as account management institution in the country.
TwoLegTxDtlsTwo Leg Transaction Details [0..1]TwoLegTransactionDetails5Specifies a transaction that the trading parties are agreeing to repurchase, sell back or return the same or similar securities at a later time.
TradDtTrade Date [0..1]TradeDate8Choice (choice)Specifies the date/time on which the trade was executed.
OpngLegIdOpening Leg Identification [0..1]Max35TextUnambiguous identification of the reference assigned in the first leg of the transaction.
ClsgLegIdClosing Leg Identification [0..1]Max35TextUnambiguous identification of the second leg of the transaction as known by the account owner (or the instructing party acting on its behalf).
GrssTradAmtGross Trade Amount [0..1]AmountAndDirection29Principal amount of a trade (price multiplied by quantity).
OthrAmtsOther Amounts [0..*]OtherAmounts16Identifies other amounts pertaining to the transaction.
ScndLegNrrtvSecond Leg Narrative [0..1]Max140TextProvides additional information about the second leg in narrative form.
EndPricEnd Price [0..1]Price14Negotiated fixed price of the security to buy it back.
ClsgDtClosing Date [0..1]ClosingDate4Choice (choice)Closing date/time or maturity date/time of the transaction.
- 3 more elements not shown
RgltryStiptnsRegulatory Stipulations [0..1]RegulatoryStipulations1Specifies regulatory stipulations that financial institutions must be compliant with in the country, region, and/or area they conduct business.
CtryCountry [1..1]CountryCodeNation with its own government, occupying a particular territory.
StiptnsStipulations [1..*]Max350TextSpecifies regulatory stipulations that financial institutions must be compliant with in the country, region, and/or where they conduct business.
SplmtryDataSupplementary Data [0..*]SupplementaryData1Additional information that cannot be captured in the structured elements and/or any other specific block.
PlcAndNmPlace And Name [0..1]Max350TextUnambiguous reference to the location where the supplementary data must be inserted in the message instance.
EnvlpEnvelope [1..1]SupplementaryDataEnvelope1Technical 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.