What is the latest version of tsin.004?

The latest version in the ISO 20022 e-Repository release of 24 April 2025 is tsin.004.001.01.

What is the root element of tsin.004?

The XML document is Document with the namespace urn:iso:std:iso:20022:tech:xsd:tsin.004.001.01, and its message element is FinInvc (FinancialInvoice).

Is there an MT equivalent of tsin.004?

No Swift MT message is listed as its direct equivalent on this site. Many ISO 20022 messages have no MT counterpart.

tsin: Trade Services Initiation

tsin.004 Financial Invoice

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

tsin.004 is the ISO 20022 FinancialInvoice message in the Trade Services Initiation business area (tsin). The latest version is tsin.004.001.01. It is no longer in the current catalogue of messages.

Message: FinancialInvoice
Latest version: tsin.004.001.01
Submitting organisation: Not read from the catalogue
MT equivalent: None listed

Archived: no version is in the latest or previous version sets.

What tsin.004 is for

The FinancialInvoice message is used to support the provision of financial and related services where there is a requirement to exchange invoice information.
While the prime function of the FinancialInvoice message is as a request from the seller to the buyer for payment, the FinancialInvoice message can also serve to evidence an invoice in support of a financial service such as invoice factoring, letters of credit, and bank payment obligations, to enable Web based services such as electronic bill payment and presentment, and as the basis to transfer invoice information via third parties such as e-invoicing service providers.
A consequence of the receipt of an invoice by the buyer is that it acts as a trigger for the use of related messages that are already defined in ISO 20022, notably where the information contained in the Financial Invoice enables payment for the goods or services received, and/or is provided in support of a request for invoice financing. While certain of these related messages, such as the CreditTransfer and PaymentInitiation messages, are shown in the sequence diagram they are out of scope. They are shown only to illustrate a given scenario and to place the invoice in the context of the financial banking processes that might be conducted between different financial institutions.
The use of self-billing by the buyer to the seller, where the buyer acts as the invoice issuer or the process of handling an incorrect invoice, is not in scope.

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

tsin.004 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
tsin.004.001.01latest	Registered	Archive

tsin.004 message structure

The building blocks of tsin.004.001.01 and the elements directly under them, 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]
- FinInvc FinancialInvoice [1..1]
  - InvcHdr Invoice Header [1..1]InvoiceHeader1
    Collection of data that is exchanged between two or more parties in written, printed or electronic form.
    - Id Identification [1..1]Max35Text
      Unique identification of this invoice document.
    - TpCd Type Code [1..1]ExternalDocumentType1Code
      Specifies the type of the document, for example commercial invoice.
    - Nm Name [0..*]Max35Text
      Name of invoice document or transaction, for example, tax invoice.
    - IsseDtTm Issue Date Time [1..1]ISODateTime
      Issue date of the document.
    - Issr Issuer [0..1]TradeParty1
      Party that issued this invoice document.
    - LangCd Language Code [0..1]LanguageCode
      Unique identifier for a language used in this invoice document.
    - CpyInd Copy Indicator [0..1]YesNoIndicator
      Indicator that the document is a copy of the original document.
    - DocPurp Document Purpose [0..1]ExternalDocumentPurpose1Code
      Specifies the function of the document.
    - InclNote Included Note [0..*]AdditionalInformation6
      Note included in this invoice document.
  - TradAgrmt Trade Agreement [1..1]TradeAgreement6
    Commercial information such as terms of commerce, parties, and documentation, related to the trading agreement under which this invoice is issued.
    - Buyr Buyer [1..1]TradeParty1
      Party that is specified as the buyer for this trade agreement.
    - Sellr Seller [1..1]TradeParty1
      Party that is specified as the seller for this trade agreement.
    - QtnDocId Quotation Document Identification [0..1]DocumentIdentification22
      Quotation document referenced from this trade agreement.
    - CtrctDocId Contract Document Identification [0..1]DocumentIdentification22
      Contract document referenced from this trade agreement.
    - BuyrOrdrIdDoc Buyer Order Identification Document [0..1]DocumentIdentification22
      Buyer order document referenced from this trade agreement.
    - AddtlRefDoc Additional Reference Document [0..*]DocumentGeneralInformation2
      Additional document referenced from this trade agreement.
    - Incotrms Incoterms [0..1]Incoterms3
      Specifies the applicable Incoterm and associated location.
  - TradDlvry Trade Delivery [1..1]TradeDelivery1
    Supply chain shipping arrangements for delivery of invoiced products and/or services.
    - DlvryPrd Delivery Period [0..1]Period1
      Actual delivery period of the products and/or services.
    - DlvryDtTm Delivery Date Time [0..1]ISODateTime
      Actual delivery date/time of the products and/or services.
    - ShipFr Ship From [0..1]TradeParty1
      Party from whom the goods are dispatched.
    - ShipTo Ship To [0..1]TradeParty1
      Party to whom the goods are dispatched.
    - UltmtShipTo Ultimate Ship To [0..1]TradeParty1
      Final party to whom the goods are dispatched.
    - DlvryNote Delivery Note [0..1]DocumentIdentification22
      Delivery note related to the delivery of the products and/or services.
    - Consgnmt Consignment [0..*]Consignment2
      Physical consolidation of goods for transport.
  - TradSttlm Trade Settlement [1..1]TradeSettlement1
    Settlement information that enables the financial reconciliation and payment of this invoice.
    - DuePyblAmt Due Payable Amount [0..*]CurrencyAndAmount
      Monetary value that is an exact amount due and payable, such as the amount due to the creditor.
    - CdtrRef Creditor Reference [0..*]CreditorReferenceInformation2
      Unique and unambiguous reference assigned by the creditor.
    - PmtRef Payment Reference [0..*]Max35Text
      Unique and unambiguous identifier for a payment transaction, as assigned by the originator.
    - InvcCcyCd Invoice Currency Code [0..1]CurrencyCode
      Code specifying the currency of the invoice.
    - Invcr Invoicer [0..1]TradeParty1
      Organization issuing the invoice.
    - Invcee Invoicee [0..1]TradeParty1
      Party to whom the invoice was issued.
    - Pyee Payee [0..1]TradeParty1
      Party specified to receive payment for the invoice.
    - Pyer Payer [0..1]TradeParty1
      Party specified to initiate payment for the invoice.
    - TaxCcyXchg Tax Currency Exchange [0..1]CurrencyReference2
      Currency exchange applicable to a tax.
    - InvcCcyXchg Invoice Currency Exchange [0..1]CurrencyReference2
      Currency exchange applicable to the invoice.
    - PmtCcyXchg Payment Currency Exchange [0..1]CurrencyReference2
      Currency exchange applicable to the payment.
    - PmtMeans Payment Means [0..*]PaymentMeans1
      Means of payment (for example, credit transfer, cheque, money order, or credit card) specified to initiate payment of the invoice.
    - Tax Tax [0..*]SettlementTax1
      Amount of money due to the government or tax authority, according to various pre-defined parameters such as thresholds or income.
    - BllgPrd Billing Period [0..1]Period1
      Specifies the applicable billing period.
    - AllwncChrg Allowance Charge [0..*]SettlementAllowanceCharge1
      Allowance or charge specified.
    - SubTtlClctdTax Sub Total Calculated Tax [0..*]SettlementSubTotalCalculatedTax1
      Tax subtotal calculated.
    - LogstcsChrg Logistics Charge [0..*]ChargesDetails2
      Logistics service charge specified.
    - PmtTerms Payment Terms [0..*]PaymentTerms3
      Payment terms.
    - MntrySummtn Monetary Summation [1..1]SettlementMonetarySummation1
      Monetary totals specified for the invoice.
    - AdjstmntAmtAndRsn Adjustment Amount And Reason [0..*]DocumentAdjustment2
      Financial adjustment specified.
    - InvcRefdDoc Invoice Referenced Document [0..1]DocumentIdentification22
      Invoice document referenced.
    - ProfrmInvcRefdDoc Proforma Invoice Referenced Document [0..1]DocumentIdentification22
      Pro-forma invoice document referenced.
    - LttrOfCdtRefdDoc Letter Of Credit Referenced Document [0..1]DocumentIdentification7
      Letter of credit document referenced.
    - FinCard Financial Card [0..*]FinancialCard1
      Financial card specified.
    - PurchsAcctgAcct Purchase Accounting Account [0..*]AccountingAccount1
      Specific purchase account for recording debits and credits for accounting purposes.
    - IssrFactrgListId Issuer Factoring List Identification [0..*]Max35Text
      Factoring list document referenced.
    - IssrFactrgAgrmtId Issuer Factoring Agreement Identification [0..*]Max35Text
      Factoring agreement document referenced.
  - LineItm Line Item [0..*]LineItem10
    Unit of information in this invoice showning the related provision of products and/or services and monetary summations reported as a discrete line item.
    - Id Identification [0..1]Max35Text
      The unique identification of this invoice line item.
    - TradPdct Trade Product [0..1]TradeProduct1
      Something that is produced and sold as the result of an industrial process.
    - BuyrOrdrId Buyer Order Identification [0..1]DocumentIdentification23
      Purchase order reference assigned by the buyer related to the provision of products and/or services for this line item.
    - CtrctId Contract Identification [0..1]DocumentIdentification22
      Contract reference related to the provision of products and/or services for this line item.
    - PurchsAcctgAcct Purchase Accounting Account [0..*]AccountingAccount1
      Specific purchase account for recording debits and credits for accounting purposes.
    - NetPric Net Price [0..*]CurrencyAndAmount
      Value of the price, eg, as a currency and value.
    - NetPricQty Net Price Quantity [0..1]Quantity4
      Quantity and conversion factor on which the net price is based for this line item product and/or service.
    - NetPricAllwncChrg Net Price Allowance Charge [0..*]LineItemAllowanceCharge1
      Allowance or charge applied to the net price.
    - NetWght Net Weight [0..1]Quantity3
      Net weight of the product.
    - GrssPric Gross Price [0..*]CurrencyAndAmount
      Gross price of the product and/or service.
    - GrssPricQty Gross Price Quantity [0..1]Quantity4
      Quantity and conversion factor on which the gross price is based for this line item product and/or service.
    - GrssWght Gross Weight [0..1]Quantity3
      Gross weight of the product.
    - LogstcsChrg Logistics Charge [0..*]ChargesDetails2
      Logistics service charge for this line item.
    - Tax Tax [0..*]LineItemTax1
      Amount of money due to the government or tax authority, according to various pre-defined parameters such as thresholds or income.
    - AllwncChrg Allowance Charge [0..*]LineItemAllowanceCharge1
      Allowance or charge specified for this line item.
    - FinAdjstmnt Financial Adjustment [0..*]Adjustment4
      Modification on the value of goods and / or services.
    - BlldQty Billed Quantity [0..1]Quantity3
      Quantity billed for this line item.
    - PackgQty Package Quantity [0..1]DecimalNumber
      Number of product packages delivered.
    - PerPackgUnitQty Per Package Unit Quantity [0..1]Quantity3
      Number of units per package in this line item for a supply chain trade delivery.
    - Packgng Packaging [0..*]Packaging1
      Physical packaging of the product.
    - ChrgFreeQty Charge Free Quantity [0..1]Quantity3
      Quantity that is free of charge for this line item.
    - MeasrQtyStart Measure Quantity Start [0..1]Quantity3
      Quantity value on which the quantity measurement started for a line item.
    - MeasrQtyEnd Measure Quantity End [0..1]Quantity3
      Quantity value on which the quantity measurement ended for a line item.
    - MeasrDtTmStart Measure Date Time Start [0..1]ISODateTime
      Date/time on which the clock time measure started for a line item.
    - MeasrDtTmEnd Measure Date Time End [0..1]ISODateTime
      Date/time on which the clock time measure ended for a line item.
    - ShipTo Ship To [0..1]TradeParty1
      Party to whom the goods must be delivered in the end.
    - Incotrms Incoterms [0..1]Incoterms3
      Specifies the applicable Incoterm and associated location.
    - DlvryDtTm Delivery Date Time [0..1]ISODateTime
      Actual delivery date/time of the products and/or services for this line item.
    - DlvryNoteId Delivery Note Identification [0..1]DocumentIdentification22
      Delivery note related to the delivery of the products and/or services for this line item.
    - MntrySummtn Monetary Summation [0..1]LineItemMonetarySummation1
      Monetary totals for this line item.
    - InclNote Included Note [0..*]AdditionalInformation1
      Note included in this line item.

Have a tsin.004 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 tsin.004

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

tsin.004 questions

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