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.

Document level elements

The following elements are or can be defined at the Document level:

TopicDescription
InvoiceThe Invoice object is the highest level object in a Document.
General Invoice Information
CustomizationIDThe Specification ID is used for routing.
ProfileIDYou must specify the same Profile ID for all Documents.
IDYou can specify a number for your Document, such as an invoice number.
IssueDateYou can specify the date the Document is issued.
DueDateYou can add the date payment is due to your Documents.
InvoiceTypeCodeDocuments can be of one of various invoice types that you need to specify.
InvoiceNoteYou can add a textual reference or note to your Documents.
TaxPointDateYou can add Tax Point date to your Documents.
DocumentCurrencyCodeYou can specify a currency for your Document.
TaxCurrencyCodeYou can add a Tax Accounting currency.
AccountingCostYou can model references to a Buyer's accounts.
BuyerReferenceYou can add a buyer reference for internal routing.
InvoicePeriodYou can specify a period during which the invoice is valid or active.
IssueTimeThe time, assigned by the sender, at which this document was issued.
UUIDA universally unique identifier for an instance of this document.
Document References
OrderReferenceYou may want to add a reference to an additional document.
BillingReferenceYou can specify a reference to a billing related document.
DespatchDocumentReferenceYou can reference a dispatch advice in your Document.
ReceiptDocumentReferenceYou can reference a receipt advice in your Documents.
OriginatorDocumentReferenceYou can model a reference to a lot or tender.
ContractDocumentReferenceYou can add a reference to a purchasing contract in your Documents.
AdditionalDocumentReference
ProjectReferenceYou can add a reference to a project to your Document.
Parties
AccountingSupplierPartyYou can model information about suppliers.
AccountingCustomerPartyYou can model buyer information.
PayeePartyYou may want to model a Payee when this party is different to the Supplier.
TaxRepresentativePartyYou can model the Supplier's Tax Representative at the Document level.
Delivery
DeliveryYou can add information about deliveries to your Documents.
DeliveryTermsA set of delivery terms associated with this document.
CarrierPartyUsed to model details about the carrier of a delivery,
Payment
PaymentMeansYou can add the means of payment to your Document.
PaymentTermsYou can information about payment terms.
PrepaidPaymentsPrepaid payments are usually made before the goods are purchased.
Document-Level Allowances and Charges
AllowanceChargeYou can model an Allowance or Charge at the Document level.
Document-Level Taxes
TaxTotalYou can model tax information at the Document level.
TaxExchangeRateThe exchange rate between the document currency and the tax currency.
WithholdingTaxTotalThe total withholding tax.
Document-Level Totals
LegalMonetaryTotalYou must add information about totals.

Line level elements

The following elements are or can be defined at the Line level:

ElementDescription
InvoiceLineUse this element to model a line in an invoice.
InvoiceLine/IDYou can add an ID for a line.
NoteUse this element to add a note to a line.
InvoicedQuantityYou can add a quantity to your invoice lines.
LineExtensionAmountUse this element to specify the next amount on the line level.
InvoiceLine/Accounting CostUse this element to model references to how a buyer is referenced in the the accounting.
InvoiceLine/InvoicePeriodUse this element specify an invoice period on the Line level.
InvoiceLine/SubInvoiceLineUsed in Germany XR for the construction industry.
OrderLineReferenceUse this element to reference an order at the Line level.
DespatchLineReferenceA reference to a Dispatch Advice associated with a line.
DocumentReferenceUse this element to provide a reference to an additional document reference on which the invoice line is based.
InvoiceLine/AllowanceChargeUse this element to specify an allowance or charge at the line level.
ItemItems are the goods or services that are sold on an invoice line or specified in a credit note.
Item/DescriptionUse this element to specify a description for an item.
Item/NameUse this element to specify a name for an item.
Item/ItemTypeCodeUse this element to specify the type of item.
Item/LotIdentificationUse this element to model information about a lot of items.
Item/PriceUse the Price element to model the price of an item.
BuyersItemIdentificationUse this element to specify details about the buyers item.
SellersItemIdentificationUse this element to specify details about the Seller's item identification.
StandardItemIdentificationUse this element to specify information about standard item identification.
OriginCountryUse this element to specify information about the country of origin.
CommodityClassificationUse this element to specify information about classifying an item by type or nature.
ClassifiedTaxCategoryUse this element to specify tax information at line level.
AdditionalItemPropertyUse this element to specify details about any additional properties an item may have.
PriceDetailsUse this element to specify pricing details.
InvoiceLine/UUIDUsed to add a UUID to a line.
FreeOfChargeIndicatorUsed to indicate if the goods and services in a line are free from charge.

In this section

SectionDescription
Document Level ElementsThis section contains the elements that can be defined at the Document level.
Line Level ElementsThis section lists the Elements that are or can be specified at the line level.