ZagTrader

tsmt: Trade Services Management

tsmt.014 Data Set Submission

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

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

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

In use: published in the current ISO 20022 catalogue.

What tsmt.014 is for

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

This message is used to trigger either a match or a pre-match of the information submitted with the message.

The DataSetSubmission message can be sent by either party with the instruction pre-match. In the outlined scenario, the matching application will compare the data set(s) conveyed by the DataSetSubmission message with the established baseline and report the matching result to the requester of the data set pre-match by sending a DataSetMatchReport message.

or

The DataSetSubmission message can be sent by the party specified in the baseline as data set submitter with the instruction match. In the outlined scenario, the matching application will compare the data set(s) conveyed by the DataSetSubmission message with the established baseline and report the matching result to

- the parties involved in a transaction established in the push-through mode, or

- the initiator of a transaction established in the lodge mode.

The DataSetSubmission message can be used to submit multiple data sets for multiple transactions (baselines) at the same time. However, all transactions (baselines) covered by the message must be for the same parties, that is transaction initiator and counterparty, as well as for the same buyer and seller.

The DataSetSubmission message consists of data reflecting trade information related to the purchasing agreement covered by the transaction(s), for example shipment date, invoice amount.

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

tsmt.014 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.014.001.05latestRegisteredLatest version set
tsmt.014.001.04RegisteredPrevious version set
tsmt.014.001.03RegisteredArchive

tsmt.014 message structure

The building blocks of tsmt.014.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]
    • DataSetSubmissn DataSetSubmission [1..1]
      • SubmissnId Submission Identification [1..1]MessageIdentification1

        Identifies the submitted information.

        • Id Identification [1..1]Max35Text

          Identification of the message.

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

          Date of creation of the message.

      • RltdTxRefs Related Transaction References [1..*]DataSetSubmissionReferences3

        Identifies the transactions that this submission relates to and provides associated information.

        • TxId Transaction Identification [1..1]Max35Text

          Unique identification assigned by the matching application to the transaction.

        • 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
        • SubmitrTxRef Submitter Transaction Reference [0..1]Max35Text

          Provides reference to the transaction for the financial institution that submits the data set.

        • ForcdMtch Forced Match [1..1]YesNoIndicator

          Specifies that this message should force the matching application to match all data sets it has received so far for the transaction identified by the...

      • CmonSubmissnRef Common Submission Reference [1..1]SimpleIdentificationInformation

        This reference must be used for all data sets belonging to the same submission group.

        • Id Identification [1..1]Max35Text

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

      • Instr Instruction [1..1]InstructionType3

        Specifies the instruction given by the submitter.

        • Tp Type [1..1]InstructionType3Code

          Specifies whether the data set has to be matched or pre-matched.

      • BuyrBk Buyer Bank [1..1]BICIdentification1

        The financial institution of the buyer, uniquely identified by its BIC.

        • BIC BIC [1..1]BICIdentifier

          Code allocated to a financial institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication...

      • SellrBk Seller Bank [1..1]BICIdentification1

        The financial institution of the seller, uniquely identified by its BIC.

        • BIC BIC [1..1]BICIdentifier

          Code allocated to a financial institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication...

      • ComrclDataSet Commercial Data Set [0..1]CommercialDataSet5

        Commercial information that is submitted to the matching application for processing.

        • DataSetId Data Set Identification [1..1]DocumentIdentification1

          Identifies the commercial data set.

          • Id Identification [1..1]Max35Text
          • Vrsn Version [1..1]Number
          • Submitr Submitter [1..1]BICIdentification1
        • ComrclDocRef Commercial Document Reference [1..1]InvoiceIdentification1

          Reference to the identification of the underlying commercial document.

          • InvcNb Invoice Number [1..1]Max35Text
          • IsseDt Issue Date [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
        • 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
        • Goods Goods [1..*]LineItem15

          Information about the goods and/or services of the underlying transaction.

          • PurchsOrdrRef Purchase Order Reference [1..1]DocumentIdentification7
          • FnlSubmissn Final Submission [1..1]YesNoIndicator
          • ComrclLineItms Commercial Line Items [1..*]LineItemDetails14
          • LineItmsTtlAmt Line Items Total Amount [1..1]CurrencyAndAmount
          • Adjstmnt Adjustment [0..*]Adjustment6
          • FrghtChrgs Freight Charges [0..1]Charge25
          • Tax Tax [0..*]Tax22
          • TtlNetAmt Total Net Amount [1..1]CurrencyAndAmount
          • BuyrDfndInf Buyer Defined Information [0..*]UserDefinedInformation1
          • SellrDfndInf Seller Defined Information [0..*]UserDefinedInformation1
          • Incotrms Incoterms [0..1]Incoterms4
        • PmtTerms Payment Terms [1..*]PaymentTerms4

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

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

          Specifies how the transaction should be settled.

          • CdtrAgt Creditor Agent [0..1]FinancialInstitutionIdentification4Choice (choice)
          • CdtrAcct Creditor Account [1..1]CashAccount24
      • TrnsprtDataSet Transport Data Set [0..1]TransportDataSet5

        Transport information that is submitted to the matching application for processing.

        • DataSetId Data Set Identification [1..1]DocumentIdentification1

          Identifies the submitted transport data set.

          • Id Identification [1..1]Max35Text
          • Vrsn Version [1..1]Number
          • Submitr Submitter [1..1]BICIdentification1
        • Buyr Buyer [0..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 [0..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
        • Consgnr Consignor [1..1]PartyIdentification26

          Party responsible for dispatching the goods.

          • 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
        • 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
        • TrnsprtInf Transport Information [1..1]TransportDetails4

          Specifies the shipment date, the charges, the routing and the goods that are described in the transport document.

          • TrnsprtDocRef Transport Document Reference [1..*]DocumentIdentification7
          • TrnsprtdGoods Transported Goods [1..*]TransportedGoods1
          • Consgnmt Consignment [0..1]Consignment3
          • RtgSummry Routing Summary [1..1]TransportMeans6
          • ShipmntDt Shipment Date [1..1]ShipmentDate1Choice (choice)
          • FrghtChrgs Freight Charges [0..1]Charge25
          • Incotrms Incoterms [0..1]Incoterms4
      • InsrncDataSet Insurance Data Set [0..1]InsuranceDataSet1

        Insurance information that is submitted to the matching application for processing.

        • DataSetId Data Set Identification [1..1]DocumentIdentification1

          Identifies the insurancedata set.

          • Id Identification [1..1]Max35Text
          • Vrsn Version [1..1]Number
          • Submitr Submitter [1..1]BICIdentification1
        • Issr Issuer [1..1]PartyIdentification26

          Issuer of the certificate, typically the insurance company or its agent.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • IsseDt Issue Date [1..1]ISODate

          Issue date of the document.

        • FctvDt Effective Date [0..1]ISODate

          Date upon which cover under an insurance policy becomes effective.

        • PlcOfIsse Place Of Issue [0..1]PostalAddress5

          Place where the insurance certificate was issued.

          • StrtNm Street Name [0..1]Max70Text
          • PstCdId Post Code Identification [0..1]Max16Text
          • TwnNm Town Name [0..1]Max35Text
          • CtrySubDvsn Country Sub Division [0..1]Max35Text
          • Ctry Country [1..1]CountryCode
        • InsrncDocId Insurance Document Identification [1..1]Max35Text

          Unique identifier of the document.

        • Trnsprt Transport [0..1]SingleTransport3

          Transport information relative to the goods that are insured under the insurance policy.

          • TrnsprtByAir Transport By Air [0..1]TransportByAir2
          • TrnsprtBySea Transport By Sea [0..1]TransportBySea4
          • TrnsprtByRoad Transport By Road [0..1]TransportByRoad2
          • TrnsprtByRail Transport By Rail [0..1]TransportByRail2
        • InsrdAmt Insured Amount [1..1]CurrencyAndAmount

          Value of the goods as insured under the insurance policy.

        • InsrdGoodsDesc Insured Goods Description [0..1]Max70Text

          Information about the goods and/or services of a trade transaction.

        • InsrncConds Insurance Conditions [0..*]Max350Text

          Description of the conditions and exclusion clauses under which insurance is granted.

        • InsrncClauses Insurance Clauses [0..*]InsuranceClauses1Code

          Standard insurance clauses defined by the Institute of London Underwriters (or the American Institute of marine Underwriters).

        • Assrd Assured [1..1]PartyIdentification29Choice (choice)

          Party that is covered under the assurance policy.

          • BIC BIC [1..1]BICIdentifier
          • NmAndAdr Name And Address [1..1]PartyIdentification26
        • ClmsPyblAt Claims Payable At [1..1]PostalAddress5

          Place where claims under the insurance policy will be paid.

          • StrtNm Street Name [0..1]Max70Text
          • PstCdId Post Code Identification [0..1]Max16Text
          • TwnNm Town Name [0..1]Max35Text
          • CtrySubDvsn Country Sub Division [0..1]Max35Text
          • Ctry Country [1..1]CountryCode
        • ClmsPyblIn Claims Payable In [0..1]CurrencyCode

          Currency in which claims, if valid, will be paid.

      • CertDataSet Certificate Data Set [0..*]CertificateDataSet2

        Certificate information that is submitted to the matching application for processing.

        • DataSetId Data Set Identification [1..1]DocumentIdentification1

          Identifies the certificate data set.

          • Id Identification [1..1]Max35Text
          • Vrsn Version [1..1]Number
          • Submitr Submitter [1..1]BICIdentification1
        • CertTp Certificate Type [1..1]TradeCertificateType1Code

          Specifies the type of the certificate.

        • LineItm Line Item [0..*]LineItemAndPOIdentification1

          Specifies if the certificate data set is required in relation to specific line items, and which line items.

          • LineItmId Line Item Identification [1..*]Max70Text
          • PurchsOrdrRef Purchase Order Reference [1..1]DocumentIdentification7
        • CertfdChrtcs Certified Characteristics [1..1]CertifiedCharacteristics2Choice (choice)

          Characteristics of the goods that are certified, in the context of a commercial trade transaction.

          • Orgn Origin [1..1]CountryCode
          • Qlty Quality [1..1]Max70Text
          • Anlys Analysis [1..1]Max70Text
          • Wght Weight [1..1]Quantity9
          • Qty Quantity [1..1]Quantity9
          • HlthIndctn Health Indication [1..1]YesNoIndicator
          • PhytosntryIndctn Phytosanitary Indication [1..1]YesNoIndicator
        • IsseDt Issue Date [1..1]ISODate

          Issue date of the document.

        • PlcOfIsse Place Of Issue [0..1]PostalAddress5

          Place where the certificate was issued.

          • StrtNm Street Name [0..1]Max70Text
          • PstCdId Post Code Identification [0..1]Max16Text
          • TwnNm Town Name [0..1]Max35Text
          • CtrySubDvsn Country Sub Division [0..1]Max35Text
          • Ctry Country [1..1]CountryCode
        • Issr Issuer [1..1]PartyIdentification26

          Issuer of the certificate, typically the inspection company or its agent.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • InspctnDt Inspection Date [0..1]DatePeriodDetails

          Date(s) at which inspection of the goods took place.

          • FrDt From Date [1..1]ISODate
          • ToDt To Date [1..1]ISODate
        • AuthrsdInspctrInd Authorised Inspector Indicator [0..1]YesNoIndicator

          Indicates that the inspection has been performed by an authorised inspector.

        • CertId Certificate Identification [1..1]Max35Text

          Unique identifier of the document.

        • Trnsprt Transport [0..1]SingleTransport3

          Transport information relative to the goods that are covered by the certificate.

          • TrnsprtByAir Transport By Air [0..1]TransportByAir2
          • TrnsprtBySea Transport By Sea [0..1]TransportBySea4
          • TrnsprtByRoad Transport By Road [0..1]TransportByRoad2
          • TrnsprtByRail Transport By Rail [0..1]TransportByRail2
        • GoodsDesc Goods Description [0..1]Max70Text

          Information about the goods and/or services of a trade transaction.

        • Consgnr Consignor [0..1]PartyIdentification26

          Party responsible for dispatching the goods.

          • 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 (which are the subject of the certificate) must be delivered.

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

          Manufacturer of the goods which are the subject of the certificate.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • AddtlInf Additional Information [0..*]Max350Text

          Additional and important information that could not be captured by structured fields.

      • OthrCertDataSet Other Certificate Data Set [0..*]OtherCertificateDataSet2

        Other certificate information that is submitted to the matching application for processing.

        • DataSetId Data Set Identification [1..1]DocumentIdentification1

          Identifies the certificate data set.

          • Id Identification [1..1]Max35Text
          • Vrsn Version [1..1]Number
          • Submitr Submitter [1..1]BICIdentification1
        • CertId Certificate Identification [1..1]Max35Text

          Unique identifier of the document.

        • CertTp Certificate Type [1..1]Exact4AlphaNumericText

          Specifies the type of the certificate.

        • IsseDt Issue Date [1..1]ISODate

          Issue date of the document.

        • Issr Issuer [1..1]PartyIdentification26

          Issuer of the certificate, typically the inspection company or its agent.

          • Nm Name [1..1]Max70Text
          • PrtryId Proprietary Identification [0..1]GenericIdentification4
          • PstlAdr Postal Address [1..1]PostalAddress5
        • CertInf Certificate Information [0..*]Max350Text

          Additional and important information that could not be captured by structured fields.

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

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

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