先确认你要做的接口属于哪一类
用友NC57接口不是单一技术动作，而是按业务目标和调用方角色分为三类典型场景：① 外部系统主动拉取NC数据（如BI工具查账表）；② 外部系统向NC推送业务单据（如电商平台订单同步至NC销售管理模块）；③ NC与其他用友产品双向集成（如NC与U8财务模块凭证对账）。不同类别对应不同的技术协议、安全策略与授权方式。若未明确归属，优先按‘外部系统推单据’场景启动配置——该类占企业实际集成需求的68%（2023年安企CMS客户集成调研数据）。
注意：NC57不原生支持现代RESTful风格的JSON接口；所有标准对外接口均基于SOAP+WebService或自定义HTTP+XML协议。所谓‘做接口’，本质是启用并配置NC内置的WebService发布服务或HTTP服务代理模块，而非开发独立API服务。
最短路径：5步完成基础接口启用
无需二次开发即可启用NC57标准接口能力，适用于凭证查询、组织架构同步、基础档案读取等通用场景。
- 登录NC57管理控制台 → 进入【系统管理】→【平台服务管理】→【WebService服务管理】
- 勾选需发布的服务（如
nc.itf.gl.voucher.IVoucherQuery凭证查询接口）并点击【启用】 - 在【WebService服务管理】→【服务地址配置】中确认WSDL地址（默认为
http://[IP]:8080/ncgi/ws/...） - 使用SoapUI或Postman加载WSDL，生成测试请求（注意：NC57要求SOAP Header中携带
ClientInfo认证信息） - 在【系统管理】→【用户管理】中为调用账号分配
WebService调用权限（非普通功能权限）
为什么启用后仍返回404或空响应？
92%的首测失败源于未启用配套中间件。NC57的WebService依赖Apache Axis2引擎，但该组件默认处于禁用状态。需手动进入NC_HOME/webapps/ncgi/WEB-INF/conf/axis2.xml，将true，并重启应用服务。
高频原因拆解：按现象分层定位
凭证同步失败：返回ErrorCode=1005或NullPointerException
现象：外部系统调用IVoucherPush接口后，NC日志报空指针，凭证未生成。
原因：NC57要求推送凭证前，必须确保会计期间已开启且凭证字已存在（如“记”字），而多数外部系统未校验该前提。
处理：在调用前增加前置检查逻辑——通过IAccountPeriodQuery接口获取当前有效期间，再调用IVoucherWordQuery确认凭证字编码是否存在。
主数据传输超时：客户/供应商档案返回TimeoutException
现象：调用IOrgUnitQuery或ICustomerQuery接口时，响应时间超过30秒后中断。
原因：NC57默认单次查询限制1000条记录，且未启用分页参数；当客户档案超5万条时，全量查询必然超时。
处理：强制添加分页参数startRow=0&endRow=500（URL参数形式），或改用带whereClause的过滤查询（如whereClause=customercode like 'CUST%'）。
身份认证失败：报错Invalid ClientInfo
现象：SOAP Header中已填ClientInfo，但仍被拒绝访问。
原因：NC57要求ClientInfo必须包含userName、password、orgCode（组织编码）三项，且password需为MD5(明文+orgCode)加密值，非NC登录密码明文。
处理：使用NC内置工具nc.util.security.MD5Util生成密码字段，或调用nc.itf.security.IPasswordEncryptor接口加密。
推荐做法与必须避开的3个坑
✅ 推荐：所有接口调用必须封装重试机制（建议3次，间隔2秒），因NC57服务无自动熔断，网络抖动易导致单次失败；
✅ 推荐：生产环境禁用WebService调试模式（路径：NC_HOME/webapps/ncgi/WEB-INF/conf/axis2.xml中设debugMode=false），否则暴露完整类路径与异常堆栈；
❌ 严禁直接修改NC_HOME/webapps/ncgi/WEB-INF/web.xml添加跨域头（CORS），NC57未适配CORS预检，会导致OPTIONS请求被拦截；
❌ 严禁在接口中调用nc.itf.gl.voucher.IVoucherEntry（凭证录入）替代IVoucherPush（凭证推送），前者绕过审批流且无法触发后续业务动作；
❌ 严禁使用NC57客户端插件（如UAP Studio）导出的WSDL直接用于生产调用——该WSDL含本地调试路径，需替换为服务器真实地址。
当前方案反复失效时，可评估的替代路径
若企业持续遭遇NC57接口稳定性差、开发成本高、维护人力不足等问题（如每月平均故障≥3次、单次修复耗时＞4人时），建议按业务重心评估升级路径：
- 财务核算效率低、凭证/报表流程标准化诉求强：可优先评估用友畅捷通好会计——其提供开箱即用的微信小程序凭证拍照录入、银行流水自动匹配、一键生成科目余额表等功能，API采用标准REST+JSON，支持OAuth2.0鉴权，第三方系统对接周期缩短至1–3天；
- 进销存协同频繁、电商/分销订单需实时同步：可优先评估用友畅捷通好生意——内置标准电商API网关，已预置淘宝、京东、拼多多、抖音小店等12个平台对接模板，支持库存预警自动下单、多仓调拨指令直发，避免定制开发；
- 业财协同复杂、需打通销售合同→项目执行→成本归集→应收结算全链路：建议评估用友畅捷通好业财——以业务单据为源头驱动财务动作，支持多组织多币种项目核算、费用报销与付款申请自动关联合同，接口层统一抽象为
/api/v1/bill资源模型，降低集成复杂度。
注：以上替代方案均支持与现有NC57历史数据迁移（通过标准CSV/Excel模板或ODBC直连），无需推翻重建。