详解EBS接口开发之供应商导入
（一）供应商常用标准表简介
1.1 常用标准表
如下表中列出了与供应商相关的表和说明：
| 表名 |
说明 |
其他信息 |
||
| ap_suppliers |
供应商头表 |
供应商的头信息如：供应商名、供应商编码、税号等 |
po_vendors |
对应视图 |
| ap_supplier_sites_all |
供应商地点表 |
供应商的地点信息，如对应OU、地址等 |
po_vendor_sites_all |
对应视图 |
| pos_supp_prof_ext_b |
供应商地点附加信息表 |
供应商地点附加信息c_ext_attr1~15,d_ext_attr1~15字段 |
|
|
| ap_supplier_contacts |
供应商联系人表 |
供应商联系人姓名、联系方式等 |
po_vendor_contacts |
对应视图 |
| hz_contact_points |
供应商联系人联系信息表 |
供应商联系人的电话、传真、邮箱等 |
|
|
| zx_party_tax_profile |
供应商税信息表 |
供应商纳税类型等 |
|
|
| hz_code_assignments |
供应商税率表 |
供应商对应地址上的税率等 |
|
|
| iby_external_payees_all |
付款信息表 |
供应商对应地点上的付款方式等 |
|
|
| iby_account_ownes |
银行账户拥有者 |
在添加银行账户的lov中 |
|
|
| iby_pmt_instr_uses_all |
供应商地点银行账户使用表 |
供应商地点所挂的银行账户 |
|
|
| iby_ext_bank_accounts |
供应商地点银行账户表 |
供应商地点银行账户信息 |
|
|
| iby_ext_banks_v |
地点银行表 |
地点银行信息 |
hz_parties |
基表 |
| Iby_ext_bank_branches_v |
地点银行支行表 |
地点银行支行的联行号、支行名登信息 |
|
|
供应商银行信息表：IBY_EXT_BANKS_V
| 字段名 |
说明 |
| BANK_PARTY_ID |
银行id |
| BANK_NAME |
银行名称 |
| BANK_NUMBER |
银行编号 |
供应商银行分行信息表：IBY_EXT_BANK_BRANCHES_V
| 字段名 |
说明 |
| BRANCH_PARTY_ID |
分行id |
| BRANCH_NUMBER |
分行编号 |
| BANK_PARTY_ID |
父行id |
供应商账户信息表：IBY_EXT_BANK_ACCOUNTS
| 字段名 |
说明 |
| BRANCH_ID |
分行id |
| BANK_ID |
父行id |
| BANK_ACCOUNT_NUM |
银行账号 |
供应商导入顺序及流程
3.1 供应商导入顺序
由于数据的先后关联依赖关系，同一供应商的信息导入必须按照一定的顺序进行：先导头信息，再导地点信息，最后导入地点下的地点附加信息、联系人、税率、银行、默认付款方法等信息。（同时有的时候需要把银行导入到供应商层而不是地点层）
3.2 API供应商导入流程
API供应商导入流程：
第一步：创建需要导入供应商信息的中间表，字段上提供供应商头信息、地点信息等必输字段。
第二步：向中间表中插入需要导入的供应商信息，验证需要插入的数据是否满足供应商信息规则，去除不合规范的数据。
第三步：对需要导入的数据在数据库标准表中尽行验证是否存在，不存在的供应商信息调用标准API进行导入操作，已存在的供应商根据实际需求是否进行更新。
第四步：导入完成后在界面或者后台表中查询该供应商信息，检验导入的供应商信息是否正确。
3.3 接口表供应商导入流程
接口表供应商导入流程：
第一步：将外部系统数据验证后，转化后导入到客户化CUX表。
第二步：将CUX表中数据验证，转化后插入到系统标准接口表中。
第三步：提交并发请求将数据导入系统。
第四步：调用API将供应商银行信息导入到系统中（可能是地点，地址，供应商等层次）。
说明：导入供应商的时候如果需要导入银行信息，切记不能将供应商银行数据插入接口临时表iby_temp_ext_bank_accts再一起提交并发请求，期待将数据包括账户信息导入（这是公司标准化程序，但是我们项目上我亲自验证，这将会导致系统自动验证字段iby_temp_ext_bank_accts.iban【International Bank Account Number 国际银行帐号】；经我调试发现将数据插入此账号临时接口表该字段即使为null也会验证，从而导致验证不过，结果数据进不去，相反如果用API倒银行信息，如果该字段为null则跳过验证，验证的程序在包IBY_EXT_BANKACCT_VALIDATIONS里有空大家可以研究一下）
API
供应商头创建
pos_vendor_pub_pkg.create_vendor
(
p_vendor_rec => l_vendor_rec,
x_return_status => l_return_status, --返回的状态
x_msg_count => l_msg_count, --返回的错误数量
x_msg_data => l_msg_data, --返回的错误信息
x_vendor_id => l_vendor_id, --返回的创建的供应商id
x_party_id => l_party_id); --返回的机构id
供应商头更新
l_vendor_rec ap_vendor_pub_pkg.r_vendor_rec_type;
--更新供应商头信息
pos_vendor_pub_pkg.update_vendor
(
p_vendor_rec => l_vendor_rec,
x_return_status => l_return_status, --返回的状态
x_msg_count => l_msg_count, --返回的错误数量
x_msg_data => l_msg_data); --返回的错误信息
供应商地点创建
pos_vendor_pub_pkg.create_vendor_site(
p_vendor_site_rec=> l_vendor_site_rec,
x_return_status => l_return_status, --返回的导入状态
x_msg_count => l_msg_count, --错误数量
x_msg_data => l_msg_data, --错误信息
x_vendor_site_id =>l_vendor_site_id,--返回的创建成功的地点id
x_party_site_id => l_party_site_id, --返回机构地点id
x_location_id => l_location_id);
--更新供应商地点
pos_vendor_pub_pkg.update_vendor_site(
x_return_status => o_return_status, --导入状态
x_msg_count => l_msg_count, --错误数量
x_msg_data => l_msg_data, --错误信息
p_vendor_site_rec => l_vendor_site_rec);
--创建联系人
pos_vendor_pub_pkg.create_vendor_contact(
p_vendor_contact_rec => l_contact_rec,
x_return_status => l_return_status, --返回状态
x_msg_count => l_msg_count, --错误数量
x_msg_data => l_msg_data, --错误信息
x_vendor_contact_id => l_vendor_contact_id,--联系人id
x_per_party_id => l_per_party_id, --联系人机构id
x_rel_party_id => l_rel_party_id, --关系机构id
x_rel_id => l_rel_id, --关系id
x_org_contact_id => l_org_contact_id, --地点联系人id
x_party_site_id => l_party_site_id); --地点id
pos_supp_contact_pkg.update_supplier_contact(
p_contact_party_id => l_party_id, --联系人机构id
p_vendor_party_id => l_vendor_party_site_id,--供应商机构id
p_last_name => i_last_name, --联系人姓名
p_phone_number => i_phone, --联系人电话
p_url => i_id_num, --联系人身份证号
p_fax_number => i_fax_num, --联系人传真号
p_email_address => i_emial_addr, --联系人邮箱地址
x_return_status => l_return_status, --返回状态
x_msg_count => l_msg_count, --错误数量
x_msg_data => l_msg_data); --错误信息
--创建和更新供应商默认付款方法的创建和更新
iby_disbursement_setup_pub.update_external_payee(
p_api_version => l_api_version, --版本号
p_init_msg_list => 'T',
p_ext_payee_tab => l_ext_payee_tab,
p_ext_payee_id_tab => l_ext_payee_id_tab,
x_return_status => l_return_status,
x_msg_count => l_msg_count,
x_msg_data => l_msg_data,
x_ext_payee_status_tab => l_ext_payee_status_tab);
--创建银行
iby_ext_bankacct_pub.create_ext_bank(
p_api_version => l_api_version, --版本号
p_init_msg_list => fnd_api.g_true, --默认值’T’
p_ext_bank_rec => p_extbank_rec,
x_bank_id => o_bank_id, --返回的银行id
x_return_status => o_return_status, --返回状态
x_msg_count => l_msg_count, --错误数量
x_msg_data => l_msg_data, --错误信息
x_response => l_result_rec);
--创建支行
iby_ext_bankacct_pub.create_ext_bank_branch(
p_api_version => l_api_version, --版本号
p_init_msg_list => fnd_api.g_true, --‘T’
p_ext_bank_branch_rec => l_extbankbranch_rec,
x_branch_id => o_branch_id, --支行id
x_return_status => o_return_status, --返回状态
x_msg_count => l_msg_count, --错误数量
x_msg_data => l_msg_data, --错误信息
x_response => l_result_rec);
--创建帐号
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 => l_ext_bank_acct_rec,
x_acct_id => l_bank_acct_id,
x_return_status => l_return_status,
x_msg_count => l_msg_count,
x_msg_data => l_msg_data,
x_response => l_result_rec);
将账户信息挂到对应地点“添加”按钮中的lov中：
iby_ext_bankacct_pub.add_joint_account_owner(
p_api_version => p_object_version_number, --版本号
p_init_msg_list => fnd_api.g_true, --默认值‘T’
p_bank_account_id => l_ext_bank_acct_rec.bank_account_id, --账户id
p_acct_owner_party_id => l_party_id, --组织id
x_joint_acct_owner_id => l_joint_acct_owner_id, --返回的账户所有者的id
x_return_status => l_return_status,
x_msg_count => l_msg_count,
x_msg_data => l_msg_data,
x_response => l_result_rec);
--创建到地点上
iby_disbursement_setup_pub.set_payee_instr_assignment(
p_api_version => '1.0', --版本号
p_init_msg_list => fnd_api.g_true, --‘T’
p_commit => fnd_api.g_true, --‘T’
x_return_status => l_return_status, --返回状态
x_msg_count => l_msg_count, --错误数量
x_msg_data => l_msg_data, --错误信息
p_payee => l_payee_rec,
p_assignment_attribs => l_assignment_attribs_rec,
x_assign_id => l_assign_id, --使用id
x_response => l_result_rec);
（2）将供应商银行账户信息导入到其他层
l_ext_bank_acct_rec.acct_owner_party_id := v_vendor_party_id;这个必须提供，导入到地点层（1）不需要提供
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 => l_ext_bank_acct_rec,
p_association_level => 'S', --S:供应商层；SS：供应商地点层；A:Address; AO:Address Operating Unit
p_supplier_site_id => NULL,
p_party_site_id => NULL,
p_org_id => NULL,
p_org_type => NULL, --Bug7136876: new parameter
x_acct_id => l_bank_acct_id,
x_return_status => l_return_status,
x_msg_count => l_msg_count,
x_msg_data => l_msg_data,
x_response => l_result_rec);
接口表实现导入方法
6.1 往供应商头信息表里插数据
ap_suppliers_int
6.2 往供应商地点信息表里插数据
ap_supplier_sites_int
6.3往供应商地点联系人信息表里插数据
ap_sup_site_contact_int
6.4 提交并发请求
1.供应商导入
fnd_request.submit_request('SQLAP', --应用简称
'APXSUIMP', --并发程序
'',
'',
FALSE,
'ALL',
1000,
'N',
'N',
'N',
chr(0)) ;
2.供应商地点导入
fnd_request.submit_request('SQLAP', --应用简称
'APXSSIMP', --并发程序
'',
'',
FALSE,
NULL,
'ALL',
1000,
'Y', --REDO
'Y',
'Y',
chr(0));
3.联系人导入
fnd_request.submit_request('SQLAP', --应用简称
'APXSCIMP', --并发程序
'',
'',
FALSE,
'ALL',
1000,
'N',
'N',
'N',
chr(0));
6.5调用API创建银行账户信息
参考API讲解
说明：关于接口表导入的接口表信息信息和字段要求可参考标准文档，或者oracle网站