ZagTrader

tsmt: Trade Services Management

tsmt.009 Baseline Amendment Request

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

tsmt.009 is the ISO 20022 BaselineAmendmentRequest message in the Trade Services Management business area (tsmt). The latest version is tsmt.009.001.05, and 3 versions are in the repository.

Message
BaselineAmendmentRequest
Latest version
tsmt.009.001.05
Submitting organisation
Not read from the catalogue
MT equivalent
None listed

In use: published in the current ISO 20022 catalogue.

What tsmt.009 is for

The BaselineAmendmentRequest message is sent by a primary party involved in a transaction to the matching application.

The message is used to request the amendment of an established baseline.

The BaselineAmendmentRequest message may only be sent if the transaction is in the state Established or Active.

The BaselineAmendmentRequest message can be sent to the matching application by one of the primary parties involved in a transaction established in the push-through mode to request the amendment of an established baseline.

The matching application acknowledges the receipt of the amendment request by sending a DeltaReport message to the submitter of the BaselineAmendmentRequest message. It passes on the newly proposed baseline to the counterparty by sending a FullPushThroughReport message, a DeltaReport message and a pre-calculated BaselineReport message.

The counterparty is expected to either accept or reject the amendment request by submitting an AmendmentAcceptance or AmendmentRejection message.

or

The BaselineAmendmentRequest message can be sent by the party involved in a transaction established in the lodge mode to the matching application to amend an established baseline.

The matching application amends the baseline according to the BaselineAmendmentRequest message and confirms the execution of the request by sending a DeltaReport and calculated BaselineReport message to the requester of the amendment.

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

tsmt.009 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
tsmt.009.001.05latestRegisteredLatest version set
tsmt.009.001.04RegisteredPrevious version set
tsmt.009.001.03RegisteredArchive

tsmt.009 message structure

The building blocks of tsmt.009.001.05 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]
    • BaselnAmdmntReq BaselineAmendmentRequest [1..1]
      • ReqId Request Identification [1..1]MessageIdentification1

        Identifies the request message.

        • Id Identification [1..1]Max35Text

          Identification of the message.

        • CreDtTm Creation Date Time [1..1]ISODateTime

          Date of creation of the message.

      • TxId Transaction Identification [1..1]SimpleIdentificationInformation

        Unique identification assigned by the matching application to the transaction.

        • Id Identification [1..1]Max35Text

          Name or number assigned by an entity to enable recognition of that entity, eg, account identifier.

      • SubmitrTxRef Submitter Transaction Reference [0..1]SimpleIdentificationInformation

        Reference to the transaction for the requesting financial institution.

        • Id Identification [1..1]Max35Text

          Name or number assigned by an entity to enable recognition of that entity, eg, account identifier.

      • Baseln Baseline [1..1]Baseline5

        Specifies the commercial details of the underlying transaction.

        • SubmitrBaselnId Submitter Baseline Identification [1..1]DocumentIdentification1

          Identifies the baseline provided by the submitter.

          • Id Identification [1..1]Max35Text
          • Vrsn Version [1..1]Number
          • Submitr Submitter [1..1]BICIdentification1
        • SvcCd Service Code [1..1]TradeFinanceService2Code

          Identifies the service requested by the submitter by means of a code.

        • PurchsOrdrRef Purchase Order Reference [1..1]DocumentIdentification7

          Reference to the purchase order of the underlying transaction.

          • Id Identification [1..1]Max35Text
          • DtOfIsse Date Of Issue [1..1]ISODate
        • Buyr Buyer [1..1]PartyIdentification26

          Party that buys goods or services, or a financial instrument.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • Sellr Seller [1..1]PartyIdentification26

          Party that sells goods or services, or a financial instrument.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • BuyrBk Buyer Bank [1..1]BICIdentification1

          Financial institution of the buyer, uniquely identified by its BIC.

          • BIC BIC [1..1]BICIdentifier
        • SellrBk Seller Bank [1..1]BICIdentification1

          Financial institution of the seller, uniquely identified by its BIC.

          • BIC BIC [1..1]BICIdentifier
        • BuyrSdSubmitgBk Buyer Side Submitting Bank [0..*]BICIdentification1

          Financial institution on the buyer's side, uniquely identified by its BIC.

          • BIC BIC [1..1]BICIdentifier
        • SellrSdSubmitgBk Seller Side Submitting Bank [0..*]BICIdentification1

          Financial institution on the seller's side, uniquely identified by its BIC.

          • BIC BIC [1..1]BICIdentifier
        • BllTo Bill To [0..1]PartyIdentification26

          Party to be invoiced for the purchase.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • ShipTo Ship To [0..1]PartyIdentification26

          Party to whom the goods must be delivered in the end.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • Consgn Consignee [0..1]PartyIdentification26

          Party to whom the goods must be delivered.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • Goods Goods [1..1]LineItem13

          Goods or services that are part of a commercial trade agreement.

          • GoodsAndOrSvcsDesc Goods And Or Services Description [0..1]Max70Text
          • PrtlShipmnt Partial Shipment [1..1]YesNoIndicator
          • TrnsShipmnt Trans Shipment [0..1]YesNoIndicator
          • ShipmntDtRg Shipment Date Range [0..1]ShipmentDateRange1
          • LineItmDtls Line Item Details [1..*]LineItemDetails13
          • LineItmsTtlAmt Line Items Total Amount [1..1]CurrencyAndAmount
          • RtgSummry Routing Summary [0..1]TransportMeans5
          • Incotrms Incoterms [0..1]Incoterms4
          • Adjstmnt Adjustment [0..*]Adjustment7
          • FrghtChrgs Freight Charges [0..1]Charge24
          • Tax Tax [0..*]Tax23
          • TtlNetAmt Total Net Amount [1..1]CurrencyAndAmount
          • BuyrDfndInf Buyer Defined Information [0..*]UserDefinedInformation1
          • SellrDfndInf Seller Defined Information [0..*]UserDefinedInformation1
        • PmtTerms Payment Terms [1..*]PaymentTerms5

          Specifies the payment terms by means of a code and a limit in time.

          • PmtTerms Payment Terms [1..1]PaymentCodeOrOther2Choice (choice)
          • AmtOrPctg Amount Or Percentage [1..1]AmountOrPercentage2Choice (choice)
        • SttlmTerms Settlement Terms [0..1]SettlementTerms3

          Specifies how the underlying transaction should be settled.

          • CdtrAgt Creditor Agent [0..1]FinancialInstitutionIdentification4Choice (choice)
          • CdtrAcct Creditor Account [1..1]CashAccount24
        • PmtOblgtn Payment Obligation [0..*]PaymentObligation2

          Specifies the details of the payment obligation between financial institutions in this transaction.

          • OblgrBk Obligor Bank [1..1]BICIdentification1
          • RcptBk Recipient Bank [1..1]BICIdentification1
          • PmtOblgtnAmt Payment Obligation Amount [1..1]AmountOrPercentage2Choice (choice)
          • Chrgs Charges [0..*]Charges5
          • XpryDt Expiry Date [1..1]ISODate
          • AplblRules Applicable Rules [0..1]BPOApplicableRules1Choice (choice)
          • AplblLaw Applicable Law [0..1]CountryCode
          • PlcOfJursdctn Place Of Jurisdiction [0..1]Location2
          • PmtTerms Payment Terms [0..*]PaymentTerms4
          • SttlmTerms Settlement Terms [0..1]SettlementTerms3
        • LatstMtchDt Latest Match Date [0..1]ISODate

          Specifies the latest date on which a data set must be matched with a baseline.

        • ComrclDataSetReqrd Commercial Data Set Required [1..1]RequiredSubmission2

          Specifies that a commercial data set is required for each shipment part of the transaction.

          • Submitr Submitter [1..*]BICIdentification1
        • TrnsprtDataSetReqrd Transport Data Set Required [0..1]RequiredSubmission2

          Specifies that a transport data set is required for each shipment part of the transaction.

          • Submitr Submitter [1..*]BICIdentification1
        • InsrncDataSetReqrd Insurance Data Set Required [0..1]RequiredSubmission3

          Specifies that an insurance data set is required for each shipment part of the transaction.

          • Submitr Submitter [1..*]BICIdentification1
          • MtchIssr Match Issuer [0..1]PartyIdentification27
          • MtchIsseDt Match Issue Date [1..1]YesNoIndicator
          • MtchTrnsprt Match Transport [1..1]YesNoIndicator
          • MtchAmt Match Amount [1..1]YesNoIndicator
          • ClausesReqrd Clauses Required [0..*]InsuranceClauses1Code
          • MtchAssrdPty Match Assured Party [0..1]AssuredType1Code
        • CertDataSetReqrd Certificate Data Set Required [0..*]RequiredSubmission4

          Specifies that a certificate data set is required for each shipment part of the transaction.

          • Submitr Submitter [1..*]BICIdentification1
          • CertTp Certificate Type [1..1]TradeCertificateType1Code
          • MtchIssr Match Issuer [0..1]PartyIdentification27
          • MtchIsseDt Match Issue Date [1..1]YesNoIndicator
          • MtchInspctnDt Match Inspection Date [1..1]YesNoIndicator
          • AuthrsdInspctrInd Authorised Inspector Indicator [1..1]YesNoIndicator
          • MtchConsgn Match Consignee [1..1]YesNoIndicator
          • MtchManfctr Match Manufacturer [0..1]PartyIdentification27
          • LineItmId Line Item Identification [0..*]Max70Text
        • OthrCertDataSetReqrd Other Certificate Data Set Required [0..*]RequiredSubmission6

          Specifies that another type of certificate data set is required for each shipment part of the transaction.

          • Submitr Submitter [1..*]BICIdentification1
          • CertTp Certificate Type [1..1]Exact4AlphaNumericText
          • CertTpDesc Certificate Type Description [1..1]Max140Text
        • InttToPayXpctd Intent To Pay Expected [1..1]YesNoIndicator

          Specifies that IntentToPayNotice message(s) are expected as part of this transaction.

      • BuyrCtctPrsn Buyer Contact Person [0..*]ContactIdentification1

        Person to be contacted in the organisation of the buyer.

        • Nm Name [1..1]Max35Text

          Name by which a party is known and which is usually used to identify that party.

        • NmPrfx Name Prefix [0..1]NamePrefix1Code

          Specifies the terms used to formally address a person.

        • GvnNm Given Name [0..1]Max35Text

          First name of a person.

        • Role Role [0..1]Max35Text

          Role of the party in the activity.

        • PhneNb Phone Number [0..1]PhoneNumber

          Collection of information that identifies a phone number, as defined by telecom services.

        • FaxNb Fax Number [0..1]PhoneNumber

          Collection of information that identifies a FAX number, as defined by telecom services.

        • EmailAdr Email Address [0..1]Max256Text

          Address for electronic mail (e-mail).

      • SellrCtctPrsn Seller Contact Person [0..*]ContactIdentification1

        Person to be contacted in the organisation of the seller.

        • Nm Name [1..1]Max35Text

          Name by which a party is known and which is usually used to identify that party.

        • NmPrfx Name Prefix [0..1]NamePrefix1Code

          Specifies the terms used to formally address a person.

        • GvnNm Given Name [0..1]Max35Text

          First name of a person.

        • Role Role [0..1]Max35Text

          Role of the party in the activity.

        • PhneNb Phone Number [0..1]PhoneNumber

          Collection of information that identifies a phone number, as defined by telecom services.

        • FaxNb Fax Number [0..1]PhoneNumber

          Collection of information that identifies a FAX number, as defined by telecom services.

        • EmailAdr Email Address [0..1]Max256Text

          Address for electronic mail (e-mail).

      • BuyrBkCtctPrsn Buyer Bank Contact Person [0..*]ContactIdentification1

        Person to be contacted in the buyer's bank.

        • Nm Name [1..1]Max35Text

          Name by which a party is known and which is usually used to identify that party.

        • NmPrfx Name Prefix [0..1]NamePrefix1Code

          Specifies the terms used to formally address a person.

        • GvnNm Given Name [0..1]Max35Text

          First name of a person.

        • Role Role [0..1]Max35Text

          Role of the party in the activity.

        • PhneNb Phone Number [0..1]PhoneNumber

          Collection of information that identifies a phone number, as defined by telecom services.

        • FaxNb Fax Number [0..1]PhoneNumber

          Collection of information that identifies a FAX number, as defined by telecom services.

        • EmailAdr Email Address [0..1]Max256Text

          Address for electronic mail (e-mail).

      • SellrBkCtctPrsn Seller Bank Contact Person [0..*]ContactIdentification1

        Person to be contacted in the seller's bank.

        • Nm Name [1..1]Max35Text

          Name by which a party is known and which is usually used to identify that party.

        • NmPrfx Name Prefix [0..1]NamePrefix1Code

          Specifies the terms used to formally address a person.

        • GvnNm Given Name [0..1]Max35Text

          First name of a person.

        • Role Role [0..1]Max35Text

          Role of the party in the activity.

        • PhneNb Phone Number [0..1]PhoneNumber

          Collection of information that identifies a phone number, as defined by telecom services.

        • FaxNb Fax Number [0..1]PhoneNumber

          Collection of information that identifies a FAX number, as defined by telecom services.

        • EmailAdr Email Address [0..1]Max256Text

          Address for electronic mail (e-mail).

      • OthrBkCtctPrsn Other Bank Contact Person [0..*]ContactIdentification3

        Person to be contacted in another bank than the seller or buyer's bank.

        • BIC BIC [1..1]BICIdentifier

          Business Identifier Code to identify the financial institution that the contact person belongs to.

        • Nm Name [1..1]Max35Text

          Name by which a party is known and which is usually used to identify that party.

        • NmPrfx Name Prefix [0..1]NamePrefix1Code

          Specifies the terms used to formally address a person.

        • GvnNm Given Name [0..1]Max35Text

          First name of a person.

        • Role Role [0..1]Max35Text

          Role of the party in the activity.

        • PhneNb Phone Number [0..1]PhoneNumber

          Collection of information that identifies a phone number, as defined by telecom services.

        • FaxNb Fax Number [0..1]PhoneNumber

          Collection of information that identifies a FAX number, as defined by telecom services.

        • EmailAdr Email Address [0..1]Max256Text

          Address for electronic mail (e-mail).

Have a tsmt.009 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 tsmt.009

These elements take their values from ISO 20022 external code sets, which are published separately and updated every quarter without a new message version.

tsmt.009 questions

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