---
title: "Get a new ReceivedDocument"
method: GET
path: "/received_documents/{guid}/{format}"
tags: ["ReceivedDocuments"]
---

# Get a new ReceivedDocument

`GET /received_documents/{guid}/{format}`

Get a new ReceivedDocument that you have been notified for via received_document webhook.

## Path parameters

- `guid` string, uuid, required
- `format` 'json' | 'original', required

## Query parameters

- `version` string

## Response `200`

Success

- Transportable — A transportable document. Currently only used for receiving.
  - `legalEntityId` integer — The id of the LegalEntity this document should be sent on behalf of or was received for.
  - `direction` 'in' | 'out' — The direction of the document.
  - `guid` string — The GUID of the document that was received
  - `original` string — The document as originally received. Process this as a blob. Only present if requested.
  - `document` ReceivableDocument — The received document.
    - `documentType` 'invoice' | 'order', required — The type of document received.
    - `source` 'self' | 'peppol' | 'dbnalliance' | 'ro-anaf' | 'finvoice' | 'it-sdi', required — The source of the document.
    - `invoice` Invoice — unresolved $ref
    - `order` DocumentOrder — The order to send.
      - `taxSystem` 'tax_line_percentages' — The tax system used for the invoice. The system 'tax_line_percentages' is the only one currently supported.
      - `documentNumber` string, required — The number you assigned to the document.
      - `references` Reference[] — An array of references to other documents. Note that many syntaxes do not support multiple references of the same type in which case they will be concatenated with ','. Also, not all syntaxes and doucments support all documentTypes.
        - `documentType` 'purchase_order' | 'replaced_order' | 'buyer_reference' | 'billing' | 'billing_uuid' | 'advance_invoice' | 'sales_order' | 'contract' | 'despatch_advice' | 'originator' | 'receipt' | 'project' | 'quotation' | 'payment_url' | 'additional' | 'certified_exporter_authorization' | 'free_trade_agreement' | 'my_customs_form_1_9' | 'my_customs_form_2' | 'item_classification_code' | 'item_commodity_code' | 'item_specification' | 'line_document_reference' | 'line_standard_item_identification' | 'line_sellers_item_identification' | 'line_buyers_item_identification' | 'line_purchase_order' | 'line_billing' | 'line_despatch_document' | 'line_receipt_document', required — The type of the referenced document. The following types are supported: ++++ <ul> <li> <b>purchase_order</b> (document level, Invoice) <p>A reference to an order for this document, assigned by the buyer. Note that this often is a key field, since many receivers of invoices will use this field to automatically match the invoice to an order they placed. Many receivers refuse invoices that cannot be automatically matched, in particular government agencies. So it is highly recommended to fill this field whenever possible.</p> </li> <li> <b>billing</b> (document level, Invoice) <p>A reference to a billing document. For instance, credit notes may refer to an invoice they are a credit note for.</p> </li> <li> <b>billing_uuid</b> (document level, Invoice) <p>DEPRECATED. Use the billingUuid property of the 'billing' reference. A UUID reference to a billing document. For instance, credit notes may refer to an invoice they are a credit note for.</p> </li> <li> <b>advance_invoice</b> (document level, Invoice) <p>A reference to an advance invoice that a settlement invoice settles. Used for Polish KSeF settlement invoices (faktura rozliczeniowa, ROZ), with one entry per advance invoice (FakturaZaliczkowa). When sending, provide documentId set to the advance invoice's KSeF number when available or otherwise the seller invoice number. When receiving, one entry is emitted per FakturaZaliczkowa, with documentId set to the KSeF number when available (also kept in documentUuid) or otherwise the seller invoice number.</p> </li> <li> <b>sales_order</b> (document level, Invoice + Order) <p>A reference to an order for this document, assigned by the seller.</p> </li> <li> <b>buyer_reference</b> (document level, Invoice, Order) <p>The buyer's reference. Used for internal routing by the receiver. For orders, this becomes the customer reference which the receiver of the order should put back in the buyer reference field in the invoice.</p> </li> <li> <b>additional</b> (document level, Invoice, Order) <p>An additional reference. For UBL, this translates into an AdditionalDocumentReference without a EmbeddedDocumentBinaryObject. For the latter, use the attachments array.</p> </li> <li> <b>contract</b> (document level, Invoice + Order) <p>A reference to a contract or framework agreement that this document relates to.</p> </li> <li> <b>despatch_advice</b> (document level, Invoice) <p>A reference to a despatch advice for this document. In the FatturaPA, this is what will become the DDT.</p> </li> <li> <b>originator</b> (document level, Invoice + Order) <p>A reference to an originator document for this invoice.</p> </li> <li> <b>receipt</b> (document level, Invoice) <p>A reference to a receipt document for this document.</p> </li> <li> <b>project</b> (document level, Invoice) <p>A reference to a project document for this document.</p> </li> <li> <b>quotation</b> (document level, Order) <p>A reference to a quotation document for this document.</p> </li> <li> <b>replaced_order</b> (document level, Order) <p>A reference to the initial order that was rejected and a new order is issued. </p> </li> <li> <b>payment_url</b> (document level, Invoice) <p>A to a payment URL for the invoice.</p> </li> <li> <b>item_classification_code</b> (line level) <p>A reference to a commodity classification / item classification code for this line. Note that in combination with the documentIdListId these can be used for Malaysia LHDNM to provide the product classification code (documentIdListId=CLASS) and the product tariff code (documentIdListId=PTC)</p> </li> <li> <b>item_commodity_code</b> (line level) <p>A reference to a commodity classification / commodity code for this line.</p> </li> <li> <b>item_specification</b> (line level) <p>A referece to an item specification document</p> </li> <li> <b>line_document_reference</b> (line level) <p>A reference to another document for this line.</p> </li> <li> <b>line_standard_item_identification</b> (line level) <p>A standard item identification.</p> </li> <li> <b>line_sellers_item_identification</b> (line level) <p>The seller's item identification.</p> </li> <li> <b>line_buyers_item_identification</b> (line level) <p>The buyer's item identification.</p> </li> <li> <b>line_purchase_order</b> (line level) <p>A reference to an order for this line, assigned by the buyer. Note not all outgoing document formats support this, so they may end up concatenated at the invoice level.</p> </li> <li> <b>line_billing</b> (line level) <p>A reference to a previous invoice that this invoice line corrects (FR-FE EXT-FR-FE-136/137/138/139). Use documentId for the previous invoice number, documentTypeCode for the type code, issueDate for the previous invoice issue date and lineId for the line in the previous invoice.</p> </li> <li> <b>line_despatch_document</b> (line level) <p>A reference to a despatch document (BL) for this invoice line (FR-FE). Use documentId for the despatch document identifier and lineId for the line in the despatch document. In UBL the documentId is taken from Invoice/InvoiceLine/DespatchLineReference/DocumentReference/ID with Invoice/DespatchDocumentReference/ID as fallback. In CII the documentId is taken from IncludedSupplyChainTradeLineItem/SpecifiedLineTradeDelivery/DespatchAdviceReferencedDocument/IssuerAssignedID with ApplicableHeaderTradeDelivery/DespatchAdviceReferencedDocument/IssuerAssignedID as fallback.</p> </li> <li> <b>line_receipt_document</b> (line level) <p>A reference to a receipt document (BR) for this invoice line (FR-FE). Use documentId for the receipt document identifier and lineId for the line in the receipt document. In UBL the documentId is taken from Invoice/InvoiceLine/ReceiptLineReference/DocumentReference/ID with Invoice/ReceiptDocumentReference/ID as fallback. In CII the documentId is taken from IncludedSupplyChainTradeLineItem/SpecifiedLineTradeDelivery/ReceivingAdviceReferencedDocument/IssuerAssignedID with ApplicableHeaderTradeDelivery/ReceivingAdviceReferencedDocument/IssuerAssignedID as fallback.</p> </li></ul> ++++
        - `documentTypeCode` string — The code of the referenced document type. Used for documentType = 'line_document_reference', and for the FR-FE extensions documentType = 'contract' (EXT-FR-FE-01, allowed values for FR-DGFiP: 'CONTRAT', 'MARCHE') and documentType = 'line_billing' (EXT-FR-FE-137). UNCL1001 codes may be sent either prefixed ('uncl1001_<code>') or as bare digits.
        - `documentId` string — The id of the referenced document.
        - `documentUuid` string — The UUID of the referenced document.
        - `documentIdSchemeId` string — The scheme id of the id of the referenced document.
        - `documentIdSchemeAgencyId` string — The the agency id of the scheme id of the id of the referenced document.
        - `documentIdSchemeVersionId` string — The version id of the scheme id of the id of the referenced document.
        - `documentIdListId` string — The list id of the id of the referenced document.
        - `documentIdListAgencyId` string — The agency id of the list id of the id of the referenced document.
        - `documentIdListVersionId` string — The version id of the list id of the id of the referenced document.
        - `lineId` string — The line in the referenced document.
        - `issueDate` string — The issue date of the referenced document.
        - `documentDescription` string — A description for the referenced document.
      - `issueDate` string, required — Format: yyyy-mm-dd.
      - `issueTime` string — Format: hh:mm:ss
      - `timeZone` string — Format: ±zzzz, where ±zzzz is the difference from UTC, e.g. +0100 or -0900 etc. The timezone will also apply to the document issue date if this field is provided.
      - `orderType` 'regular' | 'consignment' — The type of this order.
      - `note` string — A note to add to the document
      - `documentCurrencyCode` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BOV' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CHW' | 'CLF' | 'CLP' | 'CNH' | 'CNY' | 'COP' | 'COU' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MXV' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SLL' | 'SOS' | 'SRD' | 'SSP' | 'STN' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'USN' | 'UYI' | 'UYU' | 'UZS' | 'VED' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XAG' | 'XAU' | 'XBA' | 'XBB' | 'XBC' | 'XBD' | 'XCD' | 'XDR' | 'XFU' | 'XOF' | 'XPD' | 'XPF' | 'XPT' | 'XSU' | 'XTS' | 'XUA' | 'XXX' | 'YER' | 'ZAR' | 'ZMW' — The ISO 4217 currency code.
      - `accountingCost` string — The buyer's accounting cost centre for this document.
      - `validityPeriod` string — The period (or specific date) to which the invoice applies. Format: yyyy-mm-dd - yyyy-mm-dd.
      - `buyerCustomerParty` BuyerCustomerPartyOrder — The buyer sending the order.
        - `party` SenderParty, required — A party that can send documents
          - `contact` Contact — Contact details for the invoice
            - `firstName` string
            - `lastName` string
            - `email` string, email
            - `phone` string
            - `id` string — Only supported for AccountingCustomerParty.
      - `sellerSupplierParty` SellerSupplierParty, required — The party sending the order.
        - `party` SenderParty, required — A party that can send documents
          - `contact` Contact — Contact details for the invoice
            - `firstName` string
            - `lastName` string
            - `email` string, email
            - `phone` string
            - `id` string — Only supported for AccountingCustomerParty.
        - `publicIdentifiers` PublicIdentifier[], required — A list of legal and tax identifiers for this customer.
          - `scheme` string, required — The scheme of the identifier. See <<_receiver_identifiers_list>> for a list.
          - `id` string, required — The actual identifier.
      - `delivery` Delivery
        - `deliveryLocation` object
          - `id` string — The location identifier.
          - `schemeId` string — The schemeId of the location identifier (e.g. 'EAN')
          - `schemeAgencyId` string — DEPRECATED. The schemeAgencyId of the location identifier (e.g. 'ZZZ')
          - `locationName` string — The name of the delivery location. Only used for DocumentOrder.
          - `address` Address — The address
            - `street1` string — The street name and number. Mandatory in most countries.
            - `street2` string — The second street field. Use this if you used the first field for the building name.
            - `city` string — The name of the city. Mandatory in most countries.
            - `zip` string — The zipcode/postalzone. Mandatory unless the country does not have zip codes.
            - `county` string — An optional county name.
            - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'XK' | 'XI', required — An ISO 3166-1 alpha-2 country code.
        - `requestedDeliveryPeriod` string — The requested delivery period. Used only for DocumentOrder. Will also be used for DocumentOrder order lines, if that order line does not specify its own delivery period.
        - `actualDeliveryDate` string — The actual date of the delivery. Used only for Invoice
        - `quantity` number — The quantity of the delivery. Used only for Invoice
        - `deliveryPartyName` string — DEPRECATED. Use deliveryParty. The name of the party that took delivery. Used only for Invoice
        - `deliveryParty` DeliveryParty — The party receiving the shipment.
          - `party` ReceiverParty, required — A party that can receive or send invoices
            - `companyName` string — The name of the company transporting the invoice
            - `registrationName` string — The registration name of the company transporting the invoice
            - `additionalLegalInformation` string — Additional legal information relevant for the Seller.
            - `classificationCode` string — The classification code of the company transporting the invoice. This currently is used only for the Malaysia LHDNM application in selfBillingMode. In that case, it becomes the MSIC of the sender of the purchase invoice.
            - `registrationAuthorityName` string — The name of the authority that issued the legal registration identifier (BTAE-11). Only used when the sender country is AE (PINT-AE), where it is mandatory when the party's legal registration identifier is a commercial/trade license (publicIdentifier scheme AE:TL). Maps to the schemeAgencyName attribute of UBL PartyLegalEntity/CompanyID. See <<country_ae>>.
            - `passportIssuingCountry` string — The country that issued the passport used as the party's legal registration identifier (BTAE-19). Only used when the sender country is AE (PINT-AE), where it is mandatory when the party's legal registration identifier is a passport (publicIdentifier scheme AE:PAS). Format: ISO 3166-1 alpha-2 country code or the Peppol extension 1A; membership is enforced in Rails validation via CodeLists::Iso3166Alpha2. Maps to the schemeAgencyName attribute of UBL PartyLegalEntity/CompanyID. See <<country_ae>>.
            - `address` Address — The address
              - …
            - `contact` Contact — Contact details for the invoice
              - …
          - `publicIdentifiers` PublicIdentifier[] — A list of legal and tax identifiers for this delivery party.
            - `scheme` string, required — The scheme of the identifier. See <<_receiver_identifiers_list>> for a list.
            - `id` string, required — The actual identifier.
        - `shipment` Shipment
          - `shippingMarks` string — A text that the buyer requests to be printed on the packing labels. Used only for DocumentOrder.
          - `originAddress` Address — The address
            - `street1` string — The street name and number. Mandatory in most countries.
            - `street2` string — The second street field. Use this if you used the first field for the building name.
            - `city` string — The name of the city. Mandatory in most countries.
            - `zip` string — The zipcode/postalzone. Mandatory unless the country does not have zip codes.
            - `county` string — An optional county name.
            - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'XK' | 'XI', required — An ISO 3166-1 alpha-2 country code.
          - `allowanceCharges` AllowanceCharge[] — A list of charges
            - `amountExcludingVat` number — DEPRECATED. Use amountExcludingTax. The amount for the allowance or charge, excluding VAT.
            - `amountExcludingTax` number — The amount for the allowance or charge, excluding tax.
            - `baseAmountExcludingTax` number — The base amount for the allowance or charge, excluding tax.
            - `amountIncludingTax` number — The amount for the allowance or charge, including tax.
            - `baseAmountIncludingTax` number — The base amount for the allowance or charge, including tax.
            - `tax` Tax
              - …
            - `taxesDutiesFees` Tax[] — An array of taxes, duties and fees for this invoice line. At this moment, multiple Tax items is allowed only for IN (India) and US (USA) taxes. All other countries can only have a single Tax item in this array.
              - …
            - `reason` string — The reason for the allowance or charge, free text. Defaults to 'Mutually Agreed' if neither reason nor reasonCode are provided.
            - `reasonCode` string — The reason code for the allowance or charge
            - `taxExemptionReason` string — Free-text reason explaining why the tax on this allowance or charge is exempt or zero-rated. Used for the French e-invoicing reform (FR-FE EXT-FR-FE-187/189). Maps to UBL AllowanceCharge/TaxCategory/TaxExemptionReason and CII SpecifiedTradeAllowanceCharge/CategoryTradeTax/ExemptionReason.
            - `taxExemptionReasonCode` string — Coded reason (VATEX code) explaining why the tax on this allowance or charge is exempt or zero-rated. Used for the French e-invoicing reform (FR-FE EXT-FR-FE-188/190). Maps to UBL AllowanceCharge/TaxCategory/TaxExemptionReasonCode and CII SpecifiedTradeAllowanceCharge/CategoryTradeTax/ExemptionReasonCode.
        - `shippingMarks` string — DEPRECATED. Use the shipment object. A text that the buyer requests to be printed on the packing labels. Used only for DocumentOrder.
      - `deliveryTerms` DeliveryTerms
        - `incoterms` 'EXW' | 'FCA' | 'CPT' | 'CIP' | 'DAP' | 'DPU' | 'DDP' | 'FAS' | 'FOB' | 'CFR' | 'CIF' — The incoterms: ++++ <ul> <li> <strong>EXW – Ex Works</strong><br/> The seller must give the buyer access to goods at an agreed location. From that moment, the buyer bears almost all costs and risks during the entire shipping process.<br/> </li> <li> <strong>FCA – Free Carrier</strong><br/> The seller must make the goods available at his own risk and expense at his own premises or at an agreed place. In both cases, the seller is responsible for the clearance of the goods for export. It can be agreed that the buyer must instruct the carrier to transfer a “Bill of Lading (BL)” with a note on board to the seller. </li> <li> <strong>CPT – Carriage Paid To</strong><br/> The seller has the same responsibilities as with FCA, but in this case also pays the delivery costs. </li> <li> <strong>CIP – Carriage Insurance Paid To</strong><br/> The same seller responsibilities as with CPT, only in this case the seller is obliged to pay the insurance with a high coverage ratio. Parties can agree separately to apply limited coverage. </li> <li> <strong>DAP – Delivered At Place</strong><br/> The seller bears the costs and risks during the transport of the goods to an agreed address. As soon as the goods have arrived at this address and are ready for unloading, the risk passes to the buyer. </li> <li> <strong>DPU – Delivered at Place Unloaded</strong><br/> The seller is responsible for the costs and risks of delivering goods to an agreed destination where goods can be unloaded for further transport. The selling party arranges customs and unloads the goods at the agreed place. The buyer arranges the customs clearance and any associated rights. </li> <li> <strong>DDP – Delivered Duty Paid</strong><br/> The seller bears the costs and risks of transport, carries out the export and import responsibilities and pays any import duties. As soon as the goods have arrived at the address and are ready for unloading, the risk passes to the buyer. </li> <li> <strong>FAS – Free Alongside Ship</strong><br/> The seller bears all costs and risks until the goods are delivered next to the ship. From that point, the risk is for the buyer and he also arranges the export clearance and import clearance. </li> <li> <strong>FOB – Free On Board</strong><br/> The seller bears all costs and risks until the goods are on board the ship and also arranges the export clearance. As soon as the goods have been delivered to the ship, the buyer bears all responsibilities. </li> <li> <strong>CFR – Cost And Freight</strong><br/> The same applies to the seller and buyer as with FOB, but in this case, the seller must also pay for the transport of the goods to the port. </li> <li> <strong>CIF – Cost, Insurance, and Freight</strong><br/> The seller has the same obligations as with CFR but also pays the (minimum) insurance costs. The buyer must pay for more comprehensive insurance. </li></ul> ++++
        - `specialTerms` string — A description of special conditions relating to the delivery terms.
        - `deliveryLocationId` string — The location to which the delivery terms refer.
      - `paymentTerms` PaymentTerms — The payment terms of the document. Note that not all syntaxes support payment terms, so in some syntaxes they will converted into a payment terms note and it is even possible that they have to be omitted completely, for instance in many eReporting syntaxes (where they don't play a role anyway). ++++ <br/> ++++ Provide either the note or the terms, but not both.
        - `note` string — The note for the payment terms.
        - `terms` PaymentTerm[] — The terms for the payment terms.
          - `settlementDays` integer, required — The number of days within which the invoice must be settled for the term to apply.
          - `discountPercentage` number — The discount percentage that applies if the invoice is settled within the required number of days. Provide only one of discountPercentage or surchargePercentage.
          - `surchargePercentage` number — The surcharge percentage that applies if the invoice is settled after the required number of days. Provide only one of discountPercentage or surchargePercentage.
          - `baseAmount` number — The base amount on which the discount percentage is applied.
          - `note` string — The note for this payment term.
      - `allowanceCharges` AllowanceCharge[] — An array of allowance charges.
        - `amountExcludingVat` number — DEPRECATED. Use amountExcludingTax. The amount for the allowance or charge, excluding VAT.
        - `amountExcludingTax` number — The amount for the allowance or charge, excluding tax.
        - `baseAmountExcludingTax` number — The base amount for the allowance or charge, excluding tax.
        - `amountIncludingTax` number — The amount for the allowance or charge, including tax.
        - `baseAmountIncludingTax` number — The base amount for the allowance or charge, including tax.
        - `tax` Tax
          - `amount` number — The amount of tax. Mandatory if taxSystem == 'tax_line_amounts'. However, it is best to use taxSystem tax_line_percentages and provide only the percentage, not the actual amount. The amount is then provided at the invoice level, in the taxSubtotals element.
          - `percentage` number — The percentage Tax. This should be a valid Tax percentage in the country at the time of the issueDate of this invoice. Mandatory if taxSystem == 'tax_line_percentages'
          - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'XK' | 'XI', required — An ISO 3166-1 alpha-2 country code.
          - `acknowledgeThirdCountryTax` boolean — When specifying a tax country other than that of the sender or the receiver, this flag must be set. This is to prevent accidental errors.
          - `category` 'standard' | 'zero_rated' | 'reverse_charge' | 'intra_community' | 'exempt' | 'export' | 'outside_scope' | 'regulation33_exempt' | 'nonregulation33_exempt' | 'deemed_supply' | 'srca_s' | 'srca_c' | 'not_registered' | 'igst' | 'cgst' | 'sgst' | 'cess' | 'state_cess' | 'srovr' | 'srovr_rs' | 'srovr_lvg' | 'srlvg' | 'bollo_virtuale' | 'exempt_it_n1' | 'sales' | 'service' | 'tourism' | 'high_value_goods' | 'low_value_goods' | 'sales_zero' | 'service_zero' | 'not_applicable' | 'standard_ca' | 'standard_na' | 'standard_re' | 'standard_n33' | 'standard_33' | 'import_service' | 'import_33_service' | 'import_n33_service' | 'import_reverse_charge_service' | 'import_goods' | 'import_33_goods' | 'import_n33_goods' | 'import_reverse_charge_goods' | 'import_mes' | 'import_gst_ds' | 'blocked' | 'exempt_purchase' | 'standard_additional' | 'ieps' | 'wht' — The allowed values depend on the country of the tax: ++++ <ul> <li> AE: <ul> <li>standard (5%)</li> <li>standard_additional(5%)</li> <li>reverse_charge (0%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> AU: <ul> <li>standard (10%, 5.5%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> EU: <ul> <li>standard (percentages country dependent)</li> <li>zero_rated (0%)</li> <li>reverse_charge (0%)</li> <li>intra_community (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> EU/IT: <ul> <li>standard</li> <li>zero_rated (0%)</li> <li>reverse_charge (0%)</li> <li>intra_community (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>bollo_virtuale (only at the invoice level and with mandatory amount: €2.00)</li> </ul> </li> <li> IN: <ul> <li>igst (28%, 18%, 12%, 5%, 3%, 0.25%)</li> <li>sgst (14%, 9%, 6%, 2.5%, 1.5%)</li> <li>cgst (14%, 9%, 6%, 2.5%, 1.5%)</li> <li>cess (any percentage)</li> <li>state_cess (any percentage)</li> <li>reverse_charge (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>zero_rated (0%)</li> </ul> </li> <li> JP: <ul> <li>standard (10%, 8%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> MX: <ul> <li>standard (16%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>ieps</li> <li>wht</li> </ul> </li> <li> MY: <ul> <li>sales (5%, 10%) ⮕ LHDNM '01', Peppol 'T' <li>sales_zero (0%) ⮕ LHDNM '01', Peppol 'E' <li>service (6%, 8%) ⮕ LHDNM '02', Peppol 'T' <li>service_zero (0%) ⮕ LHDNM '02', Peppol 'E' <li>tourism (any amount) ⮕ LHDNM '03', Peppol 'T' <li>high_value_goods (any percentage) ⮕ LHDNM '04', Peppol 'T' <li>low_value_goods (10%) ⮕ LHDNM '05', Peppol 'T' <li>zero_rated (0%) ⮕ LHDNM '06', Peppol 'E' <li>exempt (0%) ⮕ LHDNM 'E', Peppol 'E' <li>export (0%) ⮕ LHDNM 'E', Peppol 'E' <li>outside_scope (0%) ⮕ LHDNM '06', Peppol 'O' </ul> </li> <li> NZ: <ul> <li>standard (15%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> SG: <table> <tr> <th>category</th> <th>percentage</th> <th>sales invoice</th> <th>purchase invoice</th> </tr> <tr> <td>standard</td> <td>9%</td> <td>SR</td> <td>TX</td> </tr> <tr> <td>outside_scope</td> <td>0%</td> <td>OS</td> <td>OP</td> </tr> <tr> <td>zero_rated</td> <td>0%</td> <td>ZR</td> <td>ZP</td> </tr> <tr> <td>not_registered</td> <td>0%</td> <td>NG</td> <td>NR</td> </tr> <tr> <td>deemed_supply</td> <td>9%</td> <td>DS</td> <td></td> </tr> <tr> <td>srca_c</td> <td>9%</td> <td>SRCA-C</td> <td></td> </tr> <tr> <td>srovr_rs</td> <td>9%</td> <td>SROVR-RS</td> <td></td> </tr> <tr> <td>srovr_lvg</td> <td>9%</td> <td>SROVR-LVG</td> <td></td> </tr> <tr> <td>srlvg</td> <td>9%</td> <td>SRLVG</td> <td></td> </tr> <tr> <td>srca_s</td> <td>0%</td> <td>SRCA-S</td> <td></td> </tr> <tr> <td>regulation33_exempt</td> <td>0%</td> <td>ES33</td> <td></td> </tr> <tr> <td>nonregulation33_exempt</td> <td>0%</td> <td>ESN33</td> <td></td> </tr> <tr> <td>export</td> <td>0%</td> <td>ZR</td> <td></td> </tr> <tr> <td>not_applicable</td> <td>0%</td> <td>NA</td> <td></td> </tr> <tr> <td>standard_ca (experimental)</td> <td>9%</td> <td></td> <td>TXCA</td> </tr> <tr> <td>standard_na (experimental)</td> <td>9%</td> <td></td> <td>TXNA</td> </tr> <tr> <td>standard_re (experimental)</td> <td>9%</td> <td></td> <td>TX-RE</td> </tr> <tr> <td>standard_n33 (experimental)</td> <td>9%</td> <td></td> <td>TX-N33</td> </tr> <tr> <td>standard_33 (experimental)</td> <td>9%</td> <td></td> <td>TX-ESS</td> </tr> <tr> <td>import_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-TS</td> </tr> <tr> <td>import_33_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-ESS</td> </tr> <tr> <td>import_n33_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-N33</td> </tr> <tr> <td>import_reverse_charge_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-RE</td> </tr> <tr> <td>import_goods (experimental)</td> <td>9%</td> <td></td> <td>IM</td> </tr> <tr> <td>import_33_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-ESS</td> </tr> <tr> <td>import_n33_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-N33</td> </tr> <tr> <td>import_reverse_charge_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-RE</td> </tr> <tr> <td>import_mes (experimental)</td> <td>9%</td> <td></td> <td>ME</td> </tr> <tr> <td>import_gst_ds (experimental)</td> <td>9%</td> <td></td> <td>IGDS</td> </tr> <tr> <td>blocked (experimental)</td> <td>9%</td> <td></td> <td>BL</td> </tr> <tr> <td>exempt_purchase (experimental)</td> <td>0%</td> <td></td> <td>EP</td> </tr> </table> </li> <li> US: <ul> <li>standard (any percentage)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li></ul> ++++
          - `type` 'VAT' | 'GST' — The type of tax. This field is only used for receiving. For sending, the type is automatically determined from the country code and should not be supplied.
        - `taxesDutiesFees` Tax[] — An array of taxes, duties and fees for this invoice line. At this moment, multiple Tax items is allowed only for IN (India) and US (USA) taxes. All other countries can only have a single Tax item in this array.
          - `amount` number — The amount of tax. Mandatory if taxSystem == 'tax_line_amounts'. However, it is best to use taxSystem tax_line_percentages and provide only the percentage, not the actual amount. The amount is then provided at the invoice level, in the taxSubtotals element.
          - `percentage` number — The percentage Tax. This should be a valid Tax percentage in the country at the time of the issueDate of this invoice. Mandatory if taxSystem == 'tax_line_percentages'
          - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'XK' | 'XI', required — An ISO 3166-1 alpha-2 country code.
          - `acknowledgeThirdCountryTax` boolean — When specifying a tax country other than that of the sender or the receiver, this flag must be set. This is to prevent accidental errors.
          - `category` 'standard' | 'zero_rated' | 'reverse_charge' | 'intra_community' | 'exempt' | 'export' | 'outside_scope' | 'regulation33_exempt' | 'nonregulation33_exempt' | 'deemed_supply' | 'srca_s' | 'srca_c' | 'not_registered' | 'igst' | 'cgst' | 'sgst' | 'cess' | 'state_cess' | 'srovr' | 'srovr_rs' | 'srovr_lvg' | 'srlvg' | 'bollo_virtuale' | 'exempt_it_n1' | 'sales' | 'service' | 'tourism' | 'high_value_goods' | 'low_value_goods' | 'sales_zero' | 'service_zero' | 'not_applicable' | 'standard_ca' | 'standard_na' | 'standard_re' | 'standard_n33' | 'standard_33' | 'import_service' | 'import_33_service' | 'import_n33_service' | 'import_reverse_charge_service' | 'import_goods' | 'import_33_goods' | 'import_n33_goods' | 'import_reverse_charge_goods' | 'import_mes' | 'import_gst_ds' | 'blocked' | 'exempt_purchase' | 'standard_additional' | 'ieps' | 'wht' — The allowed values depend on the country of the tax: ++++ <ul> <li> AE: <ul> <li>standard (5%)</li> <li>standard_additional(5%)</li> <li>reverse_charge (0%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> AU: <ul> <li>standard (10%, 5.5%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> EU: <ul> <li>standard (percentages country dependent)</li> <li>zero_rated (0%)</li> <li>reverse_charge (0%)</li> <li>intra_community (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> EU/IT: <ul> <li>standard</li> <li>zero_rated (0%)</li> <li>reverse_charge (0%)</li> <li>intra_community (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>bollo_virtuale (only at the invoice level and with mandatory amount: €2.00)</li> </ul> </li> <li> IN: <ul> <li>igst (28%, 18%, 12%, 5%, 3%, 0.25%)</li> <li>sgst (14%, 9%, 6%, 2.5%, 1.5%)</li> <li>cgst (14%, 9%, 6%, 2.5%, 1.5%)</li> <li>cess (any percentage)</li> <li>state_cess (any percentage)</li> <li>reverse_charge (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>zero_rated (0%)</li> </ul> </li> <li> JP: <ul> <li>standard (10%, 8%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> MX: <ul> <li>standard (16%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>ieps</li> <li>wht</li> </ul> </li> <li> MY: <ul> <li>sales (5%, 10%) ⮕ LHDNM '01', Peppol 'T' <li>sales_zero (0%) ⮕ LHDNM '01', Peppol 'E' <li>service (6%, 8%) ⮕ LHDNM '02', Peppol 'T' <li>service_zero (0%) ⮕ LHDNM '02', Peppol 'E' <li>tourism (any amount) ⮕ LHDNM '03', Peppol 'T' <li>high_value_goods (any percentage) ⮕ LHDNM '04', Peppol 'T' <li>low_value_goods (10%) ⮕ LHDNM '05', Peppol 'T' <li>zero_rated (0%) ⮕ LHDNM '06', Peppol 'E' <li>exempt (0%) ⮕ LHDNM 'E', Peppol 'E' <li>export (0%) ⮕ LHDNM 'E', Peppol 'E' <li>outside_scope (0%) ⮕ LHDNM '06', Peppol 'O' </ul> </li> <li> NZ: <ul> <li>standard (15%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> SG: <table> <tr> <th>category</th> <th>percentage</th> <th>sales invoice</th> <th>purchase invoice</th> </tr> <tr> <td>standard</td> <td>9%</td> <td>SR</td> <td>TX</td> </tr> <tr> <td>outside_scope</td> <td>0%</td> <td>OS</td> <td>OP</td> </tr> <tr> <td>zero_rated</td> <td>0%</td> <td>ZR</td> <td>ZP</td> </tr> <tr> <td>not_registered</td> <td>0%</td> <td>NG</td> <td>NR</td> </tr> <tr> <td>deemed_supply</td> <td>9%</td> <td>DS</td> <td></td> </tr> <tr> <td>srca_c</td> <td>9%</td> <td>SRCA-C</td> <td></td> </tr> <tr> <td>srovr_rs</td> <td>9%</td> <td>SROVR-RS</td> <td></td> </tr> <tr> <td>srovr_lvg</td> <td>9%</td> <td>SROVR-LVG</td> <td></td> </tr> <tr> <td>srlvg</td> <td>9%</td> <td>SRLVG</td> <td></td> </tr> <tr> <td>srca_s</td> <td>0%</td> <td>SRCA-S</td> <td></td> </tr> <tr> <td>regulation33_exempt</td> <td>0%</td> <td>ES33</td> <td></td> </tr> <tr> <td>nonregulation33_exempt</td> <td>0%</td> <td>ESN33</td> <td></td> </tr> <tr> <td>export</td> <td>0%</td> <td>ZR</td> <td></td> </tr> <tr> <td>not_applicable</td> <td>0%</td> <td>NA</td> <td></td> </tr> <tr> <td>standard_ca (experimental)</td> <td>9%</td> <td></td> <td>TXCA</td> </tr> <tr> <td>standard_na (experimental)</td> <td>9%</td> <td></td> <td>TXNA</td> </tr> <tr> <td>standard_re (experimental)</td> <td>9%</td> <td></td> <td>TX-RE</td> </tr> <tr> <td>standard_n33 (experimental)</td> <td>9%</td> <td></td> <td>TX-N33</td> </tr> <tr> <td>standard_33 (experimental)</td> <td>9%</td> <td></td> <td>TX-ESS</td> </tr> <tr> <td>import_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-TS</td> </tr> <tr> <td>import_33_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-ESS</td> </tr> <tr> <td>import_n33_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-N33</td> </tr> <tr> <td>import_reverse_charge_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-RE</td> </tr> <tr> <td>import_goods (experimental)</td> <td>9%</td> <td></td> <td>IM</td> </tr> <tr> <td>import_33_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-ESS</td> </tr> <tr> <td>import_n33_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-N33</td> </tr> <tr> <td>import_reverse_charge_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-RE</td> </tr> <tr> <td>import_mes (experimental)</td> <td>9%</td> <td></td> <td>ME</td> </tr> <tr> <td>import_gst_ds (experimental)</td> <td>9%</td> <td></td> <td>IGDS</td> </tr> <tr> <td>blocked (experimental)</td> <td>9%</td> <td></td> <td>BL</td> </tr> <tr> <td>exempt_purchase (experimental)</td> <td>0%</td> <td></td> <td>EP</td> </tr> </table> </li> <li> US: <ul> <li>standard (any percentage)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li></ul> ++++
          - `type` 'VAT' | 'GST' — The type of tax. This field is only used for receiving. For sending, the type is automatically determined from the country code and should not be supplied.
        - `reason` string — The reason for the allowance or charge, free text. Defaults to 'Mutually Agreed' if neither reason nor reasonCode are provided.
        - `reasonCode` string — The reason code for the allowance or charge
        - `taxExemptionReason` string — Free-text reason explaining why the tax on this allowance or charge is exempt or zero-rated. Used for the French e-invoicing reform (FR-FE EXT-FR-FE-187/189). Maps to UBL AllowanceCharge/TaxCategory/TaxExemptionReason and CII SpecifiedTradeAllowanceCharge/CategoryTradeTax/ExemptionReason.
        - `taxExemptionReasonCode` string — Coded reason (VATEX code) explaining why the tax on this allowance or charge is exempt or zero-rated. Used for the French e-invoicing reform (FR-FE EXT-FR-FE-188/190). Maps to UBL AllowanceCharge/TaxCategory/TaxExemptionReasonCode and CII SpecifiedTradeAllowanceCharge/CategoryTradeTax/ExemptionReasonCode.
      - `orderLines` OrderLine[], required — An array of order lines.
        - `lineId` string, required — The id for this invoice line.
        - `quantity` number, required — The number of items (may be fractional).
        - `quantityUnitCode` '10' | '11' | '13' | '14' | '15' | '20' | '21' | '22' | '23' | '24' | '25' | '27' | '28' | '33' | '34' | '35' | '37' | '38' | '40' | '41' | '56' | '57' | '58' | '59' | '60' | '61' | '74' | '77' | '80' | '81' | '85' | '87' | '89' | '91' | '1I' | '2A' | '2B' | '2C' | '2G' | '2H' | '2I' | '2J' | '2K' | '2L' | '2M' | '2N' | '2P' | '2Q' | '2R' | '2U' | '2X' | '2Y' | '2Z' | '3B' | '3C' | '4C' | '4G' | '4H' | '4K' | '4L' | '4M' | '4N' | '4O' | '4P' | '4Q' | '4R' | '4T' | '4U' | '4W' | '4X' | '5A' | '5B' | '5E' | '5J' | 'A10' | 'A11' | 'A12' | 'A13' | 'A14' | 'A15' | 'A16' | 'A17' | 'A18' | 'A19' | 'A2' | 'A20' | 'A21' | 'A22' | 'A23' | 'A24' | 'A26' | 'A27' | 'A28' | 'A29' | 'A3' | 'A30' | 'A31' | 'A32' | 'A33' | 'A34' | 'A35' | 'A36' | 'A37' | 'A38' | 'A39' | 'A4' | 'A40' | 'A41' | 'A42' | 'A43' | 'A44' | 'A45' | 'A47' | 'A48' | 'A49' | 'A5' | 'A53' | 'A54' | 'A55' | 'A56' | 'A59' | 'A6' | 'A68' | 'A69' | 'A7' | 'A70' | 'A71' | 'A73' | 'A74' | 'A75' | 'A76' | 'A8' | 'A84' | 'A85' | 'A86' | 'A87' | 'A88' | 'A89' | 'A9' | 'A90' | 'A91' | 'A93' | 'A94' | 'A95' | 'A96' | 'A97' | 'A98' | 'A99' | 'AA' | 'AB' | 'ACR' | 'ACT' | 'AD' | 'AE' | 'AH' | 'AI' | 'AK' | 'AL' | 'AMH' | 'AMP' | 'ANN' | 'APZ' | 'AQ' | 'AS' | 'ASM' | 'ASU' | 'ATM' | 'AWG' | 'AY' | 'AZ' | 'B1' | 'B10' | 'B11' | 'B12' | 'B13' | 'B14' | 'B15' | 'B16' | 'B17' | 'B18' | 'B19' | 'B20' | 'B21' | 'B22' | 'B23' | 'B24' | 'B25' | 'B26' | 'B27' | 'B28' | 'B29' | 'B3' | 'B30' | 'B31' | 'B32' | 'B33' | 'B34' | 'B35' | 'B4' | 'B41' | 'B42' | 'B43' | 'B44' | 'B45' | 'B46' | 'B47' | 'B48' | 'B49' | 'B50' | 'B52' | 'B53' | 'B54' | 'B55' | 'B56' | 'B57' | 'B58' | 'B59' | 'B60' | 'B61' | 'B62' | 'B63' | 'B64' | 'B66' | 'B67' | 'B68' | 'B69' | 'B7' | 'B70' | 'B71' | 'B72' | 'B73' | 'B74' | 'B75' | 'B76' | 'B77' | 'B78' | 'B79' | 'B8' | 'B80' | 'B81' | 'B82' | 'B83' | 'B84' | 'B85' | 'B86' | 'B87' | 'B88' | 'B89' | 'B90' | 'B91' | 'B92' | 'B93' | 'B94' | 'B95' | 'B96' | 'B97' | 'B98' | 'B99' | 'BAR' | 'BB' | 'BFT' | 'BHP' | 'BIL' | 'BLD' | 'BLL' | 'BP' | 'BPM' | 'BQL' | 'BTU' | 'BUA' | 'BUI' | 'C0' | 'C10' | 'C11' | 'C12' | 'C13' | 'C14' | 'C15' | 'C16' | 'C17' | 'C18' | 'C19' | 'C20' | 'C21' | 'C22' | 'C23' | 'C24' | 'C25' | 'C26' | 'C27' | 'C28' | 'C29' | 'C3' | 'C30' | 'C31' | 'C32' | 'C33' | 'C34' | 'C35' | 'C36' | 'C37' | 'C38' | 'C39' | 'C40' | 'C41' | 'C42' | 'C43' | 'C44' | 'C45' | 'C46' | 'C47' | 'C48' | 'C49' | 'C50' | 'C51' | 'C52' | 'C53' | 'C54' | 'C55' | 'C56' | 'C57' | 'C58' | 'C59' | 'C60' | 'C61' | 'C62' | 'C63' | 'C64' | 'C65' | 'C66' | 'C67' | 'C68' | 'C69' | 'C7' | 'C70' | 'C71' | 'C72' | 'C73' | 'C74' | 'C75' | 'C76' | 'C78' | 'C79' | 'C8' | 'C80' | 'C81' | 'C82' | 'C83' | 'C84' | 'C85' | 'C86' | 'C87' | 'C88' | 'C89' | 'C9' | 'C90' | 'C91' | 'C92' | 'C93' | 'C94' | 'C95' | 'C96' | 'C97' | 'C99' | 'CCT' | 'CDL' | 'CEL' | 'CEN' | 'CG' | 'CGM' | 'CKG' | 'CLF' | 'CLT' | 'CMK' | 'CMQ' | 'CMT' | 'CNP' | 'CNT' | 'COU' | 'CTG' | 'CTM' | 'CTN' | 'CUR' | 'CWA' | 'CWI' | 'D03' | 'D04' | 'D1' | 'D10' | 'D11' | 'D12' | 'D13' | 'D15' | 'D16' | 'D17' | 'D18' | 'D19' | 'D2' | 'D20' | 'D21' | 'D22' | 'D23' | 'D24' | 'D25' | 'D26' | 'D27' | 'D29' | 'D30' | 'D31' | 'D32' | 'D33' | 'D34' | 'D36' | 'D41' | 'D42' | 'D43' | 'D44' | 'D45' | 'D46' | 'D47' | 'D48' | 'D49' | 'D5' | 'D50' | 'D51' | 'D52' | 'D53' | 'D54' | 'D55' | 'D56' | 'D57' | 'D58' | 'D59' | 'D6' | 'D60' | 'D61' | 'D62' | 'D63' | 'D65' | 'D68' | 'D69' | 'D73' | 'D74' | 'D77' | 'D78' | 'D80' | 'D81' | 'D82' | 'D83' | 'D85' | 'D86' | 'D87' | 'D88' | 'D89' | 'D91' | 'D93' | 'D94' | 'D95' | 'DAA' | 'DAD' | 'DAY' | 'DB' | 'DD' | 'DEC' | 'DG' | 'DJ' | 'DLT' | 'DMA' | 'DMK' | 'DMO' | 'DMQ' | 'DMT' | 'DN' | 'DPC' | 'DPR' | 'DPT' | 'DRA' | 'DRI' | 'DRL' | 'DT' | 'DTN' | 'DWT' | 'DZN' | 'DZP' | 'E01' | 'E07' | 'E08' | 'E09' | 'E10' | 'E12' | 'E14' | 'E15' | 'E16' | 'E17' | 'E18' | 'E19' | 'E20' | 'E21' | 'E22' | 'E23' | 'E25' | 'E27' | 'E28' | 'E30' | 'E31' | 'E32' | 'E33' | 'E34' | 'E35' | 'E36' | 'E37' | 'E38' | 'E39' | 'E4' | 'E40' | 'E41' | 'E42' | 'E43' | 'E44' | 'E45' | 'E46' | 'E47' | 'E48' | 'E49' | 'E50' | 'E51' | 'E52' | 'E53' | 'E54' | 'E55' | 'E56' | 'E57' | 'E58' | 'E59' | 'E60' | 'E61' | 'E62' | 'E63' | 'E64' | 'E65' | 'E66' | 'E67' | 'E68' | 'E69' | 'E70' | 'E71' | 'E72' | 'E73' | 'E74' | 'E75' | 'E76' | 'E77' | 'E78' | 'E79' | 'E80' | 'E81' | 'E82' | 'E83' | 'E84' | 'E85' | 'E86' | 'E87' | 'E88' | 'E89' | 'E90' | 'E91' | 'E92' | 'E93' | 'E94' | 'E95' | 'E96' | 'E97' | 'E98' | 'E99' | 'EA' | 'EB' | 'EQ' | 'F01' | 'F02' | 'F03' | 'F04' | 'F05' | 'F06' | 'F07' | 'F08' | 'F10' | 'F11' | 'F12' | 'F13' | 'F14' | 'F15' | 'F16' | 'F17' | 'F18' | 'F19' | 'F20' | 'F21' | 'F22' | 'F23' | 'F24' | 'F25' | 'F26' | 'F27' | 'F28' | 'F29' | 'F30' | 'F31' | 'F32' | 'F33' | 'F34' | 'F35' | 'F36' | 'F37' | 'F38' | 'F39' | 'F40' | 'F41' | 'F42' | 'F43' | 'F44' | 'F45' | 'F46' | 'F47' | 'F48' | 'F49' | 'F50' | 'F51' | 'F52' | 'F53' | 'F54' | 'F55' | 'F56' | 'F57' | 'F58' | 'F59' | 'F60' | 'F61' | 'F62' | 'F63' | 'F64' | 'F65' | 'F66' | 'F67' | 'F68' | 'F69' | 'F70' | 'F71' | 'F72' | 'F73' | 'F74' | 'F75' | 'F76' | 'F77' | 'F78' | 'F79' | 'F80' | 'F81' | 'F82' | 'F83' | 'F84' | 'F85' | 'F86' | 'F87' | 'F88' | 'F89' | 'F90' | 'F91' | 'F92' | 'F93' | 'F94' | 'F95' | 'F96' | 'F97' | 'F98' | 'F99' | 'FAH' | 'FAR' | 'FBM' | 'FC' | 'FF' | 'FH' | 'FIT' | 'FL' | 'FOT' | 'FP' | 'FR' | 'FS' | 'FTK' | 'FTQ' | 'G01' | 'G04' | 'G05' | 'G06' | 'G08' | 'G09' | 'G10' | 'G11' | 'G12' | 'G13' | 'G14' | 'G15' | 'G16' | 'G17' | 'G18' | 'G19' | 'G2' | 'G20' | 'G21' | 'G23' | 'G24' | 'G25' | 'G26' | 'G27' | 'G28' | 'G29' | 'G3' | 'G30' | 'G31' | 'G32' | 'G33' | 'G34' | 'G35' | 'G36' | 'G37' | 'G38' | 'G39' | 'G40' | 'G41' | 'G42' | 'G43' | 'G44' | 'G45' | 'G46' | 'G47' | 'G48' | 'G49' | 'G50' | 'G51' | 'G52' | 'G53' | 'G54' | 'G55' | 'G56' | 'G57' | 'G58' | 'G59' | 'G60' | 'G61' | 'G62' | 'G63' | 'G64' | 'G65' | 'G66' | 'G67' | 'G68' | 'G69' | 'G70' | 'G71' | 'G72' | 'G73' | 'G74' | 'G75' | 'G76' | 'G77' | 'G78' | 'G79' | 'G80' | 'G81' | 'G82' | 'G83' | 'G84' | 'G85' | 'G86' | 'G87' | 'G88' | 'G89' | 'G90' | 'G91' | 'G92' | 'G93' | 'G94' | 'G95' | 'G96' | 'G97' | 'G98' | 'G99' | 'GB' | 'GBQ' | 'GDW' | 'GE' | 'GF' | 'GFI' | 'GGR' | 'GIA' | 'GIC' | 'GII' | 'GIP' | 'GJ' | 'GL' | 'GLD' | 'GLI' | 'GLL' | 'GM' | 'GO' | 'GP' | 'GQ' | 'GRM' | 'GRN' | 'GRO' | 'GV' | 'GWH' | 'H03' | 'H04' | 'H05' | 'H06' | 'H07' | 'H08' | 'H09' | 'H10' | 'H11' | 'H12' | 'H13' | 'H14' | 'H15' | 'H16' | 'H18' | 'H19' | 'H20' | 'H21' | 'H22' | 'H23' | 'H24' | 'H25' | 'H26' | 'H27' | 'H28' | 'H29' | 'H30' | 'H31' | 'H32' | 'H33' | 'H34' | 'H35' | 'H36' | 'H37' | 'H38' | 'H39' | 'H40' | 'H41' | 'H42' | 'H43' | 'H44' | 'H45' | 'H46' | 'H47' | 'H48' | 'H49' | 'H50' | 'H51' | 'H52' | 'H53' | 'H54' | 'H55' | 'H56' | 'H57' | 'H58' | 'H59' | 'H60' | 'H61' | 'H62' | 'H63' | 'H64' | 'H65' | 'H66' | 'H67' | 'H68' | 'H69' | 'H70' | 'H71' | 'H72' | 'H73' | 'H74' | 'H75' | 'H76' | 'H77' | 'H79' | 'H80' | 'H81' | 'H82' | 'H83' | 'H84' | 'H85' | 'H87' | 'H88' | 'H89' | 'H90' | 'H91' | 'H92' | 'H93' | 'H94' | 'H95' | 'H96' | 'H98' | 'H99' | 'HA' | 'HBA' | 'HBX' | 'HC' | 'HDW' | 'HEA' | 'HGM' | 'HH' | 'HIU' | 'HKM' | 'HLT' | 'HM' | 'HMQ' | 'HMT' | 'HPA' | 'HTZ' | 'HUR' | 'IA' | 'IE' | 'INH' | 'INK' | 'INQ' | 'ISD' | 'IU' | 'IV' | 'J10' | 'J12' | 'J13' | 'J14' | 'J15' | 'J16' | 'J17' | 'J18' | 'J19' | 'J2' | 'J20' | 'J21' | 'J22' | 'J23' | 'J24' | 'J25' | 'J26' | 'J27' | 'J28' | 'J29' | 'J30' | 'J31' | 'J32' | 'J33' | 'J34' | 'J35' | 'J36' | 'J38' | 'J39' | 'J40' | 'J41' | 'J42' | 'J43' | 'J44' | 'J45' | 'J46' | 'J47' | 'J48' | 'J49' | 'J50' | 'J51' | 'J52' | 'J53' | 'J54' | 'J55' | 'J56' | 'J57' | 'J58' | 'J59' | 'J60' | 'J61' | 'J62' | 'J63' | 'J64' | 'J65' | 'J66' | 'J67' | 'J68' | 'J69' | 'J70' | 'J71' | 'J72' | 'J73' | 'J74' | 'J75' | 'J76' | 'J78' | 'J79' | 'J81' | 'J82' | 'J83' | 'J84' | 'J85' | 'J87' | 'J90' | 'J91' | 'J92' | 'J93' | 'J95' | 'J96' | 'J97' | 'J98' | 'J99' | 'JE' | 'JK' | 'JM' | 'JNT' | 'JOU' | 'JPS' | 'JWL' | 'K1' | 'K10' | 'K11' | 'K12' | 'K13' | 'K14' | 'K15' | 'K16' | 'K17' | 'K18' | 'K19' | 'K2' | 'K20' | 'K21' | 'K22' | 'K23' | 'K26' | 'K27' | 'K28' | 'K3' | 'K30' | 'K31' | 'K32' | 'K33' | 'K34' | 'K35' | 'K36' | 'K37' | 'K38' | 'K39' | 'K40' | 'K41' | 'K42' | 'K43' | 'K45' | 'K46' | 'K47' | 'K48' | 'K49' | 'K50' | 'K51' | 'K52' | 'K53' | 'K54' | 'K55' | 'K58' | 'K59' | 'K6' | 'K60' | 'K61' | 'K62' | 'K63' | 'K64' | 'K65' | 'K66' | 'K67' | 'K68' | 'K69' | 'K70' | 'K71' | 'K73' | 'K74' | 'K75' | 'K76' | 'K77' | 'K78' | 'K79' | 'K80' | 'K81' | 'K82' | 'K83' | 'K84' | 'K85' | 'K86' | 'K87' | 'K88' | 'K89' | 'K90' | 'K91' | 'K92' | 'K93' | 'K94' | 'K95' | 'K96' | 'K97' | 'K98' | 'K99' | 'KA' | 'KAT' | 'KB' | 'KBA' | 'KCC' | 'KDW' | 'KEL' | 'KGM' | 'KGS' | 'KHY' | 'KHZ' | 'KI' | 'KIC' | 'KIP' | 'KJ' | 'KJO' | 'KL' | 'KLK' | 'KLX' | 'KMA' | 'KMH' | 'KMK' | 'KMQ' | 'KMT' | 'KNI' | 'KNM' | 'KNS' | 'KNT' | 'KO' | 'KPA' | 'KPH' | 'KPO' | 'KPP' | 'KR' | 'KSD' | 'KSH' | 'KT' | 'KTN' | 'KUR' | 'KVA' | 'KVR' | 'KVT' | 'KW' | 'KWH' | 'KWO' | 'KWT' | 'KX' | 'L10' | 'L11' | 'L12' | 'L13' | 'L14' | 'L15' | 'L16' | 'L17' | 'L18' | 'L19' | 'L2' | 'L20' | 'L21' | 'L23' | 'L24' | 'L25' | 'L26' | 'L27' | 'L28' | 'L29' | 'L30' | 'L31' | 'L32' | 'L33' | 'L34' | 'L35' | 'L36' | 'L37' | 'L38' | 'L39' | 'L40' | 'L41' | 'L42' | 'L43' | 'L44' | 'L45' | 'L46' | 'L47' | 'L48' | 'L49' | 'L50' | 'L51' | 'L52' | 'L53' | 'L54' | 'L55' | 'L56' | 'L57' | 'L58' | 'L59' | 'L60' | 'L63' | 'L64' | 'L65' | 'L66' | 'L67' | 'L68' | 'L69' | 'L70' | 'L71' | 'L72' | 'L73' | 'L74' | 'L75' | 'L76' | 'L77' | 'L78' | 'L79' | 'L80' | 'L81' | 'L82' | 'L83' | 'L84' | 'L85' | 'L86' | 'L87' | 'L88' | 'L89' | 'L90' | 'L91' | 'L92' | 'L93' | 'L94' | 'L95' | 'L96' | 'L98' | 'L99' | 'LA' | 'LAC' | 'LBR' | 'LBT' | 'LD' | 'LEF' | 'LF' | 'LH' | 'LK' | 'LM' | 'LN' | 'LO' | 'LP' | 'LPA' | 'LR' | 'LS' | 'LTN' | 'LTR' | 'LUB' | 'LUM' | 'LUX' | 'LY' | 'M1' | 'M10' | 'M11' | 'M12' | 'M13' | 'M14' | 'M15' | 'M16' | 'M17' | 'M18' | 'M19' | 'M20' | 'M21' | 'M22' | 'M23' | 'M24' | 'M25' | 'M26' | 'M27' | 'M29' | 'M30' | 'M31' | 'M32' | 'M33' | 'M34' | 'M35' | 'M36' | 'M37' | 'M38' | 'M39' | 'M4' | 'M40' | 'M41' | 'M42' | 'M43' | 'M44' | 'M45' | 'M46' | 'M47' | 'M48' | 'M49' | 'M5' | 'M50' | 'M51' | 'M52' | 'M53' | 'M55' | 'M56' | 'M57' | 'M58' | 'M59' | 'M60' | 'M61' | 'M62' | 'M63' | 'M64' | 'M65' | 'M66' | 'M67' | 'M68' | 'M69' | 'M7' | 'M70' | 'M71' | 'M72' | 'M73' | 'M74' | 'M75' | 'M76' | 'M77' | 'M78' | 'M79' | 'M80' | 'M81' | 'M82' | 'M83' | 'M84' | 'M85' | 'M86' | 'M87' | 'M88' | 'M89' | 'M9' | 'M90' | 'M91' | 'M92' | 'M93' | 'M94' | 'M95' | 'M96' | 'M97' | 'M98' | 'M99' | 'MAH' | 'MAL' | 'MAM' | 'MAR' | 'MAW' | 'MBE' | 'MBF' | 'MBR' | 'MC' | 'MCU' | 'MD' | 'MGM' | 'MHZ' | 'MIK' | 'MIL' | 'MIN' | 'MIO' | 'MIU' | 'MLD' | 'MLT' | 'MMK' | 'MMQ' | 'MMT' | 'MND' | 'MON' | 'MPA' | 'MQH' | 'MQS' | 'MSK' | 'MTK' | 'MTQ' | 'MTR' | 'MTS' | 'MVA' | 'MWH' | 'N1' | 'N10' | 'N11' | 'N12' | 'N13' | 'N14' | 'N15' | 'N16' | 'N17' | 'N18' | 'N19' | 'N20' | 'N21' | 'N22' | 'N23' | 'N24' | 'N25' | 'N26' | 'N27' | 'N28' | 'N29' | 'N3' | 'N30' | 'N31' | 'N32' | 'N33' | 'N34' | 'N35' | 'N36' | 'N37' | 'N38' | 'N39' | 'N40' | 'N41' | 'N42' | 'N43' | 'N44' | 'N45' | 'N46' | 'N47' | 'N48' | 'N49' | 'N50' | 'N51' | 'N52' | 'N53' | 'N54' | 'N55' | 'N56' | 'N57' | 'N58' | 'N59' | 'N60' | 'N61' | 'N62' | 'N63' | 'N64' | 'N65' | 'N66' | 'N67' | 'N68' | 'N69' | 'N70' | 'N71' | 'N72' | 'N73' | 'N74' | 'N75' | 'N76' | 'N77' | 'N78' | 'N79' | 'N80' | 'N81' | 'N82' | 'N83' | 'N84' | 'N85' | 'N86' | 'N87' | 'N88' | 'N89' | 'N90' | 'N91' | 'N92' | 'N93' | 'N94' | 'N95' | 'N96' | 'N97' | 'N98' | 'N99' | 'NA' | 'NAR' | 'NCL' | 'NEW' | 'NF' | 'NIL' | 'NIU' | 'NL' | 'NM3' | 'NMI' | 'NMP' | 'NPT' | 'NT' | 'NU' | 'NX' | 'OA' | 'ODE' | 'OHM' | 'ON' | 'ONZ' | 'OPM' | 'OT' | 'OZA' | 'OZI' | 'P1' | 'P10' | 'P11' | 'P12' | 'P13' | 'P14' | 'P15' | 'P16' | 'P17' | 'P18' | 'P19' | 'P2' | 'P20' | 'P21' | 'P22' | 'P23' | 'P24' | 'P25' | 'P26' | 'P27' | 'P28' | 'P29' | 'P30' | 'P31' | 'P32' | 'P33' | 'P34' | 'P35' | 'P36' | 'P37' | 'P38' | 'P39' | 'P40' | 'P41' | 'P42' | 'P43' | 'P44' | 'P45' | 'P46' | 'P47' | 'P48' | 'P49' | 'P5' | 'P50' | 'P51' | 'P52' | 'P53' | 'P54' | 'P55' | 'P56' | 'P57' | 'P58' | 'P59' | 'P60' | 'P61' | 'P62' | 'P63' | 'P64' | 'P65' | 'P66' | 'P67' | 'P68' | 'P69' | 'P70' | 'P71' | 'P72' | 'P73' | 'P74' | 'P75' | 'P76' | 'P77' | 'P78' | 'P79' | 'P80' | 'P81' | 'P82' | 'P83' | 'P84' | 'P85' | 'P86' | 'P87' | 'P88' | 'P89' | 'P90' | 'P91' | 'P92' | 'P93' | 'P94' | 'P95' | 'P96' | 'P97' | 'P98' | 'P99' | 'PAL' | 'PD' | 'PFL' | 'PGL' | 'PI' | 'PLA' | 'PO' | 'PQ' | 'PR' | 'PS' | 'PTD' | 'PTI' | 'PTL' | 'PTN' | 'Q10' | 'Q11' | 'Q12' | 'Q13' | 'Q14' | 'Q15' | 'Q16' | 'Q17' | 'Q18' | 'Q19' | 'Q20' | 'Q21' | 'Q22' | 'Q23' | 'Q24' | 'Q25' | 'Q26' | 'Q27' | 'Q28' | 'Q29' | 'Q30' | 'Q31' | 'Q32' | 'Q33' | 'Q34' | 'Q35' | 'Q36' | 'Q37' | 'Q38' | 'Q39' | 'Q40' | 'Q3' | 'QA' | 'QAN' | 'QB' | 'QR' | 'QTD' | 'QTI' | 'QTL' | 'QTR' | 'R1' | 'R9' | 'RH' | 'RM' | 'ROM' | 'RP' | 'RPM' | 'RPS' | 'RT' | 'S3' | 'S4' | 'SAN' | 'SCO' | 'SCR' | 'SEC' | 'SET' | 'SG' | 'SIE' | 'SM3' | 'SMI' | 'SQ' | 'SQR' | 'SR' | 'STC' | 'STI' | 'STK' | 'STL' | 'STN' | 'STW' | 'SW' | 'SX' | 'SYR' | 'T0' | 'T3' | 'TAH' | 'TAN' | 'TI' | 'TIC' | 'TIP' | 'TKM' | 'TMS' | 'TNE' | 'TP' | 'TPI' | 'TPR' | 'TQD' | 'TRL' | 'TST' | 'TTS' | 'U1' | 'U2' | 'UB' | 'UC' | 'VA' | 'VLT' | 'VP' | 'W2' | 'WA' | 'WB' | 'WCD' | 'WE' | 'WEB' | 'WEE' | 'WG' | 'WHR' | 'WM' | 'WSD' | 'WTT' | 'X1' | 'YDK' | 'YDQ' | 'YRD' | 'Z11' | 'ZP' | 'ZZ' | 'X1A' | 'X1B' | 'X1D' | 'X1F' | 'X1G' | 'X1W' | 'X2C' | 'X3A' | 'X3H' | 'X43' | 'X44' | 'X4A' | 'X4B' | 'X4C' | 'X4D' | 'X4F' | 'X4G' | 'X4H' | 'X5H' | 'X5L' | 'X5M' | 'X6H' | 'X6P' | 'X7A' | 'X7B' | 'X8A' | 'X8B' | 'X8C' | 'XAA' | 'XAB' | 'XAC' | 'XAD' | 'XAE' | 'XAF' | 'XAG' | 'XAH' | 'XAI' | 'XAJ' | 'XAL' | 'XAM' | 'XAP' | 'XAT' | 'XAV' | 'XB4' | 'XBA' | 'XBB' | 'XBC' | 'XBD' | 'XBE' | 'XBF' | 'XBG' | 'XBH' | 'XBI' | 'XBJ' | 'XBK' | 'XBL' | 'XBM' | 'XBN' | 'XBO' | 'XBP' | 'XBQ' | 'XBR' | 'XBS' | 'XBT' | 'XBU' | 'XBV' | 'XBW' | 'XBX' | 'XBY' | 'XBZ' | 'XCA' | 'XCB' | 'XCC' | 'XCD' | 'XCE' | 'XCF' | 'XCG' | 'XCH' | 'XCI' | 'XCJ' | 'XCK' | 'XCL' | 'XCM' | 'XCN' | 'XCO' | 'XCP' | 'XCQ' | 'XCR' | 'XCS' | 'XCT' | 'XCU' | 'XCV' | 'XCW' | 'XCX' | 'XCY' | 'XCZ' | 'XDA' | 'XDB' | 'XDC' | 'XDG' | 'XDH' | 'XDI' | 'XDJ' | 'XDK' | 'XDL' | 'XDM' | 'XDN' | 'XDP' | 'XDR' | 'XDS' | 'XDT' | 'XDU' | 'XDV' | 'XDW' | 'XDX' | 'XDY' | 'XEC' | 'XED' | 'XEE' | 'XEF' | 'XEG' | 'XEH' | 'XEI' | 'XEN' | 'XFB' | 'XFC' | 'XFD' | 'XFE' | 'XFI' | 'XFL' | 'XFO' | 'XFP' | 'XFR' | 'XFT' | 'XFW' | 'XFX' | 'XGB' | 'XGI' | 'XGL' | 'XGR' | 'XGU' | 'XGY' | 'XGZ' | 'XHA' | 'XHB' | 'XHC' | 'XHG' | 'XHN' | 'XHR' | 'XIA' | 'XIB' | 'XIC' | 'XID' | 'XIE' | 'XIF' | 'XIG' | 'XIH' | 'XIK' | 'XIL' | 'XIN' | 'XIZ' | 'XJB' | 'XJC' | 'XJG' | 'XJR' | 'XJT' | 'XJY' | 'XKG' | 'XKI' | 'XLE' | 'XLG' | 'XLT' | 'XLU' | 'XLV' | 'XLZ' | 'XMA' | 'XMB' | 'XMC' | 'XME' | 'XMR' | 'XMS' | 'XMT' | 'XMW' | 'XMX' | 'XNA' | 'XNE' | 'XNF' | 'XNG' | 'XNS' | 'XNT' | 'XNU' | 'XNV' | 'XOA' | 'XOB' | 'XOC' | 'XOD' | 'XOE' | 'XOF' | 'XOK' | 'XOT' | 'XOU' | 'XP2' | 'XPA' | 'XPB' | 'XPC' | 'XPD' | 'XPE' | 'XPF' | 'XPG' | 'XPH' | 'XPI' | 'XPJ' | 'XPK' | 'XPL' | 'XPN' | 'XPO' | 'XPP' | 'XPR' | 'XPT' | 'XPU' | 'XPV' | 'XPX' | 'XPY' | 'XPZ' | 'XQA' | 'XQB' | 'XQC' | 'XQD' | 'XQF' | 'XQG' | 'XQH' | 'XQJ' | 'XQK' | 'XQL' | 'XQM' | 'XQN' | 'XQP' | 'XQQ' | 'XQR' | 'XQS' | 'XRD' | 'XRG' | 'XRJ' | 'XRK' | 'XRL' | 'XRO' | 'XRT' | 'XRZ' | 'XSA' | 'XSB' | 'XSC' | 'XSD' | 'XSE' | 'XSH' | 'XSI' | 'XSK' | 'XSL' | 'XSM' | 'XSO' | 'XSP' | 'XSS' | 'XST' | 'XSU' | 'XSV' | 'XSW' | 'XSY' | 'XSZ' | 'XT1' | 'XTB' | 'XTC' | 'XTD' | 'XTE' | 'XTG' | 'XTI' | 'XTK' | 'XTL' | 'XTN' | 'XTO' | 'XTR' | 'XTS' | 'XTT' | 'XTU' | 'XTV' | 'XTW' | 'XTY' | 'XTZ' | 'XUC' | 'XUN' | 'XVA' | 'XVG' | 'XVI' | 'XVK' | 'XVL' | 'XVO' | 'XVP' | 'XVQ' | 'XVN' | 'XVR' | 'XVS' | 'XVY' | 'XWA' | 'XWB' | 'XWC' | 'XWD' | 'XWF' | 'XWG' | 'XWH' | 'XWJ' | 'XWK' | 'XWL' | 'XWM' | 'XWN' | 'XWP' | 'XWQ' | 'XWR' | 'XWS' | 'XWT' | 'XWU' | 'XWV' | 'XWW' | 'XWX' | 'XWY' | 'XWZ' | 'XXA' | 'XXB' | 'XXC' | 'XXD' | 'XXF' | 'XXG' | 'XXH' | 'XXJ' | 'XXK' | 'XYA' | 'XYB' | 'XYC' | 'XYD' | 'XYF' | 'XYG' | 'XYH' | 'XYJ' | 'XYK' | 'XYL' | 'XYM' | 'XYN' | 'XYP' | 'XYQ' | 'XYR' | 'XYS' | 'XYT' | 'XYV' | 'XYW' | 'XYX' | 'XYY' | 'XYZ' | 'XZA' | 'XZB' | 'XZC' | 'XZD' | 'XZF' | 'XZG' | 'XZH' | 'XZJ' | 'XZK' | 'XZL' | 'XZM' | 'XZN' | 'XZP' | 'XZQ' | 'XZR' | 'XZS' | 'XZT' | 'XZU' | 'XZV' | 'XZW' | 'XZX' | 'XZY' | 'XZZ' | '04' | '05' | '08' | '16' | '17' | '18' | '19' | '26' | '29' | '30' | '31' | '32' | '36' | '43' | '44' | '45' | '46' | '47' | '48' | '53' | '54' | '62' | '63' | '64' | '66' | '69' | '71' | '72' | '73' | '76' | '78' | '84' | '90' | '92' | '93' | '94' | '95' | '96' | '97' | '98' | '1A' | '1B' | '1C' | '1D' | '1E' | '1F' | '1G' | '1H' | '1J' | '1K' | '1L' | '1M' | '1X' | '2V' | '2W' | '3E' | '3G' | '3H' | '3I' | '4A' | '4B' | '4E' | '5C' | '5F' | '5G' | '5H' | '5I' | '5K' | '5P' | '5Q' | 'A1' | 'A25' | 'A50' | 'A51' | 'A52' | 'A57' | 'A58' | 'A60' | 'A61' | 'A62' | 'A63' | 'A64' | 'A65' | 'A66' | 'A67' | 'A77' | 'A78' | 'A79' | 'A80' | 'A81' | 'A82' | 'A83' | 'AJ' | 'AM' | 'AP' | 'AR' | 'ARE' | 'ATT' | 'AV' | 'AW' | 'B0' | 'B2' | 'B36' | 'B37' | 'B38' | 'B39' | 'B40' | 'B5' | 'B51' | 'B6' | 'B65' | 'B9' | 'BD' | 'BE' | 'BG' | 'BH' | 'BJ' | 'BK' | 'BL' | 'BO' | 'BR' | 'BT' | 'BW' | 'BX' | 'BZ' | 'C1' | 'C2' | 'C4' | 'C5' | 'C6' | 'C77' | 'C98' | 'CA' | 'CH' | 'CJ' | 'CK' | 'CL' | 'CO' | 'CQ' | 'CR' | 'CS' | 'CT' | 'CU' | 'CV' | 'CY' | 'CZ' | 'D14' | 'D28' | 'D35' | 'D37' | 'D38' | 'D39' | 'D40' | 'D64' | 'D66' | 'D67' | 'D7' | 'D70' | 'D71' | 'D72' | 'D75' | 'D76' | 'D79' | 'D8' | 'D9' | 'D90' | 'D92' | 'D96' | 'D97' | 'D98' | 'D99' | 'DC' | 'DE' | 'DI' | 'DQ' | 'DR' | 'DRM' | 'DS' | 'DU' | 'DX' | 'DY' | 'E2' | 'E3' | 'E5' | 'EC' | 'EP' | 'EV' | 'F1' | 'F9' | 'FB' | 'FD' | 'FE' | 'FG' | 'FM' | 'G7' | 'GC' | 'GD' | 'GH' | 'GK' | 'GN' | 'GRT' | 'GT' | 'GW' | 'GY' | 'GZ' | 'H1' | 'H2' | 'HAR' | 'HD' | 'HE' | 'HF' | 'HI' | 'HJ' | 'HK' | 'HL' | 'HN' | 'HO' | 'HP' | 'HS' | 'HT' | 'HY' | 'IC' | 'IF' | 'II' | 'IL' | 'IM' | 'IP' | 'IT' | 'JB' | 'JG' | 'JO' | 'JR' | 'K5' | 'KD' | 'KF' | 'KG' | 'KS' | 'KTM' | 'LC' | 'LE' | 'LI' | 'LJ' | 'LX' | 'M0' | 'MA' | 'MF' | 'MK' | 'MQ' | 'MT' | 'MV' | 'N2' | 'NB' | 'NBB' | 'NC' | 'ND' | 'NE' | 'NG' | 'NH' | 'NI' | 'NJ' | 'NN' | 'NPL' | 'NPR' | 'NQ' | 'NR' | 'NRL' | 'NTT' | 'NV' | 'NY' | 'OP' | 'OZ' | 'P0' | 'P3' | 'P4' | 'P6' | 'P7' | 'P8' | 'P9' | 'PA' | 'PB' | 'PE' | 'PF' | 'PG' | 'PK' | 'PL' | 'PM' | 'PN' | 'PT' | 'PU' | 'PV' | 'PW' | 'PY' | 'PZ' | 'QD' | 'QH' | 'QK' | 'QT' | 'R4' | 'RA' | 'RD' | 'RG' | 'RK' | 'RL' | 'RN' | 'RO' | 'RS' | 'RU' | 'S5' | 'S6' | 'S7' | 'S8' | 'SA' | 'SD' | 'SE' | 'SHT' | 'SK' | 'SL' | 'SN' | 'SO' | 'SP' | 'SS' | 'SST' | 'ST' | 'SV' | 'T1' | 'T4' | 'T5' | 'T6' | 'T7' | 'T8' | 'TA' | 'TC' | 'TD' | 'TE' | 'TF' | 'TJ' | 'TK' | 'TL' | 'TN' | 'TQ' | 'TR' | 'TS' | 'TSD' | 'TSH' | 'TT' | 'TU' | 'TV' | 'TW' | 'TY' | 'UA' | 'UD' | 'UE' | 'UF' | 'UH' | 'UM' | 'VI' | 'VQ' | 'VS' | 'W4' | 'WH' | 'WI' | 'WR' | 'WW' | 'YL' | 'YT' | 'Z1' | 'Z2' | 'Z3' | 'Z4' | 'Z5' | 'Z6' | 'Z8', required — The unit of measure that applies to the quantity. Codes for unit of packaging from UNECE Recommendation No. 21 can be used in accordance with the descriptions in the "Intro" section of UN/ECE Recommendation 20, Revision 11 (2015): The 2 character alphanumeric code values in UNECE Recommendation 21 shall be used. To avoid duplication with existing code values in UNECE Recommendation No. 20, each code value from UNECE Recommendation 21 shall be prefixed with an “X”, resulting in a 3 alphanumeric code when used as a unit of measure. Note that the following additionally allowed codes are deprecated and will be converted to C62: 04, 05, 08, 16, 17, 18, 19, 26, 29, 30, 31, 32, 36, 43, 44, 45, 46, 47, 48, 53, 54, 62, 63, 64, 66, 69, 71, 72, 73, 76, 78, 84, 90, 92, 93, 94, 95, 96, 97, 98, 1A, 1B, 1C, 1D, 1E, 1F, 1G, 1H, 1J, 1K, 1L, 1M, 1X, 2V, 2W, 3E, 3G, 3H, 3I, 4A, 4B, 4E, 5C, 5F, 5G, 5H, 5I, 5K, 5P, 5Q, A1, A25, A50, A51, A52, A57, A58, A60, A61, A62, A63, A64, A65, A66, A67, A77, A78, A79, A80, A81, A82, A83, AJ, AM, AP, AR, ARE, ATT, AV, AW, B0, B2, B36, B37, B38, B39, B40, B5, B51, B6, B65, B9, BD, BE, BG, BH, BJ, BK, BL, BO, BR, BT, BW, BX, BZ, C1, C2, C4, C5, C6, C77, C98, CA, CH, CJ, CK, CL, CO, CQ, CR, CS, CT, CU, CV, CY, CZ, D14, D28, D35, D37, D38, D39, D40, D64, D66, D67, D7, D70, D71, D72, D75, D76, D79, D8, D9, D90, D92, D96, D97, D98, D99, DC, DE, DI, DQ, DR, DRM, DS, DU, DX, DY, E2, E3, E5, EC, EP, EV, F1, F9, FB, FD, FE, FG, FM, G7, GC, GD, GH, GK, GN, GRT, GT, GW, GY, GZ, H1, H2, HAR, HD, HE, HF, HI, HJ, HK, HL, HN, HO, HP, HS, HT, HY, IC, IF, II, IL, IM, IP, IT, JB, JG, JO, JR, K5, KD, KF, KG, KS, KTM, LC, LE, LI, LJ, LX, M0, MA, MF, MK, MQ, MT, MV, N2, NB, NBB, NC, ND, NE, NG, NH, NI, NJ, NN, NPL, NPR, NQ, NR, NRL, NTT, NV, NY, OP, OZ, P0, P3, P4, P6, P7, P8, P9, PA, PB, PE, PF, PG, PK, PL, PM, PN, PT, PU, PV, PW, PY, PZ, QD, QH, QK, QT, R4, RA, RD, RG, RK, RL, RN, RO, RS, RU, S5, S6, S7, S8, SA, SD, SE, SHT, SK, SL, SN, SO, SP, SS, SST, ST, SV, T1, T4, T5, T6, T7, T8, TA, TC, TD, TE, TF, TJ, TK, TL, TN, TQ, TR, TS, TSD, TSH, TT, TU, TV, TW, TY, UA, UD, UE, UF, UH, UM, VI, VQ, VS, W4, WH, WI, WR, WW, YL, YT, Z1, Z2, Z3, Z4, Z5, Z6, Z8
        - `itemPrice` number — The price per item (may be fractional)
        - `baseQuantity` number — The number of items the price is for.
        - `amountExcludingTax` number, required — The amount excluding tax. Should equal quantity x itemPrice + allowanceCharge.
        - `allowanceCharges` LineAllowanceCharge[] — An array of allowance charges.
          - `amountExcludingTax` number, required — The amount for the allowance or charge, excluding tax.
          - `baseAmountExcludingTax` number — The base amount for the allowance or charge, excluding tax.
          - `reason` string — The reason for the allowance or charge, free text. Defaults to 'Mutually Agreed' if neither reason nor reasonCode are provided.
          - `reasonCode` string — The reason code for the allowance or charge
        - `allowPartialDelivery` boolean — Whether or not the line items must be delivered in a single shipment.
        - `accountingCost` string — The buyer's accounting cost centre for this line.
        - `delivery` LineDelivery
          - `deliveryLocation` object
            - `id` string — The location identifier.
            - `schemeId` string — The schemeId of the location identifier (e.g. '0088')
            - `requestedDeliveryPeriod` string — The requested delivery period. If not present, will be taken from the document level. If that is not present, this field is mandatory.
        - `description` string — The description for this line.
        - `name` string — A short name for this line.
        - `references` Reference[] — An array of references to other documents or codes. Note that many syntaxes do not support multiple references of the same type in which case they will be concatenated with ','. Also, not all syntaxes support all documentTypes.
          - `documentType` 'purchase_order' | 'replaced_order' | 'buyer_reference' | 'billing' | 'billing_uuid' | 'advance_invoice' | 'sales_order' | 'contract' | 'despatch_advice' | 'originator' | 'receipt' | 'project' | 'quotation' | 'payment_url' | 'additional' | 'certified_exporter_authorization' | 'free_trade_agreement' | 'my_customs_form_1_9' | 'my_customs_form_2' | 'item_classification_code' | 'item_commodity_code' | 'item_specification' | 'line_document_reference' | 'line_standard_item_identification' | 'line_sellers_item_identification' | 'line_buyers_item_identification' | 'line_purchase_order' | 'line_billing' | 'line_despatch_document' | 'line_receipt_document', required — The type of the referenced document. The following types are supported: ++++ <ul> <li> <b>purchase_order</b> (document level, Invoice) <p>A reference to an order for this document, assigned by the buyer. Note that this often is a key field, since many receivers of invoices will use this field to automatically match the invoice to an order they placed. Many receivers refuse invoices that cannot be automatically matched, in particular government agencies. So it is highly recommended to fill this field whenever possible.</p> </li> <li> <b>billing</b> (document level, Invoice) <p>A reference to a billing document. For instance, credit notes may refer to an invoice they are a credit note for.</p> </li> <li> <b>billing_uuid</b> (document level, Invoice) <p>DEPRECATED. Use the billingUuid property of the 'billing' reference. A UUID reference to a billing document. For instance, credit notes may refer to an invoice they are a credit note for.</p> </li> <li> <b>advance_invoice</b> (document level, Invoice) <p>A reference to an advance invoice that a settlement invoice settles. Used for Polish KSeF settlement invoices (faktura rozliczeniowa, ROZ), with one entry per advance invoice (FakturaZaliczkowa). When sending, provide documentId set to the advance invoice's KSeF number when available or otherwise the seller invoice number. When receiving, one entry is emitted per FakturaZaliczkowa, with documentId set to the KSeF number when available (also kept in documentUuid) or otherwise the seller invoice number.</p> </li> <li> <b>sales_order</b> (document level, Invoice + Order) <p>A reference to an order for this document, assigned by the seller.</p> </li> <li> <b>buyer_reference</b> (document level, Invoice, Order) <p>The buyer's reference. Used for internal routing by the receiver. For orders, this becomes the customer reference which the receiver of the order should put back in the buyer reference field in the invoice.</p> </li> <li> <b>additional</b> (document level, Invoice, Order) <p>An additional reference. For UBL, this translates into an AdditionalDocumentReference without a EmbeddedDocumentBinaryObject. For the latter, use the attachments array.</p> </li> <li> <b>contract</b> (document level, Invoice + Order) <p>A reference to a contract or framework agreement that this document relates to.</p> </li> <li> <b>despatch_advice</b> (document level, Invoice) <p>A reference to a despatch advice for this document. In the FatturaPA, this is what will become the DDT.</p> </li> <li> <b>originator</b> (document level, Invoice + Order) <p>A reference to an originator document for this invoice.</p> </li> <li> <b>receipt</b> (document level, Invoice) <p>A reference to a receipt document for this document.</p> </li> <li> <b>project</b> (document level, Invoice) <p>A reference to a project document for this document.</p> </li> <li> <b>quotation</b> (document level, Order) <p>A reference to a quotation document for this document.</p> </li> <li> <b>replaced_order</b> (document level, Order) <p>A reference to the initial order that was rejected and a new order is issued. </p> </li> <li> <b>payment_url</b> (document level, Invoice) <p>A to a payment URL for the invoice.</p> </li> <li> <b>item_classification_code</b> (line level) <p>A reference to a commodity classification / item classification code for this line. Note that in combination with the documentIdListId these can be used for Malaysia LHDNM to provide the product classification code (documentIdListId=CLASS) and the product tariff code (documentIdListId=PTC)</p> </li> <li> <b>item_commodity_code</b> (line level) <p>A reference to a commodity classification / commodity code for this line.</p> </li> <li> <b>item_specification</b> (line level) <p>A referece to an item specification document</p> </li> <li> <b>line_document_reference</b> (line level) <p>A reference to another document for this line.</p> </li> <li> <b>line_standard_item_identification</b> (line level) <p>A standard item identification.</p> </li> <li> <b>line_sellers_item_identification</b> (line level) <p>The seller's item identification.</p> </li> <li> <b>line_buyers_item_identification</b> (line level) <p>The buyer's item identification.</p> </li> <li> <b>line_purchase_order</b> (line level) <p>A reference to an order for this line, assigned by the buyer. Note not all outgoing document formats support this, so they may end up concatenated at the invoice level.</p> </li> <li> <b>line_billing</b> (line level) <p>A reference to a previous invoice that this invoice line corrects (FR-FE EXT-FR-FE-136/137/138/139). Use documentId for the previous invoice number, documentTypeCode for the type code, issueDate for the previous invoice issue date and lineId for the line in the previous invoice.</p> </li> <li> <b>line_despatch_document</b> (line level) <p>A reference to a despatch document (BL) for this invoice line (FR-FE). Use documentId for the despatch document identifier and lineId for the line in the despatch document. In UBL the documentId is taken from Invoice/InvoiceLine/DespatchLineReference/DocumentReference/ID with Invoice/DespatchDocumentReference/ID as fallback. In CII the documentId is taken from IncludedSupplyChainTradeLineItem/SpecifiedLineTradeDelivery/DespatchAdviceReferencedDocument/IssuerAssignedID with ApplicableHeaderTradeDelivery/DespatchAdviceReferencedDocument/IssuerAssignedID as fallback.</p> </li> <li> <b>line_receipt_document</b> (line level) <p>A reference to a receipt document (BR) for this invoice line (FR-FE). Use documentId for the receipt document identifier and lineId for the line in the receipt document. In UBL the documentId is taken from Invoice/InvoiceLine/ReceiptLineReference/DocumentReference/ID with Invoice/ReceiptDocumentReference/ID as fallback. In CII the documentId is taken from IncludedSupplyChainTradeLineItem/SpecifiedLineTradeDelivery/ReceivingAdviceReferencedDocument/IssuerAssignedID with ApplicableHeaderTradeDelivery/ReceivingAdviceReferencedDocument/IssuerAssignedID as fallback.</p> </li></ul> ++++
          - `documentTypeCode` string — The code of the referenced document type. Used for documentType = 'line_document_reference', and for the FR-FE extensions documentType = 'contract' (EXT-FR-FE-01, allowed values for FR-DGFiP: 'CONTRAT', 'MARCHE') and documentType = 'line_billing' (EXT-FR-FE-137). UNCL1001 codes may be sent either prefixed ('uncl1001_<code>') or as bare digits.
          - `documentId` string — The id of the referenced document.
          - `documentUuid` string — The UUID of the referenced document.
          - `documentIdSchemeId` string — The scheme id of the id of the referenced document.
          - `documentIdSchemeAgencyId` string — The the agency id of the scheme id of the id of the referenced document.
          - `documentIdSchemeVersionId` string — The version id of the scheme id of the id of the referenced document.
          - `documentIdListId` string — The list id of the id of the referenced document.
          - `documentIdListAgencyId` string — The agency id of the list id of the id of the referenced document.
          - `documentIdListVersionId` string — The version id of the list id of the id of the referenced document.
          - `lineId` string — The line in the referenced document.
          - `issueDate` string — The issue date of the referenced document.
          - `documentDescription` string — A description for the referenced document.
        - `taxesDutiesFees` Tax[] — An array of taxes, duties and fees for this invoice line. Multiple taxesDutiesFees items is allowed only for IN (India) and US (USA) taxes. All other countries can only have a single Tax item in this array.
          - `amount` number — The amount of tax. Mandatory if taxSystem == 'tax_line_amounts'. However, it is best to use taxSystem tax_line_percentages and provide only the percentage, not the actual amount. The amount is then provided at the invoice level, in the taxSubtotals element.
          - `percentage` number — The percentage Tax. This should be a valid Tax percentage in the country at the time of the issueDate of this invoice. Mandatory if taxSystem == 'tax_line_percentages'
          - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'XK' | 'XI', required — An ISO 3166-1 alpha-2 country code.
          - `acknowledgeThirdCountryTax` boolean — When specifying a tax country other than that of the sender or the receiver, this flag must be set. This is to prevent accidental errors.
          - `category` 'standard' | 'zero_rated' | 'reverse_charge' | 'intra_community' | 'exempt' | 'export' | 'outside_scope' | 'regulation33_exempt' | 'nonregulation33_exempt' | 'deemed_supply' | 'srca_s' | 'srca_c' | 'not_registered' | 'igst' | 'cgst' | 'sgst' | 'cess' | 'state_cess' | 'srovr' | 'srovr_rs' | 'srovr_lvg' | 'srlvg' | 'bollo_virtuale' | 'exempt_it_n1' | 'sales' | 'service' | 'tourism' | 'high_value_goods' | 'low_value_goods' | 'sales_zero' | 'service_zero' | 'not_applicable' | 'standard_ca' | 'standard_na' | 'standard_re' | 'standard_n33' | 'standard_33' | 'import_service' | 'import_33_service' | 'import_n33_service' | 'import_reverse_charge_service' | 'import_goods' | 'import_33_goods' | 'import_n33_goods' | 'import_reverse_charge_goods' | 'import_mes' | 'import_gst_ds' | 'blocked' | 'exempt_purchase' | 'standard_additional' | 'ieps' | 'wht' — The allowed values depend on the country of the tax: ++++ <ul> <li> AE: <ul> <li>standard (5%)</li> <li>standard_additional(5%)</li> <li>reverse_charge (0%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> AU: <ul> <li>standard (10%, 5.5%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> EU: <ul> <li>standard (percentages country dependent)</li> <li>zero_rated (0%)</li> <li>reverse_charge (0%)</li> <li>intra_community (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> EU/IT: <ul> <li>standard</li> <li>zero_rated (0%)</li> <li>reverse_charge (0%)</li> <li>intra_community (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>bollo_virtuale (only at the invoice level and with mandatory amount: €2.00)</li> </ul> </li> <li> IN: <ul> <li>igst (28%, 18%, 12%, 5%, 3%, 0.25%)</li> <li>sgst (14%, 9%, 6%, 2.5%, 1.5%)</li> <li>cgst (14%, 9%, 6%, 2.5%, 1.5%)</li> <li>cess (any percentage)</li> <li>state_cess (any percentage)</li> <li>reverse_charge (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>zero_rated (0%)</li> </ul> </li> <li> JP: <ul> <li>standard (10%, 8%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> MX: <ul> <li>standard (16%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> <li>ieps</li> <li>wht</li> </ul> </li> <li> MY: <ul> <li>sales (5%, 10%) ⮕ LHDNM '01', Peppol 'T' <li>sales_zero (0%) ⮕ LHDNM '01', Peppol 'E' <li>service (6%, 8%) ⮕ LHDNM '02', Peppol 'T' <li>service_zero (0%) ⮕ LHDNM '02', Peppol 'E' <li>tourism (any amount) ⮕ LHDNM '03', Peppol 'T' <li>high_value_goods (any percentage) ⮕ LHDNM '04', Peppol 'T' <li>low_value_goods (10%) ⮕ LHDNM '05', Peppol 'T' <li>zero_rated (0%) ⮕ LHDNM '06', Peppol 'E' <li>exempt (0%) ⮕ LHDNM 'E', Peppol 'E' <li>export (0%) ⮕ LHDNM 'E', Peppol 'E' <li>outside_scope (0%) ⮕ LHDNM '06', Peppol 'O' </ul> </li> <li> NZ: <ul> <li>standard (15%)</li> <li>zero_rated (0%)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li> <li> SG: <table> <tr> <th>category</th> <th>percentage</th> <th>sales invoice</th> <th>purchase invoice</th> </tr> <tr> <td>standard</td> <td>9%</td> <td>SR</td> <td>TX</td> </tr> <tr> <td>outside_scope</td> <td>0%</td> <td>OS</td> <td>OP</td> </tr> <tr> <td>zero_rated</td> <td>0%</td> <td>ZR</td> <td>ZP</td> </tr> <tr> <td>not_registered</td> <td>0%</td> <td>NG</td> <td>NR</td> </tr> <tr> <td>deemed_supply</td> <td>9%</td> <td>DS</td> <td></td> </tr> <tr> <td>srca_c</td> <td>9%</td> <td>SRCA-C</td> <td></td> </tr> <tr> <td>srovr_rs</td> <td>9%</td> <td>SROVR-RS</td> <td></td> </tr> <tr> <td>srovr_lvg</td> <td>9%</td> <td>SROVR-LVG</td> <td></td> </tr> <tr> <td>srlvg</td> <td>9%</td> <td>SRLVG</td> <td></td> </tr> <tr> <td>srca_s</td> <td>0%</td> <td>SRCA-S</td> <td></td> </tr> <tr> <td>regulation33_exempt</td> <td>0%</td> <td>ES33</td> <td></td> </tr> <tr> <td>nonregulation33_exempt</td> <td>0%</td> <td>ESN33</td> <td></td> </tr> <tr> <td>export</td> <td>0%</td> <td>ZR</td> <td></td> </tr> <tr> <td>not_applicable</td> <td>0%</td> <td>NA</td> <td></td> </tr> <tr> <td>standard_ca (experimental)</td> <td>9%</td> <td></td> <td>TXCA</td> </tr> <tr> <td>standard_na (experimental)</td> <td>9%</td> <td></td> <td>TXNA</td> </tr> <tr> <td>standard_re (experimental)</td> <td>9%</td> <td></td> <td>TX-RE</td> </tr> <tr> <td>standard_n33 (experimental)</td> <td>9%</td> <td></td> <td>TX-N33</td> </tr> <tr> <td>standard_33 (experimental)</td> <td>9%</td> <td></td> <td>TX-ESS</td> </tr> <tr> <td>import_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-TS</td> </tr> <tr> <td>import_33_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-ESS</td> </tr> <tr> <td>import_n33_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-N33</td> </tr> <tr> <td>import_reverse_charge_service (experimental)</td> <td>9%</td> <td></td> <td>TXRC-RE</td> </tr> <tr> <td>import_goods (experimental)</td> <td>9%</td> <td></td> <td>IM</td> </tr> <tr> <td>import_33_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-ESS</td> </tr> <tr> <td>import_n33_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-N33</td> </tr> <tr> <td>import_reverse_charge_goods (experimental)</td> <td>9%</td> <td></td> <td>IM-RE</td> </tr> <tr> <td>import_mes (experimental)</td> <td>9%</td> <td></td> <td>ME</td> </tr> <tr> <td>import_gst_ds (experimental)</td> <td>9%</td> <td></td> <td>IGDS</td> </tr> <tr> <td>blocked (experimental)</td> <td>9%</td> <td></td> <td>BL</td> </tr> <tr> <td>exempt_purchase (experimental)</td> <td>0%</td> <td></td> <td>EP</td> </tr> </table> </li> <li> US: <ul> <li>standard (any percentage)</li> <li>exempt (0%)</li> <li>export (0%)</li> <li>outside_scope (0%)</li> </ul> </li></ul> ++++
          - `type` 'VAT' | 'GST' — The type of tax. This field is only used for receiving. For sending, the type is automatically determined from the country code and should not be supplied.
        - `additionalItemProperties` AdditionalItemProperty[] — An array of additional item properties.
          - `name` string — The free-text name of the property. Maps to UBL AdditionalItemProperty/Name and CII ApplicableProductCharacteristic/Description.
          - `value` string — The free-text value of the property. Maps to UBL AdditionalItemProperty/Value and CII ApplicableProductCharacteristic/Value.
          - `nameCode` string — Coded identifier for the property (FR-FE EXT-FR-FE-159). Must be a UN/EDIFACT 6313 code (https://service.unece.org/trade/untdid/d00a/tred/tred6313.htm). Maps to UBL AdditionalItemProperty/NameCode and CII ApplicableProductCharacteristic/TypeCode.
          - `valueQuantity` string — Numeric value of the measured property (FR-FE EXT-FR-FE-160). Maps to UBL AdditionalItemProperty/ValueQuantity and CII ApplicableProductCharacteristic/ValueMeasure.
          - `valueQuantityUnitCode` string — Unit of measure for `valueQuantity` (FR-FE EXT-FR-FE-161). Maps to UBL AdditionalItemProperty/ValueQuantity@unitCode and CII ApplicableProductCharacteristic/ValueMeasure@unitCode.
        - `lotNumberIds` string[] — An identifier for the production lot which the line items come from.
        - `note` string — A note to add to the line
      - `amountIncludingTax` number, required — Total amount including Tax.
      - `attachments` Attachment[] — An array of attachments. You may provide up to 10 attchments, but the total size must not exceed 100MB after Base64 encoding.
        - `document` string, required — The base64 encoded version of the document attachment.
        - `mimeType` 'text/csv' | 'application/pdf' | 'image/png' | 'image/jpeg' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/vnd.oasis.opendocument.spreadsheet', required — The document attachment mime type.
        - `filename` string — The name of the file attachment.
        - `description` string — A description for the file attachment.
        - `documentId` string — An id for the file attachment.
        - `primaryImage` boolean — DEPRECATED. Whether or not this document is a visual representation of the invoice data. Note that using value 'true' is discouraged, since the invoice data itself is leading, not the image, and including an image may lead to confusion. Peppol no longer allows including primary images.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/storecove/apis/storecove-api.md) · [All operations](https://skmtc.net/storecove/apis/storecove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/storecove/storecove-api/revisions/7f72642d80e6/schema)
