R12 Payables Supplier Creation

In R12 we have new concept of TCA(Trading Community Architecture),TCA is a centralized place where all the party details including
Customer and Supplier details get saved.
TCA has some important tables like HZ_PARTIES and HZ_PARTY_SITES.

Steps to create Supplier in R12 payables:
1. Insert data in the Supplier interface table AP_SUPPLIERS_INT table with mandatory columns like
1. vendor_interface_id (AP_SUPPLIERS_INT_S.nextval)
2. status as 'NEW'
3. Vendor_Name
4. Segment1: This columns stores the value of supplier number and which you can get
from NEXT_AUTO_SUPPLIER_NUM.AP_PRODUCT_SETUP
5. term_id and other columns
2. Insert data in supplier site interface table i.e AP_SUPPLIER_SITES_INT table with mandatory columns like :
1. vendor_site_interface_id (AP_SUPPLIER_SITES_INT_S.nextval)
2. vendor_interface_id (AP_SUPPLIERS_INT_S.currval)
3. Vendor_id: Use the vendor_id created in Step 2 (Supplier Import Program).
4. Status as 'NEW'
5. Org_id
6. Vendor_Site_Code
7. pay_site_flag as 'Y' else will throw error in the Import Program (The site is not a Pay Site error)
3. Its not a mandatory step:Insert records in the supplier contact table i.e. AP_SUP_SITE_CONTACT_INT with mandatory columns
like
1. vendor_interface_id (AP_SUPPLIERS_INT_S.currval)
2. vendor_site_interface_id (AP_SUPPLIER_SITES_INT_S.currval)
3. vendor_contact_interface_id (AP_SUP_SITE_CONTACT_INT_S.nextval)
4. LAST_NAME: Else will throw error in the import program.
5. vendor_id
4. Run the standard Import program "Supplier Open Interface Import" to import data from AP_SUPPLIER_INT table to TCA
and supplier standard tables.Using segment1 column we can check data in PO_VENDORS which is a view of AP_SUPPLIERS and
HZ_PARTIES .This will create a unique vendor_id.In case of error,we can check import failure reason in either import program
output file or in the AP_SUPPLIER_INT_REJECTIONS table.
5. Run the Standard supplier site import program i.e. "Supplier Sites Open Interface Import".This will create supplier site for
above vendor_id.
6. Then run supplier contact import program "Supplier Site Contacts Open Interface Import".
Note: We can also use request set "Supplier Open Interface Request Set" in place of running each import program
individually.

**In case any of the import program fails,we can check import failure reason in either import program output file or in
the AP_SUPPLIER_INT_REJECTIONS table.In case output file is not giving any error reason that means latest patch for the import
program has not been applied.Please check with you DBA and ask him to apply the latest patch.
Sample Code:





INSERT into ap_suppliers_int (vendor_interface_id
,last_update_date
,last_updated_by
,vendor_name
,VENDOR_NAME_ALT
,segment1
,summary_flag
,enabled_flag
,last_update_login
,creation_date
,created_by
,vendor_type_lookup_code
,one_time_flag
,ship_to_location_id
,bill_to_location_id
,ship_via_lookup_code
,fob_lookup_code
,freight_terms_lookup_code
,terms_id
,set_of_books_id
,always_take_disc_flag
,pay_date_basis_lookup_code
,pay_group_lookup_code
,payment_priority
,invoice_currency_code
,payment_currency_code
,hold_all_payments_flag
,hold_future_payments_flag
,accts_pay_code_combination_id
,prepay_code_combination_id
,type_1099
,payment_method_lookup_code
,women_owned_flag
,small_business_flag
,hold_flag
,terms_date_basis
,inspection_required_flag
,receipt_required_flag
,qty_rcv_tolerance
,qty_rcv_exception_code
,enforce_ship_to_location_code
,days_early_receipt_allowed
,days_late_receipt_allowed
,receipt_days_exception_code
,auto_tax_calc_flag
,auto_tax_calc_override
,amount_includes_tax_flag
,state_reportable_flag
,federal_reportable_flag
,auto_calculate_interest_flag
,exclude_freight_from_discount
,match_option
,attribute10
,attribute11
,attribute12
,attribute15
,status
,exclusive_payment_flag)
--,vat_code) -- New Added because of error
VALUES (AP_SUPPLIERS_INT_S.nextval
,v_last_update_date
,v_last_updated_by
,trim(upper(v_vendor_name))
,trim(upper(v_vendor_name))
,v_segment1
,v_summary_flag
,v_enabled_flag
,v_last_update_login
,v_creation_date
,v_created_by
,NVL(v_vendor_type_lookup_code,'VENDOR')
,v_one_time_flag
,v_ship_to_location_id
,v_bill_to_location_id
,v_ship_via_lookup_code
,v_fob_lookup_code
,v_freight_terms_lookup_code
,v_terms_id
,v_set_of_books_id
,v_always_take_disc_flag
,v_pay_date_basis_lookup_code
,v_pay_group_lookup_code
,v_payment_priority
,v_invoice_currency_code
,v_payment_currency_code
,v_hold_all_payments_flag
,v_hold_future_payments_flag
,v_accts_pay_ccid
,v_prepay_ccid
,v_type_1099
,v_payment_method_lookup_code
,v_women_owned_flag
,v_small_business_flag
,v_hold_flag
,v_terms_date_basis
,v_inspection_required_flag
,v_receipt_required_flag
,v_qty_rcv_tolerance
,v_qty_rcv_exception_code
,v_enforce_ship_to_loc_code
,v_days_early_receipt_allowed
,v_days_late_receipt_allowed
,v_receipt_days_exception_code
,v_auto_tax_calc_flag
calc_override
,v_amount_includes_tax_flag
,v_state_reportable_flag
,v_federal_reportable_flag
,v_auto_calculate_interest_flag
,v_exclude_fght_from_disc
,v_match_option
,p_vendor_name
-- commented sankatha 041003 ,v_address_line1
,v_vendor_site_code
,v_attribute12
,substr(v_address_line1,1,15)
,'NEW'
,nvl(v_exclusive_payment_flag,'N'));
-- ,'NO TAX');

fnd_file.put_line (fnd_file.LOG,'FIVE::'||SQL%ROWCOUNT);


--*******************************
-- Calling Supplier Import Program
--*******************************
request_id:= FND_REQUEST.SUBMIT_REQUEST
(Application => 'SQLAP'
,Program => 'APXSUIMP'
,Description => NULL
,Start_time => SYSDATE
,Sub_Request => FALSE
,Argument1 => 'ALL'
,Argument2 => 1000
,Argument3 => 'N'
,Argument4 => 'N'
,Argument5 => 'N'
);

COMMIT;
fnd_file.put_line (fnd_file.LOG,'request_id::'||request_id||'::'||lc_phase_code);


--********************************************
-- Wait for the concurrent program to complete
--********************************************

lb_wait := FND_CONCURRENT.WAIT_FOR_REQUEST
( request_id => request_id
, INTERVAL => 5
, phase => lc_phase
, status => lc_status
, dev_phase => lc_devpha
, dev_status => lc_devsta
, message => lc_mesg
);
fnd_file.put_line (fnd_file.LOG,'lc_status::'||lc_status);
COMMIT;




fnd_file.put_line (fnd_file.LOG,'v_segment1::'||v_segment1);
BEGIN
SELECT vendor_id
INTO v_vendor_id
FROM po_vendors
where segment1 = v_segment1;



INSERT into ap_supplier_sites_int (vendor_interface_id
,vendor_site_interface_id
, last_update_date
,last_updated_by
,vendor_id
,vendor_site_code
,last_update_login
,creation_date
,created_by
-- ,purchasing_site_flag
--,rfq_only_site_flag
,pay_site_flag
-- ,attention_ar_flag
,address_line1
,address_line2
,city
,state
,zip
,country
,ship_to_location_id
,bill_to_location_id
,ship_via_lookup_code
,freight_terms_lookup_code
,fob_lookup_code
,payment_method_lookup_code
,terms_date_basis
,accts_pay_code_combination_id
,prepay_code_combination_id
,pay_group_lookup_code
,payment_priority
,terms_id
,pay_date_basis_lookup_code
,always_take_disc_flag
,invoice_currency_code
,payment_currency_code
,hold_all_payments_flag
,hold_future_payments_flag
-- ,hold_unmatched_invoices_flag
-- ,ap_tax_rounding_rule
,auto_tax_calc_flag
,auto_tax_calc_override
,amount_includes_tax_flag
-- ,exclusive_payment_flag
-- ,tax_reporting_site_flag
-- ,attribute11
-- ,validation_number
,org_id
-- ,allow_awt_flag
,match_option
,status)
VALUES (AP_SUPPLIERS_INT_S.currval
,AP_SUPPLIER_SITES_INT_S.nextval
,v_last_update_date
,v_last_updated_by
,v_vendor_id--PO_VENDORS_S.CURRVAL
,v_vendor_site_code
,v_last_update_login
,v_creation_date
,v_created_by
-- ,v_purchasing_site_flag
-- ,v_rfq_only_site_flag
,v_pay_site_flag
-- ,v_attention_ar_flag
,trim(upper(v_address_line1))
,trim(upper(v_address_line2))
,trim(upper(v_city))
,trim(upper(v_state))
,v_zip
,v_country
-- ,decode(upper(p_country),'USA','US','UNITED STATES','US','','US','CANADA','CA','MEXICO','MX','')
,v_ship_to_location_id
,v_bill_to_location_id
,v_ship_via_lookup_code
,v_freight_terms_lookup_code
,v_fob_lookup_code
,v_payment_method_lookup_code
,v_terms_date_basis
,v_accts_pay_ccid
,v_prepay_ccid
,v_pay_group_lookup_code
,v_payment_priority
,v_terms_id
,v_pay_date_basis_lookup_code
,v_always_take_disc_flag
,v_invoice_currency_code
,v_payment_currency_code
,v_hold_all_payments_flag
,v_hold_future_payments_flag
-- ,v_hold_unmatched_invoices_flag
-- ,v_ap_tax_rounding_rule
,v_auto_tax_calc_flag
,v_auto_tax_calc_override
,v_amount_includes_tax_flag
-- ,v_exclusive_payment_flag
-- ,v_tax_reporting_site_flag
-- ,v_attribute11
-- ,v_validation_number
,v_org_id
-- ,v_allow_awt_flag
,v_match_option
,'NEW');

fnd_file.put_line (fnd_file.LOG,'SIX::'||SQL%ROWCOUNT);


--*******************************
-- Calling Supplier Site Import Program
--*******************************
request_id:= FND_REQUEST.SUBMIT_REQUEST
(Application => 'SQLAP'
,Program => 'APXSSIMP'
,Description => NULL
,Start_time => SYSDATE
,Sub_Request => FALSE
,Argument1 => 'ALL'
,Argument2 => 1000
,Argument3 => 'N'
,Argument4 => 'N'
,Argument5 => 'N'
);

COMMIT;
fnd_file.put_line (fnd_file.LOG,'request_id::'||request_id||'::'||lc_phase_code_one);

--********************************************
-- Wait for the concurrent program to complete
--********************************************

lb_wait := FND_CONCURRENT.WAIT_FOR_REQUEST
( request_id => request_id
, INTERVAL => 5
, phase => lc_phase
, status => lc_status
, dev_phase => lc_devpha
, dev_status => lc_devsta
, message => lc_mesg
);
COMMIT;

Additional Information:::::

Vendor conversion program will load the Supplier Master, Sites and Contacts data from data files to the staging tables, validate the data and then load the data into Interface
tables, finally Validated data will import into Oracle Supplier Standard Tables by using Oracle Standard Supplier Import Programs.
Pre-requisites setups are: Payment terms, Pay Groups, CCID, Supplier classifications, Bank Accounts , Employees (if employees have to set up as vendors).
The Interface Tables are:
AP_SUPPLIERS_INT
AP_SUPPLIER_SITES_INT
AP_SUP_SITE_CONTACT_INT
AP_SUPPLIERS_INT:
This is the open interface table for AP Suppliers. It holds Supplier information which is loaded by the user for import. The columns in the table map to corresponding columns in
the PO_VENDORS table. The Oracle Payables application uses this information to create a new Supplier record when the Supplier Open Interface Import program is submitted.
Each row in the table will be identified by a unique identifier, the VENDOR_INTERFACE_ID.
Mandatory Columns:
VENDOR_INTERFACE_ID (ap_suppliers_int_s.NEXTVAL)- Supplier interface record unique identifier
VENDOR_NAME Supplier name
Other important columns:
SEGMENT1 Supplier Number
VENDOR_TYPE_LOOKUP_CODE Supplier type
SHIP_TO_LOCATION_CODE Default ship-to-location name
BILL_TO_LOCATION_CODE Default bill-to-location name
TERMS_NAME Payment terms name
TAX_VERIFICATION_DATE Tax verification date(1099)
VAT_REGISTRATION_NUM Tax registration number
ATTRIBUTE1 -15 Descriptive Flexfield Segments
PAY_GROUP_LOOKUP_CODE Payment group type
INVOICE_CURRENCY_CODE Default currency unique identifier
PAYMENT_CURRENCY_CODE Default payment currency unique identifier
NUM_1099 Tax identification number (1099)
VAT_CODE Default invoice tax code
HOLD_FLAG Indicates whether or not the supplier is on purchasing hold
SUMMARY_FLAG Key flexfield summary flag
ENABLED_FLAG Key flexfield enable flag
EMPLOYEE_ID Employee unique identifier if supplier is an employee
AP_SUPPLIER_SITES_INT:
This is the open interface table for AP Supplier Sites. It holds Supplier Site information which is loaded by the user for import. The columns in the table map to corresponding
columns in PO_VENDOR_SITES_ALL table. The Oracle Payables application uses this information to create a new Supplier Site record when the Supplier Sites Open Interface
Import program is submitted. Each row in the table will be joined to the appropriate Supplier using the VENDOR_ID column.
Mandatory Columns:
VENDOR_SITE_INTERFACE_ID (ap_supplier_sites_int_s.NEXTVAL) Supplier Site interface record unique identifier
VENDOR_SITE_CODE Supplier Site name
Other important columns:
ADDRESS_LINE1 First line of supplier address
ADDRESS_LINE2 Second line of supplier address
ADDRESS_LINE3 Third line of supplier address
CITY City name
STATE State name or abbreviation
ZIP Postal code
COUNTRY Country name
PHONE Phone number
FAX Supplier site facsimile number
SHIP_TO_LOCATION_CODE Default ship-to-location name
BILL_TO_LOCATION_CODE Default bill-to-location name
PAYMENT_METHOD_LOOKUP_CODE Default payment method type
VAT_CODE Invoice default tax code
PAY_GROUP_LOOKUP_CODE Payment group type
TERMS_NAME Payment terms name
INVOICE_CURRENCY_CODE Default currency unique identifier
PAYMENT_CURRENCY_CODE Default payment currency unique identifier
EMAIL_ADDRESS E-mail address of the supplier contact
PURCHASING_SITE_FLAG Indicates whether purchasing is allowed from this site
AUTO_TAX_CALC_FLAG Level of automatic tax calculation for supplier
HOLD_ALL_PAYMENTS_FLAG Indicates if Oracle Payables should place payments for this supplier on hold
AP_SUP_SITE_CONTACT_INT:
This is the open interface table for AP Supplier Site Contacts. It holds Supplier contact data. The columns in the table map to corresponding columns in
PO_VENDOR_CONTACTS table. The Oracle Payables application uses this information to create a new Supplier Contact record when the Supplier Sites Open Interface Import
program is submitted. Each row in the table will be joined to the appropriate Supplier Site using the VENDOR_SITE_CODE and ORG_ID.
Mandatory Columns:
VENDOR_INTERFACE_ID Supplier interface record unique identifier
VENDOR_CONTACT_INTERFACE_ID (AP_SUP_SITE_CONTACT_INT_S.NEXTVAL) Vendor Contact Interface Identifier
VENDOR_SITE_CODE Supplier Site name
Other important columns:
FIRST_NAME Contact First name
LAST_NAME Contact last name
AREA_CODE Area code of contact phone number
PHONE Contact phone number
FIRST_NAME_ALT Alternate Supplier contact first name
LAST_NAME_ALT Alternate Supplier contact last name
EMAIL_ADDRESS Email address for the Supplier Site contact
FAX Facsimile number for the Supplier Site contact
VENDOR_ID Supplier unique identifier
Validations:
Vendor Number (Check for duplicate records in ap_suppliers table)
Vendor Name (Check for duplicate records in staging as well as in ap_suppliers table)
Terms Name (Check for proper record in ap_terms_tl table)
Pay Group (Check for proper record in fnd_lookup_values_vl table where lookup_type = PAY GROUP)
Employee Id (Check for proper employee record in per_all_people_f table)
Vendor Type (Check for proper record in po_lookup_codes table where lookup_type = VENDOR TYPE)
Vendor Site Code (Check for duplicate records in ap_supplier_sites_all table)
Country Code ( Check for proper country code in fnd_territories_vl table)
Payment Method (Check for proper payment method in iby_payment_methods_vl table)
Interface programs:
1. Supplier Open Interface Import
2. Supplier Sites Open Interface Import
3. Supplier Site Contacts Open Interface Import
The data inserted via these interfaces are automatically populated into TCA tables.
Note: AP_SUPPLIER_INT_REJECTIONS table contains suppliers, sites, contacts rejections information.