Search Results c_source_code




Overview

BIM_RESPONSE_IMPORT_PUB is a public PL/SQL package in the Oracle E-Business Suite Applications (APPS) schema that supports the import of supplier response data into the Oracle Advanced Procurement / Sourcing (AMS) module. Its fundamental business purpose is to validate and load bid responses, including response grades and rejection reasons, that have been captured in the interface staging tables and are awaiting processing into the production sourcing data model. The package belongs to the BIM (Bidding/Procurement) family of objects and carries an API classification of PUB, indicating that it is a documented, callable interface intended for use by external processes, concurrent programs, and custom code.

The source header identifies the internal package name as BIM_Response_IMPORT and references an origin date of 2005, reflecting a component that has been stable within the purchasing and sourcing stack across releases. The package body initializes global session context values such as G_USER_ID and G_LOGIN_ID from FND_GLOBAL, ensuring that audit columns and validation logic carry accurate user and login attribution throughout a run.

Key Procedures and Functions

The documented public interface exposes a single procedure, IMPORT_RESPONSES, which serves as the primary entry point for processing supplier responses from the interface tables into the destination structures. The internal source excerpt additionally reveals a validation routine, VALIDATE_RESPONSES, which performs the data quality checks required before import. IMPORT_RESPONSES orchestrates the overall load, invoking validation against the response grade and invalid-reason tables and then committing the accepted records.

VALIDATE_RESPONSES accepts parameters for source code, response country, response source, a response creation date, and PL/SQL collection tables carrying grade and invalid-reason values. It returns a standard API return status along with message count and message data outputs, following the conventional EBS API error-handling pattern (x_return_status, x_msg_count, x_msg_data). Internally it references lookups such as AMS_RESP_GRADE and AMS_RESP_REJECT_REASON to confirm that submitted grades and rejection reasons are valid before the data proceeds.

Tables Accessed

The package reads and writes a defined set of interface and reference tables through APPS synonyms. The staging tables BIM_R_RESP_INT_HEADER, BIM_R_RESP_INT_HEADER_S, BIM_R_RESP_INT_GRADES, BIM_R_RESP_INT_GRADES_S, BIM_R_RESP_INT_REASON, and BIM_R_RESP_INT_REASON_S hold header, grade, and rejection-reason data awaiting import. AMS_SOURCE_CODES provides the sourcing source-code reference used during validation, while JTF_LOC_HIERARCHIES_B supplies location hierarchy data for country and geographic validation. DUAL is used for scalar evaluations, and PLITBLM represents the PL/SQL table utility used to manipulate the indexed collection structures declared in the package. Together these tables support both the validation of incoming responses and the transfer of validated records into the sourcing application.

Usage Notes

BIM_RESPONSE_IMPORT_PUB is typically invoked by concurrent programs and batch processes that move supplier responses from interface staging into Oracle Sourcing, or by custom code that programmatically submits response data captured through forms, uploads, or integration layers. Because it is classified as a public API, callers should pass the standard return status and message parameters and inspect them after each invocation to handle validation failures. The package is not referenced by other documented packages, so it functions as a self-contained entry point. When extending or troubleshooting, the associated interface tables should be reviewed first, since validation outcomes and rejection reasons are persisted there through the reason and grade staging tables.