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:
Topic | Description |
---|---|
Routing Extension | |
RoutingDetails (Extn) | You must specify the required routing details. |
General Invoice Information | |
CustomizationID | The Specification ID is used for routing. |
ProfileID | You must specify the same Profile ID for all Documents. |
ID | You can specify a number for your Document, such as an invoice number. |
IssueDate | You can specify the date the Document is issued. |
DueDate | You can add the date payment is due to your Documents. |
InvoiceTypeCode | Documents can be of one of various invoice types that you need to specify. |
InvoiceNote | You can add a textual reference or note to your Documents. |
TaxPointDate | You can add Tax Point date to your Documents. |
DocumentCurrencyCode | You can specify a currency for your Document. |
TaxCurrencyCode | You can add a Tax Accounting currency. |
AccountingCost | You can model references to a Buyer's accounts. |
BuyerReference | You can add a buyer reference for internal routing. |
InvoicePeriod | You can specify a period during which the invoice is valid or active. |
Document References | |
OrderReference | You may want to add a reference to an additional document. |
BillingReference | You can specify a reference to a billing related document. |
DespatchDocumentReference | You can reference a dispatch advice in your Document. |
ReceiptDocumentReference | You can reference a receipt advice in your Documents. |
OriginatorDocumentReference | You can model a reference to a lot or tender. |
ContractDocumentReference | You can add a reference to a purchasing contract in your Documents. |
AdditionalDocumentReference | |
ProjectReference | You can add a reference to a project to your Document. |
Parties | |
AccountingSupplierParty | You can model information about suppliers. |
AccountingCustomerParty | You can model buyer information. |
PayeeParty | You may want to model a Payee when this party is different to the Supplier. |
TaxRepresentativeParty | You can model the Supplier's Tax Representative at the Document level. |
Delivery | |
Delivery | You can add information about deliveries to your Documents. |
Payment | |
PaymentMeans | You can add the means of payment to your Document. |
PaymentTerms | You can information about payment terms. |
PrepaidPayments | Prepaid payments are usually made before the goods are purchased. |
Document Level Allowances and Charges | |
AllowanceCharge | You can model an allowance at the Document level. |
AllowanceCharge | You can model charges in your Document. |
Document Level Taxes | |
TaxTotal | You can model tax information at the Document level. |
TaxTotal | You can model tax information at the Document level in the Accounting Currency. |
LegalMonetaryTotal | You 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>
Updated 15 days ago