ZagTrader

tsmt: Trade Services Management

tsmt.017 Forward Data Set Submission Report

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

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

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

In use: published in the current ISO 20022 catalogue.

What tsmt.017 is for

The ForwardDataSetSubmissionReport message is sent by the matching application to the counterparty(ies) of the submitter of data sets.

This message is used to pass on information related to the purchasing agreement(s) covered by the transaction(s) referred to in the message.

The ForwardDataSetSubmission message can be sent by the matching application to forward the details of a DataSetSubmission message that it has obtained.

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

tsmt.017 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.017.001.05latestRegisteredLatest version set
tsmt.017.001.04RegisteredPrevious version set
tsmt.017.001.03RegisteredArchive

tsmt.017 message structure

The building blocks of tsmt.017.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]
    • FwdDataSetSubmissnRpt ForwardDataSetSubmissionReport [1..1]
      • RptId Report Identification [1..1]MessageIdentification1

        Identifies the report.

        • 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..*]DataSetSubmissionReferences4

        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
        • UsrTxRef User Transaction Reference [0..2]DocumentIdentification5

          Own reference to the transaction for the financial institution.

          • Id Identification [1..1]Max35Text
          • IdIssr Identification Issuer [1..1]BICIdentification1
        • 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...

        • EstblishdBaselnId Established Baseline Identification [1..1]DocumentIdentification3

          Unique identification assigned by the matching engine to the baseline when it is established.

          • Id Identification [1..1]Max35Text
          • Vrsn Version [1..1]Number
        • TxSts Transaction Status [1..1]BaselineStatus3Code

          Identifies the status of the transaction by means of a code.

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

      • Submitr Submitter [1..1]BICIdentification1

        The financial institution that has submitted the data sets to the matching engine.

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

      • 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 has been submitted to the matching application by the other party.

        • 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 has been submitted to the matching application by the other party.

        • 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 has been submitted to the matching application by the other party.

        • 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 has been submitted to the matching application by the other party.

        • 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 has been submitted to the matching application by the other party.

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

      • ReqForActn Request For Action [0..1]PendingActivity2

        Next processing step required.

        • Tp Type [1..1]Action2Code

          Code which specifies the next course of action that the receiver of the message must take.

        • Desc Description [0..1]Max140Text

          Further information on the course of action that the receiver of the message must take.

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

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

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