BAPI_OUTB_DELIVERY_CREATE_SLS的行项目号分配机制

joe_sap

于 2025-06-27 07:47:53 发布

阅读量756

点赞数 21

CC 4.0 BY-SA版权

分类专栏： SAP 文章标签：笔记

本文链接：https://blog.youkuaiyun.com/joe_sap/article/details/148938980

SAP 专栏收录该内容

3 篇文章

订阅专栏

一、行项目号分配的核心规则

通过分析标准BAPI行为，我们总结出以下不可变规则：

输入参数无效
ITEM_DATA中的DELIV_ITEM字段在输入时会被系统忽略

ls_item_data-deliv_item = '999' " ⚠️ 此赋值无效！
继承式自动分配
系统严格遵循销售订单行号结构：
- 主项行号直接继承（销售订单行10 → 交货单行10）
- 子项行号层级保留（销售订单行0110 → 交货单行0110）
- 多行项目顺序保持原结构

输出表关键作用
生成的明细通过BCREATED_ITEMS表返回：

LOOP AT lt_created_items INTO DATA(ls_item).
  WRITE: / '交货单:', ls_item-deliv_numb,
           '行号:',  ls_item-deliv_item. " 系统分配行号
ENDLOOP.

二、技术实现全景解析

标准创建流程（推荐）

DATA:
  lt_item_data TYPE TABLE OF bapiobdlvitemcrt,
  lt_created   TYPE TABLE OF bapiobdlvitemcreated.

" 1. 准备数据（行号字段留空）
APPEND VALUE #( 
  ref_doc  = 'ORDR001'   " 必填：销售订单
  ref_item = '000010'    " 必填：销售订单行
  material = 'MAT-001'
  dlv_qty  = 100
) TO lt_item_data.

" 2. 调用BAPI
CALL FUNCTION 'BAPI_OUTB_DELIVERY_CREATE_SLS'
  EXPORTING
    header_data   = ls_header
  TABLES
    item_data     = lt_item_data
    created_items = lt_created. " 接收行明细

" 3. 验证结果
IF line_exists( lt_return[ type = 'E' ] ).
  ROLLBACK WORK.
ELSE.
  COMMIT WORK.
ENDIF.

输出表BCREATED_ITEMS结构详解

字段名	类型	说明	示例值
DELIV_NUMB	CHAR10	交货单号	180000123
DELIV_ITEM	NUMC6	系统分配行号	000010
REF_DOC	CHAR10	参考销售订单	ORDR001
REF_ITEM	NUMC6	销售订单行号	000010
MATERIAL	CHAR18	物料号	MAT-001
BATCH	CHAR10	批次号	BATCH01

三、强制自定义行号的进阶方案

当业务必须自定义行号时，可通过增强实现：

方案1：交货单修改（风险较高）

" 先创建交货单（获取系统行号）
CALL FUNCTION 'BAPI_OUTB_DELIVERY_CREATE_SLS'
  EXPORTING...
  TABLES created_items = lt_created.

" 尝试修改行号（需增强支持）
DATA(lt_change) = VALUE bapiobdlvitemchg_tab(
  FOR ls_in IN lt_created
  ( deliv_numb = ls_in-deliv_numb
    deliv_item = ls_in-deliv_item
    deliv_item_new = '999' ) " 新行号
).

CALL FUNCTION 'BAPI_OUTB_DELIVERY_CHANGE'
  TABLES
    item_data = lt_change
    return    = lt_return.

方案2：BAdI增强（推荐）

在LE_SHP_DELIVERY_PROC的ITEM_BEFORE_UPDATE方法中覆盖行号：

METHOD if_ex_le_shp_delivery_proc~item_before_update.
  " 自定义行号逻辑
  CASE cs_delivery_item-ref_doc.
    WHEN 'ORDR-SPECIAL'.
      cs_delivery_item-deliv_item = cv_custom_item. 
  ENDCASE.
ENDMETHOD.

⚠️ 关键警示
修改行号可能引发严重后果：

破坏与销售订单的关联性

导致发货过账（VL02N）失败

影响后续开票流程
务必在测试系统充分验证！

四、最佳实践指南

优先采用系统分配行号
99%的业务场景无需自定义行号
使用扩展字段存储业务编号
```
" 添加自定义字段
ls_item_data-zz_business_item = 'CUST-001'. 
```
通过增强在ITEM_DATA中添加自定义字段

层级结构处理技巧
当需要合并多个销售订单行时：

abap

Copy

Download

APPEND VALUE #( 
  ref_doc  = 'ORDR001'
  ref_item = '000010'
  material = 'MAT-001'
  dlv_qty  = 50
) TO lt_item_data.

APPEND VALUE #( 
  ref_doc  = 'ORDR001'
  ref_item = '000020' " 不同销售订单行
  material = 'MAT-001'
  dlv_qty  = 50
) TO lt_item_data.

系统将生成两个交货行（000010和000020）

五、深度技术思考

系统设计哲学
SAP采用继承式行号设计，核心是为了：
- 保持跨模块数据一致性（SD-MM-FI集成）
- 维护行项目层级结构（主项/子项关系）
- 避免行号冲突的标准化管理
性能优化建议
大批量处理时：
- 使用DELIVERY参数预分配交货单号范围
- 并行处理不同发货点的创建请求
- 通过BAPI_SET_COMMIT延迟提交

结语

理解BAPI_OUTB_DELIVERY_CREATE_SLS的行号分配机制，是构建健壮交货流程的基础。虽然标准功能限制手动指定行号，但通过合理利用BCREATED_ITEMS输出表和增强方案，依然能满足复杂业务需求。建议开发者始终遵循最小定制化原则，优先采用SAP标准逻辑，确保系统长期稳定性。