Search Results ap_card_emp_candidates_pk




Overview

The AP_CARD_EMP_CANDIDATES table is a core data object within the Oracle E-Business Suite Payables (AP) module, specifically supporting the Corporate Cards functionality. As indicated by its description, "New Card Employee Candidates," this table serves as a staging or intermediate repository. Its primary role is to hold records of employees who have been identified as potential candidates for receiving a corporate purchasing or travel card. The table is integral to the workflow of card program administration, facilitating the process of selecting, reviewing, and approving employees before their official enrollment and card issuance.

Key Information Stored

The table's structure is designed to link candidate employees with specific card programs. Based on the provided metadata, the critical columns include:

  • CARD_ID: This is the primary key column for the table (as part of the AP_CARD_EMP_CANDIDATES_PK constraint). It stores a unique identifier that links each candidate record to a specific corporate card program defined in the system. This column is also a foreign key referencing the AP_CARDS_ALL table, establishing the relationship between a candidate and the card for which they are being considered.
  • While the full column list is not detailed in the excerpt, typical columns in such a candidate table would include identifiers for the employee (e.g., PERSON_ID or EMPLOYEE_ID), the status of the candidacy (e.g., PENDING, APPROVED, REJECTED), and audit information such as creation date and who proposed the candidate.

Common Use Cases and Queries

This table is central to administrative reporting and process management for corporate card programs. Common use cases include generating lists of pending candidates for managerial review, tracking the approval pipeline, and auditing the card assignment process. A typical query would join this table to employee and card master tables to produce a meaningful candidate report.

Sample SQL Pattern:

  • To list all pending candidates for a specific card program:
    SELECT ac.employee_id, ac.creation_date, aca.card_number
    FROM ap_card_emp_candidates ac,
         ap_cards_all aca
    WHERE ac.card_id = aca.card_id
    AND ac.status = 'PENDING'
    AND aca.card_id = :p_card_id;
  • To identify all card programs for which a specific employee is a candidate:
    SELECT aca.card_number, aca.description, ac.status
    FROM ap_card_emp_candidates ac,
         ap_cards_all aca
    WHERE ac.card_id = aca.card_id
    AND ac.employee_id = :p_employee_id;

Related Objects

The primary and most critical relationship for this table is defined by its foreign key constraint. As documented:

  • AP_CARDS_ALL: This is the master table for corporate card programs in Oracle Payables. The AP_CARD_EMP_CANDIDATES.CARD_ID column references AP_CARDS_ALL.CARD_ID. This ensures that every candidate is associated with a valid, existing card program. Any process or report involving candidates will typically join to this table to retrieve card details like card number, description, and program limits.
  • While not explicitly listed in the metadata, this table would also have logical relationships with core HRMS tables (such as PER_ALL_PEOPLE_F) to obtain employee names and details, and potentially with workflow tables if the candidate approval process is automated.