SAP EWM内向交货单创建避坑指南：从PRDI事务码到后台代码的完整映射与常见报错解决
SAP EWM内向交货单自动化创建实战：从PRDI事务码到ABAP OO API的深度解析
1. 理解内向交货单创建的核心逻辑
在SAP EWM（Extended Warehouse Management）系统中，内向交货单（Inbound Delivery）的创建是仓库管理中最基础也最关键的环节之一。与传统的SAP ERP系统不同，EWM的内向交货单创建机制采用了面向对象的设计理念，这为自动化集成带来了独特的挑战和机遇。
为什么前台操作顺畅而后台代码容易出错？这个问题的根源在于EWM的架构设计。前台事务码/N/SCWM/PRDI实际上封装了大量隐式逻辑和默认值处理，而直接调用ABAP OO API时，这些隐式逻辑需要开发者显式处理。以下是关键差异点的对比：
| 功能点 | 前台操作自动处理的内容 | 后台代码需要显式处理的内容 |
|---|---|---|
| 仓库编号设置 | 自动从用户参数获取 | 必须通过/scwm/cl_tm=>set_lgnum显式设置 |
| 合作伙伴角色 | 根据业务场景自动填充默认角色 | 需要明确指定每个合作伙伴的角色和编号 |
| 参考凭证类型 | 自动关联ASN和ERP类型的参考凭证 | 必须手动创建两种参考凭证的关联关系 |
| 数据校验时机 | 在每一步操作后进行即时校验 | 需要在关键节点手动触发校验逻辑 |
在实际项目中，我们经常遇到这样的场景：顾问在前台测试时一切正常，但一旦切换到接口自动化创建，就会频繁出现各种报错。这通常是因为没有完整映射前台操作的所有隐式步骤。
2. 关键类与方法解析
SAP EWM提供了两个核心类来处理内向交货单的创建：
" 主要服务提供类 DATA: lo_sp_inb TYPE REF TO /scwm/cl_sp_prd_inb. " 交付服务提供类 DATA: lo_delivery_sp TYPE REF TO /scdl/cl_sp_prd_inb.初始化服务提供者的正确姿势：
TRY. CREATE OBJECT lo_adapter_handler. CREATE OBJECT lo_sp_inb EXPORTING iv_mode = /scdl/cl_sp=>sc_mode_classic io_attribute_handler = lo_adapter_handler io_message_handler = lo_adapter_handler. CATCH /scdl/cx_sp. " 必须捕获特定异常 " 异常处理逻辑 ENDTRY.这里有几个关键点需要注意：
sc_mode_classic表示使用经典模式，与前台操作保持一致- 必须提供属性处理器和消息处理器
- 一定要实现完整的异常捕获机制
3. 创建流程的九大关键步骤拆解
3.1 环境准备与初始化
在开始创建交货单之前，必须正确设置执行环境：
仓库编号设置：
/scwm/cl_tm=>set_lgnum( iv_lgnum ). " 这是强制性的第一步默认值处理：
ls_details-v_fieldname = 'LGNUM'. ls_details-v_mandatory = abap_true. ls_details-v_memoryid = '/SCWM/LGN'. APPEND ls_details TO ls_default_values-t_details.
注意：忘记设置仓库编号是导致"无法确定仓库"错误的最常见原因。这个错误通常不会立即出现，而是在后续保存时才会报出，增加了排查难度。
3.2 交货单抬头创建
抬头创建是第一个实质性步骤，这里有几个容易出错的点：
DATA: lt_return_codes TYPE /scdl/t_sp_return_code. CALL METHOD lo_sp_inb->insert EXPORTING inrecords = lt_a_head_prdi aspect = /scwm/if_sp_c=>sc_asp_head IMPORTING outrecords = lt_a_head_prdi_out return_codes = lt_return_codes.常见错误及解决方案：
凭证类型不匹配：
- 错误消息：
凭证类型XXX不适用于文档类别YYY - 解决方案：确保
iv_doctype和iv_doccat参数匹配
- 错误消息：
缺少必要字段：
- 错误消息：
字段ZZZ是必需的 - 解决方案：检查所有标记为
mandatory的字段是否都已填充
- 错误消息：
3.3 合作伙伴角色处理
合作伙伴配置是另一个容易出错的环节。EWM要求至少提供以下合作伙伴角色：
- 供应商（SUPPLIER）
- 收货方（GOODSRECIPIENT）
- 通知方（NOTIFIEDPARTY）
LOOP AT it_head_party INTO ls_head_party. ls_a_head_party-party_role = ls_head_party-party_role. ls_a_head_party-partyno = ls_head_party-partyno. APPEND ls_a_head_party TO lt_a_head_party. ENDLOOP.典型错误场景：
- 角色代码拼写错误（如把SUPPLIER写成SUPLIER）
- 合作伙伴编号与角色不匹配
- 缺少必需的角色
3.4 参考凭证的特殊处理
参考凭证是EWM内向交货单中最复杂的部分之一。根据经验，必须同时提供两种类型的参考凭证：
- ERP参考凭证：通常对应采购订单
- ASN参考凭证：高级发货通知
" 先创建ERP参考凭证 ls_a_head_refdoc-refdoccat = 'ERP'. ls_a_head_refdoc-refdocno = iv_po_number. " 然后基于ERP参考创建ASN参考 ls_a_head_refdoc-refdoccat = 'ASN'. ls_a_head_refdoc-refdocno = iv_asn_number.关键提示：ASN参考凭证必须存在，否则在保存时会报错。如果实际业务中没有ASN，可以复制ERP参考凭证作为ASN参考。
4. 行项目处理的陷阱与技巧
4.1 基础行项目创建
创建行项目时需要注意几个特殊标志：
ls_a_item_prdi-itemtype = iv_itemtype. ls_a_item_prdi-manual_header = 'X'. " 必须设置为X ls_a_item_prdi-manual = 'X'. " 必须设置为X4.2 物料和数量信息填充
在填充物料信息时，常见的错误包括：
- 物料主数据在EWM中不存在
- 单位换算错误
- 库存类型不匹配
LOOP AT lt_a_item_prdi ASSIGNING FIELD-SYMBOL(<fs_item>). <fs_item>-productno = ls_item-productno. <fs_item>-qty = ls_item-qty. <fs_item>-uom = ls_item-uom. <fs_item>-stock_category = ls_item-stock_category. ENDLOOP.4.3 行项目参考凭证的特殊处理
行项目也需要关联参考凭证，这一点经常被忽略：
ls_a_item_refdoc-refdoccat = 'ERP'. ls_a_item_refdoc-refdocno = lv_ebeln. " 采购订单号 ls_a_item_refdoc-refitemno = lv_posnr. " 采购订单行号5. 保存前的最后校验
在执行最终保存前，EWM会执行一系列校验：
CALL METHOD lo_sp_inb->before_save IMPORTING rejected = lv_rejected. IF lv_rejected = abap_true. " 处理校验失败 ENDIF.常见的校验错误：
- 缺少ASN参考：如前所述，必须确保存在ASN类型的参考凭证
- 合作伙伴不完整：检查是否所有必需的合作伙伴角色都已提供
- 仓库数据不一致：确认所有物料在指定仓库中有效
6. 错误处理的最佳实践
在自动化创建过程中，健壮的错误处理机制至关重要。建议采用以下模式：
METHOD create_inbound_delivery. TRY. " 执行创建逻辑 CATCH /scdl/cx_sp INTO DATA(lx_sp). " 记录详细错误信息 log_error( lx_sp->get_text( ) ). " 尝试清理已创建的交货单 IF lv_docid IS NOT INITIAL. delete_delivery( lv_docid ). ENDIF. " 重新抛出异常 RAISE EXCEPTION TYPE cx_ewm_delivery_error EXPORTING previous = lx_sp. ENDTRY. ENDMETHOD.7. 性能优化技巧
在处理大批量交货单创建时，可以考虑以下优化措施：
- 批量处理：尽可能在一次调用中处理多个行项目
- 缓存服务实例：重复使用服务提供者实例而非每次创建新实例
- 并行处理：对独立交货单采用并行处理机制
" 批量设置行项目 DATA(lv_lines) = lines( it_item ). DO lv_lines TIMES. APPEND INITIAL LINE TO lt_a_item_prdi ASSIGNING FIELD-SYMBOL(<fs_item>). <fs_item>-itemtype = iv_itemtype. ENDDO.8. 实战案例：完整创建流程
下面是一个经过精简的完整创建示例：
METHOD create_inb_delivery. " 1. 初始化 /scwm/cl_tm=>set_lgnum( iv_lgnum ). " 2. 创建服务实例 DATA(lo_sp_inb) = create_service_provider( ). " 3. 创建抬头 DATA(lv_docid) = create_header( io_sp_inb = lo_sp_inb iv_doctype = iv_doctype iv_doccat = iv_doccat ). " 4. 添加合作伙伴 add_partners( io_sp_inb = lo_sp_inb iv_docid = lv_docid it_partner = it_partner ). " 5. 添加参考凭证 add_reference_documents( io_sp_inb = lo_sp_inb iv_docid = lv_docid it_refdoc = it_refdoc ). " 6. 创建行项目 DATA(lt_item_ids) = create_items( io_sp_inb = lo_sp_inb iv_docid = lv_docid it_item = it_item ). " 7. 保存 save_delivery( io_sp_inb ). ENDMETHOD.9. 调试技巧与日志记录
当遇到难以诊断的问题时，可以采用以下调试方法：
激活EWM跟踪：
/scwm/cl_dbg=>activate_trace( iv_trace_type = 'FULL' ).检查消息日志：
DATA(lt_messages) = lo_sp_inb->get_messages( ).使用事务码/SCWM/TRACE分析后台处理流程
10. 进阶话题：扩展与增强
对于需要扩展标准功能的场景，可以考虑以下方式：
BAdI实现：
/SCWM/EX_DLV_PRD_INB- 内向交货单处理增强/SCDL/EX_SP_PRD- 服务提供者增强
自定义校验逻辑：
METHOD /scwm/if_ex_dlv_prd_inb~check_before_save. " 自定义校验逻辑 IF cs_docid-doctype = 'MYTYPE'. " 特殊处理 ENDIF. ENDMETHOD.自定义字段扩展： 通过
/SCDL/DB_PROCI_I表的自定义字段扩展实现业务特定数据的存储