/ubl:Invoice

VRBL-Invoice-TW-TX-B2C-1p0 - Invoice

Taiwan | VRBL-Invoice-TW-TX-B2C-1p0

Context ID	INV0001
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

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:IssueTime`	Invoice Issue Time The time, assigned by the sender, at which this document was issued.	0..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:BuyerReference`	Buyer Reference A reference provided by the buyer used for internal routing of the 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
C	`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
M	`cac:AccountingSupplierParty`	Seller The accounting supplier party.	1..1
M	`cac:AccountingCustomerParty`	Buyer The accounting customer party.	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
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: TW_invoice_380.xml

<ubl:Invoice>
  <ext:UBLExtensions>
    <ext:UBLExtension>
      <ext:ExtensionContent>
        <vrbl:InvoiceExtension>
          <vrbl:RoutingDetails>
            <vrbl:Sender>VERTEX_DEV_TEMPLATE</vrbl:Sender>
            <vrbl:Receiver>GENERIC_TAXAMO_JSON_TW_1p0</vrbl:Receiver>
          </vrbl:RoutingDetails>
        </vrbl:InvoiceExtension>
      </ext:ExtensionContent>
    </ext:UBLExtension>
  </ext:UBLExtensions>
  <cbc:CustomizationID>urn:vertexinc:vrbl:billing:1#Invoice#VRBL-Invoice-TW-TX-B2C-1p0</cbc:CustomizationID>
  <cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
  <cbc:ID>INV-12345-001</cbc:ID>
  <cbc:IssueDate>2025-02-10</cbc:IssueDate>
  <cbc:IssueTime>15:30:00Z</cbc:IssueTime>
  <cbc:DueDate>2025-02-20</cbc:DueDate>
  <cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
  <cbc:Note>This is an invoice free-text</cbc:Note>
  <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
  <cbc:BuyerReference>buyer_ref_number234</cbc:BuyerReference>
  <cac:InvoicePeriod>
    <cbc:StartDate>2024-11-26</cbc:StartDate>
    <cbc:EndDate>2024-11-30</cbc:EndDate>
    <cbc:Description>Monthly</cbc:Description>
  </cac:InvoicePeriod>
  <cac:OrderReference>
    <cbc:ID>PO987654</cbc:ID>
    <cbc:SalesOrderID>SalesOrderID123456</cbc:SalesOrderID>
  </cac:OrderReference>
  <cac:DespatchDocumentReference>
    <cbc:ID>DespatchDocument123456</cbc:ID>
  </cac:DespatchDocumentReference>
  <cac:AccountingSupplierParty>
    <cac:Party>
      <cac:PartyIdentification>
        <cbc:ID>0123456789012</cbc:ID>
      </cac:PartyIdentification>
      <cac:PartyName>
        <cbc:Name>SenderCompanyName</cbc:Name>
      </cac:PartyName>
      <cac:PostalAddress>
        <cbc:StreetName>Streetname 3</cbc:StreetName>
        <cbc:CityName>Taipei City</cbc:CityName>
        <cbc:PostalZone>111</cbc:PostalZone>
        <cac:Country>
          <cbc:IdentificationCode>TW</cbc:IdentificationCode>
        </cac:Country>
      </cac:PostalAddress>
      <cac:PartyTaxScheme>
        <cbc:CompanyID>73251209</cbc:CompanyID>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:PartyTaxScheme>
      <cac:PartyLegalEntity>
        <cbc:RegistrationName>SenderRegisteredName</cbc:RegistrationName>
      </cac:PartyLegalEntity>
      <cac:Contact>
        <cbc:Name>Customer service</cbc:Name>
        <cbc:ElectronicMail>name@seller.com</cbc:ElectronicMail>
      </cac:Contact>
    </cac:Party>
  </cac:AccountingSupplierParty>
  <cac:AccountingCustomerParty>
    <cac:Party>
      <cac:PartyName>
        <cbc:Name>Mr. John Doe</cbc:Name>
      </cac:PartyName>
      <cac:PostalAddress>
        <cbc:StreetName>Streetname 4</cbc:StreetName>
        <cbc:CityName>Taipei City</cbc:CityName>
        <cbc:PostalZone>111</cbc:PostalZone>
        <cac:Country>
          <cbc:IdentificationCode>TW</cbc:IdentificationCode>
        </cac:Country>
      </cac:PostalAddress>
      <cac:PartyLegalEntity>
        <cbc:RegistrationName>BuyerRegisteredName</cbc:RegistrationName>
      </cac:PartyLegalEntity>
      <cac:Contact>
        <cbc:Telephone>09/000 88 00</cbc:Telephone>
        <cbc:ElectronicMail>jd@buyer.com</cbc:ElectronicMail>
      </cac:Contact>
    </cac:Party>
  </cac:AccountingCustomerParty>
  <cac:PaymentMeans>
    <cbc:PaymentMeansCode>31</cbc:PaymentMeansCode>
    <cac:PayeeFinancialAccount>
      <cbc:ID>TW123456788901234</cbc:ID>
      <cbc:Name>BankAccountOwner</cbc:Name>
      <cac:FinancialInstitutionBranch>
        <cbc:ID>GEBABEBB</cbc:ID>
      </cac:FinancialInstitutionBranch>
    </cac:PayeeFinancialAccount>
  </cac:PaymentMeans>
  <cac:PaymentTerms>
    <cbc:Note>Up to 10.10.2024 without deduction</cbc:Note>
  </cac:PaymentTerms>
  <cac:AllowanceCharge>
    <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
    <cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
    <cbc:Amount currencyID="EUR">100</cbc:Amount>
    <cac:TaxCategory>
      <cbc:ID>S</cbc:ID>
      <cbc:Percent>5</cbc:Percent>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:TaxCategory>
  </cac:AllowanceCharge>
  <cac:AllowanceCharge>
    <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
    <cbc:AllowanceChargeReason>Service charge</cbc:AllowanceChargeReason>
    <cbc:Amount currencyID="EUR">100</cbc:Amount>
    <cac:TaxCategory>
      <cbc:ID>S</cbc:ID>
      <cbc:Percent>5</cbc:Percent>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:TaxCategory>
  </cac:AllowanceCharge>
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="EUR">20</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="EUR">400</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="EUR">20</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>5</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="EUR">400</cbc:LineExtensionAmount>
    <cbc:TaxExclusiveAmount currencyID="EUR">400</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="EUR">420</cbc:TaxInclusiveAmount>
    <cbc:AllowanceTotalAmount currencyID="EUR">100</cbc:AllowanceTotalAmount>
    <cbc:ChargeTotalAmount currencyID="EUR">100</cbc:ChargeTotalAmount>
    <cbc:PayableAmount currencyID="EUR">420</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
  <cac:InvoiceLine>
    <cbc:ID>000010</cbc:ID>
    <cbc:Note>ItemDecription</cbc:Note>
    <cbc:InvoicedQuantity unitCode="H87">3</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">300</cbc:LineExtensionAmount>
    <cac:OrderLineReference>
      <cbc:LineID>000001</cbc:LineID>
    </cac:OrderLineReference>
    <cac:Item>
      <cbc:Name>ItemName</cbc:Name>
      <cac:SellersItemIdentification>
        <cbc:ID>730430</cbc:ID>
      </cac:SellersItemIdentification>
      <cac:StandardItemIdentification>
        <cbc:ID schemeID="0160">1234567890128</cbc:ID>
      </cac:StandardItemIdentification>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>5</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
      <cac:AdditionalItemProperty>
        <cbc:Name>Purchase Order Number</cbc:Name>
        <cbc:Value>PO987654</cbc:Value>
      </cac:AdditionalItemProperty>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">100</cbc:PriceAmount>
      <cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
    </cac:Price>
  </cac:InvoiceLine>
  <cac:InvoiceLine>
    <cbc:ID>000020</cbc:ID>
    <cbc:Note>Item Description</cbc:Note>
    <cbc:InvoicedQuantity unitCode="H87">2</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="EUR">100</cbc:LineExtensionAmount>
    <cac:OrderLineReference>
      <cbc:LineID>000002</cbc:LineID>
    </cac:OrderLineReference>
    <cac:AllowanceCharge>
      <cbc:ChargeIndicator>false</cbc:ChargeIndicator>
      <cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
      <cbc:MultiplierFactorNumeric>10.00</cbc:MultiplierFactorNumeric>
      <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
      <cbc:BaseAmount currencyID="EUR">100.00</cbc:BaseAmount>
    </cac:AllowanceCharge>
    <cac:AllowanceCharge>
      <cbc:ChargeIndicator>true</cbc:ChargeIndicator>
      <cbc:AllowanceChargeReason>Sample Description</cbc:AllowanceChargeReason>
      <cbc:MultiplierFactorNumeric>10.00</cbc:MultiplierFactorNumeric>
      <cbc:Amount currencyID="EUR">10.00</cbc:Amount>
      <cbc:BaseAmount currencyID="EUR">100.00</cbc:BaseAmount>
    </cac:AllowanceCharge>
    <cac:Item>
      <cbc:Name>ItemName</cbc:Name>
      <cac:SellersItemIdentification>
        <cbc:ID>730430</cbc:ID>
      </cac:SellersItemIdentification>
      <cac:StandardItemIdentification>
        <cbc:ID schemeID="0160">1234567890128</cbc:ID>
      </cac:StandardItemIdentification>
      <cac:ClassifiedTaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>5</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:ClassifiedTaxCategory>
      <cac:AdditionalItemProperty>
        <cbc:Name>Purchase Order Number</cbc:Name>
        <cbc:Value>PO987654</cbc:Value>
      </cac:AdditionalItemProperty>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="EUR">50</cbc:PriceAmount>
      <cbc:BaseQuantity unitCode="H87">1</cbc:BaseQuantity>
    </cac:Price>
  </cac:InvoiceLine>
</ubl:Invoice>

Rules

Rule ID	Error Message
VRBL-INV-TW-TX-B2C-1p0-1	For Credit Memos with Invoice Document Reference Correction Method equal to 'VRBL:TW:Full', the Invoice Document Reference Correction Reason must exist within the Invoice.
VRBL-INV-TW-TX-B2C-1p0-16	The Invoice Document Reference Correction Method must exist for Credit Memos.
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.