8/7/2018 Oracle Applications: Creating a R12 Supplier Bank accounts Using API

More

Home AP AR GL INV PO OM HR PA FAQS SCRIPTS PL-SQL TECH OAF FUSION

WEDNESDAY, SEPTEMBER 14, 2011

Creating a R12 Supplier Bank accounts Using API

After the Supplier or Supplier Site is validated and a row entered in the various AP and HZ tables, a Payee is created in IBY (the new Payments application) for the Supplier or
Supplier Site. If the Payee is successfully created, we then check to see if there are any corresponding rows in IBY_TEMP_EXT_BANK_ACCTS. If there are, we call an IBY API
to create the Bank Account and associate it with the Payee. So to import supplier bank accounts during Supplier and Supplier Site Open Interface, you can populate the
IBY_TEMP_EXT_BANK_ACCTS table. A row in IBY_TEMP_EXT_BANK_ACCTS is said to be associated with the Supplier or Supplier Site if the column
IBY_TEMP_EXT_BANK_ACCTS. calling_app_unique_ref1 is equal to either AP_SUPPLIERS_INT.vendor_interface_id for Suppliers or
IBY_TEMP_EXT_BANK_ACCTS.calling_app_unique_ref2 is equal to AP_SUPPLIER_SITES_INT.vendor_site_interface_id for Supplier Sites. The bank and bank branch
referenced in IBY_TEMP_EXT_BANK_ACCTS must already exist in the system. There is no functionality in the Bank Account Import to create the bank and/or bank branch.
This functionality associates the new supplier to an existing bank and/or bank branch.

Some information
The supplier bank account information is in the table: IBY_EXT_BANK_ACCOUNTS, the bank and bank branches information is in the table HZ_PARTIES.
Creating a supplier in AP now creates a record in HZ_PARTIES. In the create Supplier screen, you will notice that that Registry_id is the party_number in HZ_Parties.
The table hz_party_usg_assignments table stores the party_usage_code SUPPLIER, and also contains the given party_id for that supplier. Running this query will return if
customer was a SUPPLIER or CUSTOMER
Payment related details of supplier are also inserted in iby_external_payees_all as well as iby_ext_party_pmt_mthds
IBY_EXT_BANK_ACCOUNTS, the bank and bank branches information is in the table: HZ_PARTIES.
The master record that replaces PO_VENDORS is now AP_SUPPLIERS. PO_VENDORS is a view that joins AP_SUPPLIERS and HZ_PARTIES.
The table that hold mappings between AP_SUPPLIERS.VENDOR_ID and HZ_PARTIES.PARTY_ID is PO_SUPPLIER_MAPPINGS. Query by party_id.
The bank branch number can be found in the table: HZ_ORGANIZATION_PROFILES .The HZ_ORGANIZATION_PROFILES table stores a variety of information about a party.
This table gets populated when a party of the Organization type is created.

For Importing internal and external bank account we can use the following API's

1. API to create External Customer Bank IBY_EXT_BANKACCT_PUB.create_ext_bank

2. Bank Branch
IBY_EXT_BANKACCT_PUB.create_ext_bank_branch

3. Customer Bank Account

IBY_EXT_BANKACCT_PUB.create_ext_bank_acct

4. Instrument Assignment
IBY_FNDCPT_SETUP_PUB.Set_Payer_Instr_Assignment

5. Payer Attributes
IBY_FNDCPT_SETUP_PUB.Set_Payer_Attributes

6. For the Branch Address

hz_location_v2pub.create_location
hz_party_site_v2pub.create_party_site

7. Contacts
HZ_PARTY_V2PUB.create_person
hz_party_contact_v2pub.create_org_contact
hz_party_contact_v2pub.create_org_contact_role
HZ_CONTACT_POINT_V2PUB.create_contact_point

Oracle Table Involved

IBY_EXTERNAL_PAYEES_ALL : This stores supplier information and customer information
IBY_EXT_BANK_ACCOUNTS : This storage for bank accounts
IBY_EXT_PARTY_PMT_MTHDS : This storage for payment method usage rules.
IBY_CREDITCARD : stores the credit card information for a customer
IBY_EXT_BANK_ACCOUNTS :This Stores external bank accounts . These records have bank_account_type = Supplier
IBY_ACCOUNT_OWNERS :stores the joint account owners of a bank account
IBY_PMT_INSTR_USES_ALL : This stores data from AP_BANK_ACCOUNT_USES_ALL for payment instruments assignments .

Link between Supplier And Banks and TCA table

http://oracleapps88.blogspot.com/2011/09/creating-r12-supplier-bank-accounts.html 1/6
8/7/2018 Oracle Applications: Creating a R12 Supplier Bank accounts Using API
The link between PO_VENDORS and HZ_PARTIES is PO_VENDORS.party_id. The link between PO_VENDOR_SITES_ALL and HZ_PARTY_SITES is
PO_VENDOR_SITES_ALL.party_site_id.
When a Supplier is created Record will be Inserted in HZ_PARTIES. When the Supplier Site is created Record will be Inserted in HZ_PARTY_SITES. When Address is created it
will be stored in HZ_LOCATIONS
When a bank Is Created, the banking information will be stored in IBY_EXT_BANK_ACCOUNTS IBY_EXT_BANK_ACCOUNTS.BANK_id = hz_paties.party_id
When the Bank is assigned to Vendors then it will be updated in HZ_CODE_ASSIGNMENTS.
HZ_CODE_ASSIGNMENTS.owner_table_id = IBY_EXT_BANK_ACCOUNTS.branch_id.
The PARTY_SITE_ID column is the link between the tables IBY_EXTERNAL_PAYEES_ALL & PO_VENDOR_SITES_ALL

Example procedure::
CREATE OR REPLACE PROCEDURE APPS.XXSUP_BANK_TEST_V2
AS
x_bank_rec IBY_EXT_BANKACCT_PUB.ExtBank_rec_type;
x_bank_id NUMBER;
x_return_status VARCHAR2(10);
x_msg_count NUMBER;
x_msg_data VARCHAR2(256);
x_response_rec IBY_FNDCPT_COMMON_PUB.Result_rec_type;
x_bank_branch_rec IBY_EXT_BANKACCT_PUB.ExtBankBranch_rec_type;
x_branch_id NUMBER;
x_acct_id NUMBER;
x_bank_acct_rec IBY_EXT_BANKACCT_PUB.ExtBankAcct_rec_type;
p_ext_payee_tab IBY_DISBURSEMENT_SETUP_PUB.External_Payee_Tab_Type ;
x_ext_payee_id_tab IBY_DISBURSEMENT_SETUP_PUB.Ext_Payee_ID_Tab_Type ;
x_ext_payee_status_tab IBY_DISBURSEMENT_SETUP_PUB.Ext_Payee_Create_Tab_Type ;
l_ext_payee_rec IBY_DISBURSEMENT_SETUP_PUB.External_Payee_Rec_Type ;
l_ext_payee_id_rec_type IBY_DISBURSEMENT_SETUP_PUB.Ext_Payee_ID_Rec_Type ;
p_payee IBY_DISBURSEMENT_SETUP_PUB.PayeeContext_rec_type ;
p_assignment_attribs IBY_FNDCPT_SETUP_PUB.PmtInstrAssignment_rec_type ;
p_instrument IBY_FNDCPT_SETUP_PUB.PmtInstrument_rec_type ;
x_assign_id NUMBER;
BEGIN
dbms_output.put_line('Start of procedure.');

FND_GLOBAL.APPS_INITIALIZE
(fnd_global.user_id,
fnd_global.resp_id,
fnd_global.resp_appl_id
);
dbms_output.put_line('Procedure initializad.');

x_bank_rec.bank_name := 'ran_sbi71';
x_bank_rec.bank_number := 23591;
x_bank_rec.institution_type := 'BANK'; -- hz_code_assignments .CLASS_CODE
x_bank_rec.country_code := 'SA' ;
x_msg_count := 0;
x_msg_data := NULL;
x_return_status := NULL;
dbms_output.put_line('before External bank creation.');

IBY_EXT_BANKACCT_PUB.CREATE_EXT_BANK
(p_api_version => 1.0
,p_init_msg_list => FND_API.G_TRUE
,p_ext_bank_rec => x_bank_rec
,x_bank_id => x_bank_id
,x_return_status => x_return_status
,x_msg_count => x_msg_count
,x_msg_data => x_msg_data
,x_response => x_response_rec
);

dbms_output.put_line('External bank created.');

dbms_output.put_line(' bank id. '||x_bank_id);
dbms_output.put_line('x_return_status: '||x_return_status);
dbms_output.put_line('x_msg_count. '||x_msg_count);
dbms_output.put_line('x_msg_data. '||x_msg_data);

x_bank_branch_rec.bank_party_id := x_bank_id ;
x_bank_branch_rec.branch_name := 'xxran_branch71' ;
x_bank_branch_rec.branch_number := 23592 ;
x_bank_branch_rec.branch_type := 'OTHER' ; --defined in lookup as BANK

-- BRANCH TYPE
x_msg_count := 0;
http://oracleapps88.blogspot.com/2011/09/creating-r12-supplier-bank-accounts.html 2/6
8/7/2018 Oracle Applications: Creating a R12 Supplier Bank accounts Using API
x_msg_data := NULL;
x_return_status := NULL;

IBY_EXT_BANKACCT_PUB.CREATE_EXT_BANK_BRANCH
(p_api_version => 1.0
,p_init_msg_list => FND_API.G_TRUE
,p_ext_bank_branch_rec => x_bank_branch_rec
,x_branch_id => x_branch_id
,x_return_status => x_return_status
,x_msg_count => x_msg_count
,x_msg_data => x_msg_data
,x_response => x_response_rec
);
dbms_output.put_line('External bank Branch created.');
dbms_output.put_line('x_branch_id: '||x_branch_id);
dbms_output.put_line('x_return_status: '||x_return_status);
dbms_output.put_line('x_msg_count. '||x_msg_count);
dbms_output.put_line('x_msg_data. '||x_msg_data);

x_bank_acct_rec.country_code := 'SA' ;
x_bank_acct_rec.branch_id := x_branch_id ;
x_bank_acct_rec.bank_id := x_bank_id ;
x_bank_acct_rec.acct_owner_party_id := 325685; --supplier party id
x_bank_acct_rec.currency := 'USD' ;
x_bank_acct_rec.bank_account_name := 'xxran account6';
x_bank_acct_rec.bank_account_num := 23593 ;
x_msg_count := 0;
x_msg_data := NULL;
x_return_status := NULL;

IBY_EXT_BANKACCT_PUB.CREATE_EXT_BANK_ACCT
(p_api_version => 1.0
,p_init_msg_list => FND_API.G_TRUE
,p_ext_bank_acct_rec => x_bank_acct_rec
,x_acct_id => x_acct_id
,x_return_status => x_return_status
,x_msg_count => x_msg_count
,x_msg_data => x_msg_data
,x_response => x_response_rec
);
dbms_output.put_line('External bank account created.');
dbms_output.put_line('x_acct_id'||x_acct_id);
dbms_output.put_line('x_return_status'||x_return_status);
dbms_output.put_line('x_msg_count.'||x_msg_count);
dbms_output.put_line('x_msg_data.'||x_msg_data);

l_ext_payee_rec.Payee_Party_Site_Id := 189630;
l_ext_payee_rec.Payee_Party_Id := 325685;
l_ext_payee_rec.payment_function := 'PAYABLES_DISB';
l_ext_payee_rec.payer_org_id := 204;
l_ext_payee_rec.payer_org_type := 'OPERATING_UNIT';
l_ext_payee_rec.Exclusive_Pay_Flag := 'N';
l_ext_payee_rec.Default_Pmt_method := 'XX_REP_VIREMENT';
l_ext_payee_rec.Supplier_Site_Id := 6930;
x_msg_count := 0;
x_msg_data := NULL;
x_return_status := NULL;
p_ext_payee_tab(0) := l_ext_payee_rec;

IBY_DISBURSEMENT_SETUP_PUB.CREATE_EXTERNAL_PAYEE
(p_api_version => 1.0,
p_init_msg_list => fnd_api.G_TRUE,
p_ext_payee_tab => p_ext_payee_tab,
x_return_status => x_return_status,
x_msg_count => x_msg_count,
x_msg_data => x_msg_data,
x_ext_payee_id_tab => x_ext_payee_id_tab,
x_ext_payee_status_tab => x_ext_payee_status_tab
);
dbms_output.put_line('External Payee created.');
dbms_output.put_line('x_return_status: '||x_return_status);
dbms_output.put_line('x_msg_count. '||x_msg_count);
dbms_output.put_line('x_msg_data. '||x_msg_data);

http://oracleapps88.blogspot.com/2011/09/creating-r12-supplier-bank-accounts.html 3/6
8/7/2018 Oracle Applications: Creating a R12 Supplier Bank accounts Using API

p_payee.Supplier_Site_id := 6930;
p_payee.Party_Id := 325685;
p_payee.Party_Site_Id := 189630;
p_payee.Payment_Function := 'PAYABLES_DISB';
p_payee.Org_Id := 204;
p_payee.Org_Type := 'OPERATING_UNIT';
l_ext_payee_id_rec_type := x_ext_payee_id_tab(0);
p_instrument.Instrument_Id := x_acct_id;
p_instrument.Instrument_Type := 'BANKACCOUNT';
p_assignment_attribs.priority := 1;
p_assignment_attribs.Instrument := p_instrument;
x_msg_count := 0;
x_msg_data := NULL;
x_return_status := NULL;
x_response_rec := NULL;

IBY_DISBURSEMENT_SETUP_PUB.SET_PAYEE_INSTR_ASSIGNMENT
(p_api_version => 1.0,
p_init_msg_list => fnd_api.G_TRUE,
p_commit => fnd_api.G_TRUE,
x_return_status => x_return_status,
x_msg_count => x_msg_count,
x_msg_data => x_msg_data,
p_payee => p_payee,
p_assignment_attribs => p_assignment_attribs,
x_assign_id => x_assign_id,
x_response => x_response_rec
);
dbms_output.put_line('Payee_Instr_Assignment.');
dbms_output.put_line('x_assign_id'||x_assign_id);
dbms_output.put_line('x_return_status'||x_return_status);
dbms_output.put_line('x_msg_count.'||x_msg_count);
dbms_output.put_line('x_msg_data.'||x_msg_data);

EXCEPTION
WHEN OTHERS THEN
dbms_output.put_line('Error occurred during procedure.');
dbms_output.put_line('sqlcode: '||SQLCODE||' Sqlerrm: '||SUBSTR(sqlerrm,1,255));
END XXSUP_BANK_TEST_V2;
/

You can get the related party_id, vendor_site_id and party_site_id by using the following query.
SELECT
hp.party_id,
hp.party_name,
apss.vendor_site_id,
hps.party_site_id
FROM
hz_parties hp,
hz_party_sites hps,
ap_suppliers aps,
ap_supplier_sites_all apss
WHERE
hp.party_id = aps.party_id
AND hp.party_id = hps.party_id
AND aps.vendor_id = apss.vendor_id
ORDER BY
HP.CREATION_DATE DESC

Query to get bank details with supplier details

SELECT
HZP.PARTY_NAME "VENDOR NAME" ,
APS.SEGMENT1 "VENDOR NUMBER" ,
ASS.VENDOR_SITE_CODE "SITE CODE" ,
IEB.BANK_ACCOUNT_NUM "ACCOUNT NUMBER" ,
IEB.BANK_ACCOUNT_NAME "ACCOUNT NAME" ,
HZPBANK.PARTY_NAME "BANK NAME" ,
HOPBRANCH.BANK_OR_BRANCH_NUMBER "BANK NUMBER" ,
HZPBRANCH.PARTY_NAME "BRANCH NAME" ,
HOPBRANCH.BANK_OR_BRANCH_NUMBER "BRANCH NUMBER"
FROM

http://oracleapps88.blogspot.com/2011/09/creating-r12-supplier-bank-accounts.html 4/6
8/7/2018 Oracle Applications: Creating a R12 Supplier Bank accounts Using API
HZ_PARTIES HZP ,
AP_SUPPLIERS APS ,
HZ_PARTY_SITES SITE_SUPP ,
AP_SUPPLIER_SITES_ALL ASS ,
IBY_EXTERNAL_PAYEES_ALL IEP ,
IBY_PMT_INSTR_USES_ALL IPI ,
IBY_EXT_BANK_ACCOUNTS IEB ,
HZ_PARTIES HZPBANK ,
HZ_PARTIES HZPBRANCH ,
HZ_ORGANIZATION_PROFILES HOPBANK ,
HZ_ORGANIZATION_PROFILES HOPBRANCH
WHERE
HZP.PARTY_ID = APS.PARTY_ID
AND HZP.PARTY_ID = SITE_SUPP.PARTY_ID
AND SITE_SUPP.PARTY_SITE_ID = ASS.PARTY_SITE_ID
AND ASS.VENDOR_ID = APS.VENDOR_ID
AND IEP.PAYEE_PARTY_ID = HZP.PARTY_ID
AND IEP.PARTY_SITE_ID = SITE_SUPP.PARTY_SITE_ID
AND IEP.SUPPLIER_SITE_ID = ASS.VENDOR_SITE_ID
AND IEP.EXT_PAYEE_ID = IPI.EXT_PMT_PARTY_ID
AND IPI.INSTRUMENT_ID = IEB.EXT_BANK_ACCOUNT_ID
AND IEB.BANK_ID = HZPBANK.PARTY_ID
AND IEB.BANK_ID = HZPBRANCH.PARTY_ID
AND HZPBRANCH.PARTY_ID = HOPBRANCH.PARTY_ID
AND HZPBANK.PARTY_ID = HOPBANK.PARTY_ID
ORDER BY

1,3

Best Blogger Gadgets

Posted by Raju Chinthapatla at 3:50:00 PM

Labels: AP, BANKS, CONVERSIONS, R12, SCRIPTS, SUPPLIERS

2 comments:
Ross Fujitsu said...
Many thanks for your very helpful blog. We like to use the "Get Bank details with Supplier Details" SQL to help with a report - do we have your permission to use this?

Thanks
November 13, 2012 at 4:17 PM

Hunain Khanani said...

Done great work, can you please enable copy functionality for all your pages? thanks.
February 6, 2016 at 11:29 AM

Post a Comment

Enter your comment...

Comment as: Google Account

Publish Preview

Links to this post

Create a Link

Newer Post Home Older Post

Subscribe to: Post Comments (Atom)

http://oracleapps88.blogspot.com/2011/09/creating-r12-supplier-bank-accounts.html 5/6
8/7/2018 Oracle Applications: Creating a R12 Supplier Bank accounts Using API
Email : OracleApps88@Yahoo.Com. Picture Window theme. Theme images by konradlew. Powered by Blogger.

Get Flower Effect

http://oracleapps88.blogspot.com/2011/09/creating-r12-supplier-bank-accounts.html 6/6