SAP-ABAP:Sap的SD模块bapi详解，带实例

在SAP SD（销售与分销）模块中，BAPI（Business Application Programming Interface） 是用于与其他系统（如外部程序、EDI、Web服务等）或内部模块集成的重要工具。BAPI封装了业务逻辑，提供标准化的接口，支持创建、修改、查询销售订单、发货单、发票等核心业务对象。以下是SD模块中常见BAPI的详解及使用要点：

---

一、BAPI核心概念

1. BAPI是什么？

   • 基于RFC（Remote Function Call）的标准化接口，用于访问SAP业务对象（Business Objects）。
   • 每个BAPI对应一个业务对象的方法（如Create, Change, GetDetail）。
   • 支持事务性操作（需显式提交BAPI_TRANSACTION_COMMIT）。

2. BAPI特点：

   • 标准化：SAP官方维护，兼容性强。
   • 事务控制：需手动提交或回滚事务。
   • 结构化参数：输入/输出参数多为结构或内表。
   • 错误处理：通过RETURN表返回消息（成功、警告、错误）。

---

二、SD模块常用BAPI及功能

1. 销售订单（Sales Order）

• 创建销售订单
  BAPI_SALESORDER_CREATEFROMDAT2
  参数：

  • ORDER_HEADER_IN：订单抬头数据（如销售组织、分销渠道）。
  • ORDER_ITEM_IN：订单行项目数据（物料、数量、价格）。
  • RETURN：返回消息表。
  • SALESDOCUMENT：生成的订单号（输出）。

  示例代码：

  CALL FUNCTION 'BAPI_SALESORDER_CREATEFROMDAT2'
    EXPORTING
      ORDER_HEADER_IN = ls_header
    TABLES
      RETURN          = lt_return
      ORDER_ITEM_IN   = lt_items.
  

• 修改销售订单
  BAPI_SALESORDER_CHANGE
  通过ITEM_CHANGE或HEADER_CHANGE指定修改字段。

• 查询销售订单
  BAPI_SALESORDER_GETLIST：获取订单列表。
  BAPI_SALESORDER_GETDETAIL：获取订单详细信息。

---

2. 发货单（Delivery）

• 创建外向交货单
  BAPI_OUTB_DELIVERY_CREATE_SLS
  参数：

  • SHIP_POINT：装运点。
  • SALES_ORDER：参考销售订单。
  • VERKO_BELEG：生成的交货单号（输出）。

• 过账发货（Post Goods Issue）
  BAPI_GOODSMVT_CREATE
  使用移动类型601（销售发货）更新库存。

---

3. 发票（Billing）

• 创建发票
  BAPI_BILLINGDOC_CREATE
  参数：
  • BILLINGDOC_IN：发票抬头数据。
  • RETURN：消息表。
  • BILLINGDOC：生成的发票编号（输出）。

---

4. 主数据维护

• 客户主数据
  BAPI_CUSTOMER_CREATE：创建客户。
  BAPI_CUSTOMER_CHANGE：修改客户。

• 物料主数据
  BAPI_MATERIAL_SAVEDATA：创建/修改物料。

---

三、BAPI调用通用步骤

1. 准备输入数据：填充结构或内表（如订单抬头、行项目）。
2. 调用BAPI：使用CALL FUNCTION执行目标BAPI。
3. 检查返回消息：遍历RETURN表，处理错误（TYPE = 'E'或'A'）。
4. 提交事务：若成功，调用BAPI_TRANSACTION_COMMIT；失败时调用BAPI_TRANSACTION_ROLLBACK。

---

四、注意事项

1. 必填字段：需严格遵循SAP数据字典要求（如销售组织、物料号）。
2. 增强字段：若使用自定义字段，需通过EXTENSIONIN参数传递。
3. 性能优化：批量处理时建议启用BAPI_*_BULK类接口。
4. 事务一致性：确保在业务逻辑完成后提交事务，避免数据不一致。
5. 测试环境：建议先在测试系统验证BAPI逻辑。

---

五、调试与错误处理

• 查看RETURN表：使用MESSAGE_ID和MESSAGE_NUMBER定位错误。
• 使用事务SE37：直接测试BAPI输入输出。
• 日志工具：结合APPLICATION_LOG相关BAPI记录操作日志。

---

六、示例场景

场景：通过外部系统创建销售订单
步骤：

1. 填充ORDER_HEADER_IN（销售组织、分销渠道、订单类型）。
2. 填充ORDER_ITEM_IN（物料、数量、工厂）。
3. 调用BAPI_SALESORDER_CREATEFROMDAT2。
4. 检查RETURN表，确认无错误后提交事务。

---

七、官方资源

• BAPI Explorer（事务码BAPI）：查看所有可用BAPI。
• SAP Help Portal：搜索具体BAPI文档（输入BAPI名称）。
• 事务码SE37：直接查看函数模块参数和代码逻辑。

通过合理使用BAPI，可以实现SD模块与其他系统的高效集成，同时确保业务流程的标准化和稳定性。