BAPI_PR_CREATE 技术指南

用途：通过 RFC 接口创建 SAP 采购申请（PR），支持自动化集成与批量处理。

---

一、功能概览

类别	说明
核心功能	创建标准采购申请、预留转采购申请，支持多行项目及账户分配。
集成场景	与 MRP 系统、外部采购平台、企业门户等集成，实现需求自动提报。
数据范围	支持工厂、库存地点、采购组、审批策略、交货日期等关键业务字段的维护。

---

二、参数详解

1. 输入参数（Import Parameters）

关键结构说明

参数名	结构类型	必填	说明
PRHEADER	BAPIMEREQHEADER	是	采购申请抬头信息，定义单据类型、采购组织等全局属性。
PRITEM	BAPIMEREQITEM_T	是	行项目明细表，包含物料、数量、工厂等核心数据。
PRACCOUNT	BAPIMEREQACCOUNT_T	否	账户分配表（如成本中心、WBS 元素），需与 ACCTASSCAT 字段匹配。
PRITEMX	BAPIMEREQITEM_T	否	字段更新标识表，标记需显式传入的字段（避免默认值覆盖问题）。

字段速查表

PRHEADER 关键字段

DOC_TYPE   TYPE BAPIMEREQHEADER-DOC_TYPE,   "单据类型（默认 'NB'）
PUR_ORG    TYPE BAPIMEREQHEADER-PUR_ORG,    "采购组织（如 '0001'）
PUR_GROUP  TYPE BAPIMEREQHEADER-PUR_GROUP,  "采购组（如 '001'）
DELIV_DATE TYPE BAPIMEREQHEADER-DELIV_DATE, "需求日期（必填）

PRITEM 关键字段

PREQ_ITEM  TYPE BAPIMEREQITEM-PREQ_ITEM,    "行号（建议 '00010' 递增）
MATERIAL   TYPE BAPIMEREQITEM-MATERIAL,     "物料编号（需存在主数据）
PLANT      TYPE BAPIMEREQITEM-PLANT,        "工厂（与采购组织分配一致）
QUANTITY   TYPE BAPIMEREQITEM-QUANTITY,    "数量（>0）
ACCTASSCAT TYPE BAPIMEREQITEM-ACCTASSCAT,  "账户分配类型（如 'K'=成本中心）

---

2. 输出参数（Export Parameters）

参数名	结构类型	说明
PURCHASINGDOCUMENT	BAPIMEREQHEADER-PREQ_NO	生成的采购申请号（如 ‘4500000123’）
RETURN	BAPIRET2_T	执行结果消息（成功/错误明细）

---

三、调用示例与分步解析

1. ABAP 代码示例

DATA: ls_header    TYPE BAPIMEREQHEADER,lt_pritem    TYPE TABLE OF BAPIMEREQITEM,lt_praccount TYPE TABLE OF BAPIMEREQACCOUNT,lt_return    TYPE TABLE OF BAPIRET2,lv_preq_no   TYPE BAPIMEREQHEADER-PREQ_NO.* 1. 抬头信息配置
ls_header = VALUE #(DOC_TYPE   = 'NB'             "采购申请类型PUR_ORG    = '0001'           "采购组织PUR_GROUP  = '001'            "采购组DELIV_DATE = sy-datum + 30    "30天后交货
).* 2. 行项目配置
APPEND VALUE #(PREQ_ITEM  = '00010'          "行号MATERIAL   = 'MAT-1000'       "物料号（需在MM01中存在）PLANT      = '1000'           "工厂QUANTITY   = 5                "数量UNIT       = 'EA'             "单位ACCTASSCAT = 'K'              "成本中心分配
) TO lt_pritem.* 3. 账户分配配置（若 ACCTASSCAT=K）
APPEND VALUE #(PREQ_ITEM  = '00010'          "关联行号CO_AREA    = '1000'           "控制范围COSTCENTER = 'KOSTEN_001'     "成本中心（需在KS03激活）
) TO lt_praccount.* 4. 执行 BAPI
CALL FUNCTION 'BAPI_PR_CREATE'EXPORTINGPRHEADER           = ls_headerIMPORTINGPURCHASINGDOCUMENT = lv_preq_noTABLESPRITEM             = lt_pritemPRACCOUNT          = lt_praccountRETURN             = lt_return.* 5. 事务提交与错误处理
IF lt_return IS INITIAL.CALL FUNCTION 'BAPI_TRANSACTION_COMMIT'.WRITE: / 'PR Created:', lv_preq_no.
ELSE.CALL FUNCTION 'BAPI_TRANSACTION_ROLLBACK'.LOOP AT lt_return INTO DATA(ls_msg).WRITE: / ls_msg-type, ls_msg-message.ENDLOOP.
ENDIF.

2. 关键步骤说明

1. 抬头配置：确保采购组织与工厂的分配关系（SPRO: Materials Management > Purchasing > Assign Purchasing Organization to Plant）。
2. 行项目校验：物料主数据需存在且采购视图维护完整（MM03 检查）。
3. 账户分配：若使用成本中心，需确保其有效性（KS03 检查状态和有效期）。

---

四、注意事项与常见问题

1. 必填字段校验

字段	检查点	事务码
MATERIAL	物料采购视图是否维护	MM03
PLANT	工厂是否分配给采购组织	SPRO
COSTCENTER	成本中心是否在有效期内	KS03

2. 事务控制

• 显式提交：BAPI 不自动提交，需调用 BAPI_TRANSACTION_COMMIT。
• 错误回滚：若 RETURN 表包含错误（Type = ‘E’），必须调用 ROLLBACK。

3. 增强与扩展

• 自定义字段：通过 EXTENSIONIN 传递扩展结构（需提前通过 CMOD 增强 ME_REQ_HEAD 或 ME_REQ_ITEM）。
• 审批流触发：调用 BAPI_REQUISITION_RELEASE 触发后续审批。

---

五、故障排查指南

错误现象	可能原因	解决方案
物料不存在或采购视图缺失	物料未维护采购组织/工厂	MM01 维护采购视图
采购组未分配采购组织	采购主数据配置错误	SPRO 检查采购组分配
成本中心无效	未激活或控制范围不匹配	KS03 检查成本中心主数据
行项目数量为0	QUANTITY 字段未传值	检查代码逻辑或输入参数

---

六、扩展工具与参考

工具/事务码	用途
ME53N	查看生成的采购申请
BAPI_PR_GETDETAIL	获取采购申请详细信息
BAPI_PR_CHANGE	修改已有采购申请
SU22	检查用户权限（对象 B_PURCHREQ）

---

通过此优化结构，读者可快速定位参数定义、代码示例及常见问题，同时遵循 SAP 最佳实践确保集成稳定性。