使用“事务处理 API”导入事务处理《Oracle 应收款管理系统帮助》


	上一页	下一页		目录	索引	定位	词汇表	程序库

使用“事务处理 API”导入事务处理

您可以使用 Oracle 应收款管理系统事务处理“应用编程接口”(API) 将发票、贷项通知单和借项通知单从外部系统导入 Oracle 应收款管理系统。应收款管理系统以前要求您在“事务处理”窗口中人工输入事务处理，或者使用自动开票程序从外部系统将其导入。但自动开票通常要消耗时间，并要求您创建事务处理作为批的一部分。“事务处理 API”使您可以使用您的系统，以在较少限制条件下更快地在应收款管理系统中创建事务处理。

注意：此功能当前处于 BETA 状态，并且仅可与测试或演示数据库一同使用。在生产环境下使用此功能之前，请与应收款管理系统产品经理取得联系以获得批准。

API 流程与在“应收款事务处理”窗口中创建事务处理非常相似。使用事务处理 API，您可以在系统中创建单个事务处理，保存所做的工作，然后立即提交以在应收款管理系统中进行创建。如果所有信息均完整且有效，应收款管理系统将立即创建事务处理；否则，您需要修改或提供任何遗漏的数据，然后重新提交事务处理至 API。

使用“事务处理 API”的其它优点包括：

省时 - “事务处理 API”允许更快地将产量从您的系统传送至 Oracle 应收款管理系统。您可以根据需要创建事务处理，而无需按自动开票要求的方式导入、验证、更正错误，然后重新导入。

增大灵活性 - 您可以从系统的事务处理分录窗口或从程序（此程序将多个事务处理从外部系统传送至应收款管理系统）调用“事务处理 API”。

立即验证 - 如果从外部系统调用，“事务处理 API”将立即验证信息，然后在 Oracle 应收款管理系统中创建事务处理或显示错误信息。

更新和删除事务处理 - 您可以修改系统中的事务处理，并且“事务处理 API”将自动更新应收款管理系统中的信息。您也可以使用此方法删除应收款管理系统中的某个事务处理（如果此事务处理符合某些要求）。

从不同系统导入数据 - “事务处理 API”允许您导入各种环境中的事务处理数据。您可以从 Oracle 订单分录管理系统、现有系统或储存信息的任何第三方应用产品中导入数据。

下图显示了使用“事务处理 API”如何将事务处理信息导入 Oracle 应收款管理系统的过程。

在您提交事务处理时，“事务处理 API”将验证信息。如果信息符合所有验证要求，API 将在 Oracle 应收款管理系统中创建事务处理。如果数据未通过验证，API 将显示错误信息以帮助您确定丢失或无效的数据。然后，您可以更新系统中的信息并重新提交事务处理至 API。

事务处理验证

“事务处理 API”将验证数据与 Oracle 应收款管理系统是否兼容。它确保 Oracle 应收款管理系统接口表中的栏参考了应收款管理系统中的相应值和栏。“事务处理 API”执行的其它验证包括：

现存性：对于某些栏，“事务处理 API”将确保栏值在应收款管理系统中已经定义。但是，此程序将不对照状态进行验证。例如，如果您导入了具有无效付款条件的事务处理，API 并不拒绝此事务处理。

唯一性：“事务处理 API”将确保您提供的发票编号唯一，并且您提供的单据编号在关联序列类型中唯一。

精确度：对于给定的币种，“事务处理 API”将确保您提供的金额和入帐额具有正确的精确度。

交叉验证：“事务处理 API”将确保某些栏值相互一致。这些值可在单个接口表或多个接口表中。

有关详情，请参阅：错误处理

对事务处理计税

“事务处理 API”提供了您需要符合销售税和其它纳税要求的功能，如增值税 (VAT)。您可以传送税码行、免税行，或使用在计税流程图中显示的分层结构，以使“事务处理 API”自动确定税率。在“事务处理 API”确定税率时，它将考虑所有客户或项目免税或项目税收例外项。请参阅：计税概览

“事务处理 API”允许您传送作为单个事务处理或其它事务处理参考的税行。如果要传送税行，您只能传送与增值税或销售税类型的税码相关联的税行。与自动开票不同的是，“事务处理 API”允许您传送非即席税行。此时，API 将依据指定的税码计算每行的税率和税额。

如果您在支系统中指定了税码、税率和优先信息，“事务处理 API”会将数据直接导入应收款管理系统表（例如，无需计算）。如果您未提供此信息，应收款管理系统将使用与发运地址相关联的税率来计算销售税。应收款管理系统仅计算国家/地区内发运地址的销售税，该国家/地区在“系统选项”窗口的“默认国家/地区”字段中定义。

“事务处理 API”将使用您在“系统选项”窗口中定义的分层结构搜索税率，直至找到为止。您可以在应收款管理系统的以下层中指定税码：

发运目的地/开单至地址

客户

项目/标准通知单行

“系统选项”窗口（如果税收方法为增值税）

如果您不需要应收款管理系统依据地点计税，则可以通过 line_type 参数设置为“税”的行传送税码。税码可以是“增值税”或“销售税”类型。对于即席税码，您同时必须传送税率或税额。如果您要传送非即席税码，则不能指定延期额或税率。任何免税均必须计入税率或税额。

确定 GL 日期

“事务处理 API”将依据您提供的信息导出 GL 日期。API 将使用以下分层结构搜索 GL 日期，直至找到为止：

批 GL 日期

事务处理日期

上一事务处理 GL 日期

开票规则标识

注意：“事务处理 API”拒绝在关闭期间中具有 GL 日期的事务处理。

导入含规则发票

如果会计方法是“应计制”，您可以使用“事务处理 API”导入含会计和开票规则的发票。如果会计方法是“现金收付制”，则 API 将拒绝所有含规则发票。会计规则将确定期数以及在每个会计期中要记录的收入总额百分比。开票规则将确定记录应收款金额的会计期。

应收款管理系统提拱了两个开票规则，“提前开票”和“拖欠开票”。您需要提供具有模型帐户的 API，此帐户包含会计分配和分配给每个帐户的百分比。在应收款管理系统可以为这些发票创建会计分录之前，您必须运行收入确认程序。

“事务处理 API”除验证日期外，并在以下情况下验证和拒绝行：

会计规则具有重叠期间

在会计规则期限内并不存在所有会计期

导入贷项通知单

在您对照事务处理导入贷项通知单时，“事务处理 API”将确保要导入的贷项通知单“未结应收款”标志与它要贷记的事务处理“未结应收款”标志相匹配。

在您导入含规则发票的贷项通知单时，API 将使用您在 CREDIT_METHOD_FOR_RULES 栏中输入的会计规则方法来确定如何冲销为原始发票创建的会计分录。您可以输入“后进先出”、“按比例分配”或“单位”。如果您选择“后进先出”，应收款管理系统将从最后一期开始冲销会计分录。如果您选择“按比例分配”，应收款管理系统将在所有会计期中按比例分配贷项金额。如果您选择“单位”，应收款管理系统将允许您贷记特定的数量（从您在栏 LAST_PERIOD_TO_CREDIT 中指定的期间开始）并继续向后进行。

如果您导入无规则发票的贷项通知单，“自动开票”将使用接口表中的总帐日期作为贷项通知单的总帐日期。贷项通知单行的总帐日期必须始终与贷项通知单的日期相同。

贷项通知单总帐日期必须等于或大于您要贷记的发票总帐日期。同时，贷项通知单总帐日期必须在“打开”或“将来”期间内。但是，如果会计规则是“拖欠”，贷项通知单的总帐日期则可以在“未打开”的期间内。

使用“事务处理 API”导入的无规则发票贷项通知单与通过“贷项通知单”窗口人工输入的那些贷项通知单功能相同。例如，您传送了要贷记的金额，应收款管理系统将自动创建所有会计冲销分录。应收款管理系统还将自动冲销对销售人员指定的销售和非收入贷项。

默认

“事务处理 API”为某些参数提供了默认值。有关详情，请参阅：事务处理 API 矩阵

定金和保证金

“事务处理 API”并不将定金或保证金（“承付款”）导入应收款管理系统。

应收款管理系统表

如果事务处理通过验证，则“事务处理 API”会将数据写入以下应收款管理系统表中：

RA_ BATCHES

RA_CUSTOMER_TRX

RA_CUSTOMER_TRX_LINES

RA_CUST_TRX_LINE_GL_DIST

RA_CUST_TRX_LINE_SALESREPS

AR_PAYMENT_SCHEDULES

AR_ADJUSTMENTS

AR_RECEIVABLE_APPLICATIONS

有关详情，请参阅：“事务处理 API”矩阵

注：AR_PAYMENT_SCHEDULES、AR_ADJUSTMENTS 和 AR_RECEIVABLE_APPLICATIONS 表并不包括在“事务处理 API 矩阵”中。这是因为 API 会自动将数据写入这些表中，而其它表则要求您传送每个栏值。

功能程序库

文件 $AR_TOP/admin/sql/ARTPTRXS.pls 包含以下主要 API 例行程序的说明：

get_transaction

create_transaction

update_transaction

delete_transaction

“事务处理 API”同时提供了支持例行程序的程序库，它可帮助您准备要导入应收款管理系统的数据。例如，在创建事务处理时，API 要求将事务处理的付款条件标识而非名称填入应收款管理系统表。但在某些系统中，重要参考将使用用户值而非内部标识传送。“事务处理 API”的例行程序库会将外部系统中的用户值转换成应收款管理系统为成功创建事务处理所要求的标识。请参阅：准备系统

有关以下转换例行程序，请参阅 $AR_TOP/admin/sql/ARTPTRLS.pls：

get_ID

get_address_id

get_site_use_id

get_contact_id

get_bank_account_id

get_bank_branch_id

get_flex_ccid

get_transaction_ids

get_customer_trx_id

ARTPTRLS.pls 同时包含以下例行程序的说明，您可以使用这些例行程序以获得事务处理的默认值：

get_date_default_new

get_number_default_value

get_char_default_value

有关详情，请参阅：API 参数和“事务处理 API”矩阵

API 参数

创建、更新和删除例行程序均具有不同的参数集。但是，以下参数是这三个例行程序的公用参数：

p_api_name 调用 API 的程序名。

p_api_version 传送值 1.0。这将核实您要调用的 API 版本与支程序是否兼容。

p_init_msg_list 传送“T”以使 API 为您初始化信息栈；否则，请传送“F”。

p_commit 如果成功完成，请传送“T”以使 API 进行确认；否则，请传送“F”。

p_validation_level （API 当前未使用）

p_return_status 返回以下值之一：
S - 成功完成
E - 验证/意外错误
U - 意外错误（如 Oracle 错误）

p_msg_count 返回放入信息栈中的信息数目。

p_msg_data 如果 p_msg_count 为 1，则 p_msg_data 包含信息；否则，p_msg_data 为空。

p_errors 出现具有附加信息的错误列表。

以下参数用于一个或多个 API 例行程序：

p_batch_rec 传送要存储在 RA_BATCHES 中的批信息。

p_header_rec 传送要存储在 RA_CUSTOMER_TRX 中的页眉信息。

p_receivable_gl_date 为应收款帐户指定传送 GL 日期。

p_lines_tbl 传送要存储在 RA_CUSTOMER_TRX_LINES 中的行信息。

p_tax_lines_tbl 传送要存储在 RA_CUSTOMER_TRX_LINES 中的税务信息。

p_freight_lines_tbl 传送要存储在 RA_CUSTOMER_TRX_LINES 中的运费信息。

p_salescredit_lines_ tbl 传送要存储在 RA_CUST_TRX_LINE_SALESREPS 中的销售业绩信息。

p_dist_tbl 传送要存储在 RA_CUST_TRX_LINE_GL_DIST 中的帐户指定或帐户集。

p_recac_tax_flag 传送“T”以使 API 重新计税。

p_rerun_autoacc_flag 传送“T”以使 API 使用“自动会计”重新创建帐户指定或帐户集。

p_backout_sc_flag 输入“T”以使 API 创建调整帐户指定分录而非更新现有销售业绩行。

p_backout_dist_flag 输入“T”以使 API 创建调整帐户指定分录而非更新现有帐户指定行。

高速缓存

“事务处理 API”将使用多个高速缓存来存储有用数据，如会计期、客户信息和税码。根据系统内存，您可能要重新配置高速缓存的大小以提高系统的运行能力。如果您具有大量内存且要增大高速缓存，请将高速缓存的大小设置为更大的数目；否则，请将高速缓存的大小设置为较小的数目。高速缓存的默认值为 1000，但您可以通过使用以下库例行程序进行修改：

configure_caches

另请参阅

索引

定位

词汇表

程序库

p_api_name	调用 API 的程序名。
p_api_version	传送值 1.0。这将核实您要调用的 API 版本与支程序是否兼容。
p_init_msg_list	传送“T”以使 API 为您初始化信息栈；否则，请传送“F”。
p_commit	如果成功完成，请传送“T”以使 API 进行确认；否则，请传送“F”。
p_validation_level	（API 当前未使用）
p_return_status	返回以下值之一： S - 成功完成 E - 验证/意外错误 U - 意外错误（如 Oracle 错误）
p_msg_count	返回放入信息栈中的信息数目。
p_msg_data	如果 p_msg_count 为 1，则 p_msg_data 包含信息；否则，p_msg_data 为空。
p_errors	出现具有附加信息的错误列表。

p_batch_rec	传送要存储在 RA_BATCHES 中的批信息。
p_header_rec	传送要存储在 RA_CUSTOMER_TRX 中的页眉信息。
p_receivable_gl_date	为应收款帐户指定传送 GL 日期。
p_lines_tbl	传送要存储在 RA_CUSTOMER_TRX_LINES 中的行信息。
p_tax_lines_tbl	传送要存储在 RA_CUSTOMER_TRX_LINES 中的税务信息。
p_freight_lines_tbl	传送要存储在 RA_CUSTOMER_TRX_LINES 中的运费信息。
p_salescredit_lines_ tbl	传送要存储在 RA_CUST_TRX_LINE_SALESREPS 中的销售业绩信息。
p_dist_tbl	传送要存储在 RA_CUST_TRX_LINE_GL_DIST 中的帐户指定或帐户集。
p_recac_tax_flag	传送“T”以使 API 重新计税。
p_rerun_autoacc_flag	传送“T”以使 API 使用“自动会计”重新创建帐户指定或帐户集。
p_backout_sc_flag	输入“T”以使 API 创建调整帐户指定分录而非更新现有销售业绩行。
p_backout_dist_flag	输入“T”以使 API 创建调整帐户指定分录而非更新现有帐户指定行。