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.

Here are some examples:

Element	Description
ID	Specify an ID for the Document.
InvoiceTypeCode	The 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.
InvoiceLine	Used to specify line details. More information is provided in the Invoice Lines topic.
DocumentCurrencyCode	Used to specify the invoice currency.

Details

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

Detail	Value
Name	`Invoice`
Path	`Invoice`
Definition	The highest level Element that gathers all other Elements in the Document.

Elements

Field	Description
`ID`	The identifier of the invoice.
`IssueDate`	The date the invoice was issued.
`IssueTime`	The time the invoice was issued.
`InvoiceTypeCode listVersionID=`	The type of invoice. See Invoice Types.
`DocumentCurrencyCode`	The ISO code for the currency that is applied to the invoice.
`InvoicePeriod`	See 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>

Updated 6 months ago