/ubl:Invoice

Invoice

China | VRBL-Invoice-CN-1p0
Download sample files
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.