Document- and Line-Level Elements

Elements can be defined at the Document or Line level or both.

Elements and Extensions can be defined on the Document or Line level, depending on requirements and use cases. Some can be defined at both levels, like Allowances. However, some, like item classification must be specified at the line level. Some countries might require that you place specific information at a specific level. These are mentioned in the Country Guide Overview section.

📘

Note

This section lists the Elements. Extensions are listed in the VRBL Extensions Reference Guide section.

This section list only Element. Extensions are listed in the VRBL Extensions Reference Guide section.

Document-level

Document level means the element is in the top level of the Invoice element. This code snippet shows some Document level elements:

<?xml version="1.0" encoding="UTF-8"?>
  <Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:cec="urn:oasis:names:specification:ubl:schema:xsd:CommonExtensionComponents-2" xmlns:vrbl="urn:vertexinc:vrbl:ExtensionComponent:1">
  	<cec:UBLExtensions>
  		<cec:UBLExtension>
  			<cec:ExtensionContent>
  				<vrbl:InvoiceExtension>
  					<vrbl:RoutingDetails>
  						<vrbl:Sender>DE000000000</vrbl:Sender>
  						<vrbl:Receiver>GENERIC_PEPPOL_UBL_DE</vrbl:Receiver>
  					</vrbl:RoutingDetails>
  				</vrbl:InvoiceExtension>
  			</cec:ExtensionContent>
  		</cec:UBLExtension>
  	</cec:UBLExtensions>
  	<cbc:CustomizationID>urn:vertexinc:vrbl:billing:1</cbc:CustomizationID>
  	<cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
  	<cbc:ID>DE-B2B_380_241119222726_01</cbc:ID>
  	<cbc:IssueDate>2024-11-19</cbc:IssueDate>
  	<cbc:DueDate>2024-12-19</cbc:DueDate>
  	<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  	<cbc:Note>Please note we have a new phone number: 22 22 22 22</cbc:Note>
  	<cbc:TaxPointDate>2017-12-01</cbc:TaxPointDate>
  	<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
  	<cbc:TaxCurrencyCode>SEK</cbc:TaxCurrencyCode>
  	<cbc:AccountingCost>4025:123:4343</cbc:AccountingCost>
  	<cbc:BuyerReference>0150abc</cbc:BuyerReference>
  	<cac:InvoicePeriod>
          <cbc:StartDate>2017-12-01</cbc:StartDate>
          <cbc:EndDate>2017-12-31</cbc:EndDate>
      </cac:InvoicePeriod>
  	<cac:ContractDocumentReference>
          <cbc:ID>framework no 1</cbc:ID>
      </cac:ContractDocumentReference>
  	<cac:AdditionalDocumentReference>
          <cbc:ID schemeID="ABT">DR35141</cbc:ID>
          <cbc:DocumentTypeCode>130</cbc:DocumentTypeCode>
      </cac:AdditionalDocumentReference>

The Document level elements are listed in Document-Level Elements topic.

Invoice-level

Invoice lines are specified in the InvoiceLine element. For example:

	<cac:InvoiceLine>
      <cbc:ID>1</cbc:ID>
          <cbc:Note>Testing note on line level</cbc:Note>
          <cbc:InvoicedQuantity unitCode="C62">10</cbc:InvoicedQuantity>
          <cbc:LineExtensionAmount currencyID="EUR">4000.00</cbc:LineExtensionAmount>
          <cbc:AccountingCost>Konteringsstreng</cbc:AccountingCost>
          <cac:AllowanceCharge>
              <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
              <cbc:AllowanceChargeReasonCode>CG</cbc:AllowanceChargeReasonCode>
              <cbc:AllowanceChargeReason>Cleaning</cbc:AllowanceChargeReason>
              <cbc:MultiplierFactorNumeric>1</cbc:MultiplierFactorNumeric>
              <cbc:Amount currencyID="EUR">1</cbc:Amount>
              <cbc:BaseAmount currencyID="EUR">100</cbc:BaseAmount>
          </cac:AllowanceCharge>
          <cac:AllowanceCharge>
              <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
              <cbc:AllowanceChargeReasonCode>95</cbc:AllowanceChargeReasonCode>
              <cbc:AllowanceChargeReason>Discount</cbc:AllowanceChargeReason>
              <cbc:Amount currencyID="EUR">101</cbc:Amount>
          </cac:AllowanceCharge>
          <cac:Item>
              <cbc:Description>Description of item</cbc:Description>
              <cbc:Name>item name</cbc:Name>

The Line level elements are listed in the Line-Level Elements topic.

In this section

This section contains the following topics:

TopicDescription
Document-Level ElementsRead a list of elements that can be specified at the Document-level.
Line-Level ElementsRead a list of elements that can be specified at the Line-level.