Professional Documents
Culture Documents
Suppliers in R12
Contents
Introduction
Overview
Controlling Supplier Information Entry
Entering Employees as Suppliers
Creating an Employee Supplier from an Expense Report
Entering an Employee Supplier Manually
Updating Employee Suppliers
Expense Report Export
Employee Update Program
Querying Employee Suppliers
Merging Employee Suppliers
Employee Supplier
Employee Supplier Site Contacts
Technical Information
References
Introduction
In Release 12 the Oracle E-Business Suite application has been enhanced to
maintain employee address and other important, sensitive information only
in the Oracle HR application. This enhancement has been done to support
Safe Harbour requirements, which requires the application to support data
privacy and data security of sensitive information like employee related
information.
Oracle Payables has migrated Supplier data into the Trading Community
Architecture (TCA) repository. TCA provides a single common definition that
can be used to identify customers, suppliers, and organizations that provide
you with goods or services, and are in turn, a customer of your own products
or services. The TCA repository stores the key elements that define an
organization, identity, business locations, and key contacts. TCA already has
Employees created in the HR application defined as a Party. Since TCA is a
common repository, the Party information will be available for all products of
EBS applications to access employee related information. Five Oracle
financial applications use the Suppliers pages: Payables, Purchasing, Assets,
Property Manager, and iSupplier Portal.
This article was written to try and clarify the supplier changes introduced
with R12 and to then explain how they relate specifically to employee
suppliers in Payables.
Overview
You set up and maintain suppliers in the Suppliers pages to record
information about individuals and companies from whom you purchase
goods and services. Payables uses employee information to create and
update employee type supplier records. You can then pay employees for
expense reports and invoices. If your site uses Oracle HRMS, then you can
access employee information entered by your Human Resources department
through the People window. If your site does not have Oracle HRMS installed,
you can access employee information in the Enter Person window. When you
enter a supplier that does business from multiple locations, you store
supplier information only once, and enter supplier addresses for each
location. You can designate supplier addresses as payment, purchasing, RFQ
only, or procurement card locations.
Note: Suppliers can have can have multiple addresses and each address can
be used by an operating unit through a supplier site record.
Most supplier information automatically defaults to all supplier sites to
facilitate supplier site entry. However, you can override these defaults and
have unique information for each site.
When the system enters that information in a later transaction, it only uses
supplier site information as a default, even if the supplier site value is null
and the supplier has a value. If you update information at the supplier level,
existing supplier sites are not updated.
You can either grant full update access to your users or grant them read-only
access to the Supplier pages. You can also grant access to users to view all
supplier records or only to view Standard Suppliers. This allows you to
restrict the users that can access employee-supplier records that contain
sensitive personal information for the employee that is used to pay their
expenses. The current functionality does not provide any way to restrict
access to employee suppliers only. If a user is granted employee supplier
access then they will also have access to standard suppliers and an
enhancement request was logged for this. Please see Note:1368011.1 for more
information.
R12 Supplier entry and inquiry navigation paths still exist but they are the
same webform and therefore the ability to create suppliers exists by default
in the inquiry page. To prevent users from creating suppliers it is necessary
to exclude the function Supplier Full Access: Buyer View
(POS_HT_SP_ACCESS_FULL) from a responsibility and assign that
responsibility to users you wish to prevent from having this ability.
1. System Administrator > Security > Responsibility > Define
2. Query the Payables responsibility you want to only have Inquiry
access.
3. Under Menu Exclusion area, set the following:
Type = Function
Name = Supplier Full Access : Buyer View
4. Save and test this responsibility.
The employee specific functions which are currently available for supplier
restrictions are as follows:
POS_HT_SP_EMP_SUPPLIER - Create/Update employee supplier details
POS_HT_SP_RO_EMP_SUPPLIER - View employee supplier details
Responsibilities that need the ability to create employee suppliers need to
have POS_HT_SP_EMP_SUPPLIER added to the menu, however if
responsibility is an inquiry only responsibility then the function
POS_HT_SP_RO_EMP_SUPPLIER needs to be added to allow inquiry of
employee suppliers. See Note: 1368011.1 and 955482.1.
Objective
Responsibility Level)
Inquiry
Prevent
Supplier
Creation
Inquiry
Query
Employee
Suppliers
Entry
Create/Update
Suppliers
Entry
Create/Update
Employee
Suppliers
c) In the Payables Options window, set the options in the Expense Report
region. Enable the Automatically Create Employee as Supplier option
so Payables will automatically create a supplier record the first time
you import an expense report for each employee.
d) Enter employee records. Either your Human Resources department
enters employee information in the People window (if HRMS is
installed), or the appropriate department enters employee information
in the Enter Person window. To ensure that Payables can create a
supplier record during Expense Report Export, the following are
requirements for each employee record:
the employee name is unique
reimbursement address for either Home or Office exists
City/State/Country does not exceed 25 characters
Zip Code for the home address does not exceed 20 characters
e) (Optional) In the Suppliers page, enter a supplier record for the
employee. You don't need to do this step if you complete steps 2 and
3, because the system creates supplier records automatically during
Expense Report Export.
f) To link an existing supplier with an employee, in the Suppliers:
Organization page, choose Employee as the Type, then enter either the
employee name in the Supplier Name field or the employee number in
the Supplier Number field. (Payables creates this link automatically for
any employee supplier records it creates during Expense Report
Export.)
Note: If you create a supplier for an employee, you cannot change the
Supplier Type from an Employee. The TCA Person Party that represents
the employee is also used to represent the supplier. TCA does not allow
you to change a Person Party into an Organization party. For standard
suppliers, you can update the Supplier Type after the supplier has been
created. However, you cannot change it to Employee.
If you do not have the supplier type Supplier used to process expense
payments to internal employees then you do not have the correct access.
See Notes:955482.1, 1371295.1
Enter required fields and click Apply
Whichever method was used to create the supplier, a row is inserted into the
AP_SUPPLIERS table. AP_SUPPLIERS stores information about supplier level
attributes. This table contain supplier records entered manually, generated
automatically (i.e. during expense reports export) and imported using open
interface tables. Each row includes the purchasing, receiving, invoice, tax,
classification, and general information. Suppliers created in any module in
EBS for example Payables, Purchasing, iSP etc., will get stored in this table
along with TCA table - HZ_PARTIES. This table replaces the old PO_VENDORS
table. A new view PO_VENDORS is created on this table. The supplier name,
legal identifiers of the supplier will be stored in TCA and a reference to the
party created in TCA will be stored in AP_SUPPLIERS.PARTY_ID, to link the
party record in TCA table HZ_PARTIES.
If the Create Payment Site field is checked (Home, Office or Provisional) then
a supplier site is also created.
AP_SUPPLIER_SITES_ALL stores information about supplier site level
attributes. A row in this table stores unique combination of supplier address,
operating unit and the business relationship defined with the supplier. This
table replaces the old PO_VENDOR_SITES_ALL table. A new view
PO_VENDOR_SITES_ALL is created on this table.
The supplier address information is not maintained in this table and is
maintained in Trading Community Architecture (TCA). The reference to the
internal identifier of address in TCA will be stored in
AP_SUPPLIER_SITES_ALL.LOCATION_ID, to link the address record in TCA table
HZ_LOCATIONS. Each row includes the supplier reference, purchasing,
invoice, and general information.
The R12 model allows employees and standard (non-employee) suppliers to
be created with the same name. It is a valid business scenario to have
multiple employees having same name, or standard suppliers and employee
type suppliers having the same name. Duplicate supplier name validation
happens only in case of standard suppliers as it is still not possible to have
two standard suppliers with the same name and this is being tracked in ER
5123472. If you are unable to add a non-employee supplier with the same
name as an employee supplier then you are likely hitting the issue described
in Note:761415.1
In order to allow users to differentiate employees with the same first and last
name the following changes were made:
Once the results are returned use the Update button to access the details for
the supplier.
Note: By default the Suppliers page has the Create Supplier button available.
When querying an employee supplier and navigating to the Organization
page, the Tax and Financial Information section is missing by design as all
employee tax information is entered, viewed and maintained from HR.
Employee supplier TIN/SSN data is not displayed in Payables forms or reports
since this is confidential information.
Tip: The system links the supplier number with the employee number, so
the link between the records is maintained even if the employee name and
supplier name change. So if you want to query all records for any supplier,
use the supplier number.
When querying an employee supplier in AP, the display name format might
be different than the display name in HR. There is a bug where running the
EUP will change the display name in AP to Last Name, First Name Middle
Name which is different to the way it is stored in HR (PER_ALL_PEOPLE_F).
See Note: 1269458.1.
In R12, when you submit the EUP, the system identifies any employee
records that have changed since the last time you submitted the program. If
any employee records have been updated, then EUP updates the
AP_SUPPLIERS.VENDOR_NAME (updated from Employee Name) and the
inactive date information in the supplier records. This program no longer
updates the address information for the supplier. EUP does not work correctly
if the last name and first name are the same and a patch is required to
resolve this. Please see Note: 1322681.1.
If an employee supplier is terminated in HR and then expense reports are
submitted, the system does not provide a way to process the expense report
payment as the inactive date of the employee supplier cannot be updated
once the actual termination date has passed. A patch was provided to fix
this - full details available from Note: 1205384.1.
temporary address (Other than 'Home' & 'Office'). See Note: 887015.1,
Note:1191544.1 and 952913.1.
This provisional functionality is ONLY available to customers that have Oracle Human
Resources FULLY installed. Shared HR customers DO NOT have this functionality .
You can find out whether you have HR fully installed or shared by running the following script:
SQL> Select p.application_id, p.status, a.application_short_name
from fnd_product_installations p,
fnd_application a
where p.application_id = a.application_id
and p.application_id in (800)
order by a.application_id;
APPLICATION_ID S APPLICATION_SHORT_NAME
-------------- - -------------------------------------------------800
I
PER
Here a status of I means this is Fully Installed. A status of S would be a shared install.
In HRMS: A new option named Provisional is provided in Mail To LOV available
in employee information:
In Payables > Financials Options > Human Resources tab - A new option
named
Provisional is provided in Employee Reimbursement Address LOV:
Create Supplier page - Enables users to create a new payment site named
Provisional apart from Home and Office.
Create Address: Site Creation page - Enables users to create a new Expense
Payment Site Name
HRMS and the full address needs to be entered in HRMS address information
for the address type of Mailing.
However if the expense payment site is different from any the above
mentioned (generally in case of an application upgrade from Release 11)
(i.e.) 'Home', 'Office' or 'Provisional' then the logic applied for 'Home' will be
applied.
Employee type suppliers in the R12 Supplier model are treated differently
than other types of Suppliers. Employee type suppliers do not have Address
records in TCA associated with them. They can have the OFFICE, HOME or
PROVISIONAL sites, but there is no address as defined in TCA.
Address elements (Address1, City, State, etc.) for the HOME site are taken
directly from the People form in HR and for the OFFICE site are found using
the Location value from the Assignment window of the HR People form, and
then from the Locations form. It is intended behaviour to not display this
data in the Supplier form at all as a Payables clerk does not need to have
access to the home address of every employee who is set up to receive
Expense payments.
Table PER_ADDRESSES stores Home & provisional information. HOME sites
have Primary_Flag=Y and PROVISIONAL sites have the Address_Type =M.
Office site details are stored in HR_LOCATIONS and Location_ID links to
PER_ALL_ASSIGNMENTS_F.Location_id. PER_ALL_ASSIGNMENTS_F. Person_id
is used to link to PER_ALL_PEOPLE_F.
In R12, due to security reasons the application has been enhanced so that
sensitive Employee Supplier information is neither displayed nor available for
modification like 'Alternate Supplier Name' or like 'Address'. Employee
related information has to be maintained in HR. The system should not allow
the update of the employee suppliers details like supplier name, alternate
supplier name, known_as and sic_code. This is because the data should be in
sync with TCA and HR information. So the code has been changed to make
those fields as read only for employee type supplier.
Therefore, users will not be able to update the Alternate Supplier Name field
for Employee type suppliers. Enhancement Request 7241561/6962262 was
logged for possible future change to this functionality. However, as a
workaround it is possible to enter an alternate name for a supplier in the
HRMS application
People form : Enter and Maintain Form
Go to 'Further Name' tab.
Enter the alternate name on the 'Preferred Name' field.
This information is then shown on the Alias field for the employee in the
Supplier form.
Technical Information
The Supplier, Sites/Locations, and their Contact information will be migrated to TCA. As part of
the migration we have introduced three new tables:
AP_SUPPLIERS, AP_SUPPLIER_SITES_ALL, and AP_SUPPLIER_CONTACTS.
These tables will hold the attributes that represent the terms and conditions of the deploying
company doing business with this supplier and the necessary transaction defaults. To minimize
the impact to the other products, views are provided with the names PO_VENDORS,
PO_VENDOR_SITES_ALL, and PO_VENDOR_CONTACTS. These views will be based on
the information from TCA and Payables Suppliers tables.
As a result of this, the Suppliers (AP_SUPPLIERS) will represent the Supplier account and will
carry all Supplier level profile information that will default to the transactions.
The Suppliers Sites (AP_SUPPLIER_SITES_ALL) will represent the supplier site account
information in the context of an operating unit.
The Contacts (AP_SUPPLIER_CONTACTS) are created to support backwards compatibility, so
that impacted products (such as Purchasing ) do not have to upgrade transaction data that carries
the reference to vendor contact IDs.
Note: The existing Suppliers tables PO_VENDORS, PO_VENDOR_SITES_ALL, and
PO_VENDOR_CONTACTS are obsoleted and renamed as PO_VENDORS_OBS,
PO_VENDOR_SITES_OBS, and PO_VENDOR_CONTACTS_OBS.
Suppliers -- With the new architecture, the Supplier entity will represent the supplier
account for a party record in TCA. The Suppliers table will be updated with the unique
Party identifier for reference purposes.
Supplier Sites -- The supplier sites table will store the Site account attributes per
Operating Unit, which will default into transactions. Going forward, supplier site creation
will involve either selecting an existing location for the supplier or creating a new location
in HZ_LOCATIONS. The user will then have to select the Operating Unit based on the
security profile, and enter the site attributes as they are entered today.
Contacts -- Contacts are modeled as a child entity to Supplier Sites in Release 12. Since
the Supplier Sites are striped by Operating Unit, the contact records are implicitly striped
by Operating Unit. This required our customers to enter/maintain the same contact
information more than once if the implementing company did business with the same
Supplier Site in more than one Operating Unit.
For example: Adam Smith is the Contact in the San Mateo site of ABC supplier. If
Company A does business with ABC supplier from two operating units, then the contact
Adam Smith should be entered as a contact twice, once for the San Mateo Site OU1 and
another for the San Mateo Site OU2. In an ideal case, Contacts could be defined for
Supplier or for a particular Location of the Supplier. There is no need to stripe the contact
information by Operating Unit. With the decision to move the address information to TCA,
the suggested approach for modeling contacts would be to leverage the TCA contacts
model completely.
Contacts in TCA are modeled differently. Each contact (person) is represented as a party
first. A relationship is then created between the person party and the organization party
(customer, supplier, etc). This relationship itself is reflected as a party record in TCA. All
the contact points (for example, email, fax, phone) are tied to the party record, which
represents the relationship. The contact information can be defined for a Party, Party Site,
and Party Relationship in TCA. Since contact information is maintained at the Supplier Site
level for a particular Operating Unit, Payables will do an as-is approach to replicate the
data into TCA. TCA does not have the relationship party reference with respect to the Site
(it is not required), AP will have to link Supplier Site contact to the TCA Relationship party
using the TCA's HZ_ORG_CONTACTS table. The HZ_ORG_CONTACTS table will
carry some information about the contact such as department information.
If we take the case mentioned above, Adam Smith will be defined as a person party. One
new relationship record will be created between Adam Smith and ABC Supplier. This
relationship is also a party. All the information about Adam's Departments will be moved to
Org Contacts with reference to the San Mateo Site and Adam's relationship with ABC
Supplier. All contact details will be represented as Contact Point records against the
relationship party reference.
APXVDMVD.fmb Suppliers Create and Inquire forms are obsoleted and the user interface is
replaced by a OA Framework user interface created by Oracle iSupplier Portal.
The following diagram shows how Suppliers is migrated to TCA.