Invoice

The Invoice object is the highest level object in a Document.

General information is provided in the Documents topic.

The Invoice element is super ordinate to all elements. All elements are contained within it.

Here are some examples:

ElementDescription
IDSpecify an ID for the Document.
InvoiceTypeCodeThe value used here denotes whether this Invoice element specifies an invoice or credit note or some other type of invoice. More nformation is provided in the Invoice Types topic.
InvoiceLineUsed to specify line details. More nformation is provided in the Invoice Lines topic.
DocumentCurrencyCodeUsed to specify the invoice currency.

Details

The following table shows an overview of components used in and by this object:

DetailValue
NameInvoice
PathInvoice
DefinitionThe highest level Element that gathers all other Elements in the Document.

Elements

FieldDescription
IDThe identifier of the invoice.
IssueDateThe date the invoice was issued.
IssueTimeThe time the invoice was issued.
InvoiceTypeCode listVersionID=The type of invoice. See Invoice Types.
DocumentCurrencyCodeThe ISO code for the currency that is applied to the invoice.
InvoicePeriodSee Invoice Period

Example

The following example is a Greek invoice. Examples are detailed in the Example Documents topics:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <ubl:Invoice xmlns:ubl="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2" 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">
  	<!-- Required UBL extensions -->
  	<cec:UBLExtensions>
  		<cec:UBLExtension>
  			<cec:ExtensionContent>
  				<vrbl:InvoiceExtension>
  					<vrbl:InstallationSerialNumber>99887744</vrbl:InstallationSerialNumber>
  					<vrbl:InvoiceSeries>AB789</vrbl:InvoiceSeries>
  					<vrbl:InvoiceSubtypeCode>VRBL:GR:1.1</vrbl:InvoiceSubtypeCode>
  					<vrbl:RoutingDetails>
  						<!-- Unique sender ID. In case of Greece always the sender's VAT ID -->
  						<vrbl:Sender>EL123456789</vrbl:Sender>
  						<!-- Unique receiver ID. In case of Greece always a static value identifies the country (Greece) and the target version to be created -->
  						<vrbl:Receiver>GENERIC_PEPPOL_UBL_GR_1p0p0</vrbl:Receiver>
  						<vrbl:ReceiverDetails>0088:1234567890123</vrbl:ReceiverDetails>
  					</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>INV456</cbc:ID>
  	<cbc:IssueDate>2024-07-12</cbc:IssueDate>
  	<cbc:IssueTime>15:30:00Z</cbc:IssueTime>
  	<cbc:DueDate>2024-10-10</cbc:DueDate>
  	<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  	<cbc:Note>This is an invoice free-text</cbc:Note>
  	<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
  	<cbc:BuyerReference>buyer_ref_number234</cbc:BuyerReference>
  	<cac:InvoicePeriod>
  		<cbc:StartDate>2024-11-26</cbc:StartDate>
  		<cbc:EndDate>2024-11-30</cbc:EndDate>
  		<cbc:Description>Monthly</cbc:Description>
  	</cac:InvoicePeriod>
  	<cac:OrderReference>
  		<cbc:ID>PO987654</cbc:ID>
  		<cbc:SalesOrderID>SalesOrderID123456</cbc:SalesOrderID>
  	</cac:OrderReference>
  	<cac:DespatchDocumentReference>
  		<cbc:ID>DespatchDocument123456</cbc:ID>
  	</cac:DespatchDocumentReference>
  	<cac:AdditionalDocumentReference>
  		<cbc:ID>1234</cbc:ID>
  		<cbc:DocumentDescription>VRBL:GR:MARK</cbc:DocumentDescription>
  	</cac:AdditionalDocumentReference>
  	<cac:AdditionalDocumentReference>
  		<cbc:ID>1234</cbc:ID>
  		<cbc:DocumentDescription>VRBL:GR:INVOICEURL</cbc:DocumentDescription>
  		<cac:Attachment>
  			<cac:ExternalReference>
  				<cbc:URI>http://www.example.com/index.html</cbc:URI>
  			</cac:ExternalReference>
  		</cac:Attachment>
  	</cac:AdditionalDocumentReference>
  	<cac:AccountingSupplierParty>
  		<cac:Party>
  			<!-- Technical Endpoint. Provides the PEPPOL ID of the sender -->
  			<!-- use schemeID codes from https://docs.peppol.eu/poacc/billing/3.0/codelist/eas/ -->
  			<cbc:EndpointID schemeID="9933">123456789</cbc:EndpointID>
  			<cac:PartyName>
  				<cbc:Name>SenderCompanyName</cbc:Name>
  			</cac:PartyName>
  			<cac:PostalAddress>
  				<cbc:StreetName>Ioulianou 39</cbc:StreetName>
  				<cbc:CityName>Athina</cbc:CityName>
  				<cbc:PostalZone>104 33</cbc:PostalZone>
  				<cac:Country>
  					<cbc:IdentificationCode>GR</cbc:IdentificationCode>
  				</cac:Country>
  			</cac:PostalAddress>
  			<cac:PartyTaxScheme>
  				<cbc:CompanyID>EL123456789</cbc:CompanyID>
  				<cac:TaxScheme>
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:PartyTaxScheme>
  			<cac:PartyLegalEntity>
  				<cbc:RegistrationName>SenderRegisteredName</cbc:RegistrationName>
  			</cac:PartyLegalEntity>
  			<cac:Contact>
  				<cbc:Name>Customer service</cbc:Name>
  			</cac:Contact>
  		</cac:Party>
  	</cac:AccountingSupplierParty>
  	<cac:AccountingCustomerParty>
  		<cac:Party>
  			<!-- Technical Endpoint. Provides the PEPPOL ID of the receiver -->
  			<!-- use schemeID codes from https://docs.peppol.eu/poacc/billing/3.0/codelist/eas/ -->
  			<cbc:EndpointID schemeID="9933">987654321</cbc:EndpointID>
  			<cac:PartyName>
  				<cbc:Name>ReceiverCompanyName</cbc:Name>
  			</cac:PartyName>
  			<cac:PostalAddress>
  				<cbc:StreetName>Leof. Mesogeion 554</cbc:StreetName>
  				<cbc:CityName>Athina</cbc:CityName>
  				<cbc:PostalZone>115 27</cbc:PostalZone>
  				<cac:Country>
  					<cbc:IdentificationCode>GR</cbc:IdentificationCode>
  				</cac:Country>
  			</cac:PostalAddress>
  			<cac:PartyTaxScheme>
  				<cbc:CompanyID>EL987654321</cbc:CompanyID>
  				<cac:TaxScheme>
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:PartyTaxScheme>
  			<cac:PartyLegalEntity>
  				<cbc:RegistrationName>ReceiverRegisteredName</cbc:RegistrationName>
  			</cac:PartyLegalEntity>
  			<cac:Contact>
  				<cbc:Telephone>+30 00 9999 0000</cbc:Telephone>
  				<cbc:ElectronicMail>[email protected]</cbc:ElectronicMail>
  			</cac:Contact>
  		</cac:Party>
  	</cac:AccountingCustomerParty>
  	<cac:Delivery>
  		<cbc:ActualDeliveryDate>2024-07-12</cbc:ActualDeliveryDate>
  		<cac:DeliveryLocation>
  			<cac:Address>
  				<cbc:StreetName>Leof. Panagioti Kanellopoulou 376</cbc:StreetName>
  				<cbc:CityName>Athina</cbc:CityName>
  				<cbc:PostalZone>115 25</cbc:PostalZone>
  				<cac:Country>
  					<cbc:IdentificationCode>GR</cbc:IdentificationCode>
  				</cac:Country>
  			</cac:Address>
  		</cac:DeliveryLocation>
  		<cac:DeliveryParty>
  			<cac:PartyName>
  				<cbc:Name>DeliveryPartyName</cbc:Name>
  			</cac:PartyName>
  		</cac:DeliveryParty>
  	</cac:Delivery>
  	<cac:PaymentMeans>
  		<cbc:PaymentMeansCode>30</cbc:PaymentMeansCode>
  		<cac:PayeeFinancialAccount>
  			<cbc:ID>GR123456789012365478</cbc:ID>
  			<cbc:Name>BankAccountOwner</cbc:Name>
  			<cac:FinancialInstitutionBranch>
  				<cbc:ID>ERBKGRAAXXX</cbc:ID>
  			</cac:FinancialInstitutionBranch>
  		</cac:PayeeFinancialAccount>
  	</cac:PaymentMeans>
  	<cac:PaymentTerms>
  		<cbc:Note>Up to 10.10.2024 without deduction</cbc:Note>
  	</cac:PaymentTerms>
  	<cac:AllowanceCharge>
  		<cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  		<cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
  		<cbc:Amount currencyID="EUR">100</cbc:Amount>
  		<cac:TaxCategory>
  			<cbc:ID>S</cbc:ID>
  			<cbc:Percent>24</cbc:Percent>
  			<cac:TaxScheme>
  				<cbc:ID>VAT</cbc:ID>
  			</cac:TaxScheme>
  		</cac:TaxCategory>
  	</cac:AllowanceCharge>
  	<cac:AllowanceCharge>
  		<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  		<cbc:AllowanceChargeReason>Service charge</cbc:AllowanceChargeReason>
  		<cbc:Amount currencyID="EUR">100</cbc:Amount>
  		<cac:TaxCategory>
  			<cbc:ID>S</cbc:ID>
  			<cbc:Percent>24</cbc:Percent>
  			<cac:TaxScheme>
  				<cbc:ID>VAT</cbc:ID>
  			</cac:TaxScheme>
  		</cac:TaxCategory>
  	</cac:AllowanceCharge>
  	<cac:TaxTotal>
  		<cbc:TaxAmount currencyID="EUR">96</cbc:TaxAmount>
  		<cac:TaxSubtotal>
  			<cbc:TaxableAmount currencyID="EUR">400</cbc:TaxableAmount>
  			<cbc:TaxAmount currencyID="EUR">96</cbc:TaxAmount>
  			<cac:TaxCategory>
  				<cbc:ID>S</cbc:ID>
  				<cbc:Percent>24</cbc:Percent>
  				<cac:TaxScheme>
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:TaxCategory>
  		</cac:TaxSubtotal>
  	</cac:TaxTotal>
  	<cac:LegalMonetaryTotal>
  		<cbc:LineExtensionAmount currencyID="EUR">400</cbc:LineExtensionAmount>
  		<cbc:TaxExclusiveAmount currencyID="EUR">400</cbc:TaxExclusiveAmount>
  		<cbc:TaxInclusiveAmount currencyID="EUR">496</cbc:TaxInclusiveAmount>
  		<cbc:AllowanceTotalAmount currencyID="EUR">100</cbc:AllowanceTotalAmount>
  		<cbc:ChargeTotalAmount currencyID="EUR">100</cbc:ChargeTotalAmount>
  		<cbc:PayableAmount currencyID="EUR">496</cbc:PayableAmount>
  	</cac:LegalMonetaryTotal>
  	<cac:InvoiceLine>
  		<cbc:ID>000010</cbc:ID>
  		<cbc:Note>ItemDecription</cbc:Note>
  		<cbc:InvoicedQuantity unitCode="H87">3</cbc:InvoicedQuantity>
  		<cbc:LineExtensionAmount currencyID="EUR">300</cbc:LineExtensionAmount>
  		<cac:OrderLineReference>
  			<cbc:LineID>000001</cbc:LineID>
  		</cac:OrderLineReference>
  		<cac:Item>
  			<cbc:Name>ItemName</cbc:Name>
  			<cac:SellersItemIdentification>
  				<cbc:ID>730430</cbc:ID>
  			</cac:SellersItemIdentification>
  			<!-- GTIN13 of the item -->
  			<cac:StandardItemIdentification>
  				<cbc:ID schemeID="0088">1234567890123</cbc:ID>
  			</cac:StandardItemIdentification>
  			<cac:ClassifiedTaxCategory>
  				<cbc:ID>S</cbc:ID>
  				<cbc:Percent>24</cbc:Percent>
  				<cac:TaxScheme>
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:ClassifiedTaxCategory>
  		</cac:Item>
  		<cac:Price>
  			<cbc:PriceAmount currencyID="EUR">100</cbc:PriceAmount>
  			<cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
  		</cac:Price>
  	</cac:InvoiceLine>
  	<cac:InvoiceLine>
  		<cbc:ID>000020</cbc:ID>
  		<cbc:Note>Item Description</cbc:Note>
  		<cbc:InvoicedQuantity unitCode="H87">2</cbc:InvoicedQuantity>
  		<cbc:LineExtensionAmount currencyID="EUR">100</cbc:LineExtensionAmount>
  		<cac:OrderLineReference>
  			<cbc:LineID>000002</cbc:LineID>
  		</cac:OrderLineReference>
  		<cac:AllowanceCharge>
  			<cbc:ChargeIndicator>false</cbc:ChargeIndicator>
  			<cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
  			<cbc:MultiplierFactorNumeric>10</cbc:MultiplierFactorNumeric>
  			<cbc:Amount currencyID="EUR">10</cbc:Amount>
  		</cac:AllowanceCharge>
  		<cac:AllowanceCharge>
  			<cbc:ChargeIndicator>true</cbc:ChargeIndicator>
  			<cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
  			<cbc:MultiplierFactorNumeric>10</cbc:MultiplierFactorNumeric>
  			<cbc:Amount currencyID="EUR">10</cbc:Amount>
  		</cac:AllowanceCharge>
  		<cac:Item>
  			<cbc:Name>ItemName</cbc:Name>
  			<cac:SellersItemIdentification>
  				<cbc:ID>730430</cbc:ID>
  			</cac:SellersItemIdentification>
  			<!-- GTIN13 of the item -->
  			<cac:StandardItemIdentification>
  				<cbc:ID schemeID="0088">1234567890123</cbc:ID>
  			</cac:StandardItemIdentification>
  			<cac:ClassifiedTaxCategory>
  				<cbc:ID>S</cbc:ID>
  				<cbc:Percent>24</cbc:Percent>
  				<cac:TaxScheme>
  					<cbc:ID>VAT</cbc:ID>
  				</cac:TaxScheme>
  			</cac:ClassifiedTaxCategory>
  		</cac:Item>
  		<cac:Price>
  			<cbc:PriceAmount currencyID="EUR">50</cbc:PriceAmount>
  			<cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
  		</cac:Price>
  	</cac:InvoiceLine>
  </ubl:Invoice>