SAP-ABAP：采购申请创建（PR）BAPI_PR

SAP-ABAP：采购申请创建（PR）BAPI_PR_CREATE 技术指南-详解

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. 关键步骤说明

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