ZagTrader

tsin: Trade Services Initiation

tsin.005 Undertaking Application

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

tsin.005 is the ISO 20022 UndertakingApplication message in the Trade Services Initiation business area (tsin). The latest version is tsin.005.001.01.

Message
UndertakingApplication
Latest version
tsin.005.001.01
Submitting organisation
Not read from the catalogue
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What tsin.005 is for

The UndertakingApplication message is sent by the party requesting issuance of the undertaking (applicant or obligor) to the party issuing the undertaking. It is used to request the issuance of an undertaking (demand guarantee or standby letter of credit or suretyship) or counter-undertaking (counter-guarantee or counter-standby or suretyship), and provides details on the applicable rules, terms, conditions and content of the undertaking to be issued.

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

tsin.005 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
tsin.005.001.01latestRegisteredLatest version set

tsin.005 message structure

The building blocks of tsin.005.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]
    • UdrtkgAppl UndertakingApplication [1..1]
      • UdrtkgApplDtls Undertaking Application Details [1..1]Undertaking1

        Details of the application for an independent undertaking, such as a demand guarantee or standby letter of credit, that provides financial assurance, to be collected on the presentation of documents that comply with its terms and conditions.

        • ApplcntRefNb Applicant Reference Number [1..1]Max35Text

          Unique and unambiguous identifier assigned by the applicant to the undertaking.

        • Purp Purpose [1..1]Max350Text

          Brief description of the purpose of the undertaking.

        • Nm Name [1..1]UndertakingName1Code

          Undertaking name.

        • Tp Type [1..1]UndertakingType1Choice (choice)

          Type of undertaking, for example, performance, payment.

          • Cd Code [1..1]ExternalUndertakingType1Code
          • Prtry Proprietary [1..1]GenericIdentification1
        • Oblgr Obligor [1..1]PartyIdentification43

          Party obligated to reimburse the issuer.

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • Applcnt Applicant [0..*]PartyIdentification43

          Party to be named in the undertaking as the “applicant” when different from the obligor.

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • Issr Issuer [1..1]PartyIdentification43

          Party that issues the undertaking (or counter-undertaking).

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • Bnfcry Beneficiary [1..*]PartyIdentification43

          Ultimate party in whose favour the undertaking is to be issued.

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • AdvsgPty Advising Party [0..1]PartyIdentification43

          Party asked to advise the undertaking to the beneficiary or to another advising party.

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • ScndAdvsgPty Second Advising Party [0..1]PartyIdentification43

          Additional party asked to advise the undertaking.

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • Cnfrmr Confirmer [0..1]PartyIdentification43

          Party that adds its confirmation to the undertaking.

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • ConfInd Confirmation Indicator [0..1]YesNoIndicator

          Indicates whether the advising bank (confirmer) is requested to add its confirmation to the undertaking.

        • CntrUdrtkgInd Counter Undertaking Indicator [1..1]YesNoIndicator

          Indicates whether the undertaking is a local or ancillary undertaking to be issued under a counter-undertaking.

        • CntrUdrtkg Counter Undertaking [0..1]Undertaking2

          Details related to the counter undertaking.

          • Nm Name [0..1]UndertakingName1Code
          • Bnfcry Beneficiary [0..1]PartyIdentification43
          • XpryDtls Expiry Details [0..1]ExpiryDetails2
          • CntrUdrtkgAmt Counter Undertaking Amount [0..1]UndertakingAmount1
          • ConfChrgsPyblBy Confirmation Charges Payable By [0..1]ExternalTypeOfParty1Code
          • GovncRulesAndLaw Governance Rules And Law [0..1]GovernanceRules1
          • StdClmDocInd Standard Claim Document Indicator [0..1]YesNoIndicator
          • AddtlInf Additional Information [0..5]Max2000Text
        • UdrtkgAmt Undertaking Amount [1..1]UndertakingAmount1

          Details related to the amount of the undertaking.

          • Amt Amount [1..1]ActiveCurrencyAndAmount
          • PlusTlrnce Plus Tolerance [0..1]PercentageRate
          • AddtlInf Additional Information [0..5]Max2000Text
        • XpryDtls Expiry Details [1..1]ExpiryDetails2

          Details related to the expiry terms of the undertaking.

          • XpryTerms Expiry Terms [0..1]ExpiryTerms2
          • AddtlXpryInf Additional Expiry Information [0..5]Max2000Text
        • AddtlPty Additional Party [0..*]PartyAndType1

          Party, in addition to the other parties specified in the undertaking, that is also related to the undertaking.

          • Tp Type [1..1]PartyType1Choice (choice)
          • Pty Party [0..1]PartyIdentification43
        • GovncRulesAndLaw Governance Rules And Law [1..1]GovernanceRules1

          Rules and laws governing the undertaking.

          • RuleId Rule Identification [1..1]GovernanceIdentification1Choice (choice)
          • AplblLaw Applicable Law [0..1]Location1
          • Jursdctn Jurisdiction [0..*]Location1
        • UndrlygTx Underlying Transaction [0..*]UnderlyingTradeTransaction1

          Details of the underlying transaction for which the undertaking is issued.

          • Tp Type [1..1]UnderlyingTradeTransactionType1Choice (choice)
          • Id Identification [0..1]Max35Text
          • TxDt Transaction Date [0..1]ISODate
          • TndrClsgDt Tender Closing Date [0..1]ISODate
          • TxAmt Transaction Amount [0..1]ActiveCurrencyAndAmount
          • CtrctAmtPctg Contract Amount Percentage [0..1]PercentageRate
          • AddtlInf Additional Information [0..5]Max2000Text
        • PresntnDtls Presentation Details [0..1]Presentation4

          Presentation details related to the undertaking.

          • Mdm Medium [0..1]PresentationMedium1Choice (choice)
          • Doc Document [0..*]Document11
          • AddtlInf Additional Information [0..5]Max2000Text
        • UdrtkgWrdg Undertaking Wording [1..1]UndertakingWording1

          Wording details and text for the undertaking.

          • MdlForm Model Form [0..1]ModelFormIdentification1
          • ReqdWrdgLang Requested Wording Language [0..1]ISO2ALanguageCode
          • UdrtkgTermsAndConds Undertaking Terms And Conditions [0..*]Narrative1
        • MltplDmndInd Multiple Demand Indicator [0..1]YesNoIndicator

          Indicates whether multiple demands are permitted.

        • PrtlDmndInd Partial Demand Indicator [0..1]YesNoIndicator

          Indicates whether partial demands/drawings are permitted.

        • TrfInd Transfer Indicator [0..1]YesNoIndicator

          Indicates whether the undertaking is transferable.

        • TrfChrgsPyblBy Transfer Charges Payable By [0..1]ExternalTypeOfParty1Code

          Indicates whether the applicant/obligor or beneficiary is responsible for payment of the transfer charges.

        • ConfChrgsPyblBy Confirmation Charges Payable By [0..1]ExternalTypeOfParty1Code

          Indicates whether the applicant/obligor or beneficiary is responsible for payment of the confirmation charges.

        • AutomtcAmtVartn Automatic Amount Variation [0..*]AutomaticVariation1

          Details related to a variation in amount that is automatically applied.

          • Id Identification [1..1]Max35Text
          • Tp Type [1..1]VariationType1Code
          • AmtAndTrggr Amount And Trigger [1..*]AmountAndTrigger1
          • AddtlInf Additional Information [0..5]Max2000Text
        • DlvryChanl Delivery Channel [1..1]CommunicationChannel1

          Details of the communication channel.

          • Mtd Method [1..1]ExternalChannel1Code
          • DlvrToPtyTp Deliver To Party Type [1..1]PartyType1Choice (choice)
          • DlvrToNm Deliver To Name [0..1]Max140Text
          • DlvrToAdr Deliver To Address [0..1]PostalAddress6
        • OblgrLbltyAcct Obligor Liability Account [0..1]CashAccount28

          Account nominated by the obligor to record the liability amount of the undertaking.

          • Id Identification [1..1]AccountIdentification4Choice (choice)
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
        • OblgrChrgAcct Obligor Charge Account [0..1]CashAccount28

          Account nominated by the obligor for the settlement of charges related to the undertaking.

          • Id Identification [1..1]AccountIdentification4Choice (choice)
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
        • OblgrSttlmAcct Obligor Settlement Account [0..1]CashAccount28

          Account nominated by the obligor for the settlement of the amount claimed under the undertaking.

          • Id Identification [1..1]AccountIdentification4Choice (choice)
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
        • NclsdFile Enclosed File [0..*]Document9

          Document or template enclosed in the undertaking directly related to the undertaking to be issued.

          • Tp Type [1..1]UndertakingDocumentType1Choice (choice)
          • Id Identification [1..1]Max35Text
          • Frmt Format [0..1]DocumentFormat1Choice (choice)
          • Nclsr Enclosure [1..1]Max2MBBinary
          • DgtlSgntr Digital Signature [0..1]PartyAndSignature2
        • AddtlApplInf Additional Application Information [0..5]Max2000Text

          Additional information related to the application for an undertaking.

      • InstrsToBk Instructions To Bank [0..5]Max2000Text

        Instructions specific to the bank receiving the message.

      • DgtlSgntr Digital Signature [0..1]PartyAndSignature2

        Digital signature of the undertaking application.

        • Pty Party [1..1]PartyIdentification43

          Entity involved in an activity.

          • Nm Name [0..1]Max140Text
          • PstlAdr Postal Address [0..1]PostalAddress6
          • Id Identification [0..1]Party11Choice (choice)
          • CtryOfRes Country Of Residence [0..1]CountryCode
          • CtctDtls Contact Details [0..1]ContactDetails2
        • Sgntr Signature [1..1]ProprietaryData3

          Signature of a party.

          • Any Any [1..1]SkipProcessing

Have a tsin.005 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 tsin.005

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

tsin.005 questions

What is the latest version of tsin.005?
The latest version in the ISO 20022 e-Repository release of 24 April 2025 is tsin.005.001.01.
What is the root element of tsin.005?
The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:tsin.005.001.01, and its message element is UdrtkgAppl (UndertakingApplication).
Is there an MT equivalent of tsin.005?
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.