--- title: "XSD documentation invoice" canonical: "https://knowledge-hub.onetrail.com/space/docs/718701262/XSD%20documentation%20invoice" format: markdown --- > ✅ **Download** > ✅ > ✅ Download the XSD: The **Invoice** message (OTINV). Onetrail Invoice V3.1 Format. Copyright 2013 Onetrail TPN™. All rights reserved. | **Root element** | `invoices` | | --- | --- | | **Namespace** | `http://www.onetrail.net` | | **Schema file** | `OTINV_Invoice-V3.1.xsd` | | **Version** | V3.1 | > Macro (toc) ## Message structure – invoices Complete element tree. Click a type to open its page.
Expand full tree **invoices** – [invoicesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727122059) - **invoice** `1..1` – [invoiceType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106120) - **invoiceDate** `1..1` – [DateTimeFormatType](#XSDdocumentationinvoice-DateTimeFormatType) pattern `[0-9]{8}T[0-9]{6}` - **headerText** `0..1` – [FreeFormTextType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726564939) - **FreeFormText** `1..1` – [fftType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726237277) - **@lang** `optional` - **remarks** `0..1` – [RemarksType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859883) - **remark** `1..n` – [RemarkType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726335502) - **@lang** `optional` - **@context** `optional` - **addresses** `1..1` – [addressesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725450867) - **address** `1..n` – [addressType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726270025) - **name** `1..1` – `xsd:string` - **addressLine1** `0..1` – `xsd:string` - **addressLine2** `0..1` – `xsd:string` - **addressLine3** `0..1` – `xsd:string` - **cityName** `0..1` – `xsd:string` - **nationalPostalCode** `0..1` – `xsd:string` - **globalCountryCode** `0..1` – `xsd:string` - **contactName** `0..1` – `xsd:string` - **emailAddress** `0..1` – `xsd:string` - **telephoneNumber** `0..1` – `xsd:string` - **facsimileNumber** `0..1` – `xsd:string` - **accountNumber** `0..1` – `xsd:string` - **taxIdentifier** `0..1` – `xsd:string` - **bankAccountNumber** `0..1` – `xsd:string` - **IBAN** `0..1` – `xsd:string` - **BIC** `0..1` – `xsd:string` - **@partnerID** `optional` - **@type** `required` - **invoiceLines** `1..1` – [invoiceLinesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726630458) - **invoiceLine** `0..n` – [invoiceLineType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725975206) - **orderIdentifications** `1..1` – [orderIdentificationsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106171) - **orderIdentification** `1..n` – [orderIdentificationType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725581926) - **@type** `required` - **tracking** `0..1` – [trackingType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859945) - **trackingcode** `1..n` – [trackingcodeType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726204604) - **@origcode** `required` - **lineNumbers** `1..1` – [lineNumbersType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726892760) - **lineNumber** `1..n` – [lineNumberType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859974) - **@type** `required` - **amounts** `1..1` – [amountsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827150) - **monetaryAmount** `1..n` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **unitOfMeasurement** `0..1` – [GlobalProductUnitOfMeasureCodeType](#XSDdocumentationinvoice-GlobalProductUnitOfMeasureCodeType) 14 code values - **productDescription** `0..1` – `xsd:string` - **countryOfOrigin** `0..1` – `xsd:string` - **invoicedQuantity** `1..1` – `xsd:string` - **orderedQuantity** `0..1` – `xsd:string` - **deliveredQuantity** `0..1` – `xsd:string` - **productIdentifiers** `1..1` – [productIdentifiersType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727318577) - **productIdentifier** `1..n` – [productIdentifierType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725942385) - **@type** `required` - **productClassification** `0..1` – `xsd:string` - **serialNumbers** `0..1` – [serialNumbersType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727547914) - **serialNumber** `1..n` – `xsd:string` - **taxes** `0..1` – [taxesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483654) - **tax** `1..n` – [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) - **monetaryAmount** `0..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **@type** `required` - **@rate** `optional` - **@origrate** `optional` - **@origcode** `optional` - **levies** `0..1` – [leviesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725614663) - **levy** `1..n` – [levyType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859914) - **description** `0..1` – `xsd:string` - **monetaryAmount** `1..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **tax** `0..1` – [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) - **monetaryAmount** `0..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **@type** `required` - **@rate** `optional` - **@origrate** `optional` - **@origcode** `optional` - **@type** `required` - **@origrate** `optional` - **@origcode** `optional` - **charges** `0..1` – [chargesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726728759) - **charge** `1..n` – [chargeType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726368562) - **description** `1..1` – `xsd:string` - **monetaryAmount** `1..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **tax** `0..1` – [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) - **monetaryAmount** `0..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **@type** `required` - **@rate** `optional` - **@origrate** `optional` - **@origcode** `optional` - **@type** `optional` - **@origcode** `required` - **discounts** `0..1` – [discountsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483685) - **discount** `1..n` – [discountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827210) - **description** `1..1` – `xsd:string` - **monetaryAmount** `0..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **discountPercentage** `0..1` – `xsd:string` - **tax** `0..1` – [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) - **monetaryAmount** `0..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **@type** `required` - **@rate** `optional` - **@origrate** `optional` - **@origcode** `optional` - **@type** `optional` - **@origcode** `required` - **paymentTerms** `0..1` – [paymentTermsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726597791) - **paymentTerm** `1..n` – [paymentTermType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827179) - **paymentCondition** `1..1` – [paymentTermConditionType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726630487) - **@period** `optional` - **@amountTypeCode** `optional` - **@origcode** `required` - **conditionDescription** `0..1` – `xsd:string` - **values** `1..1` – [valuesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726761539) - **value** `1..n` – [valueType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726990959) - **@type** `required` - **orderHistory** `0..1` – [orderHistoryType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726040670) - **date** `1..n` – [dateType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726597764) - **@type** `required` - **address** `0..1` – [addressType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726270025) - *structure shown earlier in this tree* - **lineText** `0..1` – [FreeFormTextType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726564939) - **FreeFormText** `1..1` – [fftType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726237277) - **@lang** `optional` - **remarks** `0..1` – [RemarksType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859883) - **remark** `1..n` – [RemarkType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726335502) - **@lang** `optional` - **@context** `optional` - **paymentDueDate** `1..1` – [paymentDueDateType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727089159) - **@origcode** `required` - **@type** `required` - **paymentTerms** `0..1` – [paymentTermsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726597791) - **paymentTerm** `1..n` – [paymentTermType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827179) - *structure shown earlier in this tree* - **shipmentTermsCode** `0..1` – `xsd:string` - **returnMaterialsAuthorisationNumber** `0..1` – `xsd:string` - **taxSummary** `1..1` – [taxesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483654) - **tax** `1..n` – [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) - **monetaryAmount** `0..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **@type** `required` - **@rate** `optional` - **@origrate** `optional` - **@origcode** `optional` - **charges** `0..1` – [chargesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726728759) - **charge** `1..n` – [chargeType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726368562) - *structure shown earlier in this tree* - **discounts** `0..1` – [discountsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483685) - **discount** `1..n` – [discountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827210) - *structure shown earlier in this tree* - **levies** `0..1` – [leviesTotalType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483625) - **levy** `1..n` – [levyTotalType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725647413) - **monetaryAmount** `1..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **tax** `0..1` – [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) - **monetaryAmount** `0..1` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **@type** `required` - **@rate** `optional` - **@origrate** `optional` - **@origcode** `optional` - **@type** `optional` - **@origcode** `required` - **amountSummary** `1..1` – [amountSummaryType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726892731) - **monetaryAmount** `1..n` – [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) - **@amountTypeCode** `required` - **@currency** `required` - **@type** `optional` - **@invoiceTypeCode** `required` - **@amountTypeCode** `required` - **@currency** `required` - **@id** `required`
## Diagram ![invoices diagram](media://e3cff8bc-0692-46f8-a280-caea21b0bc83) ## Components | **Name** | **Kind** | **Elements** | **Used by** | | --- | --- | --- | --- | | [invoicesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727122059) | complex type | 1 | Root | | [invoiceType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106120) | complex type | 14 | invoicesType | | [RemarksType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859883) | complex type | 1 | invoiceLineType, invoiceType | | [RemarkType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726335502) | complex type | 0 | RemarksType | | [paymentDueDateType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727089159) | complex type | 0 | invoiceType | | [invoiceLinesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726630458) | complex type | 1 | invoiceType | | [invoiceLineType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725975206) | complex type | 22 | invoiceLinesType | | [amountsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827150) | complex type | 1 | invoiceLineType | | [orderHistoryType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726040670) | complex type | 1 | invoiceLineType | | [dateType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726597764) | complex type | 0 | orderHistoryType | | [paymentTermsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726597791) | complex type | 1 | invoiceLineType, invoiceType | | [paymentTermType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827179) | complex type | 3 | paymentTermsType | | [paymentTermConditionType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726630487) | complex type | 0 | paymentTermType | | [valuesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726761539) | complex type | 1 | paymentTermType | | [valueType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726990959) | complex type | 0 | valuesType | | [leviesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725614663) | complex type | 1 | invoiceLineType | | [levyType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859914) | complex type | 3 | leviesType | | [leviesTotalType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483625) | complex type | 1 | invoiceType | | [levyTotalType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725647413) | complex type | 2 | leviesTotalType | | [productIdentifiersType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727318577) | complex type | 1 | invoiceLineType | | [productIdentifierType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725942385) | complex type | 0 | productIdentifiersType | | [serialNumbersType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727547914) | complex type | 1 | invoiceLineType | | [addressesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725450867) | complex type | 1 | invoiceType | | [orderIdentificationsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106171) | complex type | 1 | invoiceLineType | | [orderIdentificationType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725581926) | complex type | 0 | orderIdentificationsType | | [FreeFormTextType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726564939) | complex type | 1 | invoiceLineType, invoiceType | | [fftType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726237277) | complex type | 0 | FreeFormTextType | | [taxesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483654) | complex type | 1 | invoiceLineType, invoiceType | | [chargesType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726728759) | complex type | 1 | invoiceLineType, invoiceType | | [chargeType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726368562) | complex type | 3 | chargesType | | [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) | complex type | 1 | chargeType, discountType, levyTotalType, levyType, taxesType | | [trackingType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859945) | complex type | 1 | invoiceLineType | | [trackingcodeType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726204604) | complex type | 0 | trackingType | | [amountSummaryType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726892731) | complex type | 1 | invoiceType | | [lineNumbersType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726892760) | complex type | 1 | invoiceLineType | | [lineNumberType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859974) | complex type | 0 | lineNumbersType | | [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) | complex type | 0 | amountSummaryType, amountsType, chargeType, discountType, levyTotalType, levyType, taxType | | [addressType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726270025) | complex type | 16 | addressesType, invoiceLineType | | [discountsType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725483685) | complex type | 1 | invoiceLineType, invoiceType | | [discountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726827210) | complex type | 4 | discountsType | ## Code lists ### lineNumberTypeType `xsd:string` 8 code values - `Invoice` - `DesAdv` - `Buyer` - `Purchase` - `Seller` - `Claim` - `Deal` - `Project` Used by: [lineNumberType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726859974) / **@type** ### monetaryAmountTypeType `xsd:string` 15 code values - `Unit` - `Line` - `LineTotal` - `Taxes` - `Levies` - `Charges` - `Discounts` - `NetTotal` - `EndTotal` - `TotalItems` - `TotalTaxes` - `TotalCharges` - `TotalDiscounts` - `TotalLevies` - `TotalChargesDiscountsLevies` Used by: [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) / **@type** ### invoiceTypeCodeType `xsd:string` 3 code values - `Invoice` - `Credit` - `Debit` Used by: [invoiceType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106120) / **@invoiceTypeCode** ### currencyType `xsd:string`, length 3 Used by: [invoiceType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106120) / **@currency**, [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) / **@currency** ### amountTypeCodeType `xsd:string` 2 code values - `Debit` - `Credit` Used by: [invoiceType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106120) / **@amountTypeCode**, [paymentTermConditionType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726630487) / **@amountTypeCode**, [monetaryAmountType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726794344) / **@amountTypeCode** ### paymentTermsValueType `xsd:string` 2 code values - `Percentage` - `Amount` Used by: [valueType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726990959) / **@type** ### taxTypeType `xsd:string` 3 code values - `NationalTax` - `RegionalTax` - `VATReverseCharge` Used by: [taxType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726138937) / **@type** ### productIdentifierTypeType `xsd:string` 5 code values - `Seller` - `Buyer` - `Manufacturer` - `EAN` - `GTIN` Used by: [productIdentifierType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725942385) / **@type** ### addressTypeType `xsd:string` 8 code values - `TradingPartnerFrom` - `TradingPartnerTo` - `Buyer` - `Seller` - `BillFrom` - `BillTo` - `ShipFrom` - `ShipTo` Used by: [addressType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726270025) / **@type** ### GlobalProductUnitOfMeasureCodeType `xsd:string` 14 code values - `EACH` - `CMT` - `DAY` - `GRM` - `HUR` - `KGM` - `LTR` - `MIN` - `MLT` - `MMT` - `MTK` - `MTQ` - `MTR` - `TNE` Used by: [invoiceLineType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725975206) / **unitOfMeasurement** ### DateTypeType `xsd:string` 3 code values - `Invoice` - `Order` - `DespatchAdvice` Used by: [dateType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726597764) / **@type** ### orderIdentificationTypeType `xsd:string` 10 code values - `Invoice` - `DesAdv` - `Buyer` - `Purchase` - `Seller` - `Claim` - `Deal` - `Quotation` - `Project` - `EndUser` Used by: [orderIdentificationType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/725581926) / **@type** ### DateTimeFormatType `xsd:string`, pattern `[0-9]{8}T[0-9]{6}` Used by: [invoiceType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726106120) / **invoiceDate**, [dateType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/726597764) / **(type extends it)** ### EanStringType For future use. `xsd:string`, length 13 ### paymentDueDateTypeType `xsd:string` 2 code values - `Calculated` - `Provided` Used by: [paymentDueDateType](https://onetrail.atlassian.net/wiki/spaces/docs/pages/727089159) / **@type** ## Type pages > Macro (children)