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.
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.
| Version | Registration status | Published in |
|---|---|---|
| tsin.005.001.01latest | Registered | Latest 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]UdrtkgApplUndertakingApplication [1..1]UdrtkgApplDtlsUndertaking Application Details [1..1]Undertaking1Details 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.
ApplcntRefNbApplicant Reference Number [1..1]Max35TextUnique and unambiguous identifier assigned by the applicant to the undertaking.
PurpPurpose [1..1]Max350TextBrief description of the purpose of the undertaking.
NmName [1..1]UndertakingName1CodeUndertaking name.
TpType [1..1]UndertakingType1Choice (choice)Type of undertaking, for example, performance, payment.
CdCode [1..1]ExternalUndertakingType1CodePrtryProprietary [1..1]GenericIdentification1
OblgrObligor [1..1]PartyIdentification43Party obligated to reimburse the issuer.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
ApplcntApplicant [0..*]PartyIdentification43Party to be named in the undertaking as the “applicant” when different from the obligor.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
IssrIssuer [1..1]PartyIdentification43Party that issues the undertaking (or counter-undertaking).
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
BnfcryBeneficiary [1..*]PartyIdentification43Ultimate party in whose favour the undertaking is to be issued.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
AdvsgPtyAdvising Party [0..1]PartyIdentification43Party asked to advise the undertaking to the beneficiary or to another advising party.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
ScndAdvsgPtySecond Advising Party [0..1]PartyIdentification43Additional party asked to advise the undertaking.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
CnfrmrConfirmer [0..1]PartyIdentification43Party that adds its confirmation to the undertaking.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
ConfIndConfirmation Indicator [0..1]YesNoIndicatorIndicates whether the advising bank (confirmer) is requested to add its confirmation to the undertaking.
CntrUdrtkgIndCounter Undertaking Indicator [1..1]YesNoIndicatorIndicates whether the undertaking is a local or ancillary undertaking to be issued under a counter-undertaking.
CntrUdrtkgCounter Undertaking [0..1]Undertaking2Details related to the counter undertaking.
NmName [0..1]UndertakingName1CodeBnfcryBeneficiary [0..1]PartyIdentification43XpryDtlsExpiry Details [0..1]ExpiryDetails2CntrUdrtkgAmtCounter Undertaking Amount [0..1]UndertakingAmount1ConfChrgsPyblByConfirmation Charges Payable By [0..1]ExternalTypeOfParty1CodeGovncRulesAndLawGovernance Rules And Law [0..1]GovernanceRules1StdClmDocIndStandard Claim Document Indicator [0..1]YesNoIndicatorAddtlInfAdditional Information [0..5]Max2000Text
UdrtkgAmtUndertaking Amount [1..1]UndertakingAmount1Details related to the amount of the undertaking.
AmtAmount [1..1]ActiveCurrencyAndAmountPlusTlrncePlus Tolerance [0..1]PercentageRateAddtlInfAdditional Information [0..5]Max2000Text
XpryDtlsExpiry Details [1..1]ExpiryDetails2Details related to the expiry terms of the undertaking.
XpryTermsExpiry Terms [0..1]ExpiryTerms2AddtlXpryInfAdditional Expiry Information [0..5]Max2000Text
AddtlPtyAdditional Party [0..*]PartyAndType1Party, in addition to the other parties specified in the undertaking, that is also related to the undertaking.
TpType [1..1]PartyType1Choice (choice)PtyParty [0..1]PartyIdentification43
GovncRulesAndLawGovernance Rules And Law [1..1]GovernanceRules1Rules and laws governing the undertaking.
RuleIdRule Identification [1..1]GovernanceIdentification1Choice (choice)AplblLawApplicable Law [0..1]Location1JursdctnJurisdiction [0..*]Location1
UndrlygTxUnderlying Transaction [0..*]UnderlyingTradeTransaction1Details of the underlying transaction for which the undertaking is issued.
TpType [1..1]UnderlyingTradeTransactionType1Choice (choice)IdIdentification [0..1]Max35TextTxDtTransaction Date [0..1]ISODateTndrClsgDtTender Closing Date [0..1]ISODateTxAmtTransaction Amount [0..1]ActiveCurrencyAndAmountCtrctAmtPctgContract Amount Percentage [0..1]PercentageRateAddtlInfAdditional Information [0..5]Max2000Text
PresntnDtlsPresentation Details [0..1]Presentation4Presentation details related to the undertaking.
MdmMedium [0..1]PresentationMedium1Choice (choice)DocDocument [0..*]Document11AddtlInfAdditional Information [0..5]Max2000Text
UdrtkgWrdgUndertaking Wording [1..1]UndertakingWording1Wording details and text for the undertaking.
MdlFormModel Form [0..1]ModelFormIdentification1ReqdWrdgLangRequested Wording Language [0..1]ISO2ALanguageCodeUdrtkgTermsAndCondsUndertaking Terms And Conditions [0..*]Narrative1
MltplDmndIndMultiple Demand Indicator [0..1]YesNoIndicatorIndicates whether multiple demands are permitted.
PrtlDmndIndPartial Demand Indicator [0..1]YesNoIndicatorIndicates whether partial demands/drawings are permitted.
TrfIndTransfer Indicator [0..1]YesNoIndicatorIndicates whether the undertaking is transferable.
TrfChrgsPyblByTransfer Charges Payable By [0..1]ExternalTypeOfParty1CodeIndicates whether the applicant/obligor or beneficiary is responsible for payment of the transfer charges.
ConfChrgsPyblByConfirmation Charges Payable By [0..1]ExternalTypeOfParty1CodeIndicates whether the applicant/obligor or beneficiary is responsible for payment of the confirmation charges.
AutomtcAmtVartnAutomatic Amount Variation [0..*]AutomaticVariation1Details related to a variation in amount that is automatically applied.
IdIdentification [1..1]Max35TextTpType [1..1]VariationType1CodeAmtAndTrggrAmount And Trigger [1..*]AmountAndTrigger1AddtlInfAdditional Information [0..5]Max2000Text
DlvryChanlDelivery Channel [1..1]CommunicationChannel1Details of the communication channel.
MtdMethod [1..1]ExternalChannel1CodeDlvrToPtyTpDeliver To Party Type [1..1]PartyType1Choice (choice)DlvrToNmDeliver To Name [0..1]Max140TextDlvrToAdrDeliver To Address [0..1]PostalAddress6
OblgrLbltyAcctObligor Liability Account [0..1]CashAccount28Account nominated by the obligor to record the liability amount of the undertaking.
IdIdentification [1..1]AccountIdentification4Choice (choice)CcyCurrency [0..1]ActiveOrHistoricCurrencyCodeNmName [0..1]Max70Text
OblgrChrgAcctObligor Charge Account [0..1]CashAccount28Account nominated by the obligor for the settlement of charges related to the undertaking.
IdIdentification [1..1]AccountIdentification4Choice (choice)CcyCurrency [0..1]ActiveOrHistoricCurrencyCodeNmName [0..1]Max70Text
OblgrSttlmAcctObligor Settlement Account [0..1]CashAccount28Account nominated by the obligor for the settlement of the amount claimed under the undertaking.
IdIdentification [1..1]AccountIdentification4Choice (choice)CcyCurrency [0..1]ActiveOrHistoricCurrencyCodeNmName [0..1]Max70Text
NclsdFileEnclosed File [0..*]Document9Document or template enclosed in the undertaking directly related to the undertaking to be issued.
TpType [1..1]UndertakingDocumentType1Choice (choice)IdIdentification [1..1]Max35TextFrmtFormat [0..1]DocumentFormat1Choice (choice)NclsrEnclosure [1..1]Max2MBBinaryDgtlSgntrDigital Signature [0..1]PartyAndSignature2
AddtlApplInfAdditional Application Information [0..5]Max2000TextAdditional information related to the application for an undertaking.
InstrsToBkInstructions To Bank [0..5]Max2000TextInstructions specific to the bank receiving the message.
DgtlSgntrDigital Signature [0..1]PartyAndSignature2Digital signature of the undertaking application.
PtyParty [1..1]PartyIdentification43Entity involved in an activity.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
SgntrSignature [1..1]ProprietaryData3Signature of a party.
AnyAny [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.
- ExternalAccountIdentification1Code4 codes
- ExternalChannel1Code13 codes
- ExternalDateFrequency1Code5 codes
- ExternalDocumentFormat1Code5 codes
- ExternalModelFormIdentification1Code10 codes
- ExternalNarrativeType1Code7 codes
- ExternalOrganisationIdentification1Code15 codes
- ExternalPersonIdentification1Code11 codes
- ExternalRelativeTo1Code3 codes
- ExternalTypeOfParty1Code13 codes
- ExternalUnderlyingTradeTransactionType1Code7 codes
- ExternalUndertakingDocumentType1Code5 codes
- ExternalUndertakingDocumentType2Code3 codes
- ExternalUndertakingType1Code14 codes
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.