/ubl:Invoice
Invoice
Download sample files| Context ID | INV0001 |
| Cardinality | 1..1 |
| Usage | M |
Description
VRBL is a general datamodel for an invoice based on UBL2.4 and Peppol PINT, that can be used as base for specializations that are used in various jurisdictions.
Child elements
| Cardinality | Usage | Description | Element |
|---|---|---|---|
| 0..1 | M | Extensions Group | cec:UBLExtensions |
| 0..1 | M |
Specification Identifier
Identifies a user-defined customization of UBL for a specific use. |
cbc:CustomizationID |
| 0..1 | M |
Business Process Type
Identifies a user-defined profile of the customization of UBL being used. |
cbc:ProfileID |
| 1..1 | M |
Invoice Number
An identifier for this document, assigned by the sender. |
cbc:ID |
| 0..1 | M |
Unique Unit ID
A universally unique identifier for an instance of this document. |
cbc:UUID |
| 1..1 | M |
Invoice Issue Date
The date, assigned by the sender, on which this document was issued. |
cbc:IssueDate |
| 0..1 | O |
Invoice Issue Time
The time, assigned by the sender, at which this document was issued. |
cbc:IssueTime |
| 0..1 | O |
Payment Due Date
The date on which Invoice is due. |
cbc:DueDate |
| 0..1 | M |
Invoice Type Code
A code signifying the type of the Invoice. |
cbc:InvoiceTypeCode |
| 0..n | O |
Invoice Note
Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures. |
cbc:Note |
| 0..1 | O |
Tax Point Date
The date of the Invoice, used to indicate the point at which tax becomes applicable. |
cbc:TaxPointDate |
| 0..1 | M |
Document Currency Code
A code signifying the default currency for this document. |
cbc:DocumentCurrencyCode |
| 0..1 | C |
Tax Accounting Currency
A code signifying the currency used for tax amounts in the Invoice. |
cbc:TaxCurrencyCode |
| 0..1 | O |
Buyer Accounting Reference
The buyer's accounting code, applied to the Invoice as a whole, expressed as text. |
cbc:AccountingCost |
| 0..1 | O |
Buyer Reference
A reference provided by the buyer used for internal routing of the document. |
cbc:BuyerReference |
| 0..n | O |
Invoicing Period
A period to which the Invoice applies. |
cac:InvoicePeriod |
| 0..1 | O |
Order Reference
A reference to the Order with which this Invoice is associated. |
cac:OrderReference |
| 0..n | O* |
Preceding Invoice Reference
A reference to a billing document associated with this document. |
cac:BillingReference |
| 0..n | O |
Despatch Advice Reference
A reference to a Despatch Advice associated with this document. |
cac:DespatchDocumentReference |
| 0..n | O |
Receipt Advice Reference
A reference to a Receipt Advice associated with this document. |
cac:ReceiptDocumentReference |
| 0..n | O |
Statement Document Reference Group
A reference to a Statement associated with this document. |
cac:StatementDocumentReference |
| 0..n | O |
Tender Or Lot Reference
A reference to an originator document associated with this document. |
cac:OriginatorDocumentReference |
| 0..n | O |
Contract Reference
A reference to a contract associated with this document. |
cac:ContractDocumentReference |
| 0..n | O* |
Additional Document Reference Group
A reference to an additional document associated with this document. |
cac:AdditionalDocumentReference |
| 0..n | O |
Project Reference
Information about a project. |
cac:ProjectReference |
| 1..1 | M |
Seller
The accounting supplier party. |
cac:AccountingSupplierParty |
| 0..1 | M |
Buyer
The accounting customer party. |
cac:AccountingCustomerParty |
| 0..1 | O |
Payee
The payee. |
cac:PayeeParty |
| 0..1 | O |
Seller Tax Representative Party
The tax representative. |
cac:TaxRepresentativeParty |
| 0..n | O |
Delivery Information
A delivery associated with this document. |
cac:Delivery |
| 0..1 | O |
Delivery Terms Group
A set of delivery terms associated with this document. |
cac:DeliveryTerms |
| 0..n | O* |
Payment Instructions
Expected means of payment. |
cac:PaymentMeans |
| 0..n | O* |
Payment Terms
A set of payment terms associated with this document. |
cac:PaymentTerms |
| 0..n | O |
Allowance Charge Group
A discount or charge that applies to a price component. |
cac:AllowanceCharge |
| 0..n | O* |
Document Level Allowances
A discount or charge that applies to a price component. |
cac:AllowanceCharge[string(cbc:ChargeIndicator) = 'false'] |
| 0..n | O* |
Document Level Charges
A discount or charge that applies to a price component. |
cac:AllowanceCharge[string(cbc:ChargeIndicator) = 'true'] |
| 0..1 | C |
Tax Exchange Rate
The exchange rate between the document currency and the tax currency. |
cac:TaxExchangeRate |
| 0..n | M |
Tax Total
The total amount of a specific type of tax. |
cac:TaxTotal[cbc:TaxAmount/@currencyID = ../cbc:DocumentCurrencyCode] |
| 0..n | C |
Tax Total in Tax Accounting Currency
The total amount of a specific type of tax. |
cac:TaxTotal[cbc:TaxAmount/@currencyID = ../cbc:TaxCurrencyCode] |
| 1..1 | M |
Document Totals
The total amount payable on the Invoice, including Allowances, Charges, and Taxes. |
cac:LegalMonetaryTotal |
| 1..n | M+ |
Invoice Line
A line describing an invoice item. |
cac:InvoiceLine |
Rules
| Rule ID | Error Message |
|---|---|
| VRBL-INV-AE-1p0-145 | When Invoice type code is '381' or '81', the preceding invoice reference Preceding Invoice Reference MUST be provided, EXCEPT when the Credit note reason code is 'VD' (in which case it MUST NOT be provided). |
| VRBL-INV-AE-1p0-96 | When Invoice Type Code '380' (Commercial invoice) or '381' (Credit note), the Invoiced items MUST NOT strictly consist of 'Exempt from VAT' (E) and/or 'Not subject to VAT' (O) categories. |
| VRBL-INV-AE-1p0-101 | When Invoice Period Duration Measure Unit Code is 'ZZZ', the Invoice Note must exist within the Invoice. |
| VRBL-INV-AE-1p0-142 | The value of the Invoice Type Code must be contained in UNTDID 1001 [VRBL-CL-PINT-UNTDID-1001] or be contained in UNTDID 1001+480 [VRBL-CL-AE-InvoiceTypeCode]. |
| VRBL-INV-AE-1p0-141 | The Unique Unit ID must exist within the Invoice. |
| VRBL-INV-AE-1p0-25 | An Invoice that contains Invoiced Item Tax Category Code or Allowance Charge Tax ID equal to "S" shall contain at least one Tax Subtotal with the Tax Subtotal Category ID equal to "S". |
| VRBL-INV-AE-1p0-63 | An Payment Due Date must be present in case Amount Due For Payment != 0, unless Deemed Supply Indicator exists or Invoice Type Code = '261 or '81'. |
| VRBL-INV-AE-1p0-75 | An Seller Tax ID marked as 'VAT' must be present except Invoice Type Code is "480" or "81". |
| VRBL-INV-AE-1p0-77 | The Buyer Legal Registration ID MUST be present when the Invoice Type Code is '480' or '81'. |
| VRBL-INV-AE-1p0-78 | The %cec:UBLExtensions/cec:UBLExtension/cec:ExtensionContent/vrbl:InvoiceExtension/vrbl:AdditionalParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID} with @code = 'VRBL:AE:Principal' MUST be present when the message is marked as Disclosed Agent billing. |
| VRBL-INV-AE-1p0-79 | The Invoicing Period MUST be present when marked as summary invoice. |
| VRBL-INV-AE-1p0-83 | When the Tax Accounting Currency is present, it MUST be 'AED'. |
| VRBL-INV-AE-1p0-84 | When the Tax Point Date is present, it MUST be before the Invoice Issue Date. |
| VRBL-INV-AE-1p0-85 | The Delivery Location Address Line 1, Delivery Location City, and Delivery Location Country Subentity MUST be present when the invoice indicates E-commerce supplies. |
| VRBL-INV-AE-1p0-97 | The Delivery Location Address Line 1, Delivery Location City, and Delivery Location Country Subentity MUST be present when the Export Indicator exists. |
| VRBL-INV-AE-1p0-98 | When the Tax Accounting Currency is 'AED' and the Document Currency Code is not 'AED', the Tax Exchange Rate MUST be provided where the Tax Exchange Rate Source Currency Code matches the Document Currency Code, the Tax Exchange Rate Target Currency Code matches the Tax Accounting Currency, and the Tax Exchange Rate Calculation Rate is present. |
| VRBL-INV-AE-1p0-139 | An Deemed Supply Indicator, Summary Invoice Indicator and Profit Margin Scheme Indicator shall not be present when Invoice Type Code is "480" or "81". |
| VRBL-INV-AE-1p0-100 | Tax Exchange Rate Calculation Rate must be informed when then Document Currency Code is different from 'AED'. |
| VRBL-INV-AE-1p0-112 | When the Document Currency Code is not 'AED' and Tax Accounting Currency is 'AED', the total VAT amount Total Tax Amount and Legal Monetary Total in Tax Currency Tax Inclusive Amount MUST be present. |
| VRBL-INV-AE-1p0-113 | When the Disclosed Agent Billing Indicator is present, the Seller Tax ID and the Additional Party Tax Company ID with code = 'VRBL:AE:Principal' MUST NOT be the same. |
| VRBL-INV-AE-1p0-129 | The (Payment Means Type Code must be provided for standard invoices, and MUST NOT be provided when the invoice type is a Credit Note (81, 381, 261) or a Deemed Supply. |
| VRBL-INV-AE-1p0-147 | When the Invoice Type Code is '381', the Document Reason Code must exist within the Invoice. |
| VRBL-INV-PEPPOL-PINT-1 | The Specification Identifier must be provided in the Invoice. |
| VRBL-INV-PEPPOL-PINT-2 | The Invoice Number must be provided in the Invoice. |
| VRBL-INV-PEPPOL-PINT-4 | The Invoice Type Code must be provided in the Invoice. |
| VRBL-INV-PEPPOL-PINT-5 | The Document Currency Code must be provided in the Invoice. |
| VRBL-INV-PEPPOL-PINT-6 | The Seller Name must be provided in the Invoice. |
| VRBL-INV-PEPPOL-PINT-7 | The Buyer Name must be provided in the Invoice. |
| VRBL-INV-PEPPOL-PINT-8 | The Seller Postal Address must exist within the Invoice. |
| VRBL-INV-PEPPOL-PINT-9 | The Buyer Postal Address must exist within the Invoice. |
| VRBL-INV-PEPPOL-PINT-15 | The Invoice expects a maximum of one Additional Document Reference Group where Additional Document Reference Document Type Code is '130'. |
| VRBL-INV-PEPPOL-PINT-16 | The Business Process Type must exist within the Invoice. |
| VRBL-INV-PEPPOL-PINT-17 | The Tax Accounting Currency must be different from Document Currency Code when provided. |
| VRBL-INV-PEPPOL-PINT-18 | Only one Project Reference is allowed on document level. |
| VRBL-INV-PEPPOL-PINT-19 | If Despatch Advice Reference exists then there must not be Despatch Advice Reference on document level. |
| VRBL-INV-PEPPOL-PINT-20 | The Invoice expects a maximum of one Contract Reference ID. |
| VRBL-INV-PEPPOL-PINT-21 | The Invoice expects a maximum of one Receiving Advice Reference ID. |
| VRBL-INV-PEPPOL-PINT-22 | The Invoice expects a maximum of one Despatch Advice Reference ID. |
| VRBL-INV-PEPPOL-PINT-23 | The Invoice expects a maximum of one Invoicing Period. |
| VRBL-INV-PEPPOL-PINT-24 | The Invoice expects a maximum of one Delivery Information. |
| VRBL-INV-PEPPOL-PINT-28 | The Invoice expects a maximum of one Project Reference ID. |
| VRBL-INV-PEPPOL-PINT-29 | The Invoice expects a maximum of one Invoice Note. |
| VRBL-INV-PEPPOL-PINT-30 | The Invoice expects a maximum of one Tender Or Lot Reference ID. |
| VRBL-INV-PEPPOL-PINT-31 | The Invoice expects a maximum of one Payment Terms Instructions ID. |
| VRBL-INV-PEPPOL-PINT-32 | The Invoice expects a maximum of one Payment Terms Note. |
| VRBL-INV-PEPPOL-PINT-33 | The Invoice Issue Time must be formatted HH:MM:SS or HH:MM:SSS. |
| VRBL-INV-PEPPOL-PINT-89 | The Invoice Total Tax Amount in Tax Accounting Currency and the Invoice Total Tax Amount must have the same operational sign. |
| VRBL-INV-CORE-4 | The Specification Identifier must exist within the Invoice. |
| VRBL-INV-CORE-5 | The Business Process Type must exist within the Invoice. |
| VRBL-INV-CORE-10 | The Invoice Type Code must exist within the Invoice. |
| VRBL-INV-CORE-13 | The Document Currency Code must exist within the Invoice. |
| VRBL-INV-CORE-563 | The Tax Total Group is only allowed when using the currencies in Document Currency Code or Tax Accounting Currency. |
| VRBL-INV-CORE-36 | The Invoice Number must be provided in the Invoice. |
| VRBL-INV-CORE-39 | The Document Currency Code must be provided in the Invoice. |
| VRBL-INV-CORE-41 | The Invoice Total Tax Amount and the Invoice Total Tax Amount in Tax Accounting Currency must all both positive, or all negative. |
| VRBL-INV-SYSTEM-1 | If there is a value for Invoice Number, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-2 | If there is a value for Invoice Type Code, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-3 | If there is a value for Document Currency Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-4 | If there is a value for Buyer Accounting Reference, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-5 | If there is a value for Buyer Reference, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-6 | If there is a value for Seller Trading Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-7 | If there is a value for Seller Tax ID used as DUNS, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-8 | If there is a value for Seller Tax ID used as VAT ID, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-9 | If there is a value for Seller City, the allowed maximum number of characters is 200. |
| VRBL-INV-SYSTEM-10 | If there is a value for Seller Country Code, the allowed maximum number of characters is 50. |
| VRBL-INV-SYSTEM-11 | If there is a value for Seller Postal Zone, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-12 | If there is a value for Seller Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-13 | If there is a value for Seller Contact Point, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-14 | If there is a value for Seller Contact Telephone Number, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-15 | If there is a value for Seller Contact Email Address, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-16 | If there is a value for Seller Electronic Address, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-17 | If there is a value for Buyer Trading Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-18 | If there is a value for Buyer Tax ID used as DUNS, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-19 | If there is a value for Buyer Tax ID used as VAT ID, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-20 | If there is a value for Buyer City, the allowed maximum number of characters is 200. |
| VRBL-INV-SYSTEM-21 | If there is a value for Buyer Country Code, the allowed maximum number of characters is 50. |
| VRBL-INV-SYSTEM-22 | If there is a value for Buyer Postal Zone, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-23 | If there is a value for Buyer Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-24 | If there is a value for Buyer Contact Point, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-25 | If there is a value for Buyer Contact Email Address, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-26 | If there is a value for Buyer Contact Telephone Number, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-27 | If there is a value for Buyer Electronic Address, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-28 | If there is a value for Buyer Customer Party Name Group, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-29 | If there is a value for Buyer Customer Party Tax Company ID used as DUNS, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-30 | If there is a value for Buyer Customer Party Tax Company ID used as VAT ID, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-31 | If there is a value for Buyer Customer Party City Name, the allowed maximum number of characters is 200. |
| VRBL-INV-SYSTEM-32 | If there is a value for Buyer Customer Party Country Identification Code, the allowed maximum number of characters is 50. |
| VRBL-INV-SYSTEM-33 | If there is a value for Buyer Customer Party Postal Zone, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-34 | If there is a value for Buyer Customer Party Legal Entity Registration Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-35 | If there is a value for Buyer Customer Party Contact Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-36 | If there is a value for Buyer Customer Party Contact Electronic Mail, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-37 | If there is a value for Buyer Customer Party Contact Telephone, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-38 | If there is a value for Buyer Customer Party Endpoint ID, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-39 | If there is a value for Tax Subtotal Taxable Amount Currency Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-40 | If there is a value for Total Tax Amount Currency Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-41 | If there is a value for Tax Subtotal Category ID, the allowed maximum number of characters is 50. |
| VRBL-INV-SYSTEM-42 | If there is a value for Legal Monetary Total Line Extension Amount Currency Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-43 | If there is a value for Legal Monetary Total Tax Exclusive Amount Currency Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-44 | If there is a value for Legal Monetary Total Tax Inclusive Amount Currency Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-45 | If there is a value for Legal Monetary Total Payable Amount Currency Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-46 | If there is a value for Delivery Location City, the allowed maximum number of characters is 200. |
| VRBL-INV-SYSTEM-47 | If there is a value for Delivery Location Postal Zone, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-48 | If there is a value for Delivery Location Country Code, the allowed maximum number of characters is 50. |
| VRBL-INV-SYSTEM-49 | If there is a value for Delivery Party Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-50 | If there is a value for Payment Means Type Code, the allowed maximum number of characters is 25. |
| VRBL-INV-SYSTEM-51 | If there is a value for Payment Account ID, the allowed maximum number of characters is 100. |
| VRBL-INV-SYSTEM-52 | If there is a value for Payment Account Name, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-53 | If there is a value for Payment Service Provider ID, the allowed maximum number of characters is 500. |
| VRBL-INV-SYSTEM-54 | If there is a value for Purchase Order Reference ID, the allowed maximum number of characters is 300. |
| VRBL-INV-SYSTEM-55 | If there is a value for Sales Order Reference ID, the allowed maximum number of characters is 300. |