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). |