Skip to main content

Legal

Tax & Accounting

Trade & Supply

Risk & Fraud

News & Media

Books

Developers

VCTV

Schema fields for VCTV

This table includes the elements that can be found in the
input schema
 for the Vendor Charged Tax Verification (VCTV) feature.
Element
Level
Required
Description
ACCRUAL_METHOD
Invoice/Header
No
Accrual method specified in the request. The accrual method configured in Determination can be overridden in the request.
DOCUMENT_TYPE
Invoice/Header
Yes
The document type to use with the VCTV feature.
IS_VENDOR_TRUSTED
Invoice/Header
No
A trusted vendor designation can be overridden in the request.
VENDOR_TAX
Invoice/Header
No
The amount of tax charged by vendor.
This table includes the elements that can be found in the output schema.
Element
Level
Description
ACCRUAL_AMOUNT
Invoice
The total tax amount to be accrued for the invoice. This is determined based on the invoice accrual method.
ACCRUAL_AMOUNT
Line
The accrued amount per invoice line. This is determined based on the accrual method.
ACCRUAL_AMOUNT
Jurisdiction/Tax
The accrued amount for each jurisdiction for each invoice line. This amount's determined using the tax rate-based allocation method.
ACCRUAL_METHOD
Invoice/Header
The input accrual method (override) used for the transaction.
ALLOCATION_METHOD
Line
For undercharged U.S. transactions, the allocation method applied to the accrued amount. The XML's the line level. Valid values include TAX_RATE-BASED, TOP-DOWN, or BOTTOM-UP.
AMT_WITHIN_TOLERANCE_INDICATOR
Invoice/Header
Includes whether the vendor charged tax (VCT) amount's within the passing range for the tolerance amount check.
IS_DPP_APPLIED
Invoice/Header
For a U.S. transaction, indicates whether all invoice lines have a valid direct pay permit. These are considered at the invoice level. The value's true if all lines have a valid direct pay permit. Otherwise, the value's false.
IS_DPP_APPLIED
Line
The direct pay permit state. Valid values include Y and N. Direct pay permit applied for the line status.
IS_TRUSTED_VENDOR_AUDIT_INDICATOR
Invoice/Header
Indicates whether to audit the transaction for the trusted vendor. The value's true if the trusted vendor's excluded from the audit check. Otherwise, the value's false.
IS_VCT_APPLIED
Invoice/Header
Indicates whether the vendor charged tax is applied. Valid values include true or false.
VENDOR_CHARGE_TAX_GROUP_NAME
Invoice
If included in the request, the name of the vendor charged tax group used for the invoice.
VENDOR_CHARGE_TAX_GROUP_OWNER
Invoice
If included in the request, the name of the company that owns the vendor charged tax group.
VCT_RESPONSE_CODE
Invoice/Header
The response code when VCTV processing ends.
PAY_TO_VENDOR_AMOUNT
Invoice/Header
The total amount (gross amount and tax) to pay to the vendor at the invoice level.
PAY_TO_VENDOR_AMOUNT
Line
The total amount (gross amount and tax) to pay to the vendor at the line level.
PERCENT_WITHIN_TOLERANCE_INDICATOR
Invoice/Header
Indicates whether the VCT amount's within the passing range for the tolerance percentage check.
SHORT_PAY_VENDOR
Invoice/Header
Indicates whether to short pay the vendor. Valid values include Y, N, and NA (hold accrual).
TAX_SUMMARY
Line
The Determination Calculated Tax (DCT) amounts for each line.
TAX_VARIANCE
Line
The difference between the DCT amount and the VCT amount at the line level.
TAX_VARIANCE
Invoice
The difference between the DCT amount and the VCT amount at the invoice level.
THRESHOLD_AMOUNT
Invoice/Header
The configured tolerance amount value used for the tolerance amount check.
THRESHOLD_PERCENT
Invoice/Header
The configured tolerance percentage value used for the tolerance percentage check.
TOTAL_TAX_AMOUNT
Invoice/Header
The total tax amount calculated by Determination for the invoice.
TRUSTED_VENDOR
Invoice/Header
Indicates whether the vendor's considered a trusted vendor for the transaction. Valid values include Y and N.
USE_TAX_CONFIG
Invoice/Header
Indicates whether the transaction was run as Buyer or Seller. Valid values include Yes and No. Yes indicated the transaction was run as Buyer.
VCT_CALC_COMPANY_ROLE
Invoice
The company role for VCTV processing. Populated only when the company role's switched from Buyer to Seller.
VCT_DET_TAX_VARIANCE_AMT
Invoice/Header
The tax variance amount. VCTV processing continues when the difference between the vendor charged tax and the total tax calculated for the invoice exceeds the variance amount.
VCT_EFFECTIVE_TAXABLE_BASIS
Authority
The taxable basis determined using the accrued amount for each line. The formula for calculating the taxable basis is: accrual amount at the jurisdiction level / jurisdiction tax rate = taxable basis.
VCT_STATUS
Invoice/Header
Indicates whether the vendor charged tax is overcharged or undercharged. Valid values include ND (no difference), OC (overcharge), and UC (undercharged).
VENDOR_TAX
Authority/Tax
The vendor tax amount to be paid to all taxing jurisdictions for each line (prorated vendor tax at the line level).
VENDOR_TAX
Invoice/Header
The VCT amount included in the request. This is sent back to the ERP system.
VENDOR_TAX
Line
The VCT amount at the line (prorated vendor tax at the invoice level).

This article applies to:

  • Product: ONESOURCE Determination, ONESOURCE Indirect Tax