弹性域 mysql_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、配置客户、付款条件等

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

二、导入代码

-- applies to:  r12 12.1.3

-- purpose:     AR invoice 多行导入

DECLARE

l_ar_iface_row ra_interface_lines_all%ROWTYPE;

BEGIN

mo_global.init('AR');

mo_global.set_policy_context('S',

'204');

fnd_global.apps_initialize(1013616,

65883,

222,

0);

l_ar_iface_row := NULL;

l_ar_iface_row.interface_line_context       := '5211'; -- 上下文

l_ar_iface_row.interface_line_attribute1    := '100'; -- 分组规则

l_ar_iface_row.interface_line_attribute2    := 'TEST1357'; -- 分组标识

l_ar_iface_row.orig_system_bill_customer_id := 116744; -- 客户

l_ar_iface_row.orig_system_bill_address_id  := '11261'; -- 收单方地址

l_ar_iface_row.term_id                      := 1145; -- 收款条件

l_ar_iface_row.batch_source_name            := '5211_导入'; -- 来源

l_ar_iface_row.currency_code                := 'CNY'; -- 币种

l_ar_iface_row.conversion_type              := 'Corporate'; -- 汇率类型

l_ar_iface_row.conversion_rate              := NULL; -- 汇率

l_ar_iface_row.cust_trx_type_id             := 1; -- 发票分配

l_ar_iface_row.line_number                  := 1; -- 行号

l_ar_iface_row.description                  := 'import test 01'; -- 行说明

l_ar_iface_row.quantity                     := 10; -- 数量

l_ar_iface_row.unit_selling_price           := 100; -- 销售单价

l_ar_iface_row.line_type                    := 'LINE'; -- 行类型

l_ar_iface_row.org_id                       := 7911; -- OU

l_ar_iface_row.amount                       := 1000; -- 金额

INSERT INTO ra_interface_lines_all

VALUES l_ar_iface_row;

l_ar_iface_row.interface_line_context       := '5211';

l_ar_iface_row.interface_line_attribute1    := '100';

l_ar_iface_row.interface_line_attribute2    := 'TEST7531';

l_ar_iface_row.orig_system_bill_customer_id := 116744;

l_ar_iface_row.orig_system_bill_address_id  := '11261';

l_ar_iface_row.term_id                      := 1145;

l_ar_iface_row.batch_source_name            := '5211_导入'; --

l_ar_iface_row.currency_code                := 'CNY'; --

l_ar_iface_row.conversion_type              := 'Corporate';

l_ar_iface_row.conversion_rate              := NULL;

l_ar_iface_row.cust_trx_type_id             := 1;

l_ar_iface_row.line_number                  := 2;

l_ar_iface_row.description                  := 'import test 02';

l_ar_iface_row.quantity                     := 10;

l_ar_iface_row.unit_selling_price           := 100;

l_ar_iface_row.line_type                    := 'LINE';

l_ar_iface_row.org_id                       := 7911;

l_ar_iface_row.amount                       := 1000;

INSERT INTO ra_interface_lines_all

VALUES l_ar_iface_row;

END;

三、运行标准请求

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

四、错误调整

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

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

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

五、其他要说明的问题

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