Invoice

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

General information is provided in the Documents topic.

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

The following Elements can be specified at the Document level in the Invoice element:

TopicDescription
Routing Extension
RoutingDetails (Extn)You must specify the required routing details.
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.
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.
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 at the Document level.
AllowanceChargeYou can model charges in your Document.
Document Level Taxes
TaxTotalYou can model tax information at the Document level.
TaxTotalYou can model tax information at the Document level in the Accounting Currency.
LegalMonetaryTotalYou must add information about totals.

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>