详解EBS接口开发之供应商导入

时间:2023-03-09 07:01:32
详解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网站