R12 AR INVOICE 接口表导入

http://blog.csdn.net/fangz0615/article/details/38677085

Purpose

本文介绍了如何通过AR接口表进行AR事务处理（亦称AR发票）导入。

Applies To

version 12.1.3

本文中代码基于12.1.3测试通过。

Abstract

oracle支持两种不同的接口导入方式，一种是通过API导入，一种是通过接口表导入。关于API导入可以参考1242202.1。oracle标准功能OM自动开票到AR是通过接口表完成的。本文以接口表导入方式为主。

Details

一、导入前的准备

AR的接口表与其他的接口表稍稍有点不同，接口表标识字段是通过弹性域控制的，导入的数据如何分组（即一个invoice包含哪些行）也是通过弹性域控制的。ra_interface_lines_all中包含很多的弹性域，每一个弹性域都有不同的作用，详情可参考1068344.1。这些设置不仅仅适用于外部系统导入，也适用于OM autoinvoice.

1、配置弹性域

接口表的标识是通过弹性域组合interface_line_context，interface_line_attribute1~15来唯一标识的，具体使用哪些弹性域是通过配置的。

路径：OM：设置->财务系统->弹性域->说明性->段

这里我设置上下文为5211，列为interface_line_attribute2

2、配置分组规则

分组规则决定了哪些行会分到同一个ar invoice下。

路径：OM：设置->事务处理->自动开票->分组规则

注意红框内可以上下键选择不同的事务处理分类，可以针对不同的分类配置不同的分组规则。我们这里设置interface_line_attribute1。

这里说明一下，实际上，interface_line_attribute1中的值是会写入发票的参考字段的。

3、配置导入来源

发票导入时究竟是选择哪个分组规则，是通过来源控制的。

路径：OM：设置->事务处理->来源

4、配置客户、付款条件等

此处不详细介绍，参照相关文档设置即可。

二、导入代码

1. -- applies to:  r12 12.1.3
2. -- purpose:     AR invoice 多行导入
3. DECLARE
4. l_ar_iface_row ra_interface_lines_all%ROWTYPE;
5. BEGIN
6. mo_global.init('AR');
7. mo_global.set_policy_context('S',
8. '204');
9. fnd_global.apps_initialize(1013616,
10. 65883,
11. 222,
12. 0);
13. l_ar_iface_row := NULL;
14. l_ar_iface_row.interface_line_context       := '5211'; -- 上下文
15. l_ar_iface_row.interface_line_attribute1    := '100'; -- 分组规则
16. l_ar_iface_row.interface_line_attribute2    := 'TEST1357'; -- 分组标识
17. l_ar_iface_row.orig_system_bill_customer_id := 116744; -- 客户
18. l_ar_iface_row.orig_system_bill_address_id  := '11261'; -- 收单方地址
19. l_ar_iface_row.term_id                      := 1145; -- 收款条件
20. l_ar_iface_row.batch_source_name            := '5211_导入'; -- 来源
21. l_ar_iface_row.currency_code                := 'CNY'; -- 币种
22. l_ar_iface_row.conversion_type              := 'Corporate'; -- 汇率类型
23. l_ar_iface_row.conversion_rate              := NULL; -- 汇率
24. l_ar_iface_row.cust_trx_type_id             := 1; -- 发票分配
25. l_ar_iface_row.line_number                  := 1; -- 行号
26. l_ar_iface_row.description                  := 'import test 01'; -- 行说明
27. l_ar_iface_row.quantity                     := 10; -- 数量
28. l_ar_iface_row.unit_selling_price           := 100; -- 销售单价
29. l_ar_iface_row.line_type                    := 'LINE'; -- 行类型
30. l_ar_iface_row.org_id                       := 7911; -- OU
31. l_ar_iface_row.amount                       := 1000; -- 金额
32. INSERT INTO ra_interface_lines_all
33. VALUES l_ar_iface_row;
34. l_ar_iface_row.interface_line_context       := '5211';
35. l_ar_iface_row.interface_line_attribute1    := '100';
36. l_ar_iface_row.interface_line_attribute2    := 'TEST7531';
37. l_ar_iface_row.orig_system_bill_customer_id := 116744;
38. l_ar_iface_row.orig_system_bill_address_id  := '11261';
39. l_ar_iface_row.term_id                      := 1145;
40. l_ar_iface_row.batch_source_name            := '5211_导入'; --
41. l_ar_iface_row.currency_code                := 'CNY'; --
42. l_ar_iface_row.conversion_type              := 'Corporate';
43. l_ar_iface_row.conversion_rate              := NULL;
44. l_ar_iface_row.cust_trx_type_id             := 1;
45. l_ar_iface_row.line_number                  := 2;
46. l_ar_iface_row.description                  := 'import test 02';
47. l_ar_iface_row.quantity                     := 10;
48. l_ar_iface_row.unit_selling_price           := 100;
49. l_ar_iface_row.line_type                    := 'LINE';
50. l_ar_iface_row.org_id                       := 7911;
51. l_ar_iface_row.amount                       := 1000;
52. INSERT INTO ra_interface_lines_all
53. VALUES l_ar_iface_row;
54. END;

 

三、运行标准请求

将数据通过上述代码插入接口表后，运行“自动开票主程序”，选择所使用的来源，提交请求，请求会自动运行一个子程序“自动开票导入程序”导入AR发票。

四、错误调整

请求运行结束后，查看“自动开票导入程序”的输出的报表，如果导入成功，会提示导入成功。如果导入不成功，会提示报错，并提示错误原因。可根据错误原因对数据进行调整。可以直接通过后台修改数据 ，也可通过前台查看接口数据和接口例外。

路径：OM：控制->自动开票->接口行

路径：OM：控制->自控开票>接口列外

五、其他要说明的问题

这里主要讲下唯一标识的问题。上文中说到接口表的唯一标识是通过弹性域组合来控制的，实际上这个说法并不完成。应该说实际上，所有AR发票（包括在接口表中预导入的发票）都可以通过弹性域组合来控制唯一性。在我测试中遇到这样的问题，第一次将att1设置为100，发票导入成功。再次将att1为100的数据插入接口表，运行请求，导入失败，程序会报“此行与 Oracle Receivables 中的另一张发票具有相同的事务处理弹性域”，从报错中也可以看出，提示是与“另一张发票”具有相同的弹性域。