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.
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.
| Version | Registration status | Published in |
|---|---|---|
| tsrv.013.001.01latest | Registered | Latest 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]UdrtkgDmndUndertakingDemand [1..1]UdrtkgDmndDtlsUndertaking Demand Details [1..1]Demand1Details of the demand.
IdIdentification [1..1]Max35TextUnique and unambiguous identifier assigned by the presenting party to the demand.
TpType [1..1]DemandType1CodeType of demand.
UdrtkgIdUndertaking Identification [1..1]Undertaking6Details related to the undertaking.
IdIdentification [1..1]Max35TextIssrIssuer [1..1]PartyIdentification43BnfcryRefNbBeneficiary Reference Number [0..1]Max35Text
DmndAmtDemand Amount [1..1]UndertakingAmount3Details related to the demand amount.
AmtAmount [1..1]ActiveCurrencyAndAmountAddtlInfAdditional Information [0..5]Max2000Text
AdvsgPtyRefNbAdvising Party Reference Number [0..1]Max35TextUnique and unambiguous identifier assigned by the advising party to the undertaking.
ScndAdvsgPtyRefNbSecond Advising Party Reference Number [0..1]Max35TextUnique and unambiguous identifier assigned by the second advising party to the undertaking.
CnfrmrRefNbConfirmer Reference Number [0..1]Max35TextUnique and unambiguous identifier assigned by the confirmer to the undertaking.
SttlmAcctSettlement Account [0..*]CashAccount27Details related to the settlement account.
IdIdentification [1..1]AccountIdentification4Choice (choice)TpType [0..1]CashAccountType2CcyCurrency [0..1]ActiveOrHistoricCurrencyCodeNmName [0..1]Max70TextOwnrOwner [0..1]PartyIdentification41SvcrServicer [0..1]BranchAndFinancialInstitutionIdentification5
PresntnDtlsPresentation Details [0..1]Presentation2Details of the beneficiary's presentation of documents.
PresntrPresenter [0..1]PartyIdentification43BnfcryPresntnDtBeneficiary Presentation Date [0..1]ISODate
ReqdXpryDtRequested Expiry Date [0..1]ISODateRequested new expiry date as an alternative to payment of the demand.
DmndDcmnttnDemand Documentation [0..1]DemandDocumentation1Document(s) presented for examination.
CmpltIndComplete Indicator [1..1]YesNoIndicatorCmpltnInfCompletion Information [0..1]Max2000TextNclsdFileEnclosed File [0..*]Document9DmndNrrtvDemand Narrative [0..1]Max20000Text
AddtlInfAdditional Information [0..5]Max2000TextAdditional information related to the demand.
BkToBkInfBank To Bank Information [0..5]Max2000TextAdditional information specific to the bank-to-bank communication.
DgtlSgntrDigital Signature [0..1]PartyAndSignature2Digital signature of the demand.
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.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.
- ExternalAccountIdentification1Code4 codes
- ExternalClearingSystemIdentification1Code172 codes
- ExternalDocumentFormat1Code5 codes
- ExternalFinancialInstitutionIdentification1Code0 codes
- ExternalOrganisationIdentification1Code15 codes
- ExternalPersonIdentification1Code11 codes
- ExternalUndertakingDocumentType1Code5 codes
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.