Invoice Request

Complete field reference for the InvoiceDocument schema.

The InvoiceDocument schema (@type = "InvoiceDocument") is used with the Send a document from a JSON structure endpoint.

InvoiceDocument

Field	Type	Description
`accountingCurrency`	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`additionalIdentifiers`	`object`	Escape-hatch for format-specific identifiers not yet mapped to a typed field. Empty if none.
	`Attachment[]`	BG-24 — Embedded supporting documents / binary attachments (e.g. a PDF rendition). Empty if none.
`content`required	`string`	BG-24 embedded binary content, Base64-encoded (BT-125)
`contentType`required	`string`	BG-24 attachment MIME type — must be application/pdf for v1.0
`description`	`string`	BG-24 human-readable document description (BT-123)
`filename`required	`string`	BG-24 attachment file name (e.g. invoice-2026-001.pdf)
`businessProcessType`	`string`	BT-23 — Business process type the invoice belongs to.
required	`Party`
`additionalLegalInfo`	`string`	BT-33 — Additional legal information about the party (e.g. share capital, legal form).
required	`Address`
`additionalStreet`	`string`	BT-162 / BT-163 — Additional address line.
`city`required	`string`	BT-37 (seller) / BT-52 (buyer) — City / town.
`countryCode`required	`string`	ISO 3166-1 alpha-2 country code (BT-40, BT-55, BT-159). Serialized in JSON as the two-letter country code, which is the enum constant name, e.g. "LU", "DE", "FR".
`countrySubdivision`	`string`	BT-39 (seller) / BT-54 (buyer) — Country subdivision (region / state / province).
`postCode`required	`string`	BT-38 (seller) / BT-53 (buyer) — Post code / ZIP.
`street1`required	`string`	BT-35 (seller) / BT-50 (buyer) — Address line 1 (street and number).
`street2`	`string`	BT-36 / BT-51 — Address line 2.
	`Contact`
`email`	`string`	BT-43 (seller) / BT-58 (buyer) — Contact email address.
`name`	`string`	BT-41 (seller) / BT-56 (buyer) — Contact point name.
`telephone`	`string`	BT-42 (seller) / BT-57 (buyer) — Contact telephone number.
`electronicAddress`required	`string`	BT-34 (seller) / BT-49 (buyer) — Electronic address: the Peppol participant value, paired with electronicAddressSchemeId.
`electronicAddressSchemeId`required	`string`	Peppol EAS (Electronic Address Scheme, iso6523-actorid-upis) code list identifying the scheme of a participant's electronic address. Serialized in JSON as the numeric EAS code, e.g. "9938" = LU:VAT, "0211" = IT:IVA, "0235" = AE:TIN, "0088" = GLN; for backward compatibility the enum constant name (colon replaced by underscore, e.g. "LU_VAT") is also accepted on deserialization.
`identifier`	`string`	BT-29 (seller) / BT-46 (buyer) — Party identifier (with optional scheme).
`legalRegistrationId`	`string`	BT-30 (seller) / BT-47 (buyer) — Legal registration identifier (e.g. commercial register no.).
`name`required	`string`	BT-27 (seller) / BT-44 (buyer) — Party legal name.
`taxRegistration`	`string`	BT-32 — Seller tax registration identifier (where a non-VAT tax number applies).
`tradingName`	`string`	BT-28 (seller) / BT-45 (buyer) — Trading name, if different from the legal name.
`vatId`required	`string`	BT-31 (seller) / BT-48 (buyer) — VAT identifier.
`buyerAccountingReference`	`string`	BT-19 — Buyer accounting reference (e.g. accounting cost / GL account).
`buyerReference`	`string`	BT-10 — Buyer reference (e.g. cost centre); often mandatory for B2G.
`contractReference`	`string`	BT-12 — Contract reference.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
	`Delivery`
	`Address`
`additionalStreet`	`string`	BT-162 / BT-163 — Additional address line.
`city`required	`string`	BT-37 (seller) / BT-52 (buyer) — City / town.
`countryCode`required	`string`	ISO 3166-1 alpha-2 country code (BT-40, BT-55, BT-159). Serialized in JSON as the two-letter country code, which is the enum constant name, e.g. "LU", "DE", "FR".
`countrySubdivision`	`string`	BT-39 (seller) / BT-54 (buyer) — Country subdivision (region / state / province).
`postCode`required	`string`	BT-38 (seller) / BT-53 (buyer) — Post code / ZIP.
`street1`required	`string`	BT-35 (seller) / BT-50 (buyer) — Address line 1 (street and number).
`street2`	`string`	BT-36 / BT-51 — Address line 2.
`deliveryDate`	`date`	BG-13 actual delivery date (BT-72)
`locationIdentifier`	`string`	BG-13 deliver-to location identifier (BT-71)
`locationIdentifierSchemeId`	`string`	BG-13 deliver-to location identifier scheme (BT-71-1)
`partyName`	`string`	BG-13 deliver-to party name (BT-70)
`despatchAdviceReference`	`string`	BT-16 — Despatch advice reference.
`documentId`required	`string`	BT-1 — Invoice number. Unique identifier of the invoice from the sender.
	`Allowance[]`	BG-20 — Document-level allowances (discounts). Empty if none.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`percentage`	`number`	BG-20/BG-27 allowance percentage (BT-94 / BT-138)
`reasonCode`	`string`	BG-20/BG-27 allowance reason code (BT-98 / BT-140)
`reasonText`	`string`	BG-20/BG-27 allowance reason text (BT-97 / BT-139)
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`	`number`	BG-20/BG-27 allowance VAT rate (BT-96)
	`Charge[]`	BG-21 — Document-level charges (fees). Empty if none.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`percentage`	`number`	BG-21/BG-28 charge percentage (BT-101 / BT-143)
`reasonCode`	`string`	BG-21/BG-28 charge reason code (BT-105 / BT-145)
`reasonText`	`string`	BG-21/BG-28 charge reason text (BT-104 / BT-144)
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`	`number`	BG-21/BG-28 charge VAT rate (BT-103)
`dueDate`	`date`	BT-9 — Payment due date.
	`FacturXExtensions`
`profile`required	`string`	Factur-X / ZUGFeRD 2.x conformance profile, in increasing order of completeness: MINIMUM, BASIC_WL (basic without invoice lines), BASIC, EN16931 (EN 16931 compliant), EXTENDED.
`renderHumanReadablePdf`	`boolean`	Whether to render a human-readable PDF representation of the invoice.
	`FatturaPaExtensions`
`codiceDestinatario`	`string`	Recipient SDI destination code (Codice Destinatario) for routing the invoice through the Sistema di Interscambio.
`codiceFiscaleSender`	`string`	Sender's Italian fiscal code (Codice Fiscale).
	`FatturaPaContractRef`
`codiceCIG`	`string`	Tender identification code (CodiceCIG), mandatory for public-administration invoices.
`codiceCUP`	`string`	Single project code (CodiceCUP), mandatory for public-administration invoices.
`data`required	`date`	Contract date (Data).
`idDocumento`required	`string`	Contract document identifier (IdDocumento).
	`FatturaPaDdtRef`
`dataDdt`required	`date`	Transport document date (DataDDT).
`numeroDdt`required	`string`	Transport document number (NumeroDDT).
`esigibilitaIVA`	`string`	FatturaPA EsigibilitaIVA code list defining the VAT chargeability point: I (immediate), D (deferred), or S (split payment / scissione dei pagamenti).
`modalitaPagamento`	`string`	FatturaPA ModalitaPagamento code list (MP01..MP23) identifying the Italian payment method.
`naturaPerTaxBreakdown`	`string[]`	VAT-exemption nature codes (Natura, N1..N7) applied per tax breakdown line, mandatory when the VAT rate is zero.
`pecDestinatario`	`string`	Recipient certified e-mail address (PEC) used as an alternative delivery channel when no Codice Destinatario applies.
`regimeFiscale`required	`string`	FatturaPA RegimeFiscale code list (RF01..RF19) identifying the sender's Italian tax regime.
`splitPayment`	`boolean`	Whether split payment (scissione dei pagamenti) applies, meaning the buyer pays VAT directly to the tax authority.
`tipoDocumento`required	`string`	FatturaPA TipoDocumento code list (TD01..TD29) identifying the Italian SDI document type. Reference: Agenzia delle Entrate, FatturaPA v1.9 (April 2025).
`invoicedObjectIdentifier`	`string`	BT-18 — Invoiced object identifier.
`issueDate`required	`date`	BT-2 — Invoice issue date.
required	`LineItem[]`	BG-25 — Invoice lines. At least one line is required.
	`Allowance[]`	BG-27 — Invoice line allowances (discounts). Empty if none.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`percentage`	`number`	BG-20/BG-27 allowance percentage (BT-94 / BT-138)
`reasonCode`	`string`	BG-20/BG-27 allowance reason code (BT-98 / BT-140)
`reasonText`	`string`	BG-20/BG-27 allowance reason text (BT-97 / BT-139)
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`	`number`	BG-20/BG-27 allowance VAT rate (BT-96)
	`NameValue[]`	BG-32 — Item attributes (additional name/value characteristics). Empty if none.
`name`required	`string`	Attribute name / item property name (BT-160)
`value`required	`string`	Attribute value / item property value (BT-161)
`buyerAccountingRef`	`string`	BT-133 — Invoice line buyer accounting reference.
`buyerItemId`	`string`	BT-156 — Buyer's item identifier.
	`Charge[]`	BG-28 — Invoice line charges (fees). Empty if none.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`percentage`	`number`	BG-21/BG-28 charge percentage (BT-101 / BT-143)
`reasonCode`	`string`	BG-21/BG-28 charge reason code (BT-105 / BT-145)
`reasonText`	`string`	BG-21/BG-28 charge reason text (BT-104 / BT-144)
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`	`number`	BG-21/BG-28 charge VAT rate (BT-103)
`classificationId`	`string`	BT-158 — Item classification identifier (e.g. CPV / UNSPSC).
`countryOfOrigin`	`string`	ISO 3166-1 alpha-2 country code (BT-40, BT-55, BT-159). Serialized in JSON as the two-letter country code, which is the enum constant name, e.g. "LU", "DE", "FR".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`id`required	`string`	BT-126 — Invoice line identifier.
`itemDescription`	`string`	BT-154 — Item description.
`itemName`required	`string`	BT-153 — Item name.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`note`	`string`	BT-127 — Invoice line note (free text).
`objectIdentifier`	`string`	BT-128 — Invoice line object identifier.
`periodEnd`	`date`	BT-135 — Invoice line period end date.
`periodStart`	`date`	BT-134 — Invoice line period start date.
`priceBaseQuantity`	`number`	BT-149 — Item price base quantity (number of units the price applies to).
`priceBaseQuantityUnit`	`string`	UN/ECE Recommendation 20 unit of measure code (BT-130, BT-150), e.g. C62 piece, HUR hour, KGM kilogram, MTR metre. Serialized in JSON as the Rec 20 code, which is the enum constant name, e.g. "C62", "HUR".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`purchaseOrderLineRef`	`string`	BT-132 — Referenced purchase order line.
`quantity`required	`number`	BT-129 — Invoiced quantity.
`sellerItemId`	`string`	BT-155 — Seller's item identifier.
`standardItemId`	`string`	BT-157 — Item standard identifier (with scheme, e.g. GTIN).
`unitCode`required	`string`	UN/ECE Recommendation 20 unit of measure code (BT-130, BT-150), e.g. C62 piece, HUR hour, KGM kilogram, MTR metre. Serialized in JSON as the Rec 20 code, which is the enum constant name, e.g. "C62", "HUR".
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`required	`number`	BT-152 — Invoiced item VAT rate (percentage).
`note`	`string`	BT-22 — Invoice note (free-text remarks).
	`PaymentInfo`
	`BankAccount[]`	BG-17 credit-transfer bank accounts (BT-84..86); empty when not applicable
`accountName`	`string`	Payment account name (BT-85)
`bic`	`string`	Payment service provider identifier / BIC (BT-86)
`iban`required	`string`	Payment account identifier / IBAN for credit transfer (BT-84)
`paymentMeansCode`required	`string`	UNCL4461 payment means code (BT-81), e.g. 30 credit transfer, 58 SEPA credit transfer, 48 card, 49 direct debit. Serialized in JSON as the enum constant name (e.g. "CREDIT_TRANSFER", "SEPA_CREDIT_TRANSFER"); the numeric code is exposed separately via code().
`paymentMeansText`	`string`	BG-16 payment means text (BT-82)
`remittanceInformation`	`string`	BG-16 remittance / payment reference (BT-83)
`paymentTermsText`	`string`	BT-20 — Payment terms in free text.
	`PeppolExtensions`
`profileIdOverride`	`string`	Optional override for the PEPPOL profile identifier.
`receiverSchemeIdOverride`	`string`	Peppol EAS (Electronic Address Scheme, iso6523-actorid-upis) code list identifying the scheme of a participant's electronic address. Serialized in JSON as the numeric EAS code, e.g. "9938" = LU:VAT, "0211" = IT:IVA, "0235" = AE:TIN, "0088" = GLN; for backward compatibility the enum constant name (colon replaced by underscore, e.g. "LU_VAT") is also accepted on deserialization.
`senderSchemeIdOverride`	`string`	Peppol EAS (Electronic Address Scheme, iso6523-actorid-upis) code list identifying the scheme of a participant's electronic address. Serialized in JSON as the numeric EAS code, e.g. "9938" = LU:VAT, "0211" = IT:IVA, "0235" = AE:TIN, "0088" = GLN; for backward compatibility the enum constant name (colon replaced by underscore, e.g. "LU_VAT") is also accepted on deserialization.
`precedingInvoiceDate`	`date`	BT-26 — Preceding invoice issue date.
`precedingInvoiceReference`	`string`	BT-25 — Preceding invoice reference (the invoice number this one corrects/relates to).
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`projectReference`	`string`	BT-11 — Project reference.
`purchaseOrderReference`	`string`	BT-13 — Purchase order reference.
`receivingAdviceReference`	`string`	BT-15 — Receiving advice reference.
`salesOrderReference`	`string`	BT-14 — Sales order reference.
required	`Party`
`additionalLegalInfo`	`string`	BT-33 — Additional legal information about the party (e.g. share capital, legal form).
required	`Address`
`additionalStreet`	`string`	BT-162 / BT-163 — Additional address line.
`city`required	`string`	BT-37 (seller) / BT-52 (buyer) — City / town.
`countryCode`required	`string`	ISO 3166-1 alpha-2 country code (BT-40, BT-55, BT-159). Serialized in JSON as the two-letter country code, which is the enum constant name, e.g. "LU", "DE", "FR".
`countrySubdivision`	`string`	BT-39 (seller) / BT-54 (buyer) — Country subdivision (region / state / province).
`postCode`required	`string`	BT-38 (seller) / BT-53 (buyer) — Post code / ZIP.
`street1`required	`string`	BT-35 (seller) / BT-50 (buyer) — Address line 1 (street and number).
`street2`	`string`	BT-36 / BT-51 — Address line 2.
	`Contact`
`email`	`string`	BT-43 (seller) / BT-58 (buyer) — Contact email address.
`name`	`string`	BT-41 (seller) / BT-56 (buyer) — Contact point name.
`telephone`	`string`	BT-42 (seller) / BT-57 (buyer) — Contact telephone number.
`electronicAddress`required	`string`	BT-34 (seller) / BT-49 (buyer) — Electronic address: the Peppol participant value, paired with electronicAddressSchemeId.
`electronicAddressSchemeId`required	`string`	Peppol EAS (Electronic Address Scheme, iso6523-actorid-upis) code list identifying the scheme of a participant's electronic address. Serialized in JSON as the numeric EAS code, e.g. "9938" = LU:VAT, "0211" = IT:IVA, "0235" = AE:TIN, "0088" = GLN; for backward compatibility the enum constant name (colon replaced by underscore, e.g. "LU_VAT") is also accepted on deserialization.
`identifier`	`string`	BT-29 (seller) / BT-46 (buyer) — Party identifier (with optional scheme).
`legalRegistrationId`	`string`	BT-30 (seller) / BT-47 (buyer) — Legal registration identifier (e.g. commercial register no.).
`name`required	`string`	BT-27 (seller) / BT-44 (buyer) — Party legal name.
`taxRegistration`	`string`	BT-32 — Seller tax registration identifier (where a non-VAT tax number applies).
`tradingName`	`string`	BT-28 (seller) / BT-45 (buyer) — Trading name, if different from the legal name.
`vatId`required	`string`	BT-31 (seller) / BT-48 (buyer) — VAT identifier.
required	`TaxBreakdown[]`	BG-23 — VAT breakdown per category/rate. At least one entry is required.
`categoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`exemptionReasonCode`	`string`	BT-121 — VAT exemption reason code.
`exemptionReasonText`	`string`	BT-120 — VAT exemption reason text.
`rate`required	`number`	BT-119 — VAT category rate (percentage).
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`tenderOrLotReference`	`string`	BT-17 — Tender or lot reference.
`typeCode`required	`string`	UN/CEFACT 1001 document type code (BT-3), e.g. 380 commercial invoice, 381 credit note, 384 corrected invoice, 386 prepayment invoice, 389 self-billed invoice. Serialized in JSON as the enum constant name (e.g. "COMMERCIAL_INVOICE", "CREDIT_NOTE"); the numeric code is exposed separately via code().
`vatPointDate`	`date`	BT-7 — VAT point date: the date when VAT becomes accountable.
`vatPointDateCode`	`string`	BT-8 — VAT point date code, when the VAT point is expressed as a code instead of a date.
	`XRechnungExtensions`
`b2gMode`	`boolean`	Whether to enable German B2G mode.
	`LeitwegId`
`value`required	`string`	The Leitweg-ID value, e.g. 04011000-12345-37.

Party

BG-7 — Buyer (Cessionario / Committente).

Field	Type	Description
`additionalLegalInfo`	`string`	BT-33 — Additional legal information about the party (e.g. share capital, legal form).
required	`Address`
`additionalStreet`	`string`	BT-162 / BT-163 — Additional address line.
`city`required	`string`	BT-37 (seller) / BT-52 (buyer) — City / town.
`countryCode`required	`string`	ISO 3166-1 alpha-2 country code (BT-40, BT-55, BT-159). Serialized in JSON as the two-letter country code, which is the enum constant name, e.g. "LU", "DE", "FR".
`countrySubdivision`	`string`	BT-39 (seller) / BT-54 (buyer) — Country subdivision (region / state / province).
`postCode`required	`string`	BT-38 (seller) / BT-53 (buyer) — Post code / ZIP.
`street1`required	`string`	BT-35 (seller) / BT-50 (buyer) — Address line 1 (street and number).
`street2`	`string`	BT-36 / BT-51 — Address line 2.
	`Contact`
`email`	`string`	BT-43 (seller) / BT-58 (buyer) — Contact email address.
`name`	`string`	BT-41 (seller) / BT-56 (buyer) — Contact point name.
`telephone`	`string`	BT-42 (seller) / BT-57 (buyer) — Contact telephone number.
`electronicAddress`required	`string`	BT-34 (seller) / BT-49 (buyer) — Electronic address: the Peppol participant value, paired with electronicAddressSchemeId.
`electronicAddressSchemeId`required	`string`	Peppol EAS (Electronic Address Scheme, iso6523-actorid-upis) code list identifying the scheme of a participant's electronic address. Serialized in JSON as the numeric EAS code, e.g. "9938" = LU:VAT, "0211" = IT:IVA, "0235" = AE:TIN, "0088" = GLN; for backward compatibility the enum constant name (colon replaced by underscore, e.g. "LU_VAT") is also accepted on deserialization.
`identifier`	`string`	BT-29 (seller) / BT-46 (buyer) — Party identifier (with optional scheme).
`legalRegistrationId`	`string`	BT-30 (seller) / BT-47 (buyer) — Legal registration identifier (e.g. commercial register no.).
`name`required	`string`	BT-27 (seller) / BT-44 (buyer) — Party legal name.
`taxRegistration`	`string`	BT-32 — Seller tax registration identifier (where a non-VAT tax number applies).
`tradingName`	`string`	BT-28 (seller) / BT-45 (buyer) — Trading name, if different from the legal name.
`vatId`required	`string`	BT-31 (seller) / BT-48 (buyer) — VAT identifier.

LineItem

BG-25 — Invoice lines. At least one line is required.

Field	Type	Description
	`Allowance[]`	BG-27 — Invoice line allowances (discounts). Empty if none.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`percentage`	`number`	BG-20/BG-27 allowance percentage (BT-94 / BT-138)
`reasonCode`	`string`	BG-20/BG-27 allowance reason code (BT-98 / BT-140)
`reasonText`	`string`	BG-20/BG-27 allowance reason text (BT-97 / BT-139)
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`	`number`	BG-20/BG-27 allowance VAT rate (BT-96)
	`NameValue[]`	BG-32 — Item attributes (additional name/value characteristics). Empty if none.
`name`required	`string`	Attribute name / item property name (BT-160)
`value`required	`string`	Attribute value / item property value (BT-161)
`buyerAccountingRef`	`string`	BT-133 — Invoice line buyer accounting reference.
`buyerItemId`	`string`	BT-156 — Buyer's item identifier.
	`Charge[]`	BG-28 — Invoice line charges (fees). Empty if none.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`percentage`	`number`	BG-21/BG-28 charge percentage (BT-101 / BT-143)
`reasonCode`	`string`	BG-21/BG-28 charge reason code (BT-105 / BT-145)
`reasonText`	`string`	BG-21/BG-28 charge reason text (BT-104 / BT-144)
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`	`number`	BG-21/BG-28 charge VAT rate (BT-103)
`classificationId`	`string`	BT-158 — Item classification identifier (e.g. CPV / UNSPSC).
`countryOfOrigin`	`string`	ISO 3166-1 alpha-2 country code (BT-40, BT-55, BT-159). Serialized in JSON as the two-letter country code, which is the enum constant name, e.g. "LU", "DE", "FR".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`id`required	`string`	BT-126 — Invoice line identifier.
`itemDescription`	`string`	BT-154 — Item description.
`itemName`required	`string`	BT-153 — Item name.
required	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`note`	`string`	BT-127 — Invoice line note (free text).
`objectIdentifier`	`string`	BT-128 — Invoice line object identifier.
`periodEnd`	`date`	BT-135 — Invoice line period end date.
`periodStart`	`date`	BT-134 — Invoice line period start date.
`priceBaseQuantity`	`number`	BT-149 — Item price base quantity (number of units the price applies to).
`priceBaseQuantityUnit`	`string`	UN/ECE Recommendation 20 unit of measure code (BT-130, BT-150), e.g. C62 piece, HUR hour, KGM kilogram, MTR metre. Serialized in JSON as the Rec 20 code, which is the enum constant name, e.g. "C62", "HUR".
	`Money`
`amount`required	`number`	Monetary amount. Up to 2 decimals for totals, up to 4 for unit prices / tax bases.
`currency`required	`string`	ISO 4217 currency code (BT-5, BT-6). Serialized in JSON as the three-letter ISO 4217 alphabetic code, which is the enum constant name, e.g. "EUR", "USD", "CHF".
`purchaseOrderLineRef`	`string`	BT-132 — Referenced purchase order line.
`quantity`required	`number`	BT-129 — Invoiced quantity.
`sellerItemId`	`string`	BT-155 — Seller's item identifier.
`standardItemId`	`string`	BT-157 — Item standard identifier (with scheme, e.g. GTIN).
`unitCode`required	`string`	UN/ECE Recommendation 20 unit of measure code (BT-130, BT-150), e.g. C62 piece, HUR hour, KGM kilogram, MTR metre. Serialized in JSON as the Rec 20 code, which is the enum constant name, e.g. "C62", "HUR".
`vatCategoryCode`required	`string`	UNCL5305 VAT category code (BT-118, BT-151), e.g. S standard rate, Z zero rated, E exempt, AE reverse charge, K intra-community supply, G free export, O outside scope, L Canary Islands IGIC, M Ceuta and Melilla (plus PINT MY jurisdiction codes). Serialized in JSON as the category code, which is the enum constant name, e.g. "S", "AE".
`vatRate`required	`number`	BT-152 — Invoiced item VAT rate (percentage).