Context
CH
/ubl:Invoice
VRBL-Invoice-CH-YellowBill-3p0 - Invoice
Switzerland |
VRBL-Invoice-CH-YellowBill-3p0
| 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 |
| O | cbc:UUID |
Unique Unit ID
A universally unique identifier for an instance of this document. |
0..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:TaxPointDate |
Tax Point Date
The date of the Invoice, used to indicate the point at which tax becomes applicable. |
0..1 |
| M | cbc:DocumentCurrencyCode |
Document Currency Code
A code signifying the default currency for this document. |
0..1 |
| O | cac:InvoicePeriod |
Invoicing Period
A period to which the Invoice applies. |
0..n |
| 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: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 |
| 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:BuyerCustomerParty |
Buyer Customer Party Group
The buyer. |
0..1 |
| O | cac:SellerSupplierParty |
Seller Supplier Party Group
The seller. |
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 |
| 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 |
| 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: VRBL_CH_INVOICE_CreditNote.xml
<ubl:Invoice>
<ext:UBLExtensions>
<ext:UBLExtension>
<ext:ExtensionContent>
<vrbl:InvoiceExtension>
<cbc:LanguageID>de</cbc:LanguageID>
<vrbl:ProcessDetails>
<vrbl:CompanyCode>456789123</vrbl:CompanyCode>
</vrbl:ProcessDetails>
<vrbl:RoutingDetails>
<vrbl:Sender>CHE000000000</vrbl:Sender>
<vrbl:Receiver>GENERIC_CH_YELLOWBILL_3p0</vrbl:Receiver>
<vrbl:ReceiverDetails/>
</vrbl:RoutingDetails>
</vrbl:InvoiceExtension>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
<cbc:CustomizationID>urn:vertexinc:vrbl:billing:1#Invoice#VRBL-Invoice-CH-YellowBill-3p0</cbc:CustomizationID>
<cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
<cbc:ID>TechReject-251028114620330452</cbc:ID>
<cbc:UUID>hzhhshshshshshsh</cbc:UUID>
<cbc:IssueDate>2025-10-28</cbc:IssueDate>
<cbc:DueDate>2025-11-28</cbc:DueDate>
<cbc:InvoiceTypeCode>381</cbc:InvoiceTypeCode>
<cbc:TaxPointDate>2025-11-01</cbc:TaxPointDate>
<cbc:DocumentCurrencyCode>CHF</cbc:DocumentCurrencyCode>
<cac:OrderReference>
<cbc:ID>349291</cbc:ID>
<cbc:SalesOrderID>779974</cbc:SalesOrderID>
</cac:OrderReference>
<cac:BillingReference>
<cac:InvoiceDocumentReference>
<cbc:ID>TechReject-251028114620330451</cbc:ID>
</cac:InvoiceDocumentReference>
</cac:BillingReference>
<cac:AccountingSupplierParty>
<cac:Party>
<cbc:EndpointID schemeID="9927">che-106.094.282</cbc:EndpointID>
<cac:PartyName>
<cbc:Name>Seller Name</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:CityName>Supplier City</cbc:CityName>
<cbc:PostalZone>12345</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>CH</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>CHE000000000</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Seller Registration Name</cbc:RegistrationName>
<cbc:CompanyID>VRBL:1A</cbc:CompanyID>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingSupplierParty>
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="9927">che-106.094.282</cbc:EndpointID>
<cac:PartyName>
<cbc:Name>Customer Name</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:CityName>Customer City</cbc:CityName>
<cbc:PostalZone>54321</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>CH</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:PartyTaxScheme>
<cbc:CompanyID>CHE000000000</cbc:CompanyID>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Buyer Registration Name</cbc:RegistrationName>
</cac:PartyLegalEntity>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:BuyerCustomerParty>
<cac:Party>
<cac:PartyName>
<cbc:Name>Buyer Name</cbc:Name>
</cac:PartyName>
</cac:Party>
</cac:BuyerCustomerParty>
<cac:PaymentMeans>
<cbc:PaymentMeansCode>58</cbc:PaymentMeansCode>
<cbc:PaymentID>TechReject-251028114620330452</cbc:PaymentID>
<cac:PayeeFinancialAccount>
<cbc:ID>CH99999999999</cbc:ID>
<cac:FinancialInstitutionBranch>
<cbc:ID>CHFCHFCHF</cbc:ID>
</cac:FinancialInstitutionBranch>
</cac:PayeeFinancialAccount>
</cac:PaymentMeans>
<cac:PaymentTerms>
<cbc:Note>Payment within 30 days</cbc:Note>
<cbc:Amount currencyID="CHF">9124.33</cbc:Amount>
</cac:PaymentTerms>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="CHF">1190.13</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="CHF">7934.2</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="CHF">1190.13</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>15</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="CHF">7934.2</cbc:LineExtensionAmount>
<cbc:TaxExclusiveAmount currencyID="CHF">7934.2</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="CHF">9124.33</cbc:TaxInclusiveAmount>
<cbc:PayableAmount currencyID="CHF">9124.33</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="EA">10</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="CHF">7934.2</cbc:LineExtensionAmount>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="CHF">1190.13</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="CHF">7934.2</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="CHF">1190.13</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>15</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:Item>
<cbc:Description>Line Item Description</cbc:Description>
<cbc:Name>Digital Kitchen Scale</cbc:Name>
<cac:BuyersItemIdentification>
<cbc:ID>62226</cbc:ID>
</cac:BuyersItemIdentification>
<cac:SellersItemIdentification>
<cbc:ID>52225</cbc:ID>
</cac:SellersItemIdentification>
<cac:StandardItemIdentification>
<cbc:ID schemeID="0160">72227</cbc:ID>
</cac:StandardItemIdentification>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>15</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="CHF">793.42</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>
</ubl:Invoice>
Rules
| Rule ID | Error Message |
|---|---|
| VRBL-INV-CH-YELLOWBILL-3p0-20 | The Payment Due Date 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. |