Element Usage Summary

Read this topic to get an overview of how elements are used. You can also use it for reference.

This topic lists the elements and Extensions that you can use.

Elements

The table here contains the following columns:

  • Element Name (Topic Reference): The name of the Element. It also links the Element's reference topic.
  • VRBL: A link to the topic in the VRBL: Modeling Overview section that covers this element. Almost all Elements have a corresponding topic there.
  • PEPPOL: A link to the topic in the PEPPOL: Modeling Overview section, if one exists. If you see a link here, it indicates that PEPPOL has some requirements that differ from core VRBL.
  • EN16931: A link to the topic in the EN 16931: Modeling Overview section, if one exists. If you see a link here. it indicates that EN 16931 has some requirements that differ from core VRBL.
  • Country-Specific Configuration Topic(s): If a country has some requirements for how the element is used. For example, if only specified values are allowed, a topic is linked here. If this list is too long for the table, it is noted in the Notes subsection below the table.

The Extensions section of this topic list the Extensions that you can use.

Document level

This table lists the elements that can be specified at the Document level:

Element Name (Topic Reference)VRBLPEPPOLEN16931Country-Specific Configuration Topic(s)
InvoiceNoneNoneNoneNone
CustomizationIDVRBL: Specification IDsNoneNoneNone
ProfileIDVRBL: Business Process TypesNoneNoneNone
IDVRBL: Invoice NumbersNoneNoneSpain B2G: Invoice Number
IssueDateVRBL: Issue DateNoneNoneJapan: Invoice Document Reference
DueDateVRBL: Payment Due DateNoneEN 16931: Payment Due Date and EN 16931: Document TotalsSerbia: Payment Due Date and Poland B2B: Payment Due Date and Poland B2B: General Payment Terms.
InvoiceTypeCodeVRBL: Invoice TypesPEPPOL: Invoice Type CodesEN 16931: Invoice Type CodesNote 1
InvoiceNoteVRBL: Invoice NoteEN 16931: Invoice NotesEN 16931: Invoice NotesNone
TaxPointDateVRBL: Tax Point DatesNoneNoneNone
DocumentCurrencyCodeVRBL: Invoice CurrencyNoneEN 16931: Document-Level Taxes in Document CurrencyPortugal: Tax Exchange Rate
TaxCurrencyCodeVRBL: Tax Accounting CurrencyNoneEN 16931: Document-Level Taxes in Accounting CurrencyJapan: Tax Accounting Currency
AccountingCostVRBL: Buyer Accounting ReferencesNoneNoneItaly: Accounting Reference and Portugal: Buyer Accounting Reference
BuyerReferenceVRBL: Buyer ReferencesPEPPOL: Buyer ReferenceNoneFrance: Buyer Reference and Germany B2G: German Buyer Reference (Leitweg-ID) and Italy: NSO Reference for Buyers and Serbia: Buyer Reference
InvoicePeriodVRBL: Invoicing PeriodNoneEN 16931: Invoicing PeriodSpain B2G: Correction Data
OrderReferenceVRBL: Sales and Order ReferencesPEPPOL: Order ReferenceNoneFrance: Order Reference and Netherlands: Order Line References
BillingReferenceVRBL: Preceding Document ReferenceNoneNoneNote 3.
DespatchDocumentReferenceVRBL: Dispatch Advice ReferencesNoneNoneNone
ReceiptDocumentReferenceVRBL: Receipt Advice ReferencesNoneNoneNone
OriginatorDocumentReferenceVRBL: Tender or Lot ReferenceNoneNoneItaly: Tender or Lot Reference
ContractDocumentReferenceVRBL: Contract ReferencesNoneNoneNone
AdditionalDocumentReferenceVRBL: Additional Document ReferencesNoneEN 16931: Attachments and EN 16931: Additional Supporting DocumentsNote 4
ProjectReferenceVRBL: Project ReferencesNoneNoneItaly: Project Reference and Portugal: Project Reference
AccountingSupplierPartyVRBL: SuppliersPEPPOL: PartiesEN 16931: Party Scheme IDs and EN 16931: Party Tax Registration IDs and EN 16931: Supplier InformationNote 5
AccountingCustomerPartyVRBL: BuyersPEPPOL: PartiesEN 16931: Party Scheme IDs and EN 16931: Party Tax Registration IDsNote 6
PayeePartyVRBL: PayeesNoneEN 16931: Party Scheme IDsNone
TaxRepresentativePartyVRBL: Tax RepresentativesNoneEN 16931: Party Tax Registration IDsNote 7
DeliveryVRBL: Delivery InformationNoneNoneNote 8
PaymentMeansVRBL: Payment MeansPEPPOL: Payment Mandate ReferenceEN 16931: Payment MeansNote 9
PaymentTermsVRBL: Payment TermsNoneEN 16931: Document TotalsNote 10.
PrepaidPaymentsVRBL: Prepaid PaymentsNoneNoneNone
AllowanceChargeVRBL: Allowances and VRBL: ChargesPEPPOL: Allowances and ChargesEN 16931: Document-Level Allowances and EN 16931: Document-Level ChargesNote 11
TaxTotalVRBL: Tax Totals and Subtotals and VRBL: Tax Categories and SchemesPEPPOL: Tax ExemptionsNoneNote 12
LegalMonetaryTotalVRBL: Legal Monetary Totals and VRBL: RoundingNoneEN 16931: Document TotalsNone
DeliveryTermsVRBL: Delivery InformationNoneNoneMalaysia: Incoterm and Poland B2B: Delivery Terms Identifier
IssueTimeVRBL: Issue TimeNoneNoneMalaysia: Invoice Issue Time and Japan: Invoice Issue Time
TaxExchangeRateVRBL: Tax Exchange RatesNoneNoneNote 13
UUIDVRBL: Universally Unique Identifier (UUID)NoneNoneMalaysia: Original e-Invoice Reference
and Saudi Arabia: UUIDs
WithholdingTaxTotalVRBL: Withholding TaxesNoneNoneNote 14

Notes

  1. The following country-specific configurations exist for the InvoiceTypeCode element:
  1. The following country-specific configurations exist for the BillingReference topic:
  1. The following country-specific configurations are available for the AdditionalDocumentReference element:
  1. The following country-specific configurations are available for Suppliers:
  1. The following country-specific configurations exist for the AccountingCustomerParty element:
  1. The following country-specific configurations exist for the TaxRepresentativeParty element:
  1. The following country-specific configurations exist for the Delivery element:
  1. The following country-specific configurations exist for the PaymentMeans element:
  1. The following country-specific configurations exist for the PaymentTerms element:
  1. The following country-specific configurations exist for the AllowanceCharge element:
  1. The following country-specific configurations exist for the TaxTotal element:
  1. The following country-specific configurations exist for the TaxExchangeRate element:
  1. The following country-specific configurations exist for the WithholdingTaxTotal element:

Invoice level

The following table lists the elements that can be specified at line level:

Element Name (Topic Reference)VRBLPEPPOLEN16931Country-Specific Configuration Topic(s)
InvoiceLineVRBL: Invoice LinesNoneEN 16931: Line-Level InformationNone
InvoiceLine/IDVRBL: Invoice Line IDsNoneNoneNone
NoteVRBL: Invoice NotesNoneNoneNone
InvoicedQuantityVRBL: Invoiced QuantitiesNoneNoneJapan: Invoiced Quantity for Returns and Spain B2G: Invoiced Quantity
LineExtensionAmountVRBL: Invoice Line Net AmountsNoneNoneNone
InvoiceLine/Accounting CostVRBL: Buyer Accounting ReferencesNoneNoneItaly: Buyer Accounting Reference and Portugal: Buyer Accounting Reference (Invoice Line)
InvoiceLine/InvoicePeriodVRBL: Invoicing PeriodNoneNoneNone
OrderLineReferenceVRBL: Sales and Order ReferencesNoneNoneNetherlands: Order Line References
DespatchLineReferenceVRBL: Dispatch Advice ReferencesNoneNoneNone
DocumentReferenceVRBL: Line-Level Document ReferenceNoneNoneJapan: Line-Level Document Reference
InvoiceLine/AllowanceChargeVRBL: Allowances and VRBL: ChargesPEPPOL: Allowances and ChargesEN 16931: Line-Level Allowance and EN 16931: Line-Level ChargesSpain B2G: Line-Level Allowances and Spain B2G: Line-Level Charges
Item/DescriptionNoneNoneNoneNone
Item/NameNoneNoneNoneNone
BuyersItemIdentificationVRBL: Buyer Item IDNoneNoneNone
SellersItemIdentificationVRBL: Supplier's Item IDNoneNoneNone
StandardItemIdentificationVRBL: Standard Item IDsNoneNonePoland B2B: Global Trade Item Number
OriginCountryVRBL: Country of OriginNoneNoneNone
CommodityClassificationVRBL: Commodity ClassificationNoneEN 16931: Commodity ClassificationPoland B2B: Item Classification Identifier
ClassifiedTaxCategoryVRBL: Line-Level Tax InformationNoneEN 16931: Line-Level Tax InformationSerbia: Tax Information (Line Level) and Poland B2B: Line-Level Tax Information
AdditionalItemPropertyVRBL: Item AttributesNoneNoneNone
PriceDetailsVRBL: Price DetailsNoneNoneNone
InvoiceLine/UUIDVRBL: Universally Unique Identifier (UUID)NoneNonePoland B2B: Invoice Line UUID

Extensions

The following table list the Extensions and associated configuration topics:

Extension Name (Reference Topic)Country-Specific Topic(s)Description
AdditionalData (Extn)Italy: Additional Data and Italy: Tax Exemption Reason Code (Invoice Lines)Use this Extension to specify additional data for specific use cases for Italy.
AdditionalProperty (Extn)Poland B2B: Additional PropertyUsed to add additional information in Polish B2B documents.
AccountingSupplierPartyExtension (Extn)Italy: Supplier's Professional Register DetailsUsed in Italy to model the Supplier's professional registration details.
AllowanceChargeExtension (Extn)Italy: Social Security Administration Reference and Italy: Withholding Tax Type Code and Italy: Social Security Organization CodeUse this extension to model specific allowance charges for Italy.
Article73Indicator (Extn)Italy: Article 73 IndicatorUsed in Italian documents to specify whether Article 73 applies or not.
BaseCapital (Extn)Italy: Supplier's Base CapitalUsed in Italy to specify the supplier's base capital.
BelowMarketValueSupplyIndicator (Extn)Poland B2B: Below Market Value Supply IndicatorUsed to indicate if a transaction is being supplied below market value.
BillingSoftware (Extn)Portugal: Billing SoftwareUsed in Portugal to specify the software that is used for billing and is referenced in Portuguese documents.
BusinessRegistrationProvinceCode (Extn)Italy: Province for Supplier's BusinessUsed to specify the Italian province where the supplier's business is registered.
CashAccountingIndicator (Extn)Poland B2B: Supplier Cash Accounting IndicatorUsed to specify if a supplier is using cash accounting in Poland.
CorrectionReason (Extn)Taiwan: Correction ReasonUse this Extension to specify a reason for a correction in Taiwanese Documents.
Description (Extn)Portugal: Withholding Tax TotalUsed to provide a description for withheld tax in Portugal.
DigitalStampAmount (Extn)Italy: Digital StampsUsed in Italy to specify the amount for digital stamps.
DigitalStampIndicator (Extn)Italy: Digital StampsUsed in Italy to indicate whether a digital stamp applies.
DocumentReferenceExtension (Extn)Portugal: Document Reference IDUsed to reference the Commitment Document (Número do compromisso) in Portuguese documents.
IncidentalCosts (Extn)Italy: Incidental CostsUsed to specify incidental costs in Italy.
InstallationSerialNumber (Extn)Greece: Installation Serial NumberUsed to specify the Installation Serial Number in Greek documents.
InvoiceDocumentReferenceExtension (Extn)Poland B2B: Preceding Invoice ReferenceUse this extension to document the correction method and reason for Poland.
InvoicedPrepaymentAmount (Extn)Serbia: Advanced Payment InformationUse to specify advanced payments in Serbian documents.
InvoiceSeries (Extn)Greece: Invoice SeriesUse to specify the Invoice Series in Greek documents.
InvoiceSubtypeCode (Extn)Greece: Invoice Subtype CodeUsed to specify Invoice Sub-Type Codes for Greece.
LegalMonetaryTotal (Extn)Serbia: Legal Monetary Totals (for Reduced Totals)Used to specify legal monetary totals for reduced tax totals in Serbia.
LegalMonetaryTotalInTaxCurrency (Extn)Spain B2G: Document Totals in Tax CurrencyA group of elements providing the monetary totals for the invoice in tax currency.
NominalInvoiceIndicator (Extn)Saudi Arabia: Nominal Invoice IndicatorUsed to indicate if an invoice is a nominal invoice.
PayeePartyExtension (Extn)Italy: Payee DataUsed to specify Payee data in Italy.
PaymentMeansExtension (Extn)Portugal: ATM Payment EntityUsed to specify information about ATM payments in Portugal.
PaymentReasonCode (Extn)Italy: Payment Reason CodeUsed to specify a payment reason code in Italy.
PaymentTermsCode (Extn)Italy: Payment Terms CodeUse to specify the Payment Terms code in Italy.
PaymentTermsStartDate (Extn)Italy: Payment Terms Start DateUsed to specify the start date for payment terms in Italy.
PriceAmountBeforeAllowanceCharge (Extn)Poland B2B: Item Gross Price and Italy: Item Gross PriceUsed to specify gross item information in Italy.
ProfessionalRegister (Extn)Italy: Supplier's Professional Register DetailsUsed to specify a supplier's professional details in Italy.
ReducedTotals (Extn)Serbia: Reduced Tax TotalsUsed to specify reduced totals in Serbian documents.
RoundingAmount (Extn)Italy: Rounding AmountUsed in Italy to specify rounding amounts.
RoutingDetails (Extn)VRBL: Sender ID and VRBL: Receiver IDs and VRBL: Receiver DetailsUsed in all countries to specify Sender and Receiver IDs.
SdIReceiverCode (Extn)Italy: SDI Receiver CodeUsed in Italy to specify the SdI Receiver code.
SimplifiedInvoiceIndicator (Extn)Saudi Arabia: Simplified Invoice IndicatorUsed to indicate if an invoice is a simplified invoice.
SummaryInvoiceIndicator (Extn)Saudi Arabia: Summary Invoice IndicatorUsed to indicate if an invoice is a summary invoice.
ThirdPartyIndicator (Extn)Saudi Arabia: Third Party Invoice IndicatorUsed to indicate if a Document was issued by a third party.
ThirdPartyPayment (Extn)Germany B2G: Third-Party PaymentsUse this extension to model third-party payments in Germany.
TaxExemptionIndicator (Extn)Poland B2B: Supplier Tax Exemption IndicatorUse this extension to indicate if a Polish transaction is exempt from tax.
TransferOrServiceTypeCode (Extn)Italy: Transfer or Service Type CodeUse to specify the Transfer or Service Type Code that is used in Italian documents.
TransmissionFormatCode (Extn)Italy: Transmission Format CodeUse this to model the transmission format code in Italy.
TypeCode (Extn)Italy: Withholding Tax Type CodeUsed to specify the Withholding Tax Type code in Italy.
VatMechanism (Extn)Italy: VAT Mechanism and Poland B2B: VAT MechanismUsed in Italy and Poland to model VAT mechanism information.
VehicleDetails (Extn)Italy: Vehicle DetailsUse in Italy to specify details about vehicles.
WithholdingIndicator (Extn)Italy: Social Security Withholding IndicatorUsed to model information about withholding tax in Italy.