/ubl:Invoice

Invoice

United States | VRBL-Invoice-US-DBNA-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
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: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:TaxCurrencyCode Tax Accounting Currency

A code signifying the currency used for tax amounts in the Invoice.

 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: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: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: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: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: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
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:TaxTotal[cbc:TaxAmount/@currencyID = ../cbc:TaxCurrencyCode] Tax Total in Tax Accounting Currency

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_DBNA_UBL_CREDITNOTE.xml

<ubl:Invoice>
  <ext:UBLExtensions>
    <ext:UBLExtension>
      <ext:ExtensionContent>
        <vrbl:InvoiceExtension>
          <vrbl:RoutingDetails>
            <vrbl:Sender>USA_DEMO</vrbl:Sender>
            <vrbl:Receiver>GENERIC_UBL_DBNA_USA_1p0</vrbl:Receiver>
          </vrbl:RoutingDetails>
        </vrbl:InvoiceExtension>
      </ext:ExtensionContent>
    </ext:UBLExtension>
  </ext:UBLExtensions>
  <cbc:CustomizationID>urn:vertexinc:vrbl:billing:1#Invoice#VRBL-Invoice-US-DBNA-1p0</cbc:CustomizationID>
  <cbc:ProfileID>urn:vertexinc:vrbl:billing:1</cbc:ProfileID>
  <cbc:ID>1003</cbc:ID>
  <cbc:IssueDate>2023-04-12</cbc:IssueDate>
  <cbc:InvoiceTypeCode>381</cbc:InvoiceTypeCode>
  <cbc:Note>This is an example Credit Note</cbc:Note>
  <cbc:DocumentCurrencyCode>USD</cbc:DocumentCurrencyCode>
  <cac:BillingReference>
    <cac:InvoiceDocumentReference>
      <cbc:ID>INVOICE-10004</cbc:ID>
    </cac:InvoiceDocumentReference>
  </cac:BillingReference>
  <cac:AccountingSupplierParty>
    <cbc:CustomerAssignedAccountID>DUNS:123456789</cbc:CustomerAssignedAccountID>
    <cac:Party>
      <cac:PartyIdentification>
        <cbc:ID schemeID="9959">GENERIC_UBL_DBNA_USA_1p0</cbc:ID>
      </cac:PartyIdentification>
      <cac:PartyName>
        <cbc:Name>Gadgets R Us, Inc.</cbc:Name>
      </cac:PartyName>
      <cac:PostalAddress>
        <cbc:CityName>San Francisco</cbc:CityName>
        <cbc:PostalZone>94107</cbc:PostalZone>
        <cbc:CountrySubentityCode>CA</cbc:CountrySubentityCode>
        <cac:AddressLine>
          <cbc:Line>24 Willie Mays Plz</cbc:Line>
        </cac:AddressLine>
        <cac:Country>
          <cbc:IdentificationCode>US</cbc:IdentificationCode>
        </cac:Country>
      </cac:PostalAddress>
    </cac:Party>
  </cac:AccountingSupplierParty>
  <cac:AccountingCustomerParty>
    <cac:Party>
      <cbc:EndpointID schemeID="9945">USA_DEMO</cbc:EndpointID>
      <cac:PartyIdentification>
        <cbc:ID schemeID="0088">USA_DEMO</cbc:ID>
      </cac:PartyIdentification>
      <cac:PartyName>
        <cbc:Name>ACME Corp.</cbc:Name>
      </cac:PartyName>
      <cac:PostalAddress>
        <cbc:CityName>Cleveland</cbc:CityName>
        <cbc:PostalZone>44114</cbc:PostalZone>
        <cbc:CountrySubentityCode>OH</cbc:CountrySubentityCode>
        <cac:AddressLine>
          <cbc:Line>1100 E 9th St.</cbc:Line>
        </cac:AddressLine>
        <cac:Country>
          <cbc:IdentificationCode>US</cbc:IdentificationCode>
        </cac:Country>
      </cac:PostalAddress>
      <cac:Contact>
        <cbc:Name>E.Presley</cbc:Name>
      </cac:Contact>
    </cac:Party>
  </cac:AccountingCustomerParty>
  <cac:Delivery>
    <cbc:ActualDeliveryDate>2023-04-10</cbc:ActualDeliveryDate>
    <cac:DeliveryLocation>
      <cac:Address>
        <cbc:CityName>Cleveland</cbc:CityName>
        <cbc:PostalZone>44114</cbc:PostalZone>
        <cbc:CountrySubentityCode>OH</cbc:CountrySubentityCode>
        <cac:AddressLine>
          <cbc:Line>1100 E 9th St.</cbc:Line>
        </cac:AddressLine>
        <cac:Country>
          <cbc:IdentificationCode>US</cbc:IdentificationCode>
        </cac:Country>
      </cac:Address>
    </cac:DeliveryLocation>
  </cac:Delivery>
  <cac:TaxTotal>
    <cbc:TaxAmount currencyID="USD">1.25</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxAmount currencyID="USD">1.25</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:ID>VRBL:X12:LT</cbc:ID>
        <cac:TaxScheme>
          <cbc:ID>TAX</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:LegalMonetaryTotal>
    <cbc:LineExtensionAmount currencyID="USD">15</cbc:LineExtensionAmount>
    <cbc:TaxExclusiveAmount currencyID="USD">15</cbc:TaxExclusiveAmount>
    <cbc:TaxInclusiveAmount currencyID="USD">16.25</cbc:TaxInclusiveAmount>
    <cbc:PayableAmount currencyID="USD">16.25</cbc:PayableAmount>
  </cac:LegalMonetaryTotal>
  <cac:InvoiceLine>
    <cbc:ID>1</cbc:ID>
    <cbc:InvoicedQuantity>15</cbc:InvoicedQuantity>
    <cbc:LineExtensionAmount currencyID="USD">15</cbc:LineExtensionAmount>
    <cac:Item>
      <cbc:Description>Jumbo papersheets for use with matching giant ballpoint pen</cbc:Description>
      <cbc:Name>Jumbo paper sheets</cbc:Name>
    </cac:Item>
    <cac:Price>
      <cbc:PriceAmount currencyID="USD">1</cbc:PriceAmount>
      <cbc:BaseQuantity>1</cbc:BaseQuantity>
    </cac:Price>
  </cac:InvoiceLine>
</ubl:Invoice>
Rules
Rule ID Error Message
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.