1. 项目背景与核心价值易飞ERP作为国内主流的企业资源计划系统其审核流程是企业内部管控的关键环节。传统审核操作通常需要登录系统界面逐一点击完成对于批量处理或系统集成场景效率较低。我们团队通过WebAPI方式实现了对所有单据类型的审核/撤审功能封装让企业能够通过HTTP调用直接触发审核流程与内部其他系统无缝集成实现批量自动化处理构建自定义审核工作台这个方案特别适合以下场景与OA系统对接实现电子审批流与MES系统联动实现生产工单自动审核财务系统对接实现凭证批量审核移动端审批应用开发2. 技术架构设计2.1 整体方案设计采用三层架构实现[客户端] - [WebAPI服务层] - [易飞ERP数据库]服务层使用.NET Core 3.1开发主要组件包括身份认证中间件请求参数验证器单据类型路由器审核操作执行器结果包装器2.2 关键技术实现2.2.1 用户认证方案采用JWT动态密钥方式services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme) .AddJwtBearer(options { options.TokenValidationParameters new TokenValidationParameters { ValidateIssuerSigningKey true, IssuerSigningKey new SymmetricSecurityKey(Encoding.UTF8.GetBytes(Configuration[Jwt:Key])), ValidateIssuer false, ValidateAudience false }; });2.2.2 数据库访问层使用Dapper进行高效数据访问public int ExecuteAudit(string docType, string docNo, string userCode) { using (var conn new SqlConnection(_config.GetConnectionString(ERP))) { return conn.Execute( UPDATE GetTableName(docType) SET AuditStatus 1, Auditor userCode, AuditTime GETDATE() WHERE DocNo docNo, new { docNo, userCode }); } }3. API接口规范3.1 审核接口POST /api/audit Content-Type: application/json { DocType: PO, // 单据类型 DocNo: PO20230001, // 单据编号 UserCode: ADMIN // 审核人工号 }响应示例{ Success: true, Message: 审核成功, Data: { DocNo: PO20230001, AuditTime: 2023-06-15T14:30:22 } }3.2 撤审接口POST /api/unAudit 参数格式与审核接口相同4. 安全控制要点4.1 权限验证矩阵操作类型所需权限数据权限控制采购单审核PO_AUDIT供应商范围限制销售单审核SO_AUDIT客户范围限制生产单审核MO_AUDIT车间范围限制4.2 审计日志记录所有审核操作均记录完整操作日志CREATE TABLE AuditLog ( LogID INT IDENTITY PRIMARY KEY, DocType VARCHAR(10), DocNo VARCHAR(20), OperationType VARCHAR(10), Operator VARCHAR(20), OperationTime DATETIME, ClientIP VARCHAR(15) );5. 测试环境部署5.1 环境准备安装IIS 10.0安装.NET Core 3.1运行时配置数据库连接字符串5.2 测试用例使用Postman进行接口测试获取TokenPOST /api/auth Body: {UserCode:test,Password:123456}带Token调用审核接口GET /api/audit Headers: Authorization: Bearer {token}6. 常见问题解决方案6.1 错误代码表错误码说明解决方案4001无效单据类型检查DocType参数4003单据不存在确认DocNo是否正确5001数据库连接失败检查连接字符串6001无操作权限检查用户权限配置6.2 性能优化建议启用数据库连接池对高频单据类型建立缓存批量操作接口实现7. 扩展应用场景7.1 与RPA集成通过API实现自动化审核流程import requests def auto_audit(doc_list): token get_token() for doc in doc_list: resp requests.post( API_URL /audit, jsondoc, headers{Authorization: fBearer {token}} ) if not resp.json()[Success]: send_alert(doc[DocNo])7.2 移动审批应用开发微信小程序审批界面Page({ onAudit: function() { wx.request({ url: https://api.xxx.com/audit, method: POST, data: { DocType: this.data.docType, DocNo: this.data.docNo, UserCode: app.globalData.userCode }, success: res { if(res.data.Success) { wx.showToast({title: 审核成功}) } } }) } })8. 实施注意事项生产环境必须启用HTTPS建议配置API网关进行流量控制重要单据建议增加二次确认机制定期备份审计日志接口版本控制方案建议URL路径版本控制/v1/audit通过Header指定版本默认兼容最近两个版本实际部署中发现当单日审核操作超过5000次时建议增加Redis缓存层采用批量审核接口优化数据库索引对于特殊单据类型如财务凭证我们额外实现了电子签名验证审核结果回调通知关联单据联动审核