ZagTrader

tsrv: Trade Services

tsrv.013 Undertaking Demand

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

tsrv.013 is the ISO 20022 UndertakingDemand message in the Trade Services business area (tsrv). The latest version is tsrv.013.001.01.

Message
UndertakingDemand
Latest version
tsrv.013.001.01
Submitting organisation
Not read from the catalogue
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What tsrv.013 is for

The UndertakingDemand message and other required documents are sent by the beneficiary to the party that issued the undertaking, either directly or via a presenting or nominated party. It is a demand for payment and may include a request to extend the undertaking expiry date. The demand itself must be contained in an enclosed file within the message or must be specified as narrative text within the message. It may contain other required documents in addition to the demand.

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

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

tsrv.013 message structure

The building blocks of tsrv.013.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]
    • UdrtkgDmnd UndertakingDemand [1..1]
      • UdrtkgDmndDtls Undertaking Demand Details [1..1]Demand1

        Details of the demand.

        • Id Identification [1..1]Max35Text

          Unique and unambiguous identifier assigned by the presenting party to the demand.

        • Tp Type [1..1]DemandType1Code

          Type of demand.

        • UdrtkgId Undertaking Identification [1..1]Undertaking6

          Details related to the undertaking.

          • Id Identification [1..1]Max35Text
          • Issr Issuer [1..1]PartyIdentification43
          • BnfcryRefNb Beneficiary Reference Number [0..1]Max35Text
        • DmndAmt Demand Amount [1..1]UndertakingAmount3

          Details related to the demand amount.

          • Amt Amount [1..1]ActiveCurrencyAndAmount
          • AddtlInf Additional Information [0..5]Max2000Text
        • AdvsgPtyRefNb Advising Party Reference Number [0..1]Max35Text

          Unique and unambiguous identifier assigned by the advising party to the undertaking.

        • ScndAdvsgPtyRefNb Second Advising Party Reference Number [0..1]Max35Text

          Unique and unambiguous identifier assigned by the second advising party to the undertaking.

        • CnfrmrRefNb Confirmer Reference Number [0..1]Max35Text

          Unique and unambiguous identifier assigned by the confirmer to the undertaking.

        • SttlmAcct Settlement Account [0..*]CashAccount27

          Details related to the settlement account.

          • Id Identification [1..1]AccountIdentification4Choice (choice)
          • Tp Type [0..1]CashAccountType2
          • Ccy Currency [0..1]ActiveOrHistoricCurrencyCode
          • Nm Name [0..1]Max70Text
          • Ownr Owner [0..1]PartyIdentification41
          • Svcr Servicer [0..1]BranchAndFinancialInstitutionIdentification5
        • PresntnDtls Presentation Details [0..1]Presentation2

          Details of the beneficiary's presentation of documents.

          • Presntr Presenter [0..1]PartyIdentification43
          • BnfcryPresntnDt Beneficiary Presentation Date [0..1]ISODate
        • ReqdXpryDt Requested Expiry Date [0..1]ISODate

          Requested new expiry date as an alternative to payment of the demand.

        • DmndDcmnttn Demand Documentation [0..1]DemandDocumentation1

          Document(s) presented for examination.

          • CmpltInd Complete Indicator [1..1]YesNoIndicator
          • CmpltnInf Completion Information [0..1]Max2000Text
          • NclsdFile Enclosed File [0..*]Document9
          • DmndNrrtv Demand Narrative [0..1]Max20000Text
        • AddtlInf Additional Information [0..5]Max2000Text

          Additional information related to the demand.

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

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

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

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