tsrv: Trade Services
tsrv.001 Undertaking Issuance
Written and maintained by ZagTrader. Last reviewed . How this page is sourced and checked
tsrv.001 is the ISO 20022 UndertakingIssuance message in the Trade Services business area (tsrv). The latest version is tsrv.001.001.01.
- Message
- UndertakingIssuance
- Latest version
- tsrv.001.001.01
- Submitting organisation
- Not read from the catalogue
- MT equivalent
- MT760
In use: published in the current ISO 20022 catalogue.
What tsrv.001 is for
The UndertakingIssuance message is sent (and is thus issued) by the party issuing the undertaking to the beneficiary. The message may be sent either to the beneficiary directly or via an advising party. The undertaking could be a demand guarantee, standby letter of credit, or counter-undertaking (counter-guarantee or counter-standby). It contains details on the applicable rules, expiry date, the amount, required documents, and terms and conditions of the undertaking. The message constitutes an operative financial instrument.
Under the United Nations Convention on Independent Guarantees and Stand-by Letters of Credit (http://www.uncitral.org), 1996, Article 2, "an undertaking is an independent commitment, known in international practice as an independent guarantee or as a standby letter of credit, given by a bank or other institution or person ('guarantor/issuer') to pay to the beneficiary a certain or determinable amount upon simple demand or upon demand accompanied by other documents, in conformity with the terms and any documentary conditions of the undertaking, indicating, or from which it is to be inferred, that payment is due because of a default in the performance of an obligation, or because of another contingency, or for money borrowed or advanced, or on account of any mature indebtedness undertaken by the principal/applicant or another person".
tsrv.001 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 |
|---|---|---|
| tsrv.001.001.01latest | Registered | Latest version set |
tsrv.001 message structure
The building blocks of tsrv.001.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]UdrtkgIssncUndertakingIssuance [1..1]UdrtkgIssncDtlsUndertaking Issuance Details [1..1]Undertaking3Independent 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.
IdIdentification [1..1]Max35TextUnique and unambiguous identifier assigned by the issuer to the undertaking, for example the guarantee or standby number.
NmName [1..1]UndertakingIssuanceName1CodeName of undertaking such as, demand guarantee, standby letter of credit.
TpType [0..1]UndertakingType1Choice (choice)Type of undertaking, for example, performance, payment.
CdCode [1..1]ExternalUndertakingType1CodePrtryProprietary [1..1]GenericIdentification1
IssncTpIssuance Type [1..1]IssuanceType1CodeType of the undertaking issuance.
ApplcntApplicant [0..*]PartyIdentification43Party named in the undertaking as the “applicant”.
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..*]PartyIdentification43Party in whose favour the undertaking (or counter-undertaking) is issued.
NmName [0..1]Max140TextPstlAdrPostal Address [0..1]PostalAddress6IdIdentification [0..1]Party11Choice (choice)CtryOfResCountry Of Residence [0..1]CountryCodeCtctDtlsContact Details [0..1]ContactDetails2
DtOfIssncDate Of Issuance [1..1]ISODateDate on which the undertaking is issued.
PlcOfIssePlace Of Issue [0..1]PostalAddress12Location which is to be regarded as the place from which the undertaking is issued.
TwnNmTown Name [0..1]Max35TextCtrySubDvsnCountry Sub Division [0..1]Max35TextCtryCountry [1..1]CountryCode
AdvsgPtyAdvising Party [0..1]PartyIdentification43Party asked to advise the undertaking to the beneficiary or to another advising party at the request of the issuer.
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
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]ExpiryDetails1Details related to the expiry of the undertaking.
XpryTermsExpiry Terms [0..1]ExpiryTerms1AddtlXpryInfAdditional Expiry Information [0..5]Max2000Text
ConfIndConfirmation Indicator [0..1]YesNoIndicatorIndicates whether or not the advising bank (confirmer) is requested to add its confirmation to the undertaking.
ConfPtyTpConfirmation Party Type [0..1]ExternalTypeOfParty1CodeIndicates the type of party requested to add its confirmation to the undertaking.
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]Presentation1Presentation details related to the undertaking.
MdmMedium [0..1]PresentationMedium1Choice (choice)PlcOfPresntnOrUdrConfChcPlace Of Presentation Or Under Confirmation Choice [0..1]PlaceOrUnderConfirmationChoice1 (choice)DocDocument [0..*]Document8AddtlInfAdditional Information [0..5]Max2000Text
UdrtkgTermsAndCondsUndertaking Terms And Conditions [1..*]Narrative1Terms and conditions of the undertaking.
TpType [0..1]NarrativeType1Choice (choice)TxtText [1..5]Max20000Text
MltplDmndIndMultiple Demand Indicator [0..1]YesNoIndicatorIndicates that multiple demands are not permitted.
PrtlDmndIndPartial Demand Indicator [0..1]YesNoIndicatorIndicates that partial demands/drawings are not permitted.
ConfChrgsPyblByConfirmation Charges Payable By [0..1]ExternalTypeOfParty1CodeIndicates whether the applicant/obligor or beneficiary is responsible for payment of the confirmation charges.
TrfChrgsPyblByTransfer Charges Payable By [0..1]ExternalTypeOfParty1CodeIndicates whether the applicant/obligor or beneficiary is responsible for payment of the transfer 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 [0..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
TrfIndTransfer Indicator [0..1]YesNoIndicatorIndicates whether the undertaking is transferable.
NclsdFileEnclosed File [0..*]Document9Document or template enclosed in the undertaking directly related to the issued undertaking.
TpType [1..1]UndertakingDocumentType1Choice (choice)IdIdentification [1..1]Max35TextFrmtFormat [0..1]DocumentFormat1Choice (choice)NclsrEnclosure [1..1]Max2MBBinaryDgtlSgntrDigital Signature [0..1]PartyAndSignature2
AddtlInfAdditional Information [0..5]Max2000TextAdditional information related to the undertaking.
ReqdLclUdrtkgRequested Local Undertaking [0..1]Undertaking4Details of the local or ancillary undertaking requested to be issued by a local or other issuing institution.
NmName [1..1]UndertakingName1CodeTpType [1..1]ExternalUndertakingType1CodeApplcntApplicant [1..*]PartyIdentification43BnfcryBeneficiary [1..*]PartyIdentification43DtOfIssncDate Of Issuance [0..1]ISODateAdvsgPtyAdvising Party [0..1]PartyIdentification43ScndAdvsgPtySecond Advising Party [0..1]PartyIdentification43LclUdrtkgAmtLocal Undertaking Amount [1..1]UndertakingAmount1XpryDtlsExpiry Details [1..1]ExpiryDetails1ConfIndConfirmation Indicator [0..1]YesNoIndicatorAddtlPtyAdditional Party [0..*]PartyAndType1GovncRulesAndLawGovernance Rules And Law [1..1]GovernanceRules1UndrlygTxUnderlying Transaction [0..*]UnderlyingTradeTransaction1PresntnDtlsPresentation Details [0..1]Presentation1UdrtkgWrdgUndertaking Wording [1..1]UndertakingWording1MltplDmndIndMultiple Demand Indicator [0..1]YesNoIndicatorPrtlDmndIndPartial Demand Indicator [0..1]YesNoIndicatorConfChrgsPyblByConfirmation Charges Payable By [0..1]ExternalTypeOfParty1CodeTrfChrgsPyblByTransfer Charges Payable By [0..1]ExternalTypeOfParty1CodeAutomtcAmtVartnAutomatic Amount Variation [0..*]AutomaticVariation1DlvryChanlDelivery Channel [0..1]CommunicationChannel1TrfIndTransfer Indicator [0..1]YesNoIndicatorAddtlInfAdditional Information [0..5]Max2000Text
BkToBnfcryInfBank To Beneficiary Information [0..5]Max2000TextAdditional information specific to the bank-to-beneficiary communication.
BkToBkInfBank To Bank Information [0..5]Max2000TextAdditional information specific to the bank-to-bank communication.
DgtlSgntrDigital Signature [0..*]PartyAndSignature2Digital signature of the undertaking.
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 tsrv.001 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 tsrv.001
These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.
- 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
tsrv.001 questions
- What is the latest version of tsrv.001?
- The latest version in the ISO 20022 e-Repository release of 24 April 2025 is tsrv.001.001.01.
- What is the root element of tsrv.001?
- The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:tsrv.001.001.01, and its message element is UdrtkgIssnc (UndertakingIssuance).
- Is there an MT equivalent of tsrv.001?
- Yes. tsrv.001 does the same business job as MT760. Field-level translation has gaps in both directions.
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.