每月末，财务的桌面上会并排开着两个窗口：左边是用友 U8 的总账，右边是勤哲 Excel 服务器里归集的业务表。业务侧的收入、成本、往来，要按科目、按辅助核算一项项录成凭证，录完再回头核一遍借贷平不平。
这类活不难，但慢，而且错不起。一张凭证的科目挂错，月底的报表就要重出；辅助核算项漏填，下期余额对不上，又得从头翻。
要解决它，未必要换掉任何一套系统。更现实的做法是让两边通个话：业务数据留在勤哲 Excel 服务器里，通过用友开放的接口把凭证取过来，也能把凭证送回去。
下面记录的就是一次完整的对接过程——勤哲 Excel 服务器 V2023 版套餐 7 的 WebAPI 功能，对接用友 U8（12.51 版本）的 OpenAPI，以总账模块的凭证为例走一遍。
对接最怕一上来就想全打通。系统之间字段体系不同，科目、辅助核算、单据类型各有各的编码，全面铺开的结果往往是每一处都差一点，最后哪一段都不敢上线。
这次选了一个最小闭环：凭证。它同时满足两个条件——用友侧的接口成熟，勤哲侧只要一张模板就能承接。
路径分两步：先"取"，把总账里的凭证列表拉进勤哲的表单里看；再"写"，把勤哲归集好的业务数据生成凭证回写到总账。取通了，写才有参照物。
动手前要先接受一件事：用友的 OpenAPI 是收费接口，具体费用得向自己的用友服务商确认。这笔成本要算进项目预算，别等到联调时才发现额度不够。
第一步不在勤哲里，而在用友。访问用友开放平台注册用户，企业客户可以快速注册；登录后进入应用中心创建应用，具体步骤照着平台文档走即可。
这一步看着是流程性工作，其实决定了后面能不能调通。应用创建后会得到一组身份凭据，后面的 token 就靠它换取；凭据失效，接口一律返回鉴权失败。
创建应用时会遇到一个绕不开的前提：接口是收费的。平台文档里写明了计费方式，实际额度以商务确认为准。
这句话值得单独拎出来说。很多对接项目卡在这一步，不是因为技术做不到，而是预算里没算接口费，签完合同才发现调用要另外买。
光有开放平台的应用还不够。真正跟 U8 账套打交道的是本地客户端工具：先下载 U8 OpenAPI 客户端，安装到用友软件所在的那台服务器上。
装好之后，在服务器上打开"EAI 接口设置"，做三项基本配置：服务器地址、U8 帐套用户名密码、数据源选择。
这三项配置对应三件事。服务器地址告诉客户端去哪儿找 U8；帐套用户名密码决定它能进哪个账套、以什么身份进；数据源选择则指向账套背后的数据库。
最容易出的问题是装错机器。客户端要装在用友应用服务器上，装到办公电脑上连不到内网数据库；EAI 设置也必须在那台机器上做，换一台机器就得重来一遍。
轮到勤哲这一侧了。以"获取凭证列表信息"这个接口为例，先打开用友的接口文档，看清请求地址、参数和返回结构，重点确认 token 怎么取。
token 是访问用友系统的必需参数，通常有有效期。配置 WebAPI 时就要想清楚两件事：多久换一次，以及换不到时表单该给什么提示。
接下来在勤哲 Excel 服务器客户端里新建 WebAPI，把地址、方法、请求头、请求体按文档填好。凭证查询通常还要带账套、会计期间、凭证类别这些条件，少一个就可能返回空结果。
填完先单独测一次。能返回一段结构正确的数据，说明链路通了；返回鉴权错误，就回到 token 和凭据；返回空，多半是条件写错了。
接口配好只说明"能调"，要让它进入日常流程，还得挂到表单上。做法是在模板里加一条表间公式：触发条件设成填报或刷新，动作指向刚配好的 WebAPI，返回结果按列写进明细表。
这样，业务人员在表单上选好期间、点一下执行，凭证数据就落进表里。他不需要记接口地址，也不需要再打开第二个软件。
字段映射是这一步的细活。接口返回的是 JSON，表单要的是列，哪一项落到哪一列必须一一对应；金额、日期这类字段还要处理格式，否则进表之后成了一串字符，汇总时算不了。
验证的方法很朴素：同一账套、同一期间，把勤哲取到的凭证列表和用友总账里的列表并排看。凭证号、日期、摘要、科目、借贷金额逐列对，能对上才算真的通了。
对不上时先查三处：期间条件是否一致、辅助核算有没有带出、金额单位是否相同。多数偏差不是接口的问题，而是查询条件差了一点。
取通之后，反方向的路也就清楚了。用友提供的不只是查询接口，也有写入接口：勤哲里归集好的业务单据，按科目规则生成凭证，再通过 WebAPI 回写到总账。
这一步的意义是"一次录入，两处成账"。业务侧录的是事实，财务侧要的是凭证，中间那层翻译交给公式，人手不再介入，也就没有了转录误差。
回写要比取数谨慎。写错了要冲销，碰上已结账期间还会被直接拒绝。稳妥的做法是先在测试账套跑通，确认科目映射和辅助核算都对，再动生产账套。
把这六条捋清楚，对接这件事就不再神秘：一边是被调用的接口，一边是发起调用的表单，中间靠 token 和字段映射连起来。真正花时间的，从来不是点哪几个按钮，而是把两套系统的"说法"对上。
