Search Results fa_group_retirement_pvt

Overview

FA_GROUP_RETIREMENT_PVT is an internal, private PL/SQL package within the Oracle E-Business Suite Fixed Assets (FA) module. The _PVT suffix identifies it as a private API layer, meaning it is not exposed as a public integration point and is intended to be called by other, higher-level API packages rather than directly by customer extensions. Its business purpose is to process group retirements, reinstatements, and the reversal of those operations for one or more assets held in a common group. Group retirement allows an organization to retire a set of related assets in a single logical transaction, and this package encapsulates the underlying validation and data manipulation logic that executes those bulk operations consistently.

Key Procedures and Functions

The package exposes four documented entry points that mirror the lifecycle of a group retirement transaction:

• DO_RETIREMENT — Performs the group retirement operation, applying retirement processing across the assets targeted by the group transaction. This is the primary action procedure invoked to retire a group of assets.
• UNDO_RETIREMENT — Reverses a previously performed group retirement, restoring the affected assets to their pre-retirement state. This supports correction of retirements entered in error.
• DO_REINSTATEMENT — Executes a reinstatement, effectively bringing previously retired assets back into service for the group. It is distinct from undo in that it represents the forward reinstatement business event.
• UNDO_REINSTATEMENT — Reverses a previously performed reinstatement, returning the assets to the retired state.

No parameter signatures are documented in the ETRM metadata for these routines; consumers should treat them as internal interfaces invoked by the parent group retirement API and not assumed to be callable with a stable public contract.

Tables Accessed

The ETRM metadata records that this package references other objects through its dependency list rather than enumerating base tables directly. The documented dependencies include the APPS.FA_API_TYPES package (which supplies the shared public API type definitions and record structures used across Fixed Assets APIs) and FND_GLOBAL (the standard applications utility used to resolve the current user, login, and responsibility context). Because the package operates on the FA asset tables to persist retirement and reinstatement results, it relies on these dependent objects to receive validated input structures and to establish the correct runtime context. Base FA tables are accessed indirectly through the supported API framework rather than through direct DML in the metadata.

Usage Notes

FA_GROUP_RETIREMENT_PVT is a private package and is referenced by other packages within the APPS schema, most notably the public-facing group retirement API that wraps it. It is not intended to be invoked directly from client code, Oracle Forms personalizations, or custom concurrent programs. In standard Oracle EBS 12.1.1 and 12.2.2 flows, group retirement business events are driven through the Fixed Assets application or through the published FA APIs, which in turn delegate to this private layer. Because the procedure signatures are not part of a published contract, developers should never call FA_GROUP_RETIREMENT_PVT directly; instead they should use the supported public Fixed Assets API. Any dependency on this package should be treated as internal and subject to change during patching or upgrades.