详解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,     --返回的创建的供应商idx_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,--返回的创建成功的地点idx_party_site_id   => l_party_site_id, --返回机构地点idx_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,--联系人idx_per_party_id       => l_per_party_id,     --联系人机构idx_rel_party_id       => l_rel_party_id,     --关系机构idx_rel_id             => l_rel_id,           --关系idx_org_contact_id     => l_org_contact_id,   --地点联系人idx_party_site_id      => l_party_site_id);   --地点id

 

pos_supp_contact_pkg.update_supplier_contact(p_contact_party_id => l_party_id,    --联系人机构idp_vendor_party_id  => l_vendor_party_site_id,--供应商机构idp_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,       --返回的银行idx_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,        --支行idx_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, --账户idp_acct_owner_party_id => l_party_id,  --组织idx_joint_acct_owner_id => l_joint_acct_owner_id, --返回的账户所有者的idx_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,      --使用idx_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_int6.2 往供应商地点信息表里插数据ap_supplier_sites_int6.3往供应商地点联系人信息表里插数据ap_sup_site_contact_int6.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网站