Results for “get_tax_amount”

AI-generated from documented ETRM metadata — verify critical details on the linked pages.

Overview

The APPS.ZX_TDS_CALC_PKG package is a component of the Oracle E-Business Tax (EBTax) engine in Oracle EBS Release 12.1.1 and 12.2.2. Its primary business function is to calculate Tax Deducted at Source (TDS), a withholding-tax mechanism widely used in jurisdictions such as India where tax is deducted at the point of payment or invoicing. The package operates within the tax determination and tax calculation framework maintained by the ZX schema objects. It is classified as an "OTHER" API in the ETRM documentation, indicating that it is an internal calculation engine rather than a published integration API. Configuration and formula-driven logic reside outside this package, while the package applies that logic to actual transaction lines during tax calculation.

Key Procedures and Functions

The documented interface exposes a single program unit:

• GET_TAX_AMOUNT — The core routine that returns the TDS amount computed for a given tax calculation context. It derives the taxable base from the relevant tax lines and applies the applicable TDS rate, formula, threshold, and reporting-code logic defined in the EBTax setup.

As only the name and purpose are documented, parameter lists are not reproduced here. Callers pass tax line and formula context into the routine and receive the calculated withholding amount, which the calling engine then records on the tax lines.

Tables Accessed

The package reads and writes the following documented tables through APPS synonyms:

• ZX_DETAIL_TAX_LINES_GT — A global temporary table holding detail-level tax line data during calculation; populated and consumed during the tax determination run.
• ZX_LINES — The central tax line table; the package reads line-level amounts and attributes as the basis for TDS computation.
• ZX_PROCESS_RESULTS — Stores interim and final results of the tax process; the calculated TDS amount is written here.
• ZX_TAXES_B — The tax definition table; supplies tax configuration such as tax type, rate reference, and TDS indicators.
• ZX_SCO_FORMULA and ZX_FORMULA_DETAILS — Define the formula conditions and components used to derive the TDS amount.
• ZX_REPORTING_CODES_B — Provides reporting-code classification, relevant to statutory TDS reporting (for example, withholding tax sections).
• PLITBLM — A PL/SQL integer table type used internally to buffer collections of identifiers during processing.

Together these tables allow the package to obtain tax configuration, resolve formula logic, and persist results alongside the standard tax lines.

Usage Notes

ZX_TDS_CALC_PKG is invoked internally by the EBTax calculation flow rather than by end users directly. It references ZX_API_PUB and the standard STANDARD package, confirming its reliance on the public tax API infrastructure. It is referenced by ZX_TDS_CALC_SERVICES_PUB_PKG, the service-layer entry point, and by ZX_TDS_IMPORT_DOCUMENT_PKG, which supports document import scenarios such as India Localization TDS processing. The package is therefore reached during normal tax calculation for transactions configured with TDS taxes, during concurrent tax processes, and during document import. Custom code should not call GET_TAX_AMOUNT directly; instead, integrations should use the supported public APIs, since the ETRM classifies this package as internal and no formal parameter contract is published.