What is the latest version of tsrv.002?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is tsrv.002.001.01.

What is the root element of tsrv.002?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:tsrv.002.001.01, and its message element is UdrtkgIssncAdvc (UndertakingIssuanceAdvice).

Is there an MT equivalent of tsrv.002?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

tsrv: Trade Services

tsrv.002 Undertaking Issuance Advice

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

tsrv.002 is the ISO 20022 UndertakingIssuanceAdvice message in the Trade Services business area (tsrv). The latest version is tsrv.002.001.01.

Message: UndertakingIssuanceAdvice
Latest version: tsrv.002.001.01
Submitting organisation: Not read from the catalogue
MT equivalent: None listed

In use: published in the current ISO 20022 catalogue.

What tsrv.002 is for

The UndertakingIssuanceAdvice message is sent by an advising party to the beneficiary, either directly or via one or more other advising parties in the transaction chain, to advise the issuance of an undertaking. Other interested parties may also be informed of the advice. The undertaking advised could be a demand guarantee, standby letter of credit, or counter-undertaking (counter-guarantee or counter-standby). In addition to providing details on the applicable rules, expiry date, the amount, required documents, and terms and conditions of the undertaking, the advice may provide information from the sender such as confirmation details.

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

tsrv.002 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.002.001.01latest	Registered	Latest version set

tsrv.002 message structure

The building blocks of tsrv.002.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]
- UdrtkgIssncAdvc UndertakingIssuanceAdvice [1..1]
  - AdvsgPty Advising Party [1..1]PartyIdentification43
    Party advising the undertaking to the beneficiary or to another party.
    - Nm Name [0..1]Max140Text
      Name by which a party is known and which is usually used to identify that party.
    - PstlAdr Postal Address [0..1]PostalAddress6
      Information that locates and identifies a specific address, as defined by postal services.
      - AdrTp Address Type [0..1]AddressType2Code
      - Dept Department [0..1]Max70Text
      - SubDept Sub Department [0..1]Max70Text
      - StrtNm Street Name [0..1]Max70Text
      - BldgNb Building Number [0..1]Max16Text
      - PstCd Post Code [0..1]Max16Text
      - TwnNm Town Name [0..1]Max35Text
      - CtrySubDvsn Country Sub Division [0..1]Max35Text
      - Ctry Country [0..1]CountryCode
      - AdrLine Address Line [0..7]Max70Text
    - Id Identification [0..1]Party11Choice (choice)
      Unique and unambiguous identification of a party.
      - OrgId Organisation Identification [1..1]OrganisationIdentification8
      - PrvtId Private Identification [1..1]PersonIdentification5
    - CtryOfRes Country Of Residence [0..1]CountryCode
      Country in which a person resides (the place of a person's home).
    - CtctDtls Contact Details [0..1]ContactDetails2
      Set of elements used to indicate how to contact the party.
      - NmPrfx Name Prefix [0..1]NamePrefix1Code
      - Nm Name [0..1]Max140Text
      - PhneNb Phone Number [0..1]PhoneNumber
      - MobNb Mobile Number [0..1]PhoneNumber
      - FaxNb Fax Number [0..1]PhoneNumber
      - EmailAdr Email Address [0..1]Max2048Text
      - Othr Other [0..1]Max35Text
  - ScndAdvsgPty Second Advising Party [0..1]PartyIdentification43
    Additional party that advises the undertaking.
    - Nm Name [0..1]Max140Text
      Name by which a party is known and which is usually used to identify that party.
    - PstlAdr Postal Address [0..1]PostalAddress6
      Information that locates and identifies a specific address, as defined by postal services.
      - AdrTp Address Type [0..1]AddressType2Code
      - Dept Department [0..1]Max70Text
      - SubDept Sub Department [0..1]Max70Text
      - StrtNm Street Name [0..1]Max70Text
      - BldgNb Building Number [0..1]Max16Text
      - PstCd Post Code [0..1]Max16Text
      - TwnNm Town Name [0..1]Max35Text
      - CtrySubDvsn Country Sub Division [0..1]Max35Text
      - Ctry Country [0..1]CountryCode
      - AdrLine Address Line [0..7]Max70Text
    - Id Identification [0..1]Party11Choice (choice)
      Unique and unambiguous identification of a party.
      - OrgId Organisation Identification [1..1]OrganisationIdentification8
      - PrvtId Private Identification [1..1]PersonIdentification5
    - CtryOfRes Country Of Residence [0..1]CountryCode
      Country in which a person resides (the place of a person's home).
    - CtctDtls Contact Details [0..1]ContactDetails2
      Set of elements used to indicate how to contact the party.
      - NmPrfx Name Prefix [0..1]NamePrefix1Code
      - Nm Name [0..1]Max140Text
      - PhneNb Phone Number [0..1]PhoneNumber
      - MobNb Mobile Number [0..1]PhoneNumber
      - FaxNb Fax Number [0..1]PhoneNumber
      - EmailAdr Email Address [0..1]Max2048Text
      - Othr Other [0..1]Max35Text
  - DtOfAdvc Date Of Advice [1..1]DateAndDateTimeChoice (choice)
    Date on which the undertaking is advised.
    - Dt Date [1..1]ISODate
      Specified date.
    - DtTm Date Time [1..1]ISODateTime
      Specified date and time.
  - UdrtkgIssncAdvcDtls Undertaking Issuance Advice Details [1..1]UndertakingAdvice1
    Details related to the advice of the issued undertaking.
    - UdrtkgIssncMsg Undertaking Issuance Message [1..1]UndertakingIssuanceMessage
      Contents of the related UndertakingIssuance message.
      - UdrtkgDtls Undertaking Details [1..1]Undertaking3
      - DgtlSgntr Digital Signature [0..1]PartyAndSignature2
    - FrstAdvsgPtyAddtlInf First Advising Party Additional Information [0..1]AdvisingPartyAdditionalInformation1
      Additional information related to the first advising party.
      - RefNb Reference Number [0..1]Max35Text
      - BkToBnfcryInf Bank To Beneficiary Information [0..5]Max2000Text
    - ScndAdvsgPtyAddtlInf Second Advising Party Additional Information [0..1]AdvisingPartyAdditionalInformation1
      Additional information related to the second advising party.
      - RefNb Reference Number [0..1]Max35Text
      - BkToBnfcryInf Bank To Beneficiary Information [0..5]Max2000Text
    - ConfDtls Confirmation Details [0..1]UndertakingConfirmation1
      Details related to the confirmation of the undertaking.
      - Cnfrmr Confirmer [1..1]PartyIdentification43
      - RefNb Reference Number [1..1]Max35Text
      - Dt Date [1..1]DateAndDateTimeChoice (choice)
      - Conf Confirmation [0..5]Max2000Text
    - DgtlSgntr Digital Signature [0..3]PartyAndSignature2
      Digital signature of the party providing additional undertaking advice details.
      - Pty Party [1..1]PartyIdentification43
      - Sgntr Signature [1..1]ProprietaryData3
  - BkToBkInf Bank To Bank Information [0..5]Max2000Text
    Additional information specific to the bank-to-bank communication.
  - DgtlSgntr Digital Signature [0..1]PartyAndSignature2
    Digital signature of the undertaking advice.
    - 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.002 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.002

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.002 questions

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