/ubl:Invoice
VRBL-Invoice-IT-1p2 - Invoice
| Context ID | INV0001 |
| Usage | - |
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
| Usage | Element | Description | Cardinality |
|---|---|---|---|
| M | cec:UBLExtensions |
Extensions Group | 0..1 |
| M | cbc:CustomizationID |
Specification Identifier
Identifies a user-defined customization of UBL for a specific use. |
0..1 |
| M | cbc:ProfileID |
Business Process Type
Identifies a user-defined profile of the customization of UBL being used. |
0..1 |
| M | cbc:ID |
Invoice Number
An identifier for this document, assigned by the sender. |
1..1 |
| M | cbc:IssueDate |
Invoice Issue Date
The date, assigned by the sender, on which this document was issued. |
1..1 |
| O | cbc:DueDate |
Payment Due Date
The date on which Invoice is due. |
0..1 |
| M | cbc:InvoiceTypeCode |
Invoice Type Code
A code signifying the type of the Invoice. |
0..1 |
| O | cbc:Note |
Invoice Note
Free-form text pertinent to this document, conveying information that is not contained explicitly in other structures. |
0..n |
| M | cbc:DocumentCurrencyCode |
Document Currency Code
A code signifying the default currency for this document. |
0..1 |
| O | cbc:AccountingCost |
Buyer Accounting Reference
The buyer's accounting code, applied to the Invoice as a whole, expressed as text. |
0..1 |
| O | cbc:BuyerReference |
Buyer Reference
A reference provided by the buyer used for internal routing of the document. |
0..1 |
| O | cac:OrderReference |
Order Reference
A reference to the Order with which this Invoice is associated. |
0..1 |
| O* | cac:BillingReference |
Preceding Invoice Reference
A reference to a billing document associated with this document. |
0..n |
| O | cac:DespatchDocumentReference |
Despatch Advice Reference
A reference to a Despatch Advice associated with this document. |
0..n |
| O | cac:ReceiptDocumentReference |
Receipt Advice Reference
A reference to a Receipt Advice associated with this document. |
0..n |
| O | cac:OriginatorDocumentReference |
Tender Or Lot Reference
A reference to an originator document associated with this document. |
0..n |
| O | cac:ContractDocumentReference |
Contract Reference
A reference to a contract associated with this document. |
0..n |
| O* | cac:AdditionalDocumentReference |
Additional Document Reference Group
A reference to an additional document associated with this document. |
0..n |
| O | cac:AdditionalDocumentReference[not(cac:Attachment)] |
Additional Document Reference
A reference to an additional document associated with this document. |
0..n |
| O | cac:ProjectReference |
Project Reference
Information about a project. |
0..n |
| M | cac:AccountingSupplierParty |
Seller
The accounting supplier party. |
1..1 |
| M | cac:AccountingCustomerParty |
Buyer
The accounting customer party. |
0..1 |
| O | cac:PayeeParty |
Payee
The payee. |
0..1 |
| O | cac:TaxRepresentativeParty |
Seller Tax Representative Party
The tax representative. |
0..1 |
| O | cac:Delivery |
Delivery Information
A delivery associated with this document. |
0..n |
| O | cac:DeliveryTerms |
Delivery Terms Group
A set of delivery terms associated with this document. |
0..1 |
| O* | cac:PaymentMeans |
Payment Instructions
Expected means of payment. |
0..n |
| O* | cac:PaymentTerms |
Payment Terms
A set of payment terms associated with this document. |
0..n |
| O | cac:AllowanceCharge |
Allowance Charge Group
A discount or charge that applies to a price component. |
0..n |
| O* | cac:AllowanceCharge[string(cbc:ChargeIndicator) = 'false'] |
Document Level Allowances
A discount or charge that applies to a price component. |
0..n |
| O* | cac:AllowanceCharge[string(cbc:ChargeIndicator) = 'true'] |
Document Level Charges
A discount or charge that applies to a price component. |
0..n |
| M | cac:TaxTotal[cbc:TaxAmount/@currencyID = ../cbc:DocumentCurrencyCode] |
Tax Total
The total amount of a specific type of tax. |
0..n |
| O | cac:WithholdingTaxTotal |
Withholding Tax
The total withholding tax. |
0..n |
| M | cac:LegalMonetaryTotal |
Document Totals
The total amount payable on the Invoice, including Allowances, Charges, and Taxes. |
1..1 |
| M+ | cac:InvoiceLine |
Invoice Line
A line describing an invoice item. |
1..n |
Details
Example: IT_creditnote_TD04.xml
<ubl:Invoice>
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent>
<vrbl:InvoiceExtension>
<vrbl:RoutingDetails>
<vrbl:Sender>IT00000000000</vrbl:Sender>
<vrbl:Receiver>GENERIC_IT_FatturaPA_1p2p2</vrbl:Receiver>
</vrbl:RoutingDetails>
<vrbl:SdIReceiverCode>0000000</vrbl:SdIReceiverCode>
<vrbl:TransmissionFormatCode>VRBL:IT:FPR12</vrbl:TransmissionFormatCode>
</vrbl:InvoiceExtension>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:CustomizationID>urn:vertexinc:vrbl:billing:1#Invoice#VRBL-Invoice-IT-1p2</cbc:CustomizationID>
<cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
<cbc:ID>IV-TEST-00012_TD04</cbc:ID>
<cbc:IssueDate>2024-01-31</cbc:IssueDate>
<cbc:InvoiceTypeCode>VRBL:IT:TD04</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>#NO#</cbc:BuyerReference>
<cac:OrderReference>
<cbc:ID>1230000000</cbc:ID>
<cbc:IssueDate>2023-12-31</cbc:IssueDate>
</cac:OrderReference>
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID>01_FT_BIS3_V31_B2G</cbc:ID>
<cbc:IssueDate>2024-01-07</cbc:IssueDate>
</cac:InvoiceDocumentReference>
</cac:BillingReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="0210">02188520544</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Via Amendola,2</cbc:StreetName>
<cbc:CityName>REGGIO EMILIA</cbc:CityName>
<cbc:PostalZone>42100</cbc:PostalZone>
<cbc:CountrySubentity>IT-RE</cbc:CountrySubentity>
<cac:Country>
<cbc:IdentificationCode>IT</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>IT02188520544</cbc:CompanyID>
<cbc:TaxLevelCode>VRBL:IT:RF01</cbc:TaxLevelCode>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent>
<vrbl:PartyLegalEntityExtension>
<vrbl:BaseCapital>100000.00</vrbl:BaseCapital>
<vrbl:BusinessRegistrationProvinceCode>IT-RM</vrbl:BusinessRegistrationProvinceCode>
</vrbl:PartyLegalEntityExtension>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:RegistrationName>Fornitore SPA</cbc:RegistrationName>
<cbc:CompanyID>323284</cbc:CompanyID>
<cbc:SoleProprietorshipIndicator>true</cbc:SoleProprietorshipIndicator>
<cbc:CompanyLiquidationStatusCode>VRBL:IT:LN</cbc:CompanyLiquidationStatusCode>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="0210">01598570354</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Via Cliente,2</cbc:StreetName>
<cbc:CityName>REGGIO EMILIA</cbc:CityName>
<cbc:PostalZone>42100</cbc:PostalZone>
<cbc:CountrySubentity>IT-RE</cbc:CountrySubentity>
<cac:Country>
<cbc:IdentificationCode>IT</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>IT01598570354</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>USL Cliente</cbc:RegistrationName>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:PaymentMeans>
<cbc:PaymentMeansCode>VRBL:IT:MP05</cbc:PaymentMeansCode>
<cac:PayeeFinancialAccount>
<cbc:ID>IT64W0100003245243300306301</cbc:ID>
<cac:FinancialInstitutionBranch>
<cbc:ID>UNCRIT2B</cbc:ID>
</cac:FinancialInstitutionBranch>
</cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:PaymentTerms>
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent>
<vrbl:PaymentTermsExtension>
<vrbl:PaymentTermsCode>VRBL:IT:TP02</vrbl:PaymentTermsCode>
</vrbl:PaymentTermsExtension>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:Note>TP02</cbc:Note>
</cac:PaymentTerms>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">274.12</cbc:TaxAmount>
<cac:TaxSubtotal>
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent>
<vrbl:TaxSubtotalExtension>
<vrbl:VatMechanism>VRBL:IT:I</vrbl:VatMechanism>
</vrbl:TaxSubtotalExtension>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:TaxableAmount currencyID="EUR">1246.00</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">274.12</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>22</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="EUR">1246.00</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="EUR">1246.00</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="EUR">1520.12</cbc:TaxInclusiveAmount>
<cbc:PrepaidAmount currencyID="EUR">274.12</cbc:PrepaidAmount>
<cbc:PayableAmount currencyID="EUR">1246.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="C62">20.00000000</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">1246.00</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Name>EBIXA</cbc:Name>
<cac:SellersItemIdentification>
<cbc:ID>689910</cbc:ID>
</cac:SellersItemIdentification>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>22.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent>
<vrbl:PriceExtension>
<vrbl:PriceAmountBeforeAllowanceCharge currencyID="EUR">62.30000000</vrbl:PriceAmountBeforeAllowanceCharge>
</vrbl:PriceExtension>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:PriceAmount currencyID="EUR">62.30000000</cbc:PriceAmount>
<cbc:BaseQuantity unitCode="C62">1</cbc:BaseQuantity>
</cac:Price>
</cac:InvoiceLine>
</ubl:Invoice>
Rules
| Rule ID | Error Message |
|---|---|
| VRBL-INV-IT-1p2-1 | The Transmission Format Code must exist within the Invoice. |
| VRBL-INV-IT-1p2-2 | The SdI Receiver Code must exist within the Invoice. |
| VRBL-INV-IT-1p2-3 | At least one of Seller Tax ID used as VAT ID or Buyer Tax ID used as VAT ID must start with 'IT'. |
| VRBL-INV-IT-1p2-4 | For Credit Memos, the Invoice Issue Date of the Credit Memo must be equal or after the Preceding Invoice Issue Date. |
| VRBL-INV-IT-1p2-5 | For the Invoice Type Code "TD16", "TD17", "TD18", "TD19", the Seller Tax ID used as VAT ID must not equal the Buyer Tax ID used as VAT ID. |
| VRBL-INV-IT-1p2-6 | For the Invoice Type Code "TD21" the Seller Tax ID used as VAT ID must equal the Buyer Tax ID used as VAT ID. |
| VRBL-INV-IT-1p2-7 | For the Invoice Type Code "TD17", "TD18", "TD19", the Seller Country Code must not equal "IT". |
| VRBL-INV-IT-1p2-8 | For the Invoice Type Code "TD21" there must not be any Invoice Line with a Invoiced Item Tax Rate of zero. |
| VRBL-INV-IT-1p2-9 | For the Invoice Type Code "TD16", "TD17", "TD18", "TD19", "TD20", "TD22", "TD23", "TD28", the Buyer Tax ID used as VAT ID must exist. |
| VRBL-INV-IT-1p2-10 | When a Invoice Line or a Allowance Charge Group with the Withholding Indicator set to true is provided, the Withholding Tax must exist within the Invoice. |
| 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. |