ZagTrader

tsrv: Trade Services

tsrv.019 Undertaking Status Report

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

tsrv.019 is the ISO 20022 UndertakingStatusReport message in the Trade Services business area (tsrv). The latest version is tsrv.019.001.01.

Message
UndertakingStatusReport
Latest version
tsrv.019.001.01
Submitting organisation
Not read from the catalogue
MT equivalent
MT768

In use: published in the current ISO 20022 catalogue.

What tsrv.019 is for

The UndertakingStatusReport message is exchanged between parties that have an interest in the referenced undertaking transaction. It notifies the recipient of the status of the transaction, such as acceptance or rejection, withdrawal, or non-conformation. The sender may add additional information, as appropriate.

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

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

tsrv.019 message structure

The building blocks of tsrv.019.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]
    • UdrtkgStsRpt UndertakingStatusReport [1..1]
      • UdrtkgStsRptDtls Undertaking Status Report Details [1..1]UndertakingStatusAdvice1

        Details of the undertaking status report.

        • InitgPty Initiating Party [1..1]PartyIdentification43

          Details related to the party that initiated the report.

          • 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
        • UdrtkgId Undertaking Identification [0..1]Undertaking8

          Details related to the identification of the undertaking.

          • Id Identification [1..1]Max35Text
          • Issr Issuer [1..1]PartyIdentification43
          • ApplcntRefNb Applicant Reference Number [0..1]Max35Text
          • BnfcryRefNb Beneficiary Reference Number [0..1]Max35Text
        • AmdmntSeqNb Amendment Sequence Number [0..1]Number

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

        • AdvsgPtyRefNb Advising Party Reference Number [0..1]Max35Text

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

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

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

        • StsCtgy Status Category [1..1]ExternalUndertakingStatusCategory1Code

          Specifies the category of the status.

        • Sts Status [1..1]UndertakingStatus3Code

          Specifies the reported status.

        • StsRsn Status Reason [0..*]StatusReasonInformation8

          Set of elements used to provide detailed information on the status reason.

          • Orgtr Originator [0..1]PartyIdentification32
          • Rsn Reason [0..1]StatusReason6Choice (choice)
          • AddtlInf Additional Information [0..*]Max105Text
        • RptdAmt Reported Amount [0..*]ReportedAmount1

          Amount reported.

          • Id Identification [1..1]Max35Text
          • Tp Type [1..1]ExternalUndertakingAmountType1Code
          • Amt Amount [1..1]ActiveCurrencyAndAmount
        • OrgnlMsgDtls Original Message Details [0..1]OriginalMessage1

          Information concerning the original message to which the status report may be sent in response.

          • MsgDefIdr Message Definition Identifier [1..1]Max35Text
          • Fr From [1..1]Party9Choice (choice)
          • To To [1..1]Party9Choice (choice)
          • BizMsgIdr Business Message Identifier [1..1]Max35Text
          • CreDt Creation Date [1..1]ISONormalisedDateTime
          • CpyDplct Copy Duplicate [0..1]CopyDuplicate1Code
        • NclsdFile Enclosed File [0..*]Document9

          Document or template enclosed in the report.

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

      • DgtlSgntr Digital Signature [0..1]PartyAndSignature2

        Digital signature of the report.

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

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

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