Search Results receipt_class

Overview

APPS.JAI_AR_UTILS_PKG is an Oracle E-Business Suite utilities package body that supports the Oracle Financials for India localization layer on top of Oracle Receivables. Its primary business function is to provide shared helper logic for Indian tax and statutory processing associated with Receivables transactions, receipts, and registrations. In release 12.1.1 and 12.2.2 the package is catalogued under the APPS schema with an API classification of OTHER, indicating that it is not published as a formal public API but is instead consumed internally by other India-localization components.

The package encapsulates recurring processing concerns that would otherwise be duplicated across forms and concurrent programs: tax recalculation on transaction lines, receipt class and receipt tax evaluation, registration-related lookups, and locator handling. Because receipt_class is a common search term associated with this object, the package is frequently examined when users need to understand how India tax treatment is decided at the receipt level, that is, whether a given receipt class attracts receipt-based taxes.

Key Procedures and Functions

The documented package exposes six procedures and functions. Each serves a distinct utility role within the India localization stack.

• RECALCULATE_TAX — Recomputes tax amounts for Receivables transaction lines. Historical change notes indicate this routine was corrected to handle inclusive tax arithmetic so that base tax amounts are derived correctly after tax calculation, and to obtain tax amounts from JAI_AR_TRX_TAX_LINES rather than from the tax definition table for ad hoc taxes, where the definition amount is always zero.
• LOCATOR_HANDLER — Manages locator-related processing, typically concerned with identifying or validating the inventory locator context used by India-localization logic. It operates against MTL_UNITS_OF_MEASURE and related setup data.
• APPS_REL_INSERT — Inserts records into the applications relationship table JAI_AR_TRX_APPS_RELS_T, supporting the linkage of transaction data to applicable tax and statutory application rules.
• GET_TCS_FLAG — Returns the Tax Collected at Source indicator, allowing calling components to determine whether TCS treatment applies for a given context.
• GET_RECEIPT_CLASS_FLAG — Returns a flag derived from receipt class configuration in AR_RECEIPT_CLASSES. This function is central to the package's receipt_class-related behavior, enabling callers to branch on whether a receipt class is subject to India receipt taxes.
• IS_RECEIPT_TAXES_EXISTS — Determines whether receipt taxes exist for the applicable configuration, giving callers a boolean-style decision point before invoking further tax processing.

Tables Accessed

The package reads and writes a defined set of India-localization and standard Receivables tables through APPS synonyms.

• AR_RECEIPT_CLASSES and AR_RECEIPT_METHODS — Provide receipt class and receipt method configuration used by GET_RECEIPT_CLASS_FLAG and IS_RECEIPT_TAXES_EXISTS.
• JAI_AR_TRX_TAX_LINES — Stores transaction-level tax lines; read by RECALCULATE_TAX to obtain authoritative tax amounts, including ad hoc taxes.
• JAI_AR_TRX_UPDATE_T and JAI_AR_TRX_APPS_RELS_T — Support transaction update staging and applications relationship insertion via APPS_REL_INSERT.
• JAI_CMN_TAXES_ALL and JAI_CMN_DOCUMENT_TAXES — Hold India tax definitions and document-to-tax associations that drive tax determination logic.
• JAI_RGM_DEFINITIONS and JAI_RGM_REGISTRATIONS — Hold registration definitions and registrations, used for statutory registration validation.
• MTL_UNITS_OF_MEASURE — Referenced for unit of measure validation in locator handling.

Usage Notes

JAI_AR_UTILS_PKG is referenced by three other packages within the EBS environment, confirming its role as a shared internal utility rather than an entry-point API. It is typically invoked indirectly: Oracle Receivables India-localization forms, such as transaction and receipt workbenches, and India tax concurrent programs call the dependent packages that in turn call these utility routines. Customizations implemented in the India localization layer may also call GET_RECEIPT_CLASS_FLAG and IS_RECEIPT_TAXES_EXISTS when determining receipt tax applicability.

Because the package is not classified as a public API, direct calls from customer-written code should be treated with caution. The change history demonstrates that the internal logic, particularly for inclusive tax and ad hoc tax retrieval, has been revised across patches; custom code that depends on its behavior should be reviewed against the current patch level for the 12.1.1 or 12.2.2 instance in use.