ZagTrader

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".

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

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.

VersionRegistration statusPublished in
tsrv.001.001.01latestRegisteredLatest 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]
    • UdrtkgIssnc UndertakingIssuance [1..1]
      • UdrtkgIssncDtls Undertaking Issuance Details [1..1]Undertaking3

        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.

        • Id Identification [1..1]Max35Text

          Unique and unambiguous identifier assigned by the issuer to the undertaking, for example the guarantee or standby number.

        • Nm Name [1..1]UndertakingIssuanceName1Code

          Name of undertaking such as, demand guarantee, standby letter of credit.

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

          Type of undertaking, for example, performance, payment.

          • Cd Code [1..1]ExternalUndertakingType1Code
          • Prtry Proprietary [1..1]GenericIdentification1
        • IssncTp Issuance Type [1..1]IssuanceType1Code

          Type of the undertaking issuance.

        • Applcnt Applicant [0..*]PartyIdentification43

          Party named in the undertaking as the “applicant”.

          • 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

          Party in whose favour the undertaking (or counter-undertaking) is 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
        • DtOfIssnc Date Of Issuance [1..1]ISODate

          Date on which the undertaking is issued.

        • PlcOfIsse Place Of Issue [0..1]PostalAddress12

          Location which is to be regarded as the place from which the undertaking is issued.

          • TwnNm Town Name [0..1]Max35Text
          • CtrySubDvsn Country Sub Division [0..1]Max35Text
          • Ctry Country [1..1]CountryCode
        • AdvsgPty Advising Party [0..1]PartyIdentification43

          Party asked to advise the undertaking to the beneficiary or to another advising party at the request of 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
        • 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
        • 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]ExpiryDetails1

          Details related to the expiry of the undertaking.

          • XpryTerms Expiry Terms [0..1]ExpiryTerms1
          • AddtlXpryInf Additional Expiry Information [0..5]Max2000Text
        • ConfInd Confirmation Indicator [0..1]YesNoIndicator

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

        • ConfPtyTp Confirmation Party Type [0..1]ExternalTypeOfParty1Code

          Indicates the type of party requested to add its confirmation to the undertaking.

        • 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]Presentation1

          Presentation details related to the undertaking.

          • Mdm Medium [0..1]PresentationMedium1Choice (choice)
          • PlcOfPresntnOrUdrConfChc Place Of Presentation Or Under Confirmation Choice [0..1]PlaceOrUnderConfirmationChoice1 (choice)
          • Doc Document [0..*]Document8
          • AddtlInf Additional Information [0..5]Max2000Text
        • UdrtkgTermsAndConds Undertaking Terms And Conditions [1..*]Narrative1

          Terms and conditions of the undertaking.

          • Tp Type [0..1]NarrativeType1Choice (choice)
          • Txt Text [1..5]Max20000Text
        • MltplDmndInd Multiple Demand Indicator [0..1]YesNoIndicator

          Indicates that multiple demands are not permitted.

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

          Indicates that partial demands/drawings are not permitted.

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

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

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

          Indicates whether the applicant/obligor or beneficiary is responsible for payment of the transfer 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 [0..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
        • TrfInd Transfer Indicator [0..1]YesNoIndicator

          Indicates whether the undertaking is transferable.

        • NclsdFile Enclosed File [0..*]Document9

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

          • 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
        • AddtlInf Additional Information [0..5]Max2000Text

          Additional information related to the undertaking.

        • ReqdLclUdrtkg Requested Local Undertaking [0..1]Undertaking4

          Details of the local or ancillary undertaking requested to be issued by a local or other issuing institution.

          • Nm Name [1..1]UndertakingName1Code
          • Tp Type [1..1]ExternalUndertakingType1Code
          • Applcnt Applicant [1..*]PartyIdentification43
          • Bnfcry Beneficiary [1..*]PartyIdentification43
          • DtOfIssnc Date Of Issuance [0..1]ISODate
          • AdvsgPty Advising Party [0..1]PartyIdentification43
          • ScndAdvsgPty Second Advising Party [0..1]PartyIdentification43
          • LclUdrtkgAmt Local Undertaking Amount [1..1]UndertakingAmount1
          • XpryDtls Expiry Details [1..1]ExpiryDetails1
          • ConfInd Confirmation Indicator [0..1]YesNoIndicator
          • AddtlPty Additional Party [0..*]PartyAndType1
          • GovncRulesAndLaw Governance Rules And Law [1..1]GovernanceRules1
          • UndrlygTx Underlying Transaction [0..*]UnderlyingTradeTransaction1
          • PresntnDtls Presentation Details [0..1]Presentation1
          • UdrtkgWrdg Undertaking Wording [1..1]UndertakingWording1
          • MltplDmndInd Multiple Demand Indicator [0..1]YesNoIndicator
          • PrtlDmndInd Partial Demand Indicator [0..1]YesNoIndicator
          • ConfChrgsPyblBy Confirmation Charges Payable By [0..1]ExternalTypeOfParty1Code
          • TrfChrgsPyblBy Transfer Charges Payable By [0..1]ExternalTypeOfParty1Code
          • AutomtcAmtVartn Automatic Amount Variation [0..*]AutomaticVariation1
          • DlvryChanl Delivery Channel [0..1]CommunicationChannel1
          • TrfInd Transfer Indicator [0..1]YesNoIndicator
          • AddtlInf Additional Information [0..5]Max2000Text
      • BkToBnfcryInf Bank To Beneficiary Information [0..5]Max2000Text

        Additional information specific to the bank-to-beneficiary communication.

      • BkToBkInf Bank To Bank Information [0..5]Max2000Text

        Additional information specific to the bank-to-bank communication.

      • DgtlSgntr Digital Signature [0..*]PartyAndSignature2

        Digital signature of the undertaking.

        • 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 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.

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.