VRBL: Document-Level Totals

Read about Document-level totals are modeled.

Document-level totals apply to the entire Document and generally summarize totals from the line level.

These elements are also checked to see if they meet the requirements for that country. For example, in Germany, the following logic is used:

Monetary Total Payable Amount = Legal Monetary Total Tax Inclusive Amount - Legal Monetary Total Prepaid Amount + Legal Monetary Total Payable Rounding Amount - sum of Prepaid Payment Paid Amount

You use the the LegalMonetaryTotal element to model most totals (the exception being the Tax Amount that is modeled in the TaxTotal element).

This topic explains how Vertex e-Invoicing uses these elements to calculate totals at the Document level.

Restrictions

  • You need to ensure that the totals here are correct.
  • Only the amounts specified in the LegalMonetaryTotal element are submitted to Tax Authorities. If there is a discrepancy between the amounts in the LegalMonetaryTotal element and the others like AllowanceCharge, the totals in the LegalMonetaryTotal element are used.

Calculations

The following totals are calculated based on the information specified in your VRBL Documents:

  • Tax Amount: The sum of all the tax amounts in the Document.
  • Total Net Amount: Sum of all invoice line net amounts. The Invoice Line Net Amounts topic explains how these individual line amounts are modelled.
  • Tax Exclusive Amount: The sum of invoice line net amounts minus the sum of Document-level Allowances plus the sum of all Charges on the Document level.
  • Tax Inclusive Amount: Total amount of the Document including tax.
  • Total Allowance Amount: The sum of all Document-level Allowances.
  • Total Charge Amount: The sum of all Document-level Charges.
  • Total Due for Payment: The amount due for payment. This is the total amount including tax minus the paid amount plus the rounding amount.

The following section explains how each of these totals are calculated in more detail:

Tax Amount

DetailValue
Subelement Name (Path)Invoice Total Tax Amount (Invoice/TaxTotal/TaxAmount)
Element Reference TopicTaxTotal
Modeling Guide TopicVRBL: Tax Totals and Subtotals
DescriptionThe sum of all the tax amounts in the Document.
CalculationΣ of all Document-level (Invoice/TaxTotal/TaxSubtotal/TaxAmount) elements.

Total Net Amount

DetailValue
Subelement Name (Path)Sum Of Invoice Line Net Amount (Invoice/LegalMonetaryTotal/LineExtensionAmount [@currencyID=])
Element Reference TopicLegalMonetaryTotal
Modeling Guide TopicVRBL: Tax Totals and Subtotals
DescriptionSum of all invoice line net amounts. The Invoice Line Net Amounts topic explains how these individual line amounts are modelled.
CalculationΣ of all Invoice Line Net Amount (Invoice/InvoiceLine/LineExtensionAmount) elements

Tax Exclusive Amount

DetailValue
Subelement Name (Path)Invoice Total Amount Without Tax (Invoice/LegalMonetaryTotal/TaxExclusiveAmount [@currencyID=])
Element Reference TopicLegalMonetaryTotal
Modeling Guide TopicVRBL: Tax Totals and Subtotals
DescriptionThe sum of invoice line net amounts minus the sum of Document-level Allowances plus the sum of all Charges on the Document level.
CalculationSum of Invoice Line Net Amount (LegalMonetaryTotal/LineExtensionAmount) - Sum of Allowances on Document Level(LegalMonetaryTotal/AllowanceTotalAmount) + Sum of Charges on Document Level (LegalMonetaryTotal/ChargeTotalAmount)

Tax Inclusive Amount

DetailValue
Subelement Name (Path)Invoice Total Amount With Tax (LegalMonetaryTotal/TaxInclusiveAmount)
Element Reference TopicsLegalMonetaryTotal and TaxTotal
Modeling Guide TopicVRBL: Tax Totals and Subtotals
DescriptionTotal amount of the Document including tax.
CalculationInvoice Total Amount Without Tax (Invoice/LegalMonetaryTotal/TaxExclusiveAmount [@currencyID=]) + Tax Category Tax Amount (/Invoice/TaxTotal/TaxSubtotal/TaxAmount)

Total Allowance Amount

DetailValue
Subelement Name (Path)Invoice Total Amount With Tax (LegalMonetaryTotal/TaxInclusiveAmount)
Element Reference TopicLegalMonetaryTotal and AllowanceCharge
Modeling Guide TopicVRBL: Tax Totals and Subtotals and VRBL: Allowances
DescriptionThe sum of all Document-level Allowances.
CalculationSum of all Document-level Allowance/Charge - Amount (Invoice/AllowanceCharge/ChargeIndicator=false/Amount) elements.

Total Charge Amount

DetailValue
Subelement Name (Path)Sum Of Charges on Document Leve (LegalMonetaryTotal/ChargeTotalAmount)
Element Reference TopicLegalMonetaryTotal and AllowanceCharge
Modeling Guide TopicVRBL: Tax Totals and Subtotals and VRBL: Charges
DescriptionThe sum of all Document-level Charges.
CalculationSum of all Document-level Allowance ÷ Charge - Amount (Invoice/AllowanceCharge/ChargeIndicator=true/Amount) elements.

Total Due for Payment

DetailValue
Subelement Name (Path)Amount Due For Payment (Invoice/LegalMonetaryTotal/PayableAmount [@currencyID=])
Element Reference TopicLegalMonetaryTotal
Modeling Guide TopicVRBL: Tax Totals and Subtotals and VRBL: Rounding
DescriptionThe amount due for payment. This is the total amount including tax minus the paid amount plus the rounding amount.
CalculationInvoice Total Amount Without Tax (LegalMonetaryTotal/TaxExclusiveAmount) - Prepaid Amount (LegalMonetaryTotal/PrepaidAmount) + Rounding Amount (LegalMonetaryTotal/PayableRoundingAmount)