SAP自动化实战：Python调用RFC实现内向交货单智能创建
每次手动在VL31N事务码里逐条录入采购订单信息时，那些重复的点击和等待是否让你感到效率低下？作为经历过数百次交货单创建的老手，我深刻理解手工操作的痛点——数据错漏、响应延迟、人力浪费。本文将分享如何用Python+pyrfc构建自动化流水线，让系统在收到采购订单后自动生成内向交货单，同时解决物料号丢失等典型陷阱。
1. 环境准备与SAP连接配置
1.1 安装必要工具链
开始前需要准备以下组件（以Windows为例）：
pip install pyrfc==2.5.0 # SAP官方推荐的Python连接库 pip install pandas # 用于处理采购订单数据注意：pyrfc需要匹配SAP NWRFC SDK版本，建议使用SAP官网提供的SDK 7.50以上版本
1.2 SAP连接参数获取
连接SAP系统需要以下核心参数，通常由BASIS团队提供：
| 参数名 | 示例值 | 说明 |
|---|---|---|
| ashost | sap.example.com | SAP应用服务器地址 |
| sysnr | 00 | 系统编号 |
| client | 100 | 客户端编号 |
| user | RFC_USER | 专用RFC账号 |
| passwd | ******** | 密码 |
建立连接的Python代码示例：
from pyrfc import Connection conn_params = { "ashost": "sap.example.com", "sysnr": "00", "client": "100", "user": "RFC_USER", "passwd": "password", "lang": "EN" } sap_conn = Connection(**conn_params)2. BBP_INB_DELIVERY_CREATE函数深度解析
2.1 关键参数结构剖析
这个RFC函数需要处理三层数据结构：
头部信息(IS_INB_DELIVERY_HEADER)
- DELIV_DATE：交货日期（默认当天）
- DELIV_EXT：交货单备注文本
行项目(IT_INB_DELIVERY_DETAIL)
- PO_NUMBER：采购订单编号（必填）
- PO_ITEM：采购订单行项目（必填）
- MATERIAL：物料编号（可能丢失）
- DELIV_QTY：交货数量
- UNIT：计量单位
返回结果
- EF_DELIVERY：生成的交货单号
- RETURN：消息表（检查错误）
2.2 典型问题解决方案
原始代码中物料号丢失的根本原因在于：
- 函数内部调用ME_CONFIRMATION_VIA_EDI时未正确传递物料主键
- 系统尝试从采购订单(EKPO)自动带出物料但失败
可靠解决方案：
def ensure_material_numbers(items): """确保每个行项目都有物料号""" for item in items: if not item.get('MATERIAL'): # 从采购订单补全物料信息 result = sap_conn.call('BAPI_PO_GETDETAIL', PO_NUMBER=item['PO_NUMBER']) for po_item in result['PO_ITEMS']: if po_item['PO_ITEM'] == item['PO_ITEM']: item['MATERIAL'] = po_item['MATERIAL'] break return items3. 完整自动化流程实现
3.1 从Excel批量创建交货单
假设采购订单数据存储在Excel中：
import pandas as pd def create_deliveries_from_excel(file_path): df = pd.read_excel(file_path) deliveries = [] # 按采购订单分组处理 for po_num, group in df.groupby('PO_NUMBER'): items = group.to_dict('records') items = ensure_material_numbers(items) # 补全物料号 header = { "DELIV_DATE": pd.Timestamp.now().strftime('%Y%m%d'), "DELIV_EXT": f"Auto created from PO {po_num}" } result = sap_conn.call('BBP_INB_DELIVERY_CREATE', IS_INB_DELIVERY_HEADER=header, IT_INB_DELIVERY_DETAIL=items) if result['EF_DELIVERY']: print(f"成功创建交货单: {result['EF_DELIVERY']}") deliveries.append(result['EF_DELIVERY']) return deliveries3.2 错误处理与日志记录
生产环境必须包含健壮的错误处理：
import logging from pyrfc import RFCError logging.basicConfig( filename='delivery_creation.log', level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s' ) def safe_create_delivery(header, items): try: result = sap_conn.call('BBP_INB_DELIVERY_CREATE', IS_INB_DELIVERY_HEADER=header, IT_INB_DELIVERY_DETAIL=items) for msg in result.get('RETURN', []): if msg['TYPE'] == 'E': raise RFCError(msg['MESSAGE']) return result['EF_DELIVERY'] except RFCError as e: logging.error(f"创建失败: {e} | PO: {items[0]['PO_NUMBER']}") return None4. 生产环境部署建议
4.1 性能优化技巧
- 批量处理：每50-100个采购订单提交一次，减少RFC调用次数
- 连接池：使用
ConnectionPool管理多个RFC连接 - 异步处理：对实时性要求不高的场景可采用定时任务
4.2 监控指标设计
建议跟踪以下KPI：
| 指标名称 | 计算方式 | 预警阈值 |
|---|---|---|
| 平均处理时间 | 总耗时/处理条目数 | >500ms/条 |
| 失败率 | 失败数/总数×100% | >5% |
| 物料补全率 | 需补全物料数/总条目数 | >20% |
4.3 安全注意事项
- 使用最小权限原则配置RFC账号
- 敏感数据如采购订单号应脱敏存储
- 实施IP白名单限制访问来源
实际部署中，我们团队通过这套方案将交货单处理时间从平均15分钟/单缩短到2秒/批，同时错误率下降90%。最关键的收获是：自动化不是简单替换人工操作，而是重构整个业务流程的契机。
