colr: Collateral Management
colr.021 Triparty Collateral Allegement Notification
Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked
colr.021 is the ISO 20022 TripartyCollateralAllegementNotification message in the Collateral Management business area (colr). The latest version is colr.021.001.01.
- Message
- TripartyCollateralAllegementNotification
- Latest version
- colr.021.001.01
- Submitting organisation
- Swift/Banco de Espana
- MT equivalent
- None listed
In use: published in the current ISO 20022 catalogue.
What colr.021 is for
This message is sent by a triparty agent after the receipt of a collateral transaction or instruction from the collateral giver or taker to advise that a counterparty has alleged an instruction or a transaction against the account owner's account at the TPA and that the TPA could not find the corresponding transaction or instruction of the account owner.
The allegement is used for initiation, modification and termination.
In this message, the Sender is the triparty agent and the Receiver is either the collateral taker or the collateral giver or their account servicer.
An account servicer sends a SecuritiesSettlementTransactionAllegementNotification to an account owner to advise the account owner that a counterparty has alleged an instruction against the account owner's account at the account servicer and that the account servicer could not find the corresponding instruction of 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.
colr.021 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 |
|---|---|---|
| colr.021.001.01latest | Registered | Latest version set |
colr.021 message structure
The building blocks of colr.021.001.01 to three levels, 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]TrptyCollAllgmtNtfctnTripartyCollateralAllegementNotification [1..1]TxInstrIdTransaction Instruction Identification [1..1]TransactionIdentifications44Unambiguous identification of the transaction as know by the instructing party.
TrptyAgtSvcPrvdrCollInstrIdTriparty Agent Service Provider Collateral Instruction Identification [1..1]Max35TextReference assigned to the instruction by the triparty-agent/service-provider.
TrptyAgtSvcPrvdrCollTxIdTriparty Agent Service Provider Collateral Transaction Identification [0..1]Max35TextUnique reference identifying the triparty-agent/service-provider collateral management transaction from the triparty-agent's/service-provider's point...
ClntCollInstrIdClient Collateral Instruction Identification [0..1]Max35TextUnique reference identifying the collateral management transaction from the client's point of view.
ClntCollTxIdClient Collateral Transaction Identification [0..1]Max35TextUnique reference identifying the collateral management transaction from the client's point of view.
CtrPtyCollInstrIdCounterparty Collateral Instruction Identification [0..1]Max35TextUnique collateral instruction reference assigned by counterparty.
CtrPtyCollTxIdCounterparty Collateral Transaction Identification [0..1]Max35TextUnique collateral transaction reference assigned by counterparty.
CmonTxIdCommon Transaction Identification [0..1]Max52TextUnique identification (UTI) agreed upon by the two trade counterparties to identify the trade.
PgntnPagination [1..1]Pagination1Page number of the message and continuation indicator to indicate that the multi-part preliminary advice is to continue or that the message is the last page of the multi-part preliminary advice.
PgNbPage Number [1..1]Max5NumericTextPage number.
LastPgIndLast Page Indicator [1..1]YesNoIndicatorIndicates the last page.
GnlParamsGeneral Parameters [1..1]CollateralParameters11Specifies the different parameters of the collateral instruction or transaction.
CollInstrTpCollateral Instruction Type [1..1]CollateralTransactionType1Choice (choice)Specifies the type of collateral instruction.
CdCode [1..1]CollateralTransactionType1CodePrtryProprietary [1..1]GenericIdentification30
XpsrTpExposure Type [1..1]ExposureType23Choice (choice)Specifies the underlying business area/type of trade causing the exposure.
CdCode [1..1]ExposureType14CodePrtryProprietary [1..1]GenericIdentification30
CollSdCollateral Side [1..1]CollateralRole1CodeSpecifies whether the alleged side is the collateral taker or giver.
ValSghtMrgnRateValue Sought Margin Rate [0..1]RateOrType1Choice (choice)Percentage by which the collateral value sought is increased, in selecting securities for a collateral basket, to reflect the taker's margin...
RateRate [1..1]PercentageRateTpType [1..1]GenericIdentification1
ElgbltySetPrflEligibility Set Profile [0..1]GenericIdentification1Number identifying the collateral eligibility set profile of the counterparty.
IdIdentification [1..1]Max35TextSchmeNmScheme Name [0..1]Max35TextIssrIssuer [0..1]Max35Text
TrfTitlTransfer Title [0..1]YesNoIndicatorChange of title for the collateral.
SttlmPrcSettlement Process [0..1]GenericIdentification30Specifies the settlement process in which the collateral will be settled.
IdIdentification [1..1]Exact4AlphaNumericTextIssrIssuer [1..1]Max35TextSchmeNmScheme Name [0..1]Max35Text
CollPtiesCollateral Parties [1..1]CollateralParties8Identifies the chain of collateral parties.
PtyAParty A [1..1]PartyIdentificationAndAccount202Instructing party sending the collateral instruction.
IdIdentification [1..1]PartyIdentification120Choice (choice)LEILEI [0..1]LEIIdentifierAltrnIdAlternate Identification [0..1]AlternatePartyIdentification7SfkpgAcctSafekeeping Account [0..1]SecuritiesAccount19BlckChainAdrOrWlltBlock Chain Address Or Wallet [0..1]BlockChainAddressWallet3AcctOwnrAccount Owner [0..1]PartyIdentification136PtyCpctyParty Capacity [0..1]TradingPartyCapacity5Choice (choice)
ClntPtyAClient Party A [0..1]PartyIdentificationAndAccount193Party that instructs party A to send the message.
IdIdentification [1..1]PartyIdentification120Choice (choice)LEILEI [0..1]LEIIdentifierAltrnIdAlternate Identification [0..1]AlternatePartyIdentification7
PtyBParty B [1..1]PartyIdentificationAndAccount203Counterparty of party A.
IdIdentification [1..1]PartyIdentification120Choice (choice)LEILEI [0..1]LEIIdentifierAltrnIdAlternate Identification [0..1]AlternatePartyIdentification7SfkpgAcctSafekeeping Account [0..1]SecuritiesAccount19BlckChainAdrOrWlltBlock Chain Address Or Wallet [0..1]BlockChainAddressWallet3PtyCpctyParty Capacity [0..1]TradingPartyCapacity5Choice (choice)
ClntPtyBClient Party B [0..1]PartyIdentificationAndAccount193Party that instructs party B to settle the instruction on its behalf.
IdIdentification [1..1]PartyIdentification120Choice (choice)LEILEI [0..1]LEIIdentifierAltrnIdAlternate Identification [0..1]AlternatePartyIdentification7
TrptyAgtTriparty Agent [0..1]PartyIdentification136Party that handles tri-party transactions.
IdIdentification [1..1]PartyIdentification120Choice (choice)LEILEI [0..1]LEIIdentifier
DealTxDtlsDeal Transaction Details [1..1]DealTransactionDetails6Specifies the information related to the deal.
MinNtcePrdMinimum Notice Period [0..1]Exact3NumericTextIdentifies the number of days in which the cash investor and dealer can agree to revisit the terms of an agreement.
ClsgDtClosing Date [1..1]ClosingDate4Choice (choice)Closing date/time or maturity date/time of the transaction.
DtDate [1..1]DateAndDateTime2Choice (choice)CdCode [1..1]Date3Choice (choice)
DealDtlsAmtDeal Details Amount [0..1]CollateralAmount12Specifies the details for the deal amounts.
TxTransaction [0..1]AmountAndDirection49TermntnTermination [0..1]AmountAndDirection49AcrdAccrued [0..1]AmountAndDirection49CmpndSmplAcrlClctnCompound Simple Accrual Calculation [0..1]CalculationMethod1CodePmtFrqcyPayment Frequency [0..1]Frequency38Choice (choice)IntrstPmtDelyInterest Payment Delay [0..1]Max3NumericTextValSghtValue Sought [0..1]AmountAndDirection49
PricgRateAndIndxPricing Rate And Index [0..1]RateOrName4Choice (choice)Interest rate to be paid on the transaction amount as agreed between the counterparties and the tenor of the interest rate index.
RateRate [1..1]PercentageRateRateIndxDtlsRate Index Details [1..1]RateTypeAndLookback2
OvrnghtFrqcyRateFxgOvernight Frequency Rate Fixing [0..1]FrequencyRateFixing1Choice (choice)Indicates for a floating rate transaction if an overnight frequency rate fixing should be applied.
CdCode [1..1]FrequencyRateFixing1CodeNbOfDaysNumber Of Days [1..1]Max3NumericText
SprdSpread [0..1]PercentageRateMargin allowed over or under a given rate.
DayCntBsisDay Count Basis [0..1]InterestComputationMethodFormat4Choice (choice)Specifies the computation method of (accrued) interest of the financial instrument.
CdCode [1..1]InterestComputationMethod2CodePrtryProprietary [1..1]GenericIdentification30
PmtPayment [0..1]DeliveryReceiptType2CodeSpecifies whether the instruction is free or against payment.
OptnTpOption Type [0..1]OptionType6Choice (choice)Specifies whether it is a Call option (right to purchase a specific underlying asset) or a Put option (right to sell a specific underlying asset).
CdCode [1..1]OptionType1CodePrtryProprietary [1..1]GenericIdentification30
TermntnOptnTermination Option [0..1]RepoTerminationOption1CodeIndication whether the counterparties to the transaction have agreed to an evergreen or extendable repo.
DealTxDtDeal Transaction Date [1..1]CollateralDate2Identifies the dates related to the triparty collateral instruction or transactions.
TradDtTrade Date [0..1]ISODateDate the transaction was agreed between the trading parties.
ReqdExctnDtRequested Execution Date [0..1]DateAndDateTime2Choice (choice)Date/time at which the instructing party requests the instruction to be executed.
DtDate [1..1]ISODateDtTmDate Time [1..1]ISODateTime
SttlmDtSettlement Date [0..1]ISODateDate on which the financial instruments are to be delivered or received.
SctiesMvmntSecurities Movement [0..*]SecuritiesMovement7Securities movements.
SctiesMvmntTpSecurities Movement Type [1..1]CollateralEntryType1CodeSpecifies whether the quantity of financial instrument is to be delivered or received.
FinInstrmIdFinancial Instrument Identification [1..1]SecurityIdentification19Financial instrument representing a sum of rights of the investor vis-a-vis the issuer.
ISINISIN [0..1]ISINOct2015IdentifierOthrIdOther Identification [0..*]OtherIdentification1DescDescription [0..1]Max140Text
QtyQuantity [1..1]FinancialInstrumentQuantity33Choice (choice)Quantity of financial instrument.
UnitUnit [1..1]DecimalNumberFaceAmtFace Amount [1..1]ImpliedCurrencyAndAmountAmtsdValAmortised Value [1..1]ImpliedCurrencyAndAmountDgtlTknUnitDigital Token Unit [1..1]Max30DecimalNumber
CollMvmntCollateral Movement [1..1]YesNoIndicatorIndicates whether the financial instrument is delivered/received as collateral or as a loan.
ClntSctiesMvmntIdClient Securities Movement Identification [0..1]Max35TextReference assigned by the party A to the financial instrument movement.
TrptyAgtSvcPrvdrSctiesMvmntIdTriparty Agent Service Provider Securities Movement Identification [0..1]Max35TextReference assigned by the triparty agent to the financial instrument movement.
CshMvmntCash Movement [0..*]CashMovement5Cash movements.
CshMvmntCash Movement [1..1]CollateralEntryType1CodeSpecifies whether the cash amount is to be delivered or received.
CshAmtCash Amount [1..1]ActiveCurrencyAndAmountAmount of the cash movement
CollMvmntCollateral Movement [1..1]YesNoIndicatorSpecifies whether the amount is delivered/received as part of collateral or not.
ClntCshMvmntIdClient Cash Movement Identification [0..1]Max35TextReference assigned by party A to the cash movement.
TrptyAgtSvcPrvdrCshMvmntIdTriparty Agent Service Provider Cash Movement Identification [0..1]Max35TextReference assigned by the triparty agent to the cash movement.
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 colr.021 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 colr.021
These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.
colr.021 questions
- What is the latest version of colr.021?
- The latest version in the ISO 20022 e-Repository release of 24 April 2025 is colr.021.001.01.
- What is the root element of colr.021?
- The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:colr.021.001.01, and its message element is TrptyCollAllgmtNtfctn (TripartyCollateralAllegementNotification).
- Is there an MT equivalent of colr.021?
- 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.