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 最佳實踐確保集成穩定性。