VRBL Elements Reference Guide

This section contains all the elements that you can use to build your documents.

Elements are the XML tags that provide that values that are used to fill fields in the e-invoice and credit note documents.

Using Element Reference Topics

Details are provided for each element in a Details table like this one:

DetailValue
NameThe name of the Element, for example: AccountingCost.
PathThe path where the Element is placed in the hierarchy. If an element is at Document or Line Level only, the path is listed here.
Document-Level PathThe Document-level path. This is used when an Element can be used at both the Document and Line Levels.
Line-Level PathThe Line-level path. This is used when an Element can be used at both the Document and Line Levels.
DefinitionA definition for the Element.
CardinalityThe cardinality of the Element, for example: 0..1.
DataTypeThe data type, where available, for example: Text.Type.

In This Section

TopicDescription
AccountingCostThe buyer's accounting code, applied to the Invoice as a whole, expressed as text.
AccountingCustomerPartyUse this element to model the a buyer's details.
AccountingSupplierPartyUse this element to model the supplier's information in an invoice or credit note.
AdditionalDocumentReferenceUse this element to model references to additional documents.
AllowanceChargeUse the AllowanceCharge element to model allowances and charges.
BillingReferenceUse this element to model billing reference information.
BuyerReferenceA reference provided by the buyer used for internal routing of the document.
CustomizationIDIdentifies a user-defined customization of UBL for a specific use.
DeliveryUse the Delivery element to model delivery information.
DeliveryTermsA set of delivery terms associated with this document.
DocumentCurrencyCodeA code signifying the default currency for this document.
IDAn identifier for this document, assigned by the sender.
InvoiceThe Invoice object is the highest level object in a Document.
InvoiceLineUse the InvoiceLine element to model a line in an invoice.
InvoiceNoteYou can add a note to a Document.
InvoicePeriodUse the InvoicePeriod element to model the time during which the invoice remains valid.
InvoiceTypeCodeA code signifying the type of the Document.
IssueDateThe date, assigned by the sender, on which this document was issued.
IssueTimeThe time, assigned by the sender, at which this document was issued.
ItemItems are the good or service that is sold on an invoice line or specified in a credit note.
ItemPriceExtensionUse this to model price extensions for an item.
LegalMonetaryTotalUse this element to specify the legal monetary total.
LineCountNumericThe number of lines in the document.
NoteFree-form text pertinent to this document, conveying information that is not contained explicitly in other structures.
OrderReferenceUse this element to model order reference information.
OriginatorDocumentReferenceA reference to an originator document associated with this document.
PartyThe Party element models a party's details.
PayeePartyUse the PayeeParty element to model the payee's information.
PaymentMeansUse this element to model the means of payment.
PaymentTermsUse the PaymentTerms element to model notes about the payment.
PrepaidPaymentsUse this element to model prepaid payments.
PriceUse the Price element to model the price of an item.
ProjectReferenceInformation about a project.
ProfileIDIdentifies a user-defined profile of the customization of UBL being used.
ShipmentUse this element to model shipping details.
StatementDocumentReferenceA reference to a Statement associated with this document.
SellerSupplierPartyThe seller.
TaxCategoryUse this element to specify Tax Category information.
TaxCurrencyCodeA code signifying the currency used for tax amounts in the Invoice.
TaxExchangeRateThe exchange rate between the document currency and the tax currency.
TaxPointDateThe date of the Invoice, used to indicate the point at which tax becomes applicable.
TaxRepresentativePartyThe tax representative.
TaxSchemeUse this element to model Tax Scheme information.
TaxSubtotalUse the Tax Subtotal object to model tax subtotals.
TaxTotalUse the Tax Total element to model the total amount of tax.
UBLExtensionsA container for extensions foreign to the document.
UBLVersionIDIdentifies the earliest version of the UBL 2 schema for this document type that defines all of the elements that might be encountered in the current instance.
WithholdingTaxTotalThe total withholding tax.