/ubl:Invoice
VRBL-Invoice-CN-1p0 - 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 |
| 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* | cac:BillingReference |
Preceding Invoice Reference
A reference to a billing document 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 |
| 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:Delivery |
Delivery Information
A delivery associated with this document. |
0..n |
| O* | cac:PaymentMeans |
Payment Instructions
Expected means of payment. |
0..n |
| M | cac:TaxTotal[cbc:TaxAmount/@currencyID = ../cbc:DocumentCurrencyCode] |
Tax Total
The total amount of a specific type of 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: CN_creditnote_381.xml
<ubl:Invoice>
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent>
<vrbl:InvoiceExtension>
<vrbl:CorrectionData>
<vrbl:CorrectionInitiator>VRBL:CN:SELLER</vrbl:CorrectionInitiator>
<vrbl:CorrectionMethod>VRBL:CN:FULL</vrbl:CorrectionMethod>
</vrbl:CorrectionData>
<vrbl:RoutingDetails>
<vrbl:Sender>CN00000000000</vrbl:Sender>
<vrbl:Receiver>GENERIC_CN_GTS_1p0</vrbl:Receiver>
</vrbl:RoutingDetails>
</vrbl:InvoiceExtension>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:CustomizationID>urn:vertexinc:vrbl:billing:1#Invoice#VRBL-Invoice-CN-1p0</cbc:CustomizationID>
<cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
<cbc:ID>EC2601000001</cbc:ID>
<cbc:IssueDate>2024-07-12</cbc:IssueDate>
<cbc:InvoiceTypeCode>381</cbc:InvoiceTypeCode>
<cbc:Note>This is an invoice free-text</cbc:Note>
<cbc:DocumentCurrencyCode>CNY</cbc:DocumentCurrencyCode>
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID>1234</cbc:ID>
</cac:InvoiceDocumentReference>
</cac:BillingReference>
<cac:AdditionalDocumentReference>
<cbc:ID schemeID="VRBL:CN:BILLINGNUMBER">12345</cbc:ID>
</cac:AdditionalDocumentReference>
<cac:AccountingSupplierParty>
<cbc:AdditionalAccountID schemeID="VRBL:CN:STAISSUER">AAAAA</cbc:AdditionalAccountID>
<cbc:AdditionalAccountID schemeID="VRBL:CN:STALOGIN">AAAAA</cbc:AdditionalAccountID>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="VRBL:CN:CODE">00000000000000</cbc:ID>
</cac:PartyIdentification>
<cac:PartyTaxScheme>
<cbc:CompanyID>CN123456789012345</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="CNY">22</cbc:TaxAmount>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:TaxExclusiveAmount currencyID="CNY">290</cbc:TaxExclusiveAmount>
<cbc:PayableAmount currencyID="CNY">327.70</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>000010</cbc:ID>
<cbc:InvoicedQuantity unitCode="H87">3</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="CNY">290</cbc:LineExtensionAmount>
<cbc:TaxInclusiveLineExtensionAmount currencyID="CNY">327.70</cbc:TaxInclusiveLineExtensionAmount>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="CNY">37.70</cbc:TaxAmount>
</cac:TaxTotal>
<cac:Item>
<cbc:Description>Spec A</cbc:Description>
<cbc:Name>ItemName</cbc:Name>
<cac:SellersItemIdentification>
<cbc:ID>730430</cbc:ID>
</cac:SellersItemIdentification>
<cac:CommodityClassification>
<cbc:ItemClassificationCode listID="VRBL:CN:TaxClassificationCode">AAAAA</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>13.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
</cac:InvoiceLine>
</ubl:Invoice>
Rules
| Rule ID | Error Message |
|---|---|
| VRBL-INV-CN-1p0-1 | The Total Tax Amount must exist within the Invoice. |
| VRBL-INV-CN-1p0-2 | When the Invoice Type Code is 380, the Invoice Subtype Code must exist within the Invoice. |
| VRBL-INV-CN-1p0-29 | When the Invoice Type Code is 381, the Correction Data must exist within the Invoice. |
| VRBL-INV-CN-1p0-3 | When the Invoice Type Code is 381, the Preceding Invoice Reference ID must exist within the Invoice. |
| VRBL-INV-CN-1p0-27 | When the Invoice Type Code is 380, the Buyer 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. |