简介这份资源是面向用友U8二次开发者的C#接口开发示例聚焦采购订单的新增、删除、修改与审核四类操作适合具备一定C#基础、希望打通U8接口调用的企业信息化开发人员参考。示例围绕接口参数设定、通信连接建立、请求响应解析与异常处理展开并涉及订单状态向库存、财务等系统同步的一致性思路以及权限认证与测试部署等实践环节。压缩包共86个文件以cs源码、dll类库、xml配置、config与resx资源文件为主另含sln解决方案、csproj工程文件及少量exe、pdb调试文件整体约1.89MB结构完整可直接对照调试。目前已有170人学习下载读者可借此快速理解U8采购订单接口的调用流程与参数规范掌握从单条订单操作到批量处理、异常捕获的排错思路为后续定制化开发打下基础。1. 从一张采购订单说起U8 接口开发到底在解决什么问题很多做用友 U8 二开的同行都遇到过这个场景采购部门在 OA 或自研的 SRM 系统里录好了采购订单却要财务或采购内勤再手工往 U8 里录一遍。一天几十上百张单子录错单价、漏填供应商、税率选错月底对账时全是血泪经验。更麻烦的是U8 里的采购订单还要走审核流手工录入根本没法保证审批节点和业务系统同步。这时候就需要一套能对 U8 采购订单做增、删、改、审的接口把外部系统的数据直接写进 U8或者把 U8 的状态回传出去。这份资源就是围绕这个诉求展开的用 CO 方式也就是通过 U8 的 COM 组件、用 C# 或 VB 调用 U8 的登录与业务对象来开发采购订单的增删改审接口。它适合两类人一类是已经会用 U8 的 UAP 或 EAI 做简单对接但遇到采购订单这种带表头表体、带审批流的复杂单据就卡住的开发者另一类是被“用友u8.90升级到u8 18.0后登陆软件提示ufmeta库是以前版本的数据”这类升级问题折腾过想搞清楚底层接口调用逻辑的运维兼开发。核心不是教你点按钮而是把采购订单从登录、构造、保存到审核的整条链路拆开让你能照着写出可复现的代码。2. CO 方式调用 U8 采购订单登录、构造与保存的完整链路2.1 为什么选 CO 方式而不是直接写数据库在 U8 二开里绕过业务逻辑直接 INSERT 采购订单主表和子表看起来快实际是给自己埋雷。采购订单的保存不只是写两张表它还要校验供应商存货对照、更新累计到货量、触发审批流、写日志。直接写库的后果就是单子能查出来但审核按钮点不动或者后续入库单参照不到。CO 方式本质是调用 U8 自己的业务对象让 U8 去处理这些关联逻辑虽然慢一点但数据是“活”的。常见做法是引用UFIDA.U8.MomServiceCommon和UFIDA.U8.Portal.Framework这类程序集通过Login对象拿到U8Login实例再用NetLogin或Login类完成登录。登录成功后采购订单的业务对象一般通过UFIDA.U8.BusinessObjects下的PO_Pomain和PO_Podetails来操作。这里有个容易翻车的地方不同 U8 版本比如 13.0 和 18.0程序集名称和命名空间可能有细微差别升级后如果提示 ufmeta 库版本不对往往是因为登录组件和数据库元数据不匹配需要先用系统管理升级数据库。2.2 登录 U8 并拿到采购订单业务对象先看登录部分的代码。我一般会封装一个U8LoginHelper把账套、年度、用户名、密码、服务器地址传进去。注意 U8 的登录分两种一种是走Login类需要传AppServer、DataSource等另一种是走NetLogin适合跨网段。下面这段是常见的 CO 登录写法// 引用 UFIDA.U8.Portal.Framework.dll 和 UFIDA.U8.MomServiceCommon.dll using UFIDA.U8.Portal.Framework; using UFIDA.U8.Portal.Framework.Login; public class U8LoginHelper { public static U8Login LoginU8(string accId, string year, string userId, string password, string server) { U8Login u8Login new U8Login(); // 账套号、年度、操作员、密码、服务器 u8Login.Account accId; // 例如 001 u8Login.Year year; // 例如 2024 u8Login.UserId userId; // 例如 demo u8Login.Password password; // 操作员密码 u8Login.AppServer server; // U8 应用服务器 IP 或机器名 u8Login.DataSource server; // 数据库服务器通常同应用服务器 // 登录类型0 表示普通登录 u8Login.LoginType 0; if (!u8Login.Login()) { throw new Exception(U8 登录失败 u8Login.LastError); } return u8Login; } }这段代码的逻辑说明U8Login是 U8 提供的登录入口Account对应账套Year对应会计年度UserId和Password是操作员凭证。AppServer和DataSource在单机环境下可以填同一个值如果是分离部署AppServer填应用服务器DataSource填数据库服务器。LoginType一般用 0如果走门户集成可以用 1。登录失败时LastError会给出具体原因比如“用户不存在”“账套未启用”“ufmeta 库版本不一致”等。参数怎么改账套号在 U8 系统管理里能看到年度就是当前会计年度操作员需要有采购订单的增删改审权限否则登录成功但保存时会报权限不足。登录成功后拿采购订单业务对象。U8 的采购订单主表对象是PO_Pomain子表是PO_Podetails。我一般通过u8Login.GetBusinessObject(PO_Pomain)这种方式获取但更稳妥的是直接 new 一个PO_Pomain并传入登录对象。下面这段是构造一张采购订单的示例// 引用 UFIDA.U8.BusinessObjects.dll using UFIDA.U8.BusinessObjects.PO; public string SavePOOrder(U8Login u8Login) { // 创建主表对象 PO_Pomain poMain new PO_Pomain(u8Login); // 设置表头字段 poMain.cPCode PO20240101001; // 采购订单号需唯一 poMain.cVenCode V001; // 供应商编码 poMain.dPDate DateTime.Now; // 订单日期 poMain.cDepCode D01; // 部门编码 poMain.cPersonCode P001; // 业务员编码 poMain.cMemo 接口生成; // 备注 // 创建子表对象并挂到主表 PO_Podetails poDetail new PO_Podetails(u8Login); poDetail.cInvCode INV001; // 存货编码 poDetail.iQuantity 100; // 数量 poDetail.iUnitPrice 12.5m; // 单价 poDetail.iTaxRate 13; // 税率 poDetail.cMemo 接口行备注; // 将子表加入主表 poMain.PO_Podetails.Add(poDetail); // 保存 if (!poMain.Save()) { throw new Exception(保存失败 poMain.LastError); } return poMain.cPCode; }逻辑说明PO_Pomain的构造函数需要传入登录对象这样它才知道往哪个账套写。表头字段里cPCode是订单号必须唯一如果重复会报“单据号已存在”。cVenCode是供应商编码必须先在供应商档案里存在否则保存时报“供应商不存在”。子表PO_Podetails通过Add方法挂到主表的PO_Podetails集合里U8 会自动处理表头表体的关联。Save()返回布尔值失败时LastError会给出具体原因。参数怎么改数量、单价、税率根据实际业务填税率是整数百分比比如 13 表示 13%。如果存货需要批号或自由项还要设置cBatch或cFree1等字段。2.3 修改与删除先定位再操作修改采购订单不能直接 new 一个对象改必须先按订单号把已有单据查出来。常见做法是用PO_Pomain的Load方法或者用Query对象按条件查。下面这段是修改的示例public bool UpdatePOOrder(U8Login u8Login, string poCode, decimal newPrice) { PO_Pomain poMain new PO_Pomain(u8Login); // 按订单号加载 if (!poMain.Load(poCode)) { throw new Exception(订单不存在 poCode); } // 修改子表第一行的单价 if (poMain.PO_Podetails.Count 0) { poMain.PO_Podetails[0].iUnitPrice newPrice; } // 保存修改 return poMain.Save(); }逻辑说明Load方法按主键加载单据加载后可以修改表头或表体字段。注意修改已审核的单据通常会失败U8 会提示“已审核单据不能修改”所以改之前要么先弃审要么只改未审核的单子。删除也是类似先Load再调Deletepublic bool DeletePOOrder(U8Login u8Login, string poCode) { PO_Pomain poMain new PO_Pomain(u8Login); if (!poMain.Load(poCode)) { throw new Exception(订单不存在 poCode); } // 删除前检查是否已审核 if (poMain.cVerifier ! null poMain.cVerifier ! ) { throw new Exception(已审核订单不能直接删除请先弃审); } return poMain.Delete(); }参数说明cVerifier是审核人字段如果非空说明已审核。删除操作在 U8 里是物理删除删掉就没了没有后悔药所以生产环境我一般会先做逻辑作废而不是直接删。2.4 审核与弃审调用审批流接口审核采购订单不是简单改个标志位它要触发审批流。CO 方式下审核一般用PO_Pomain的Audit方法或者调用UFIDA.U8.BusinessObjects.Flow下的审批流接口。下面这段是审核示例public bool AuditPOOrder(U8Login u8Login, string poCode) { PO_Pomain poMain new PO_Pomain(u8Login); if (!poMain.Load(poCode)) { throw new Exception(订单不存在 poCode); } // 审核操作 if (!poMain.Audit()) { throw new Exception(审核失败 poMain.LastError); } return true; }逻辑说明Audit()会走 U8 的审批流引擎如果该单据类型配置了审批流会按流程节点走。审核失败常见原因当前操作员没有审核权限、审批流未启动、单据有必填项未填。弃审用UnAudit()但弃审通常要求单据未被下游参照比如没生成入库单。参数怎么改如果审批流需要指定审核人可以在登录时用对应操作员登录或者用Audit的重载方法传审核人。3. 接口开发中的参数映射与异常处理把外部数据翻译成 U8 能懂的语言3.1 字段映射表别让供应商编码变成供应商名称外部系统传过来的数据往往是 JSON 或 XML字段名和 U8 的字段名对不上。比如外部叫supplierNameU8 要的是cVenCode外部叫materialCodeU8 要的是cInvCode。我一般会先做一张映射表把外部字段和 U8 字段一一对应并且做编码转换。下面是一个常见的映射关系外部字段U8 字段说明orderNocPCode订单号需唯一supplierCodecVenCode供应商编码必须存在于供应商档案orderDatedPDate订单日期格式 yyyy-MM-dddeptCodecDepCode部门编码clerkCodecPersonCode业务员编码materialCodecInvCode存货编码qtyiQuantity数量数值型priceiUnitPrice单价数值型taxRateiTaxRate税率整数百分比这张表看着简单但坑在编码转换。外部系统可能传的是供应商名称U8 要的是编码你得先查供应商档案把名称转成编码。存货也一样外部传物料号U8 要存货编码中间可能还有存货分类和计量单位的问题。常见做法是写一个CodeConverter类用 SQL 查 U8 的Vendor表和Inventory表做转换查不到就抛异常别硬写。3.2 异常处理把 U8 的报错翻译成人话U8 的LastError有时候很笼统比如“保存失败”具体原因要去看 U8 的日志或者用 SQL Profiler 抓。我一般会在保存失败时把LastError和当前单据的关键字段一起记到日志里方便排查。下面是一个异常处理的封装public class U8ApiException : Exception { public string PoCode { get; set; } public string U8Error { get; set; } public U8ApiException(string poCode, string u8Error) : base($采购订单 {poCode} 操作失败{u8Error}) { PoCode poCode; U8Error u8Error; } } // 调用时 try { SavePOOrder(u8Login); } catch (Exception ex) { // 记录日志 LogHelper.Error($保存采购订单失败单号{poCode}错误{ex.Message}); // 如果是 U8 业务异常可以进一步解析 if (ex.Message.Contains(供应商不存在)) { // 提示调用方先同步供应商档案 } throw new U8ApiException(poCode, ex.Message); }逻辑说明自定义异常类把订单号和 U8 原始错误都带上方便上层接口返回给调用方。参数怎么改LogHelper可以用 log4net 或 NLog记录到文件或数据库。如果 U8 报“存货不存在”说明外部传的物料编码在 U8 里没有对应存货需要先同步存货档案。如果报“税率不能为空”检查iTaxRate是否赋值。3.3 事务与并发同一张单别两个人同时改CO 方式下U8 的业务对象本身没有提供跨单据的事务但单张单据的保存是原子的。并发问题主要出现在两个人同时改同一张单A 加载了单据B 也加载了A 先保存B 再保存就会覆盖 A 的修改。常见做法是在保存前检查单据的UpdateTime或版本号或者用锁。我一般会在接口层加一个简单的分布式锁按订单号加锁避免并发写。另外批量保存时如果一张失败前面的已经保存了没有后悔药所以要么逐张事务提交要么在业务上允许部分成功。4. 避坑与排查CO 方式调采购订单接口的五个血泪教训4.1 登录成功但保存时报“没有权限”现象用操作员账号登录 U8 成功但调用Save()时返回“没有权限”或“操作员无此功能权限”。原因U8 的权限分功能权限和数据权限登录只验证了账号密码保存时才会检查操作员是否有采购订单的增删改审权限。解决在 U8 系统管理里给该操作员分配采购订单的对应权限或者用有权限的账号登录。如果是在测试环境可以直接用账套主管登录。4.2 订单号重复导致保存失败现象保存时提示“单据号已存在”或“违反主键约束”。原因cPCode是主键外部系统生成的订单号可能和 U8 里已有的重复或者并发时两个请求用了同一个号。解决订单号生成规则要保证唯一可以用“前缀日期序列号”序列号从数据库取。如果外部系统已经保证了唯一保存前先Load一下存在就改成更新而不是新增。4.3 升级到 U8 18.0 后登录报 ufmeta 库版本不一致现象从 U8 13.0 或 8.90 升级到 18.0 后用 CO 方式登录时提示“ufmeta 库是以前版本的数据请使用系统管理”。原因U8 升级后数据库元数据没有同步升级登录组件读到的 ufmeta 版本和当前程序版本不匹配。解决用 U8 系统管理登录执行“升级 SQL Server 数据库”或“升级数据库”操作把 ufmeta 库升到当前版本。如果升级后还有问题检查应用服务器和数据库服务器的版本是否一致。4.4 审核时提示“审批流未启动”现象调用Audit()返回失败错误信息是“审批流未启动”或“找不到审批流”。原因该单据类型在 U8 里配置了审批流但流程没有启用或者当前操作员不在审批流节点上。解决在 U8 的审批流设置里启用对应流程并确保操作员有审核节点权限。如果不需要审批流可以在单据类型设置里关掉审批流直接审核。4.5 修改已审核单据导致数据不一致现象先调UpdatePOOrder改了单价再调AuditPOOrder审核结果审核后单价又变回去了。原因已审核单据的修改没有走弃审流程U8 在审核时可能用旧数据覆盖。解决修改已审核单据前先调UnAudit()弃审改完再审核。如果业务不允许弃审就不要改已审核单据走变更单流程。5. 进阶技巧用 Restful 接口封装 CO 调用让外部系统无感对接CO 方式虽然稳但它是 C# 程序集调用外部系统如果是 Java 或 Python 就没法直接用。常见做法是在 U8 服务器上部署一个 Web API 服务把 CO 调用封装成 Restful 接口外部系统通过 HTTP 调用。这样既保留了 CO 的业务逻辑又解耦了技术栈。下面是一个用 ASP.NET Core 封装的示例[ApiController] [Route(api/po)] public class POController : ControllerBase { [HttpPost(save)] public IActionResult SavePO([FromBody] PORequest request) { try { // 登录 U8 var u8Login U8LoginHelper.LoginU8( request.AccId, request.Year, request.UserId, request.Password, request.Server); // 保存采购订单 var poCode SavePOOrder(u8Login, request); return Ok(new { code 0, poCode poCode }); } catch (Exception ex) { return BadRequest(new { code 1, message ex.Message }); } } }逻辑说明PORequest是外部传入的 DTO包含账套、年度、操作员、订单数据等。接口返回统一格式code0表示成功code1表示失败并带错误信息。参数怎么改账套和年度可以放在配置里不用每次传操作员可以用一个专用的接口账号避免暴露个人密码。部署时注意 U8 的 COM 组件需要在服务器上注册Web API 的应用程序池要用 32 位模式如果 U8 是 32 位组件。验证方法用 Postman 或 curl 发一个 POST 请求看返回的poCode是否和传入的一致然后去 U8 里查这张单是否存在、能否审核。我一般会写一个简单的控制台测试程序先跑通单张保存再跑批量。批量时注意每张单之间加个短暂延迟避免 U8 锁表。从那以后我每次对接 U8 采购订单接口都强制先跑一遍登录和单张保存的冒烟测试确认权限、编码、审批流都没问题再上批量。希望帮到你。本文还有配套的精品资源点击获取
