---
name: kd-enterprise-openapi
description: >
  对接金蝶企业版 K3Cloud OpenAPI（HTTP JSON）。
  Use when: 外部系统/RPA/第三方通过 WebAPI 登录、查询、保存、提交、审核、下推等。
  Do not use when: BOS 插件/报表二开（kd-enterprise-csharp 或 python）；自定义插件 API 开发。
---

# 企业版 OpenAPI 对接

语言无关 HTTP 协议。协议全文：[references/details.md](references/details.md)

## When / Do not

**Use when**：外部调用金蝶 OpenAPI。  
**Do not use when**：账内插件二开、报表加字段。

## Input / Output

| Input | Output |
|-------|--------|
| server_url、账套、认证方式、业务操作、单据/字段 | 请求序列（登录→业务→错误处理）+ 样例 JSON + 会话注意 |

## Steps

```
- [ ] 1. 确认对接方向：外部→金蝶（本 skill）
- [ ] 2. 选定认证：AppSecret 或 用户密码
- [ ] 3. 维持会话 Cookie（同一 HTTP 客户端）
- [ ] 4. 按 ServiceName 构造 POST JSON 数组参数
- [ ] 5. 解析 Result.ResponseStatus；失败可重试策略（幂等操作）
- [ ] 6. 日志脱敏；超时必设
```

## 失败策略

| 失败 | 动作 |
|------|------|
| 登录失败 | 检查 acct/app 密钥/语言 ID，不进入业务调用 |
| 业务失败 | 返回 IsSuccess 与 Errors 原文，不吞错 |
| 需求实为插件 | 切换 enterprise csharp/python skill |

## 验证

- 给出完整 URL、请求体、成功/失败判定字段、会话与超时说明