SAP 公司间调拨 BAPI:BAPI_ASSET_TRANSFER_POST

原创已于 2025-09-08 11:26:23 修改 · 2.8k 阅读

43 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#SAP #BAPI #资产转移

于 2025-09-08 11:22:50 首次发布

SAP-BAPI 专栏收录该内容

7 篇文章

订阅专栏

该文章已生成可运行项目，

在 SAP 资产管理业务中，资产转移是常见操作，可能涉及公司代码内不同资产间的转移，或跨公司代码的资产调动。手动操作（事务码 ABUMN/ABT1N）效率低且易出错，尤其在批量处理场景下。本文将结合实际函数代码，详解如何使用BAPI_ASSET_TRANSFER_POST实现资产转移的自动化处理。

一、业务背景与 BAPI 选择

资产转移业务场景包括：

预转固资产向正式资产的价值转移
资产在不同成本中心 / 部门间的调拨
跨公司代码的资产转移
资产拆分与合并处理

BAPI_ASSET_TRANSFER_POST是 SAP 专门用于资产转移过账的标准 BAPI，相比前台操作，它的优势在于：

支持批量处理，可集成到批处理程序中
便于与其他系统（如 OA、ERP）对接，实现流程自动化
提供标准化的错误处理机制，便于问题排查
保留完整的业务日志，满足审计需求

二、函数代码解析

以下是封装了BAPI_ASSET_TRANSFER_POST的自定义函数ZFM_FI_ASSET_TRANSFER完整代码，我们将按接口定义、参数配置、BAPI 调用和结果处理四个维度进行解析。

1. 接口定义

函数接口设计需兼顾输入参数（业务数据）、输出参数（处理结果）和内部表（返回消息）：

FUNCTION zfm_fi_asset_transfer.
*"----------------------------------------------------------------------
*"*"本地接口：
*"  IMPORTING
*"     REFERENCE(LV_TEXT) TYPE  STRING  "行项目文本
*"  EXPORTING
*"     VALUE(LV_MSG) TYPE  BAPI_MSG  "汇总消息
*"  TABLES
*"      LT_RETURN STRUCTURE  BAPIRET2  "返回消息表
*"  CHANGING
*"     REFERENCE(IV_ITEM) TYPE  ZSFI0020  "资产转移业务数据结构
*"----------------------------------------------------------------------

关键参数说明：

LV_TEXT：行项目文本，用于凭证行项目的描述
LV_MSG：汇总错误消息，便于前端展示
LT_RETURN：BAPI 返回的详细消息，包含错误代码和描述
IV_ITEM：自定义业务结构（ZSFI0020），存储资产转移的核心数据（如公司代码、资产号、过账日期等）

2. 数据对象定义

根据 BAPI 要求，需定义四类核心结构体，分别对应不同维度的业务数据：

"定义资产转移BAPI结构
DATA:
  "通用过账信息
  ls_generalpostingdata  TYPE bapifapo_gen_info,
  "转移目标信息
  ls_transfertodata      TYPE bapifapo_transfer_to,
  "转移过账数据
  ls_transferpostingdata TYPE bapifapo_transfer_rev_distr,
  "附加过账信息
  ls_furtherpostingdata  TYPE bapifapo_add_info,
  "消息结构
  ls_return              TYPE bapiret2.

结构体功能说明：

bapifapo_gen_info：存储通用过账信息（凭证日期、公司代码、源资产信息等）
bapifapo_transfer_to：存储目标资产信息（接收方公司代码、目标资产号等）
bapifapo_transfer_rev_distr：存储转移价值信息（价值日期、转移变式、金额等）
bapifapo_add_info：存储附加文本信息（凭证抬头文本、行项目文本等）

3. 参数赋值

参数赋值是核心环节，需根据业务需求准确映射字段值，以下是关键字段配置：

"清空结构体
CLEAR: ls_generalpostingdata, ls_transfertodata, 
       ls_transferpostingdata, ls_furtherpostingdata.

"1. 通用过账信息配置
ls_generalpostingdata-doc_date   = iv_item-bzdat.    "凭证日期
ls_generalpostingdata-pstng_date = iv_item-bzdat.    "过账日期
ls_generalpostingdata-comp_code  = iv_item-bukrs.    "源公司代码
ls_generalpostingdata-assetmaino = iv_item-anln1.    "源资产主号
ls_generalpostingdata-assetsubno = iv_item-anln2.    "源资产子号

"2. 转移价值信息配置
ls_transferpostingdata-valuedate = iv_item-bzdat.    "资产价值日期
ls_transferpostingdata-transvar   = '0001'.          "转移变式（关键配置）
ls_transferpostingdata-currency   = 'CNY'.           "货币类型

"3. 目标资产信息配置
ls_transfertodata-part_comco = iv_item-bukrs1.       "目标公司代码
ls_transfertodata-part_asset = iv_item-zanln1.       "目标资产主号
ls_transfertodata-part_subno = iv_item-zanln2.       "目标资产子号

"4. 附加文本信息配置
ls_furtherpostingdata-header_txt = iv_item-zdjbh.    "凭证抬头文本（如单据编号）
ls_furtherpostingdata-item_text = lv_text.           "行项目文本

核心字段详解：

转移变式（transvar）：'0001'是标准配置，控制转移的价值范围（如原值、累计折旧）和科目确定，需根据客户配置调整（T-CODE: AO76 维护）。
日期字段：凭证日期、过账日期和价值日期通常保持一致，特殊场景下可分开设置（如跨期转移）。
资产编号：需同时指定主号（assetmaino）和子号（assetsubno），子号默认0000。

4. BAPI 调用

调用BAPI_ASSET_TRANSFER_POST执行资产转移，并通过return_all参数获取详细消息：

CALL FUNCTION 'BAPI_ASSET_TRANSFER_POST'
  EXPORTING
    generalpostingdata  = ls_generalpostingdata  "通用过账信息
    transfertodata      = ls_transfertodata      "目标资产信息
    transferpostingdata = ls_transferpostingdata "转移价值信息
    furtherpostingdata  = ls_furtherpostingdata  "附加文本信息
  TABLES
    return_all          = lt_return.             "返回消息表

5. 结果处理

BAPI 调用后必须检查返回消息，根据结果执行事务提交或回滚，并收集错误信息：

"检查是否有成功消息
READ TABLE lt_return INTO ls_return WITH KEY type = 'S' id = 'FAA_POST'.

IF sy-subrc = 0.
  "转移成功，提交事务（注：实际开发中需启用）
*  CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'
*    EXPORTING
*      wait = 'X'.  "同步提交，确保数据立即生效

ELSE.
  "转移失败，回滚事务（注：实际开发中需启用）
*  CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.

  "收集所有错误消息
  LOOP AT lt_return INTO ls_return WHERE type = 'E' OR type = 'A'.
    lv_msg = COND #( 
      WHEN lv_msg IS INITIAL THEN ls_return-message
      ELSE |{ lv_msg }，{ ls_return-message }| 
    ).
  ENDLOOP.

  "更新业务结构的状态和消息
  iv_item-type = 'E'.  "标记为错误
  iv_item-msg = lv_msg. "存储错误信息
ENDIF.

结果处理要点：

成功标识：type = 'S'且id = 'FAA_POST'通常表示过账成功
错误处理：需收集所有type = 'E'（错误）和type = 'A'（终止）的消息
事务控制：必须通过BAPI_TRANSACTION_COMMIT/ROLLBACK处理事务，否则数据不会实际写入数据库
创建成功结果展示（各公司代码各产生两张不同分类账凭证）

三、关键技术要点与注意事项

转移变式配置
转移变式（transvar）是核心控制参数，决定了：
- 哪些价值字段被转移（原值、累计折旧、重估价值等）
- 对应的总账科目（如资产原值、累计折旧科目）
- 是否产生收入 / 支出 postings
需通过 T-CODE: AO76 维护变式，确保与业务需求匹配。
日期一致性
过账日期（pstng_date）需在当前会计期间内，否则会报错 “过账日期不在当前期间”。价值日期（valuedate）决定了资产价值的变动时点，影响折旧计算。
测试运行机制
开发阶段建议先通过testrun参数（部分 BAPI 支持）进行测试，或在函数中添加测试开关，避免产生无效凭证。（此BAPI不支持）
权限控制
执行用户需具备资产转移的权限（对象F_AFA_BUK、F_AFA_ANL等），否则会返回权限不足的错误。
批量处理优化
批量转移时建议：
- 每处理 100-200 条记录提交一次事务，避免锁表
- 增加日志表记录处理结果，便于追溯
- 采用异步处理（如 Background Job），提高效率