SAP内向交货单创建避坑指南：GN_DELIVERY_CREATE必填字段全解析（含VL 561解决方案）

SAP内向交货单创建避坑指南GN_DELIVERY_CREATE必填字段全解析含VL 561解决方案在SAP供应链执行模块中内向交货单Inbound Delivery的创建是采购到付款流程的关键环节。许多企业在使用GN_DELIVERY_CREATE函数时常因字段缺失遭遇VL 561报错导致业务流程中断。本文将系统梳理该函数的核心校验逻辑提供可落地的解决方案。1. VL 561报错的底层逻辑剖析当系统抛出Essential transfer parameters are missing in record错误时本质是SAP的传输控制层检测到关键字段未满足最小数据集要求。这与传统MM模块的字段校验有显著差异校验层级发生在VL_SH_HU_CHECK之后VBUK/VBUP表更新之前校验机制通过函数组VL_FG的内部控制表进行字段必要性验证错误特征不会明确提示缺失字段名称需通过调试定位提示VL 561属于系统级校验错误优先级高于业务校验必须首先解决2. GN_DELIVERY_CREATE必填字段矩阵根据SAP S/4HANA 2022版本内核分析以下字段构成最小必填集2.1 头部字段VBSK结构字段名技术名称示例值填充逻辑凭证类型SMARTL固定值对应内向交货创建人ERNAMSY-UNAME自动获取当前用户创建日期ERDATSY-DATUM自动获取系统日期集合编号SAMMG90000001需调用NUMBER_GET_NEXT函数生成2.2 项目字段KOMDLGN结构 关键字段示例代码 ls_komdlgn-lfart ZEL. 交货类型 ls_komdlgn-vgtyp V. 参考凭证类型 ls_komdlgn-matnr gs_inbound-matnr. 物料编号 ls_komdlgn-werks gs_inbound-werks. 工厂 ls_komdlgn-lgort gs_inbound-lgort. 库存地点 ls_komdlgn-meins gs_inbound-meins. 基本单位必填字段可分为三类基础标识类物料号(MATNR)、工厂(WERKS)、库存地点(LGORT)计量单位类订单单位(VRKME)、基本单位(MEINS)参考凭证类采购订单号(VGBEL)、项目(VGPOS)3. 高频遗漏字段解决方案3.1 贸易条款缺失INCO1/INCO2 自动从供应商主数据获取贸易条款 SELECT SINGLE inco1, inco2 INTO (ls_komdlgn-inco1, ls_komdlgn-inco2) FROM lfm1 WHERE lifnr gs_inbound-lifnr AND ekorg P001.典型问题当供应商主数据未维护采购组织关联时会导致INCO字段为空。建议检查LFM1视图数据完整性设置默认值作为fallback方案在BAPI调用前增加空值校验3.2 批次管理场景特殊处理对于启用批次管理的物料必须补充以下字段批次编号CHARG特殊库存标识SOBKZ供应商批次LICHA注意批次字段的必填性取决于物料主数据配置需通过MCHA视图动态判断4. 增强型字段管理方案4.1 自动填充技术实现建议采用分层填充策略 字段填充优先级逻辑 IF ls_komdlgn-matnr IS INITIAL. 1. 尝试从采购订单获取 SELECT SINGLE matnr INTO ls_komdlgn-matnr FROM ekpo WHERE ebeln ls_komdlgn-vgbel AND ebelp ls_komdlgn-vgpos. 2. 从接口结构获取 IF sy-subrc 0. ls_komdlgn-matnr gs_inbound-matnr. ENDIF. ENDIF.4.2 字段校验工具开发可创建通用校验函数FUNCTION z_check_delivery_fields. 输入IT_KOMDLGN类型标准表 输出ET_RETURN类型BAPIRET2_T DATA: lt_required TYPE TABLE OF dfies. 获取KOMDLGN结构的必填字段定义 CALL FUNCTION DDIF_FIELDINFO_GET EXPORTING tabname KOMDLGN TABLES dfies_tab lt_required EXCEPTIONS not_found 1 OTHERS 2. 校验字段是否填充 LOOP AT lt_required ASSIGNING FIELD-SYMBOL(fs_field) WHERE notnull X. READ TABLE it_komdlgn ASSIGNING FIELD-SYMBOL(fs_item) WITH KEY (fs_field-fieldname) space. IF sy-subrc 0. 构建错误消息 APPEND VALUE #( type E id VL number 561 message_v1 fs_field-fieldname ) TO et_return. ENDIF. ENDLOOP. ENDFUNCTION.5. 错误处理最佳实践当VL 561报错发生时建议采用以下诊断流程启用调试模式在GN_DELIVERY_CREATE设置外部断点检查内部表监控变量XVFBS和XVFLS的内容分析校验日志通过CL_VL_SERVICESGET_CHECK_LOG获取详细错误字段追踪使用WHERE_USED_LIST查找字段关联关系对于批量处理场景建议实现错误自动归类 错误分类处理 CASE sy-subrc. WHEN 1. 系统错误 PERFORM log_system_error USING lv_message_all. WHEN 4. 业务错误 PERFORM log_business_error USING lt_spe_vbfs. WHEN OTHERS. 成功处理 CALL FUNCTION BAPI_TRANSACTION_COMMIT. ENDCASE.在实际项目中我们发现最常被忽略的是运输相关字段如VSTEL、ROUTE。建议建立字段检查清单在调用GN_DELIVERY_CREATE前执行预校验。