ZagTrader

tsrv: Trade Services

tsrv.005 Undertaking Amendment

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

tsrv.005 is the ISO 20022 UndertakingAmendment message in the Trade Services business area (tsrv). The latest version is tsrv.005.001.01.

Message
UndertakingAmendment
Latest version
tsrv.005.001.01
Submitting organisation
Not read from the catalogue
MT equivalent
MT767

In use: published in the current ISO 20022 catalogue.

What tsrv.005 is for

The UndertakingAmendment message is sent (and is thus issued) by the party that issued the undertaking. The message may be sent either directly to the beneficiary or via an advising party. The proposed undertaking amendment could be to a demand guarantee, standby letter of credit, or counter-undertaking (counter-guarantee or counter-standby). The message provides details on proposed changes to the undertaking, for example, to the expiry date, the amount, and terms and conditions of the undertaking. It may also be used to propose the termination or cancellation of the undertaking. Under practice and law, this communication binds the party issuing it. The message constitutes an operative financial instrument.

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

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

tsrv.005 message structure

The building blocks of tsrv.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]
    • UdrtkgAmdmnt UndertakingAmendment [1..1]
      • UdrtkgAmdmntDtls Undertaking Amendment Details [1..1]Amendment1

        Details related to the proposed undertaking amendment.

        • SeqNb Sequence Number [1..1]Max4AlphaNumericText

          Sequence number assigned by the issuer to each proposed amendment of the undertaking.

        • DtOfIssnc Date Of Issuance [1..1]ISODate

          Date on which the proposed amendment is issued.

        • UdrtkgId Undertaking Identification [1..1]Undertaking7

          Identification of the undertaking.

          • Id Identification [1..1]Max35Text
          • Issr Issuer [1..1]PartyIdentification43
        • AdvsgPty Advising Party [0..1]PartyIdentification43

          Party asked to advise the proposed amendment 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 proposed amendment.

          • 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
        • TermntnDtls Termination Details [0..1]UndertakingTermination3

          Details concerning the requested termination of the undertaking.

          • FctvDt Effective Date [1..1]ISODate
          • Rsn Reason [0..1]TerminationReason1Choice (choice)
          • AddtlInf Additional Information [0..5]Max2000Text
        • UdrtkgAmtAdjstmnt Undertaking Amount Adjustment [0..1]UndertakingAmount2

          Requested increase or decrease to the amount of for the undertaking.

          • AmtChc Amount Choice [1..1]Amount1Choice (choice)
          • AddtlInf Additional Information [0..5]Max2000Text
        • NewXpryDtls New Expiry Details [0..1]ExpiryDetails1

          Requested new expiry terms for the undertaking.

          • XpryTerms Expiry Terms [0..1]ExpiryTerms1
          • AddtlXpryInf Additional Expiry Information [0..5]Max2000Text
        • NewBnfcry New Beneficiary [0..1]PartyIdentification43

          Requested new beneficiary of 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
        • NewUdrtkgTermsAndConds New Undertaking Terms And Conditions [0..*]Narrative1

          Requested new terms and conditions of the undertaking.

          • Tp Type [0..1]NarrativeType1Choice (choice)
          • Txt Text [1..5]Max20000Text
        • LclUdrtkg Local Undertaking [0..1]Undertaking11

          Amendment details related to the local undertaking.

          • NewUdrtkgAmt New Undertaking Amount [0..1]UndertakingAmount2
          • NewXpryDtls New Expiry Details [0..1]ExpiryDetails1
          • NewBnfcry New Beneficiary [0..1]PartyIdentification43
          • NewUdrtkgTermsAndConds New Undertaking Terms And Conditions [0..1]Narrative1
          • DlvryChanl Delivery Channel [0..1]CommunicationChannel1
        • BnfcryCnsntReqInd Beneficiary Consent Request Indicator [0..1]YesNoIndicator

          Indicates whether or not consent is requested from the beneficiary.

        • DlvryChanl Delivery Channel [0..1]CommunicationChannel1

          Communication channel for delivery of the proposed amendment.

          • 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
        • NclsdFile Enclosed File [0..*]Document9

          Document or template enclosed in the proposed amendment.

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

      • 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 proposed undertaking amendment.

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

tsrv.005 questions

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