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.
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.
| Version | Registration status | Published in |
|---|---|---|
| tsmt.017.001.05latest | Registered | Latest version set |
| tsmt.017.001.04 | Registered | Previous version set |
| tsmt.017.001.03 | Registered | Archive |
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]FwdDataSetSubmissnRptForwardDataSetSubmissionReport [1..1]RptIdReport Identification [1..1]MessageIdentification1Identifies the report.
IdIdentification [1..1]Max35TextIdentification of the message.
CreDtTmCreation Date Time [1..1]ISODateTimeDate of creation of the message.
RltdTxRefsRelated Transaction References [1..*]DataSetSubmissionReferences4Identifies the transactions that this submission relates to and provides associated information.
TxIdTransaction Identification [1..1]Max35TextUnique identification assigned by the matching application to the transaction.
PurchsOrdrRefPurchase Order Reference [1..1]DocumentIdentification7Reference to the purchase order of the underlying transaction.
IdIdentification [1..1]Max35TextDtOfIsseDate Of Issue [1..1]ISODate
UsrTxRefUser Transaction Reference [0..2]DocumentIdentification5Own reference to the transaction for the financial institution.
IdIdentification [1..1]Max35TextIdIssrIdentification Issuer [1..1]BICIdentification1
ForcdMtchForced Match [1..1]YesNoIndicatorSpecifies that this message should force the matching application to match all data sets it has received so far for the transaction identified by the...
EstblishdBaselnIdEstablished Baseline Identification [1..1]DocumentIdentification3Unique identification assigned by the matching engine to the baseline when it is established.
IdIdentification [1..1]Max35TextVrsnVersion [1..1]Number
TxStsTransaction Status [1..1]BaselineStatus3CodeIdentifies the status of the transaction by means of a code.
CmonSubmissnRefCommon Submission Reference [1..1]SimpleIdentificationInformationThis reference must be used for all data sets belonging to the same submission group.
IdIdentification [1..1]Max35TextName or number assigned by an entity to enable recognition of that entity, eg, account identifier.
SubmitrSubmitter [1..1]BICIdentification1The financial institution that has submitted the data sets to the matching engine.
BICBIC [1..1]BICIdentifierCode allocated to a financial institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication...
BuyrBkBuyer Bank [1..1]BICIdentification1The financial institution of the buyer, uniquely identified by its BIC.
BICBIC [1..1]BICIdentifierCode allocated to a financial institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication...
SellrBkSeller Bank [1..1]BICIdentification1The financial institution of the seller, uniquely identified by its BIC.
BICBIC [1..1]BICIdentifierCode allocated to a financial institution by the ISO 9362 Registration Authority as described in ISO 9362 "Banking - Banking telecommunication...
ComrclDataSetCommercial Data Set [0..1]CommercialDataSet5Commercial information that has been submitted to the matching application by the other party.
DataSetIdData Set Identification [1..1]DocumentIdentification1Identifies the commercial data set.
IdIdentification [1..1]Max35TextVrsnVersion [1..1]NumberSubmitrSubmitter [1..1]BICIdentification1
ComrclDocRefCommercial Document Reference [1..1]InvoiceIdentification1Reference to the identification of the underlying commercial document.
InvcNbInvoice Number [1..1]Max35TextIsseDtIssue Date [1..1]ISODate
BuyrBuyer [1..1]PartyIdentification26Party that buys goods or services, or a financial instrument.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
SellrSeller [1..1]PartyIdentification26Party that sells goods or services, or a financial instrument.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
BllToBill To [0..1]PartyIdentification26Party to be invoiced for the purchase.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
GoodsGoods [1..*]LineItem15Information about the goods and/or services of the underlying transaction.
PurchsOrdrRefPurchase Order Reference [1..1]DocumentIdentification7FnlSubmissnFinal Submission [1..1]YesNoIndicatorComrclLineItmsCommercial Line Items [1..*]LineItemDetails14LineItmsTtlAmtLine Items Total Amount [1..1]CurrencyAndAmountAdjstmntAdjustment [0..*]Adjustment6FrghtChrgsFreight Charges [0..1]Charge25TaxTax [0..*]Tax22TtlNetAmtTotal Net Amount [1..1]CurrencyAndAmountBuyrDfndInfBuyer Defined Information [0..*]UserDefinedInformation1SellrDfndInfSeller Defined Information [0..*]UserDefinedInformation1IncotrmsIncoterms [0..1]Incoterms4
PmtTermsPayment Terms [1..*]PaymentTerms4Specifies the payment terms by means of a code and a limit in time.
PmtTermsPayment Terms [1..1]PaymentCodeOrOther1Choice (choice)AmtOrPctgAmount Or Percentage [1..1]AmountOrPercentage2Choice (choice)
SttlmTermsSettlement Terms [1..1]SettlementTerms3Specifies how the transaction should be settled.
CdtrAgtCreditor Agent [0..1]FinancialInstitutionIdentification4Choice (choice)CdtrAcctCreditor Account [1..1]CashAccount24
TrnsprtDataSetTransport Data Set [0..1]TransportDataSet5Transport information that has been submitted to the matching application by the other party.
DataSetIdData Set Identification [1..1]DocumentIdentification1Identifies the submitted transport data set.
IdIdentification [1..1]Max35TextVrsnVersion [1..1]NumberSubmitrSubmitter [1..1]BICIdentification1
BuyrBuyer [0..1]PartyIdentification26Party that buys goods or services, or a financial instrument.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
SellrSeller [0..1]PartyIdentification26Party that sells goods or services, or a financial instrument.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
ConsgnrConsignor [1..1]PartyIdentification26Party responsible for dispatching the goods.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
ConsgnConsignee [0..1]PartyIdentification26Party to whom the goods must be delivered.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
ShipToShip To [0..1]PartyIdentification26Party to whom the goods must be delivered in the end.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
TrnsprtInfTransport Information [1..1]TransportDetails4Specifies the shipment date, the charges, the routing and the goods that are described in the transport document.
TrnsprtDocRefTransport Document Reference [1..*]DocumentIdentification7TrnsprtdGoodsTransported Goods [1..*]TransportedGoods1ConsgnmtConsignment [0..1]Consignment3RtgSummryRouting Summary [1..1]TransportMeans6ShipmntDtShipment Date [1..1]ShipmentDate1Choice (choice)FrghtChrgsFreight Charges [0..1]Charge25IncotrmsIncoterms [0..1]Incoterms4
InsrncDataSetInsurance Data Set [0..1]InsuranceDataSet1Insurance information that has been submitted to the matching application by the other party.
DataSetIdData Set Identification [1..1]DocumentIdentification1Identifies the insurancedata set.
IdIdentification [1..1]Max35TextVrsnVersion [1..1]NumberSubmitrSubmitter [1..1]BICIdentification1
IssrIssuer [1..1]PartyIdentification26Issuer of the certificate, typically the insurance company or its agent.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
IsseDtIssue Date [1..1]ISODateIssue date of the document.
FctvDtEffective Date [0..1]ISODateDate upon which cover under an insurance policy becomes effective.
PlcOfIssePlace Of Issue [0..1]PostalAddress5Place where the insurance certificate was issued.
StrtNmStreet Name [0..1]Max70TextPstCdIdPost Code Identification [0..1]Max16TextTwnNmTown Name [0..1]Max35TextCtrySubDvsnCountry Sub Division [0..1]Max35TextCtryCountry [1..1]CountryCode
InsrncDocIdInsurance Document Identification [1..1]Max35TextUnique identifier of the document.
TrnsprtTransport [0..1]SingleTransport3Transport information relative to the goods that are insured under the insurance policy.
TrnsprtByAirTransport By Air [0..1]TransportByAir2TrnsprtBySeaTransport By Sea [0..1]TransportBySea4TrnsprtByRoadTransport By Road [0..1]TransportByRoad2TrnsprtByRailTransport By Rail [0..1]TransportByRail2
InsrdAmtInsured Amount [1..1]CurrencyAndAmountValue of the goods as insured under the insurance policy.
InsrdGoodsDescInsured Goods Description [0..1]Max70TextInformation about the goods and/or services of a trade transaction.
InsrncCondsInsurance Conditions [0..*]Max350TextDescription of the conditions and exclusion clauses under which insurance is granted.
InsrncClausesInsurance Clauses [0..*]InsuranceClauses1CodeStandard insurance clauses defined by the Institute of London Underwriters (or the American Institute of marine Underwriters).
AssrdAssured [1..1]PartyIdentification29Choice (choice)Party that is covered under the assurance policy.
BICBIC [1..1]BICIdentifierNmAndAdrName And Address [1..1]PartyIdentification26
ClmsPyblAtClaims Payable At [1..1]PostalAddress5Place where claims under the insurance policy will be paid.
StrtNmStreet Name [0..1]Max70TextPstCdIdPost Code Identification [0..1]Max16TextTwnNmTown Name [0..1]Max35TextCtrySubDvsnCountry Sub Division [0..1]Max35TextCtryCountry [1..1]CountryCode
ClmsPyblInClaims Payable In [0..1]CurrencyCodeCurrency in which claims, if valid, will be paid.
CertDataSetCertificate Data Set [0..*]CertificateDataSet2Certificate information that has been submitted to the matching application by the other party.
DataSetIdData Set Identification [1..1]DocumentIdentification1Identifies the certificate data set.
IdIdentification [1..1]Max35TextVrsnVersion [1..1]NumberSubmitrSubmitter [1..1]BICIdentification1
CertTpCertificate Type [1..1]TradeCertificateType1CodeSpecifies the type of the certificate.
LineItmLine Item [0..*]LineItemAndPOIdentification1Specifies if the certificate data set is required in relation to specific line items, and which line items.
LineItmIdLine Item Identification [1..*]Max70TextPurchsOrdrRefPurchase Order Reference [1..1]DocumentIdentification7
CertfdChrtcsCertified Characteristics [1..1]CertifiedCharacteristics2Choice (choice)Characteristics of the goods that are certified, in the context of a commercial trade transaction.
OrgnOrigin [1..1]CountryCodeQltyQuality [1..1]Max70TextAnlysAnalysis [1..1]Max70TextWghtWeight [1..1]Quantity9QtyQuantity [1..1]Quantity9HlthIndctnHealth Indication [1..1]YesNoIndicatorPhytosntryIndctnPhytosanitary Indication [1..1]YesNoIndicator
IsseDtIssue Date [1..1]ISODateIssue date of the document.
PlcOfIssePlace Of Issue [0..1]PostalAddress5Place where the certificate was issued.
StrtNmStreet Name [0..1]Max70TextPstCdIdPost Code Identification [0..1]Max16TextTwnNmTown Name [0..1]Max35TextCtrySubDvsnCountry Sub Division [0..1]Max35TextCtryCountry [1..1]CountryCode
IssrIssuer [1..1]PartyIdentification26Issuer of the certificate, typically the inspection company or its agent.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
InspctnDtInspection Date [0..1]DatePeriodDetailsDate(s) at which inspection of the goods took place.
FrDtFrom Date [1..1]ISODateToDtTo Date [1..1]ISODate
AuthrsdInspctrIndAuthorised Inspector Indicator [0..1]YesNoIndicatorIndicates that the inspection has been performed by an authorised inspector.
CertIdCertificate Identification [1..1]Max35TextUnique identifier of the document.
TrnsprtTransport [0..1]SingleTransport3Transport information relative to the goods that are covered by the certificate.
TrnsprtByAirTransport By Air [0..1]TransportByAir2TrnsprtBySeaTransport By Sea [0..1]TransportBySea4TrnsprtByRoadTransport By Road [0..1]TransportByRoad2TrnsprtByRailTransport By Rail [0..1]TransportByRail2
GoodsDescGoods Description [0..1]Max70TextInformation about the goods and/or services of a trade transaction.
ConsgnrConsignor [0..1]PartyIdentification26Party responsible for dispatching the goods.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
ConsgnConsignee [0..1]PartyIdentification26Party to whom the goods (which are the subject of the certificate) must be delivered.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
ManfctrManufacturer [0..1]PartyIdentification26Manufacturer of the goods which are the subject of the certificate.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
AddtlInfAdditional Information [0..*]Max350TextAdditional and important information that could not be captured by structured fields.
OthrCertDataSetOther Certificate Data Set [0..*]OtherCertificateDataSet2Other certificate information that has been submitted to the matching application by the other party.
DataSetIdData Set Identification [1..1]DocumentIdentification1Identifies the certificate data set.
IdIdentification [1..1]Max35TextVrsnVersion [1..1]NumberSubmitrSubmitter [1..1]BICIdentification1
CertIdCertificate Identification [1..1]Max35TextUnique identifier of the document.
CertTpCertificate Type [1..1]Exact4AlphaNumericTextSpecifies the type of the certificate.
IsseDtIssue Date [1..1]ISODateIssue date of the document.
IssrIssuer [1..1]PartyIdentification26Issuer of the certificate, typically the inspection company or its agent.
NmName [1..1]Max70TextPrtryIdProprietary Identification [0..1]GenericIdentification4PstlAdrPostal Address [1..1]PostalAddress5
CertInfCertificate Information [0..*]Max350TextAdditional and important information that could not be captured by structured fields.
ReqForActnRequest For Action [0..1]PendingActivity2Next processing step required.
TpType [1..1]Action2CodeCode which specifies the next course of action that the receiver of the message must take.
DescDescription [0..1]Max140TextFurther 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.